Administrator

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.

Context

The Relay Server configuration file provides the information that each Relay Server instance needs to communicate with each SAP Mobile Platform node. There must be a Relay Server outbound enabler on each SAP Mobile Platform node to receive the communications.

Procedure

  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.

  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