Relay Server (rs.config) Configuration File

Defines the relay server farm, including relay servers, back-end farms, and back-end servers.

When you register RSOE and relay server configuration changes by running regRelayServer.bat, the rs.config file is generated and stored in:
  • For IIS: C:\Inetpub\wwwroot\IAS_relay_server\Server\rs.config
  • For Apache: <Apache_Home>/modules/rs.config
This configuration file contains only the details of the server on which it is run, even if there is more than one server registered in the cluster. Therefore, you must ensure that all servers in the cluster are added to the file. The configuration file is organized into the following sections with the specified syntax:
  • Relay server with auto-start option
    [options]
    start = no
    verbosity = 1
    When auto-start is enabled, the default log file is %temp%\ias_relay_server.log while the rshost is active. Upon server shutdown, the log file is renamed using the YYMMDDNN.olg file name format.
  • Relay server peers
    [relay_server]
    enable = [yes|no]
    host = <myHostName>
    http_port = <myHttpPortNumber>
    https port = <myHttpsPortNumber>
    description = <myRSFarmMachineNumber>
  • Backend farms
    [backend_farm]
    enable = [yes|no]
    id = <myBackendFarmID>
    client_security = [on|off]
    backend_security = [on|off]
    description = <myCompanyBackendFarm>
  • Backend servers
    [backend_server]
    enable = [yes|no]
    farm = <myFarmName>
    id = <myBackendServerID>
    mac = <myMACAddress>
    token = <myBackendServerToken>
    You can uncomment the "mac" property to prompt the relay server to perform MAC verification. If you enter a value, it must be the MAC address that RSOE sends to the relay server. The MAC address is located in the RSOE.log file.

To apply the changes you make to this file, run this command from the directory where the rs.config file is located:

rshost -f rs.config -q -qc -u

Related tasks
Configuring Relay Server in a Multinode Cluster
Configuring and Enabling Relay Server Logging