Configuring Apache for Relay Sever

Modify the Apache HTTP Server configuration and environment, as needed for Relay Server.

Prerequisites

Before you modify the Apache configuration, you must create a Relay Server configuration file and deploy it on the Relay Server (Apache) host.

Task

Edit the Apache httpd.conf and envvars files to:

Load Relay Server client and server modules
Define locations and handlers for the client and server modules
Increase the number of concurrent clients (if necessary)
Set environment variables required by Relay Server executables

Open httpd.conf in a text editor.
1. Add the following to load Relay Server modules:
```
LoadModule iarelayserver_client_module modules/mod_rs_ap_client.so
LoadModule iarelayserver_server_module modules/mod_rs_ap_server.so
```
1. Add the following to define a LocationMatch for the Relay Server client module:
```
<LocationMatch /cli/iarelayserver/* >
    SetHandler iarelayserver-client-handler
</LocationMatch>
```
2. Add the following to define a Location for the Relay Server server module:
```
<Location /srv/iarelayserver/* >
    SetHandler iarelayserver-server-handler
    RSConfigFile "/apache-install/modules/rs.config"
</Location>
```
  The server module Location must match the server URL suffix specified in the Relay Server configuration file.
  
  The RSConfigFile directive specifies the location of the Relay Server configuration file, which must reside in the same directory with the State Manager executable (rshost).
3. (Optional) Add the following to increase the maximum number of concurrent clients, if necessary.
```
ServerLimit 1000
MaxClient 1000
```
  By default, Relay Server on Apache is configured for 100 concurrent device users. If you need more than that, set the ServerLimit and MaxClient directives to an appropriate value.
Open envvars in a text editor.
1. Add the following to set and export environment variables required for Relay Server executables:
```
path="$path:/apache-install/modules"
export $path
LD_LIBRARY_PATH="$LD_LIBRARY_PATH:/apache-install/modules"
export $LD_LIBRARY_PATH
```
2. Determine if one of the following environment variables are set globally: TMP, TMPDIR, or TEMP.
  
  If none of those variables is set globally, or if you want to save the default Relay Server log file in another specific directory, set and export the TMP variable to point to the log file location.
  
  Note: The Apache user process must have write permission in the directory specified by $TMP.

Next

Restart the Apache HTTP Server after you make the configuration changes.