Chapter 4: Installing and Configuring a Web Server Redirector Plug-In

Mapping Web server requests to EAServer listeners

You must configure the redirector configuration file by adding the Connector.WebApp directive which maps your requests to the EAServer listener to which they are redirected. The syntax is:

Connector.WebApp contextpath1 [, contextpath2, and so on] = \
http://host:port [, http://host:port, and so on]

For example, if “neptune” is the name of your Web server, and WEB_SERVER_HOME/conf/conn_config is the name and location of the redirector configuration file that you create, edit conn_config to set the Connector.WebApp directive:

Connector.WebApp /testapp = http://jaghost1:8080
Connector.WebApp /estore1, /estore2, /estore3 = http://neptune:8080
Connector.WebApp /* = http://foobar:8080, http://neptune:8080
Connector.WebApp examples=http://jaghost1:8080, http://jaghost1:3080, http://jaghost2:8080

In the first line, the “testapp” Web application maps to the EAServer HTTP protocol listener http://jaghost1:8080.

For example, if your Web server is accepting requests on the host machine web_server on port 8020 and the client sends the request http://web_server:8020/testapp/test.jsp, the redirector forwards the request to http://jaghost1:8080/testapp/test.jsp.
In the second, line the /estore1, /estore2, and /estore3 Web applications map to the EAServer HTTP protocol listener http://neptune:8080.

For example, if your Web server is accepting requests on the host machine web_server on port 8020 and the client sends the request http://web_server:8020/estore1/sign_in.jsp, the redirector forwards the request to http:/neptune:8080/estore1/sign_in.jsp.
In the third line, “/*” matches any request that is received by the connector, provided the request did not match any of the other specifically configured Web applications. However you still need to configure the Web server to tell it which context paths should be serviced by this connector. For this mapping, you would supply the following LocationMatch directive in the httpd.conf file:
```
<LocationMatch /* >
SetHandler eas-handler
</LocationMatch>
```
The last line of the example above provides load balancing. The “examples” Web application is available at jaghost1:8080, jaghost1:3080 and jaghost2:8080.

Single-line entries

You must make entries in the redirector configuration file on a single line. You can combine EAServer hosts in one entry or create multiple entries; for example:

Connector.WebApp /*=http://rainforest:8080,http://neptune:8080

Is the same as:

Connector.WebApp /*=http://rainforest:8080
Connector.WebApp /*=http://neptune:8080

In addition, the server hosts specified for the WebApp directive (in this case “rainforest” and “neptune”) must match the host names you define for your EAServer HTTP listeners. Use EAServer Manager to view and set host names for your EAServer HTTP listeners—see Chapter 3, “Creating and Configuring Servers,” in the EAServer System Administration Guide for more information.

View this book as PDF