Subscribing and Connecting to Sybase Hosted Relay Service

The Sybase 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 Unwired Platform system.

Prerequisites

  • All Unwired Servers and data tier servers must be installed and running.

  • The Unwired Server cluster and its nodes must be registered in Sybase 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 Sybase Control Center.
Task

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

  1. Register Unwired Server with the relay service.
    1. Register or log in to the Sybase 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 Sybase Unwired Platform Farm.
      Create one or more farms as required by your development or test environment.
      • Select at least one farm type.
      • Do not select DCN farm.
      • Select MBS farm for Hybrid Web Container applications.
      • Enter the farm name, which serves as the farm ID in Sybase Control Center. The suffix RBS or MBS is appended to the end of the farm name.
      • Enter the server name, which is used as the server node ID in Sybase Control Center. The server name must 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 Sybase Control Center and on the client devices.
  2. Use Sybase Control Center to register the hosted relay service as a Relay Server.
    1. Click the Unwired 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 (Unwired Server cluster) information.
      Farm ID Copy the farm name from 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 > <Unwired Server name>, select Server Configuration.
    2. Select the Outbound Enabler tab.
    3. Click + New to create the RSOEs.
    4. Select the details from the drop-down lists, 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 Unwired Server connection profile, and to set values in the Connection screen of a mobile application.