Configuring Relay Servers to Work with SAP Mobile Platform

Create a Relay Server configuration file that defines the Relay Server farm, each Relay Server instance, and each SAP Mobile Platform instance. Then copy that configuration file to each Relay Server in the farm.

1. On one of the Relay Server nodes., use a text editor to open the Relay Server configuration file.

   These instructions use rs.config as the Relay Server configuration file.

   Note

   For Windows, the file must be named rs.config. For Apache, the file may have a different name in your Relay Server installation.

2. Edit rs.config to add sections like those shown in the sample below.

   Your rs.config file may already have many of the lines shown below. Create any sections that do not exist. In the sections indicated, replace the variables with appropriate values for your environment. Comments (lines beginning with "#") provide guidance for editing your rs.config file; you need not include them.

   Notes:

   • host: Enter the host name or IP address of the Relay Server.
   • http_port and https_port values are Relay Server defaults; replace them with the port numbers that are actually used, if different.
   • max_junction_idle_sec must be set to less than the connection timeout value configured for the SAP Mobile Platform Server.

   #--------------------
   # Relay server peers
   #--------------------
   [relay_server]
   enable          = yes
   host            = <host1_name_or_IPaddress>
   http_port       = 80
   https_port      = 443
   description     = <unique_descriptive_text>
   
   [relay_server]
   enable          = yes
   host            = <host2_name_or_IPaddress>
   http_port       = 80
   https_port      = 443
   description     = <unique_descriptive_text>
   
   
   #---------------
   # Backend farms
   #---------------
   [backend_farm]
   enable          = yes
   verbosity       = 4
   id              = <backend_RSfarm_ID>
   description     = <backend_RSfarm_description>
   
   #-----------------
   # Backend servers
   #-----------------
   [backend_server]
   enable   = yes
   farm     = <backend_RSfarm_ID>
   id       = <outbound_enabler1_ID>
   token    = MBS
   max_junction_idle_sec = <15>
   
   [backend_server]
   enable   = yes
   farm     = <backend_RSfarm_ID>
   id       = <outbound_enabler2_ID>
   token    = MBS
   max_junction_idle_sec = <15>
   

3. Deploy the updated rs.config file to all other Relay Server nodes.
   1. (Windows only) Place the new rs.config in the same directory as rs.dll.
   2. To update an existing Relay Server with the new configuration:
      • On Windows, enter these commands to stop and restart IIS:
        1. net stop w3svc
        2. net start w3svc
      • On Linux, run:

        rshost –u –f <Path>\rs.config