Adding a backend server

Once a relay server farm is running, it may be necessary to allow a new backend server to connect to the relay server farm. In order to do this, a new backend server section for the new backend server must be added to the relay server configuration file. The rshost utility must then be run on each machine to reload the contents of the configuration file. See rshost utility.

Caution

If this change is performed while some or all of the relay servers in the relay server farm are running, the new section must be added at the end of the relay server configuration file or the entire relay server farm has to be restarted together with the new configuration file.

A backend farm section in the configuration file can be added, removed or updated at anytime. Backend servers are accessible only when the corresponding backend farm is enabled. Run the following to apply the configuration update:

rshost -h -f rs.config

Note that the relay servers do not need to be stopped and restarted. This ensures that service is not interrupted when allowing a new backend server to connect to the relay server farm.

To add a backend server for IIS on Windows

  1. Copy the new configuration file to the ias_relay_server\server directory under the relay server web site home directory. Remember, the configuration file must be called rs.config if auto start is used.

  2. From the ias_relay_server\server directory, run the following to to apply the configuration update:

    rshost -u -f rs.config

To add a backend server for Apache on Linux

  1. Copy the new configuration file to the /<Apache-install>/modules directory under your Apache install directory. Remember, the configuration file must be called rs.config if auto start is used.

  2. From the /<Apache-install>/modules directory, run the following to apply the configuration update:

    rshost -u -f rs.config