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.
-
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.
-
Add the following line to create a <location> section for the client module.
<LocationMatch /cli/iarelayserver/* >
SetHandler iarelayserver-client-handler
</LocationMatch>
-
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.
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.