Installing Relay Server Components to Apache on Linux

After installing Sybase Unwired Platform, extract the relay server component files to the Apache modules directory, edit the main configuration file for the Apache HTTP server, and set the environment variables.

1. Copy relayserver_linux_x86.tar.gz from /modules/relayserver on the installation media to the host machine. This file is available only on the installation media for the Enterprise Edition of Unwired Platform.
2. Extract the contents to the Apache modules directory.
   The file contains:

   • mod_rs_ap_client.so
   • mod_rs_ap_server.so
   • rs.config.sample
   • rshost
   • dblgen11.res
   • libdbtasks11_r.so
   • libdbicudt11.so
   • libdbicu11_r.so
   • libdblib11_r.so
   • dbsupport
3. Configure the relay server by generating a configuration file for it. Sybase recommends that you generate this file either using Sybase Control Center or the regRelayServer command line utility.

   By default, the file name is rs.config and you can output the file to place it in any convenient location.

4. Copy the generated file to the Apache modules directory.
   The relay server module expects rs.config to be in the same directory as rshost.
5. Set the PATH and LD_LIBRARY_PATH environment variables to include the Apache modules directory.
6. Edit the Apache conf/httpd.conf file.
   See Editing the Apache conf/httpd.conf File
7. When Apache spawns a process, determine if the following environment variables are set globally: $TMP, $TMPDIR or $TEMP.

   Make sure the Apache user process has write permissions to the /tmp directory.

   • If the environmental variables are set globally, you are finished.
   • If these variables are not set globally, or to save the default relay server log file in a specific temporary directory, edit the /<apache-dir>/bin/envvars file:

     set TMP="/tmp"
     export TMP

     This command sets the environment variable in the shell that Apache creates before it spawns its processes.