Using SAP Hosted Relay Service for Testing

The SAP Hosted Relay Service is an alternative to local Relay Server installation, for temporary use with development and test systems only. It is particularly suitable for a personal SAP Mobile Platform system.

Prerequisites
  • All SAP Mobile Servers and data tier servers must be installed and running.

  • The SAP Mobile Server cluster and its nodes must be registered in SAP Control Center.

Note: If the cluster or server name does not appear in the navigation pane, on the SCC console, you must register them with SAP Control Center.
Task

Subscribe online to the SAP Hosted Relay Service, and configure your SAP Mobile Platform system with the information you provide during subscription.

  1. Register SAP Mobile Server with the relay service.
    1. Register or log in to the SAP Hosted Relay Service at https://relayserver03.sybase.com/ias_relay_server/account/index.php.
      Complete any mandatory fields, then click Submit.
    2. From the navigation bar on the left, click Manage Account.
    3. Click Add New SAP Mobile Platform Farm.
      Create one or more farms as required by your development or test environment.
      • Select at least one farm type.
      • Select DCN farm only if you are registering a scale-out node.
      • Select MBS farm for Hybrid Web Container applications.
      • Enter the farm name, which serves as the farm ID in SAP Control Center. The suffix RBS or MBS is appended to the end of the farm name, depending on the farm type you select.
      • Enter the server name, which is used as the server node ID in SAP Control Center. The server name can contain only alphanumeric characters.
    4. Click Create Farm.
    5. Click Configuration Instructions from the confirmation message.
      Keep this page open, or make a copy of these details so you have them available for further configuration tasks in SAP Control Center and on the client devices.
  2. Use SAP Control Center to register the hosted relay service as a Relay Server.
    1. Click the SAP Mobile Platform cluster, and open the Relay Servers tab, then click New.
    2. Enter general configuration information from the configuration instructions, then click Next.
      Host relayserver.sybase.com
      HTTP port 80
      HTTPS port 443
    3. Enter the server farm (SAP Mobile Server cluster) information.
      Farm ID Copy the farm name from the configuration instructions
      Type Messaging or Replication
    4. Click +, then click the farm ID field.
    5. Enter the node ID.
      Use the server name you registered with the hosted relay service.
    6. Enter the token.
      Copy the token string from the configuration instructions and paste it in the field.
    7. Click + to add the server node to the list, then Finish.
  3. Create outbound enablers (RSOEs) to connect with the hosted relay service.
    1. In the left pane, under Servers > <Mobile Server name>, select Server Configuration.
    2. Select the Outbound Enabler tab.
    3. Click + New to create the RSOEs.
    4. Select the RSOE details, then click Finish.
  4. Start all RSOEs.
    1. Select some or all RSOEs, then click Start.

      The Status column should show Running.

    2. Select one or more RSOEs, then click Retrieve Log.
      Review log messages to ensure each RSOE is running correctly.

Record the connection property values shown on the Configuration Instructions page to share with developers and device users.

Developers must use those values to configure an SAP Mobile Server connection profile, and to set values in the Connection screen of a mobile application.