Lesson 2: Configuring the Relay Server

Modify the configuration of the Relay Server to forward HTTP requests to the back-end SQL Anywhere database.

Prerequisites

You must have the SYS_REPLICATION_ADMIN_ROLE system role.

For the purpose of this tutorial, the following assumptions have been made:

The name of the computer where the Relay Server is running is called machine_iis, and is a Windows 2008 Server R2 running IIS 7.5.
The setup instructions for the Relay Server have been followed exactly as outlined in the documentation:
- Relay Server
- Relay Server deployment
You have deployed the Relay Server components to Microsoft IIS 7.0 or 7.5 on Windows Server 2008/Windows Server 2008 R2. See Deploying the Relay Server components to Microsoft IIS 7.0, 7.5, or 8.0.

Context and remarks

Configuring the Relay Server relies only on modifying the rs.config file used by the Relay Server and then refreshing or restarting the rshost process.

Task

Modify the rs.config file used by the rshost process on machine_iis to add entries for the back-end SQL Anywhere database server acting as the message server:

[backend_farm]
id=srhttp_tutorial_farm
description=SQL Anywhere Web Services farm for tutorial
active_cookie=yes
active_header=no
enable=yes
verbosity=5

[backend_server]
id= srhttp_tutorial_server
description=SQL Anywhere Web Services server for tutorial
farm= srhttp_tutorial_farm
enable=yes
verbosity=5

From the %SQLANY16%\RelayServer\IIS\Bin64\Server directory, run the following command line to apply the configuration update:
rshost -u -f rs.config

Results

The configuration of the Relay Server is modified to forward HTTP requests to the back-end SQL Anywhere database.

Next

Proceed to Lesson 3: Configuring the consolidated database to act as the message server.

Discuss this page in DocCommentXchange.