Configuring and Testing Apache for Relay Server on RedHat Enterprise

Modify the Apache HTTP Server configuration and environment, as needed for Relay Server on RedHat Enterprise (Linux) host.

Prerequisites
Create a Relay Server configuration file and deploy it on the Relay Server (Apache) host.
Task
  1. Modify the httpd.conf file to configure Apache for Relay Server usage by adding these entries: 
    LoadModule iarelayserver_client_module modules/mod_rs_ap_client.so 
LoadModule iarelayserver_server_module modules/mod_rs_ap_server.so 
<LocationMatch /cli/iarelayserver/* > 
SetHandler iarelayserver-client-handler 
</LocationMatch> 
<Location /srv/iarelayserver/* > 
SetHandler iarelayserver-server-handler 
RSConfigFile /etc/httpd/modules/rs.config 
</Location> 
ServerName <your server name>
    The Relay Server is now ready to test.
  2. Start Apache and RelayServer from /etc/httpd/modules with these commands:
    • Apache – /sbin/service httpd start
    • Relay Server – ./rshost –o /usr/relay.log –f rs.config

    By default the Apache Server does not automatically start after a reboot. You must enable the service in the service configuration panel.

  3. Set the SQLANY16 environment variable:
    1. Select /etc/profile.d.
    2. Create a new file named sqlany16.sh.
    3. Add the export for the SQLANY16 path: export SQLANY16=/usr/local/relayserver
  4. Reboot the Apache server.
  5. Set up the State Manager process to run as a service on the Relay Server host:
    1. Create a new folder named bin64s under /usr/local/relayserver.
    2. Copy rshost from /usr/local/relayserver/bin64 to /usr/local/relayserver/bin64s.
    3. Open a console and select /usr/local/relayserver/bin64.
    4. As the current "apache_user" with appropriate permissions (be sure rshost and httpd processes run under the same user), execute this command:
      ./dbsvc -y -a apache_user -t rshost -w RelayServer -q -qc -f /etc/httpd/modules/rs.config -os 100k -ot /tmp/rs.log
  6. Enable the Apache Server as a service in the service configuration panel, and start the service.
    Note: Configuring the rshost as a service creates the service with the symbolic "K" link under /etc/rs.d/rs5.d (for example, K80SA_RelayServer). Verify that a symbolic "S" link is available for the relay server service, and if not, create it using one of these methods:
      1. Verify K80SA_RelayServer exists in /etc/rc.d/rc5.d.
      2. Verify a corresponding "S" link for the RelayServer exists.
      3. If not, execute the command: ln -s /etc/init.d/SA_RelayServer S80RelayServer
    • If no link at all exists for RelayServer, execute /sbin/chkconfig SA_Relayserver on, which should create the service similar to the dbsvc command. This method should find and use the native chkconfig tool to install the service, which creates the links.
Parent topic: Installing Relay Server on Apache RedHat Enterprise