Setting Relay Server General Properties

Set basic connection properties for the Relay Server.

Prerequisites
Launch the Relay Server configuration wizard.
Task
  1. Specify property values.
    Values vary for load balanced environments. If you do not configure load balancer values, Outbound Enablers bypass the load balancer and high availability is compromised if a direct Relay Server connection fails.
    • Host – for Relay Server farms that use a load balancer, the host name or IP address of the load balancer. Otherwise, the host name or IP address of a single Relay Server.
    • Http port – for Relay Server farms that use a load balancer, the port of the load balancer. Otherwise, the Relay Server HTTP port.
    • Https port – for Relay Server farms that use a load balancer, the port of the load balancer. Otherwise, the Relay Server HTTPS port.

      For IIS, the value identifies the relative path for rs_client.dll. If your IIS directory structure is different, modify this value accordingly.

      Note: If Relay Server uses HTTPS and certificates, clients other than those using replication-based synchronization may not be able to connect: messaging applications support only HTTP, and Hybrid Workflow Container applications for iOS support HTTPS, but not certificates.
    • URL suffix – the URL suffix used by the Outbound Enabler to connect to a Relay Server. The value you set depends on whether Relay Server is installed on IIS or Apache hosts. For IIS, use /ias_relay_server/server/rs_server.dll . For Apache use/srv/iarelayserver/.

      For IIS, the value identifies the relative path for rs_client.dll. If your IIS directory structure is different, modify this value accordingly.

      Note: For IIS, the value identifies the relative path for rs_client.dll. If your IIS directory structure is different, modify this value accordingly.
      Note: The value used in the client application connection for the URL suffix must match what the administrator configures in the URL suffix. Otherwise, the connection fails. Use the Diagnostic Tool command line utility to test these values. See Diagnostic Tool Command Line Utility (diagtool.exe) Reference in System Administration.
    • (Optional) Description – a user-definable description of the Relay Server.
  2. Add or remove HTTP credentials as required:
    1. Select Configure relay server HTTP credentials.
    2. To add new credentials, specify these property values and click +:
      • User name – user name for RSOE authentication on the Web server (Relay Server host).
      • Password – password for RSOE authentication on the Web server.
    3. To remove credentials from the list, select the corresponding user name, then click X.
  3. Click Next.
Parent topic: Viewing or Editing Relay Server Properties
Previous topic: Relaunching the Relay Server Configuration Wizard
Next topic: Defining Server Farms and Cluster Nodes