Administrator

Deploying Relay Server Components to Microsoft Windows Server

Configure and deploy Relay Server files to each computer in the Relay Server farm.

Prerequisites

Choose a deployment platform:

  • Windows Server 2008 (IIS 7.0 without WebSocket support for Agentry traffic)

  • Windows Server 2008 R2 (IIS 7.5 without WebSocket support for Agentry traffic)

  • Windows Server 2012 (IIS 8.0 with WebSocket support for Agentry traffic)

  • Windows Server 2012 R2 (IIS 8.5 with WebSocket support for Agentry traffic)

The Relay Server components are available in the SAP Mobile Platform Server installation. By default, the Relay Server files are located in <SMP_HOME>\Server\extras\relayserver in a RelayServer2-IIS-<SMP_version>.zip file. Within that .zip file:

  • \Bin64 contains DLLs.

  • relayserver\IIS\bin64 contains rs.dll and the rs.config.sample configuration file.

Context

With the .zip, the \relayserver\IIS\iis7_plus_setup.bat quick setup script performs the following tasks:

  1. Installs the supported version of IIS that is available and turns on the required features

  2. Configures the installed IIS for the Relay Server

  3. Creates a demo application

  4. Generates a quick reference guide

Web Server administrators can customize the script as necessary.

The Relay Server for Windows consists of the following executables:

  • rs.dll (in RelayServer2-IIS-<SMP_version>.zip\relayserver\iis\bin64)
  • dblgen17.dll (in RelayServer2-IIS-<SMP_version>.zip\Bin64)
  • dbicu17.dll (in RelayServer2-IIS-<SMP_version>.zip\Bin64)
  • dbicudt17.dll (in RelayServer2-IIS-<SMP_version>.zip\Bin64)

Procedure

  1. From any SAP Mobile Platform Server installation, copy the <SMP_HOME>\Server\extras\relayserver\RelayServer2-IIS-<SMP_version>.zip to a computer where IIS has been set up to support Relay Server in your farm.
  2. Extract the contents of the Server\extras\relayserver\RelayServer2-IIS-<SMP_version>.zip file to a folder on that computer. Ensure the path does not contain any blank characters.

    Instructions that follow use RSfiles to refer to this folder.

  3. As an administrator, open a command prompt.
  4. Set a temporary environment variable SQLANY17 to the RSfiles location.
  5. Add RSfiles\bin64 to your SYSTEM path.
  6. To enable Afaria applications, edit RSfiles\relayserver\iis\iis7_plus_setup.bat, and uncomment this line:
    appcmd set config "%site_name%/%rs_vdir%/client" -section:system.webserver/serverruntime /uploadReadAheadSize:0 /commit:apphost
  7. To configure IIS, run RSfiles\relayserver\iis\iis7_plus_setup.bat.
  8. Run C:\Windows\system32\iisreset.
  9. Update the Relay Server configuration for Microsoft IIS on Windows:
    1. For each computer that belongs to the Relay Server farm you are updating:
      1. Copy the updated rs.config.sample configuration file (from RelayServer2-IIS-<SMP_version>.zip\relayserver\iis\bin64) to the \RelayServer\IIS\Bin64\Server directory under the Relay Server web site home directory.
      2. Rename rs.config.sample to rs.config.
      3. Edit rs.config to list your Relay Servers, backend farms, and backend servers.
  10. Run net start w3svc to start the IIS Relay Server, net stop w3svc to stop it.
    The Relay Server log file is created under RSfiles\\relayserver\iis\bin64\Log.
  11. Test if the Relay Server is running and the farm is available.
    In a Web browser, check the Relay Server status using the following URL: http://localhost/rs17/client/rs.dll/<<farmId>>

Next Steps

To perform Relay Server administration, edit rs.config and then restart w3svc.