Installation guide

CHAPTER 4 Installing and Configuring a Web Server Redirector Plug-In

Installation Guide 51

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” on page 52 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” on page 51 for

more information.

Defining context paths

Context paths inform the Web server which requests are directed to the

redirector. At the end of the httpd.conf file, add the lines that define the context

paths. For example, if you have two Web applications named “ws_test” and

“examples”, the lines that direct requests of the form

http://host-name/examples/* and http://host-name/ws_test/* to

the redirector are:

SetHandler eas-handler

</LocationMatch>