Edit the httpd.conf configuration file

Edit the httpd.conf configuration file

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.

Sample httpd.conf file

The following line illustrates a sample httpd.conf file for Apache 1.3. For Apache 2.0 replace libjeas_mod.so with libjeas2_mod.so.

User wqa Group Sybase LoadModule easredirector_module libexec/libjeas_mod.so EASConfigFile APACHE_HOME/conf/conn_config ServerName www.myhost.com <LocationMatch /examples/*|/estore/* > SetHandler eas-handler </LocationMatch>

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.