To deploy the relay server files

1. Copy the above files into your Apache install modules directory.

2. Create the relay server configuration file rs.config. See Relay server configuration file.

3. Copy rs.config into the modules directory. The server module expects the rshost executable to be in the same directory where you copied the rs.config file.

4. Set the PATH and LD_LIBRARY_PATH environment variables to include the Apache modules directory.

5. Edit the Apache conf/httpd.conf file.

   1. Add the following lines to load the relay server client and server modules:

      LoadModule iarelayserver_client_module modules/mod_rs_ap_client.so

      LoadModule iarelayserver_server_module modules/mod_rs_ap_server.so

      Note

      The client and server modules are invoked using different URLs. The client module explicitly looks for the string iarelayserver in the URL path. That part of the URL need not change.

   2. Add the following line to create a <location> section for the client module:

      <LocationMatch /cli/iarelayserver/* > SetHandler iarelayserver-client-handler </LocationMatch>

   3. Add the following line to create a <location> section for the server module:

      <Location /srv/iarelayserver/* > SetHandler iarelayserver-server-handler RSConfigFile "/<apache-install>/modules/rs.config" </Location>

      Note

      You must specify an RSConfigFile directive which specifies the location of the relay servers config file, rs.config. The rs.config file must reside in the same directory where the rshost executable is deployed.