Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.

SQL Anywhere 12.0.0 » Relay Server » Deploying the Relay Server


Deploying the Relay Server components to Microsoft IIS 6.0 on Windows Server 2003

The Relay Server for Windows consists of the following executables:

For information about which versions of IIS are supported, see [external link]

Setup scripts for Relay Server on IIS can be found in the %SQLANY12%\RelayServer\IIS directory.

 To deploy the Relay Server files
  1. Install the Relay Server components using the SQL Anywhere install. By default all files are installed to %SQLANY12% and are based on the bitness of the machine:

    • %SQLANY12%\Bin32 and %SQLANY12%\Bin64 are used for DLLs and executables for administration.

    • %SQLANY12%\RelayServer\IIS\Bin32 and %SQLANY12%\RelayServer\IIS\Bin64 are used for Relay Server specific files under the appropriate folder (for example, Admin, Client, Monitor or Server). The Server folder contains the rshost.exe and rs.config files.

  2. Create the following directories under the Default Web Site in the Microsoft IIS Manager for use by the Relay Server:

    • %SQLANY12%\RelayServer\IIS\BinXX\Server
    • %SQLANY12%\RelayServer\IIS\BinXX\Admin
    • %SQLANY12%\RelayServer\IIS\BinXX\Monitor
    • %SQLANY12%\RelayServer\IIS\BinXX\Client
  3. Create the Relay Server configuration file rs.config using the following guidelines.

    • The file should have four sections:

      • Options section
      • Relay server section
      • Backend farm section
      • Backend server section
    • Each section starts with a section tag, made by enclosing a keyword that identifies the section name in square brackets.

    • Add the appropriate properties to each section. A property is defined by specifying the property name on the left-hand side of an equal sign and its value on the right-hand side of the equal sign. For example, property name = value.

    • The configuration file should contain only 7-bit ASCII characters.

    See Relay Server configuration file.

  4. Create an application pool:

    1. Start Microsoft IIS Manager Console.

    2. Right-click Application Pools and create a new application pool, for example RS_POOL.

    3. Edit the properties for the application pool you created.

      1. Select the Recycling tab and turn off all the recycling options.

      2. Select the Performance tab and do the following:

        1. Turn off Shutdown Worker Processes After Being Idle.

        2. Set the number of worker processes to the total number of processing cores. You can further adjust this number depending on your usage and performance preferences. See the Microsoft IIS performance notes about Web garden size for more information.

  5. Set the Connection timeout property of the Default Web Site to a minimum of 60 seconds. By default this value should be 120 seconds, which is sufficient.

  6. Edit the properties of ias_relay_server and enable the Relay Server web extensions:

    1. Select the Directory tab and do the following:

      1. Set execute permissions to Scripts And Executables.

      2. Click Create under Application Settings. Select the application pool you created in step 3 as the associated application pool.

    2. Select the Directory Security tab and do the following:

      1. Click Edit in Authentication and Access Control.

      2. Enable anonymous access and fill in the user name and password for an account belonging to the Administrators group.

        Alternatively, you may leave the setting as the built-in user IUSR_%computername% and execute the following command to grant permission to access the Microsoft IIS metabase.

        C:\Windows\Microsoft.Net\Framework\<Version>\aspnet_regiis.exe -ga IUSR_%computername%
    3. Under Web Server Extensions in the Microsoft IIS manager, add rs_server.dll, rs_client.dll, and rs_monitor.dll as a new Web service extension. The extension name should be ISAPI and the DLLs need to have the extension status set to Allowed.

    4. Deploy the Relay Server configuration file by creating a Relay Server configuration file and copying it to the ias_relay_server\server directory.

  7. Copy the rs.config file to the ias_relay_server\server directory.

  8. Ensure optimum performance by reviewing the performance tips. See Performance tips.

  9. Start the Relay Server State Manager as a service using a command line similar to the following:

    dbsvc -as -s auto -t rshost -w RelayServer "%SQLANY12%\RelayServer\IIS\BinXX\Server\rshost.exe" -q -qc -f "%SQLANY12%\RelayServer\IIS\BinXX\Server\rs.config" -o "c:\temp\ias_relay_server.log"



    It is recommended that you start the State Manager as a service. However, it can also be started automatically by the Relay Server. See Relay Server State Manager.

  10. Update the Relay Server configuration for Microsoft IIS 6.0 on Windows:

    1. For each computer that belongs to the Relay Server farm you are updating, copy the updated configuration file to the %SQLANY12%\RelayServer\IIS\BinXX\Server directory under the Relay Server web site home directory. The configuration file must be called rs.config if auto start is used.

    2. From the %SQLANY12%\RelayServer\IIS\BinXX\Server directory, run the following command line to apply the configuration update:

      rshost -u -f rs.config
    3. Repeat the previous steps for each computer in the Relay Server farm that is being updated.


After configuring the Relay Server with IIS, it is recommended that you restart the IIS server or reboot the machine.

 See also

Performance tips