NSAPI Redirector for Netscape/Sun web servers on Unix (deprecated)

Note

The Redirector has been deprecated. In its place, use the Relay Server. See Synchronizing through a web server with the relay server.

The NSAPI Redirector is provided for the Sun Java System web server, which was previously known as Sun One and the Netscape iPlanet Enterprise Edition web server.

For information about version support, see [external link] SQL Anywhere Supported Platforms and Engineering Support Status.

To use this Redirector on Windows, see NSAPI Redirector for Netscape/Sun web servers on Windows (deprecated).

To use the Redirector with Netscape/Sun web servers on other platforms, you can use the servlet Redirector. See Servlet Redirector (deprecated).

To configure the NSAPI Redirector

  1. Complete the steps in Configuring Redirector properties (for Redirectors that don't support server groups).

  2. If necessary, copy the file iaredirect.so to the computer that holds the web server. This file is installed with the MobiLink server, in the MobiLink/redirector/web-server subdirectory of your SQL Anywhere installation, where web-server is the name of your NSAPI web server.

  3. Update the NSAPI web server configuration files magnus.conf and obj.conf as follows.

    Sample file provided

    Sample copies of magnus.conf and obj.conf, preconfigured for the MobiLink server, are provided in the MobiLink/redirector/web-server subdirectory of your SQL Anywhere installation, where web-server is the name of your NSAPI web server. You can use these sample files to confirm where the following sections fit in to the file.

    Update the following sections of the files magnus.conf and obj.conf.

    • In magnus.conf, specify where iaredirect.so and redirector.config are located.

      At the end of the Init section, add the following text, where location is the actual location of the files. (iaredirect.so and redirector.config can be in different locations, although both must be on the same computer as the web server.)

      Solaris: 
      Init fn="load-modules" shlib="location/iaredirect.so"
      funcs="redirector,initialize_redirector"
      Init fn="initialize_redirector" configFile="location/redirector.config"
    • In obj.conf, specify the name of the Redirector to be used in URLs.

      At the beginning of the "default object" section, add the following text. This section should appear exactly as provided below, except that you can change mlredirect to whatever you want. All requests of the form http://host:port/mlredirect/ml/* are sent to one of the MobiLink servers running with the Redirector.

      <Object name=default>
      NameTrans fn="assign-name" from="/mlredirect/ml/*" name="redirectToML"
    • In obj.conf, specify the objects that are called by the Redirector. After the "default object" section, add the following section:
      <Object name="redirectToML">
      Service fn="redirector" serverType="ml"
      </Object>
Example

Following is an example of the section of magnus.conf that you need to customize.

Init fn="load-modules" shlib="location/iaredirect.so"
funcs="redirector,initialize_redirector"
Init fn=" initialize_redirector " configFile="location/redirector.config"

Following is an example of the sections of obj.conf that are important to the Redirector.

<Object name=default>
NameTrans fn="assign-name" from="/mlredirect/ml/*" name="redirectToML"
...
<Object name="redirectToML">
Service fn="redirector" serverType="ml"
</Object>

To test your configuration

  1. Call the Redirector using the following syntax:

    http://host:port/mlredirect/ml/
  2. Check the log file to see if the Redirector logged a request.

    Note: This test does not make a connection to the MobiLink server.