Installing the 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.

Prerequisites

Task

Copy relayserver_linux_x86.tar.gz from /modules/relayserver on the installation media to the host machine. This file is only available on the installation media for the deployment edition of Unwired Platform.
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
Copy the generated file from <UnwiredPlatform_InstallDir>\Servers\UnwiredServer\config\rs.config and save it to the Apache modules directory.

The relay server module expects rs.config to be in the same directory as rshost.
Set the PATH and LD_LIBRARY_PATH environment variables to include the Apache modules directory.
Edit the Apache conf/httpd.conf file:
See System Administration > Environment Setup > Relay Server Setup > Installing the Relay Server Components to Apache on Linux > Editing the Apache conf/httpd.conf File.
Determine if the following environment variables are set globally when Apache spawns a process: $TMP, $TMPDIR or $TEMP.

Make sure the Apache user process has write permissions to the /tmp directory location.
- If the environmental variables are set globally, you are finished.
- If these variables are not set globally, or you want the default relay server log file to go in a specific temporary directory, edit the /<apache-dir>/bin/envvars file to set and then export TMP.
```
set TMP="/tmp"
export TMP
```
  This command sets the environment variable in the shell that Apache creates before it spawns its processes.

Editing the Apache conf/httpd.conf File
Configure your relay servers to run in the Sybase Unwired Platform environment, by editing the Apache conf/httpd.conf file.
Setting the Kernel Parameters
You need to modify the Linux kernel if the Relay Server controls more than the default number of 256 concurrent users. You must increase the ServerLimit and MaxClient values in the Apache conf/httpd.conf file before you set the kernel parameters. You can also modify other kernel values.

Parent topic: Relay Server Setup