Configuring Redirector properties (for Redirectors that don't support server groups)

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

For a list of Redirectors that support server groups, see [external link] SQL Anywhere Supported Platforms and Engineering Support Status.

To configure Redirector properties

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

  2. Copy redirector.config to the web server.

    The file redirector.config is provided with the MobiLink server installation, in the MobiLink\redirector subdirectory of your SQL Anywhere installation.

    If the MobiLink server is not installed on the same computer as the web server, copy redirector.config to the computer that holds the web server.

  3. Configure the Redirector configuration file.

    To configure communications between the web server and MobiLink server, you must edit the file redirector.config on the computer that holds the web server.

    The following rules apply to redirector.config:

    • The maximum line length is 300 characters.
    • Comments start with the hash character (#).
    • You cannot include spaces or tabs in the directive definitions.

    You can set the following directives in this file:

    • LOG_LEVEL   Used to control the amount of output written to the log file. Values are 0, 1, and 2, with 1 being the default and 2 generating the most output. For the Apache Redirector, this setting has no effect; set the log level in the LogLevel section of the Apache configuration file, httpd.conf.

    • ML   ML is case sensitive. There are two ways that you can use the ML directive.

      For Redirectors that do not support HTTPS 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, you can 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 list of Redirectors that support HTTPS from the Redirector to the MobiLink server, see [external link] SQL Anywhere Supported Platforms and Engineering Support Status.

      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 each step of a single synchronization is directed to the same MobiLink server. The Redirector maintains an association between client and server for the duration of ML_CLIENT_TIMEOUT. This value is also used to ensure that the MobiLink server can detect duplicate synchronizations from the same remote database. The value of this parameter should be greater than the longest step in any user's synchronization.

      The default value is 600 seconds (ten minutes).

    • SLEEP   Used to set the interval in seconds at which the Redirector checks that the servers are functioning. The default is 1800 (30 minutes). For example, SLEEP=3600. SLEEP is case sensitive.

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

Example

Following is a sample redirector.config file. This file specifies the following:

  • The Redirector should check every 1800 seconds that the servers are functioning.
  • The three computers running MobiLink servers that are able to process requests. When you specify multiple servers, load balancing is automatically enabled.
SLEEP=1800
ML=myServ-pc:80
ML=209.123.123.1:8080
ML=myCompany.com:8081