Show TOC

Deploying Relay Server Components to Microsoft Windows ServerLocate this document in the navigation structure

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)
  • dblgen16.dll (in RelayServer2-IIS-<SMP_version>.zip\Bin64)
  • dbicu16.dll (in RelayServer2-IIS-<SMP_version>.zip\Bin64)
  • dbicudt16.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 a 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. Open a command prompt, running as administrator.
  4. Set a temporary environment variable SQLANY16 to the RSfiles location.
  5. Add RSfiles\bin64 to your SYSTEM path.
  6. Run RSfiles\relayserver\iis\iis7_plus_setup.bat to configure IIS.
  7. Run C:\Windows\system32\iisreset.
  8. 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.
  9. 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.
  10. 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/rs16.5/client/rs.dll/<<farmId>>

Next Steps

Perform Relay Server administration using the following URL: http://localhost/rs16.5/admin/rs.dll .