Installing the Relay Server Components to Apache on Linux

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

Copy relayserver_linux_x86.tar.gz from /modules/relayserver on the installation media to the host machine.
Extract the contents to the Apache install modules directory.
The file contains:
- mod_rs_ap_client.so
- mod_rs_ap_server.so
- rshost
- dblgen11.res
- libdbtasks11_r.so
- libdbicudt11.so
- libdbicu11_r.so
- libdblib11_r.so
- dbsupport
Create the relay server configuration file, rs.config.
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.
Set the PATH and LD_LIBRARY_PATH environment variables to include the Apache modules directory.
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
```
  The client and server modules are invoked using different URLs. The client module explicitly looks for the string iarelayserver in the URL path.
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>
```
  The RSConfigFile directive specifies the location of the relay server configuration file, rs.config. The rs.config file must reside in the same directory where the rshost executable is deployed.
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.

Next

Finish installing your Unwired Servers and Afaria servers into the farm.
If configuring an Afaria server farm with a relay server, see Sybase Control Center > Configure > Unwired Platform > Configuring Afaria > Configuring a New Afaria Installation on a Shared Host > Configuring a Relay Server for Afaria.
If configuring relay server in a production environent, see Sybase Unwired WorkSpace > Configure > Configuring Unwired Server > Configuring Unwired Server for a Production Environment > Configuring Unwired Server for a High Availability Environment > Employing a Relay Server > Configuring a Relay Server for Production.
If configuring relay server in a development environment, see Sybase Unwired WorkSpace > Configure > Configuring Unwired Server > Configuring Unwired Server for a Development Environment > Configuring a Relay Server for Development, which describes how to use the Sybase Relay Server Hosting Service. It is a Web-hosted relay service you can use to test Unwired Platform with a relay server.