To configure the servlet Redirector for Apache Tomcat

1. Complete the steps in Configuring Redirector properties (for Redirectors that don't support server groups).

2. Install the servlet version of the Redirector in Tomcat.

3. Configure the Apache web server to run as a proxy.

To install the servlet Redirector in Tomcat

1. Install Tomcat as a standalone server.

2. Optionally, set the required Tomcat HTTP port.

   Tomcat binds to port 8080 by default. If there is a conflict, perhaps because another web server is using this port,

   • Open the file: %CATALINA_HOME%/conf/server.xml.
   • Search for 8080 (which is in a <Connector> tag).
   • Change it to a port that is not in use.

3. Install the servlet Redirector as a web application.

   • Copy iaredirect.war file to %CATALINA_HOME%/webapps.
   • Shut down and restart Tomcat.

     Tomcat expands the war file and creates the directory iaredirect for the Redirector web application.

   • Edit the file %CATALINA_HOME%/webapps/iaredirect/WEB-INF/web.xml. Search for redirector.config (in an <init-param> tag), and correct the path for the redirector.config file.

     Change the entry redirector.config to read drive:/path/redirector.config. Even on Windows operating systems, use a forward slash as a path separator, as in d:/redirector.config.

   • Shut down and restart Tomcat for the changes to take effect.

     Once the changes have taken effect, you no longer need the war file in the deployed location.

   • The Redirector can now be invoked through the following URL:

     http://tc-host:tc-port/iaredirect/ml/

     where tc-host is the machine and tc-port the port on which Tomcat is listening.

To configure the Apache web server as a proxy

1. Install the Apache web server.

2. Optionally, change the Apache web server port:

   • Edit the file %APACHE_HOME%/conf/httpd.conf and change the Port setting.

3. Configure Apache to run as a proxy:

   In %APACHE_HOME%/conf/httpd.conf, add the following directives:

   LoadModule proxy_module module-path/mod_proxy.so LoadModule proxy_connect_module module-path/mod_proxy_connect.so LoadModule proxy_http_module module-path/mod_proxy_http.so

   where module-path is the location of the module. For example, the path may be modules/mod_proxy.so (the default).

4. Configure Apache to forward Redirector URLs to Tomcat.

   In %APACHE_HOME%/conf/httpd.conf, add the following directive so that Apache forwards URLs of the form http://localhost/iaredirect/* to the Tomcat 5 Connector listening on port 8080:

   ProxyPass /iaredirect http://localhost:8080/iaredirect

   The port number must match the port number used for Tomcat. If Tomcat and Apache are not running on the same computer, provide the computer name where Tomcat is running instead of localhost.

To check your configuration

1. Call the Redirector using the following syntax:

   http://host:port/iaredirect/ml/

2. Check the log file to see if the Redirector logged a request.

   Note: This test does not make a connection to the MobiLink server.