Subscribe online to the Sybase Relay Server Hosted Service (SHRS), and configure your environment with information provided during subscription, rather than installing a relay server on your network.
A SHRS is typically used by pilot, development, or test environments. All other environments should create a new relay server cluster in Sybase Control Center and use relay server binaries on their DMZ.
- Register Unwired Server with the relay service.
- If you have not already done so, create an account.
- Log in to
https://relayserver03.sybase.com/ias_relay_server/account/login1.php.
- From the navigation bar on the left, click Manage Account .
- Create one or more farms as required by your development or test environment by clicking Add New Sybase Unwired Platform Farm .
- Enter the following property values, then click Create Farm:
-
Farm Type – check at least one of the Replication-based Synchronization (RBS) Farm or Messaging-based Synchronization (MBS) Farm boxes, depending on the environment(s) you are testing. (DCN is not supported; do not check this box.) The suffix RBS or MBS is appended to the end of the Farm Name to uniquely identify each Farm within your environment.
- Farm Name – a farm name uniquely describes a single server or group of Unwired Servers for which the relay server establishes communications.
-
Server Name – enter the Server Name displayed for the Server Node ID for the Cluster Node. Display this value by displaying the cluster's Relay Servers tab then clicking Properties. The property is on the second page of the wizard.
A status message appears on this page telling you if the farm has successfully been created.
- Click Configuration Instructions to get the configuration instructions for device client connections and relay server configuration.
Keep a copy of the device client setup details and Unwired Server setup instructions to configure the relay sever in Sybase Control Center.
- Use Sybase Control Center to register this service and create RSOEs for it.
- Display the Relay Servers tab for the cluster you are configuring a relay server for.
- Click New to register the SHRS using the values exported in the previous step:
| SHRS exported property |
Used for |
|---|
| -f
|
The relay server Farm ID property (page 2 of Wizard). |
| -id |
The Server Node ID property (page 2 of Wizard). |
| -t |
The relay server node Token ID (page 2 of Wizard)
|
| host in the -cr option |
The relay server Host property (page 1 of Wizard) |
| HTTP in the -cr option |
The relay server HTTP port, which uses a default port 80 (page 2 of the Wizard). |
| HTTPS in the -cr option |
The relay server HTTP port, which uses a default port 443 (page 2 of the Wizard). |
| url_suffix in the -cr opotion |
The relay server URL Suffix property (page 1 of Wizard) |
- Configure RSOEs by clicking in the navigation pane , then clicking the RSOE tab in the administration pane.
- Click New to add one or more RSOEs using the values exported in the previous step.
- Start all RSOEs.
Select some or all RSOEs, then click Start. Check the Status column to verify if the status changes to Running.
- Select one or more RSOEs, then click Retrieve Log and review messages to ensure the RSOE is running correctly.
- Once the environment is functional, share these connection properties that are displayed on the Configuration Instructions page.
For example:
Set the Network Protocol to HTTP or HTTPS
Set the Server Name: to relayserver.sybase.com
Set the Port Number to 80 (HTTP) or 443 (HTTPS)
Set the Network Stream Parameters to "url_suffix=/ias_relay_server/client/rs_client.dll/abater.abaterRBS"
Developers need these values to configure cluster information in an Unwired Server connection profile, and to set values in the Connection screen of a device application. Values must match or the connection to the relay server enabled runtime fails.