Configuring Redirector properties (for Redirectors that support server groups)

This section describes generic web server configuration steps to configure Redirector properties. It applies to Redirectors that support server groups.

For a list of Redirectors that support server groups, see [external link] http://www.sybase.com/detail?id=1061837.

For information about server groups, see MobiLink server groups.

To configure Redirector properties
  1. Complete the steps in Configuring MobiLink clients and servers for the Redirector.

  2. Configure a Redirector configuration file. A template file named redirector_server_group.config is located in install-dir\MobiLink\redirector. The easiest way to configure a Redirector configuration file is to modify redirector_server_group.config.

    The following rules apply to the Redirector configuration file:

    • The maximum line length is 2000 characters.

    • Comments start with the hash character (#).

    • For the ISAPI Redirector, the configuration file must be named redirector.config and must be in the same directory as iaredirect.dll.

    You can set the following directives in this file:

    • Server groups   To create server groups, you create sections in redirector_server_group.config that start with a server group name in square brackets, and then define the server group.

      See MobiLink server groups.

    • LOG_LEVEL   Used to control the amount of output written to the log file. Values are 0 to 7, with higher numbers generating more output. By default, the log file is called redirector.log and is located in the same place as the Redirector configuration file. For NSAPI Redirectors, you can change the name and location in magnus.conf using the logFile directive.

    • ML   There are two ways that you can use the ML directive:

      • For Redirectors that do not support HTTPS from the Redirector to the MobiLink server or when you are not using HTTPS, you can use the ML directive to specify the list the computers running the MobiLink server, in the form ML=host:port. To specify multiple computers, you repeat this syntax on separate lines. For example:

        ML=209.123.123.1:8080
        ML=myCompany.com:8081
      • If your Redirector supports HTTPS from the Redirector to the MobiLink server and you are using HTTPS, you should specify MobiLink client network protocol options in a semicolon-separated list, as follows:

        ML="https=true;network-client-options;..."

        For example,

        ML="https=true;host=My-pc;port=82;trusted_certificates=rsaroot.crt"

        For a list of network client options, see MobiLink client network protocol options.

        For a description of HTTPS support in the Redirector, see Full HTTPS.

        For a list of Redirectors that support HTTPS from the Redirector to the MobiLink server, see [external link] http://www.sybase.com/detail?id=1061837.

      Your MobiLink server must be started with the same protocol and port number as it is given in your ML directive. If there is a difference, you must stop the MobiLink server and restart it with the correct information.

    • ML_CLIENT_TIMEOUT   Used to ensure that the MobiLink server can detect duplicate synchronizations from the same remote database. The timeout should be set to the maximum timeout of any client using the same server group. If you set this property to 0, resynchronization to a different server is allowed immediately. The default value is 240 seconds.

    • SLEEP   Used to set the interval in seconds at which the Redirector checks that the servers are functioning. The Redirector checks one server, waits for the amount of time set in this option, checks the next server, and so on in a cycle. For example, SLEEP=10. SLEEP is case sensitive. The default is 20 seconds.

  3. Copy the Redirector configuration file to the web server.

    If the MobiLink server is not installed on the same computer as the web server, copy the Redirector configuration file to the computer that holds the web server (or to a drive that computer has access to).

    For ISAPI web servers, copy the Redirector configuration file to the directory Inetpub\scripts and rename it redirector.config.

    For other web servers, you can copy the Redirector configuration file to any directory.

  4. Complete web server-specific configuration in one of the following sections:

Example

The following is a sample Redirector configuration file. This file specifies the following:

  • The Redirector should sleep for 10 seconds after checking that a server is functioning.

  • The three computers running MobiLink servers that are able to process requests.

SLEEP=10
ML=myServ-pc:80
ML=209.123.123.1:8080
ML=myCompany.com:8081