The httpd.conf file:
Defines and loads the redirector module – the LoadModule directive informs the Apache Web server of the name and location of the redirector module to load when the Web server starts.
Identifies the redirector configuration file – the redirector configuration file contains the mappings of incoming requests to the EAServer HTTP listener to which they are redirected.
Defines the context paths – the LocationMatch directive defines the context paths that inform the Web server which requests are directed to the redirector. If no context path is provided, the request is serviced by the Web server.
The following lines illustrate a sample httpd.conf file for Apache 1.3.26.
LoadModule easredirector_module libexec/libjeas_mod.sl EASConfigFile WEB_SERVER_HOME/conf/conn_config ServerName www.myhost.com <LocationMatch /examples/*|/estore/* > SetHandler eas-handler </LocationMatch>
For Apache 2.0, change the first line to:
LoadModule easredirector_module lib/libjeas2_mod.sl
At the end of the WEB_SERVER_HOME/conf/httpd.conf file, add the directives defined in the sample above, where:
LoadModule defines and loads the redirector module.
EASConfigFile identifies the file that contains the redirector configuration parameters.
ServerName identifies the host machine on which the Web server runs. Specify the host using either the IP address or the fully qualified domain name; for example, www.foo.com. If you do not set this directive, the redirector continues to run, but you might see this warning in the connector log file:
[Tue Jun 18 15:19:12 2002] [alert] httpd: Could not determine the server's fully qualified domain name, using 1.2.3.4 for ServerName". However the following is fatal and the redirector will not load."Unable to determine host name"
conn_config represents the redirector configuration file.
The redirector configuration file can be any name and location you choose, but it must be identified by EASConfigFile. In this example, conn_config is the name of the redirector configuration file. You must supply the full path to this file. See “Edit the redirector configuration file” for a description of configuration parameters.
WARNING! The Apache Web server must use the dynamic shared object (DSO) to load redirector modules and files. See your Apache Web server documentation for more information about building the Apache Web server with DSO support.
This is an Apache Web server directive:
<LocationMatch contextpath1 | contextpath2 | contextpath3> SetHandler eas-handler / </LocationMatch>
When an HTTP request arrives and the starting path matches contextpath1, contextpath2,
or contextpath3, eas-handler is
invoked. The contextpath corresponds to the
Web Application context path. If the path is set to “/*”,
all requests are sent to the redirector. See “Defining context paths” for more
information.
