MobiLink Synchronization User's Guide
  Synchronizing Through a Web Server

Configuring an NSAPI Redirector for Netscape web servers

The NSAPI Redirector is provided for the Netscape iPlanet Enterprise Edition web server. Following are setup instructions for the iPlanet web Server, Enterprise Edition 4.1, Service Pack 12.

To configure NSAPI Redirector for iPlanet

1. Complete the steps in Configuring Redirector properties (all versions).

2. If necessary, copy the file iaredirect.dll to the computer that holds the web server. This file is installed with the MobiLink synchronization server, in the MobiLink\redirector\nsapi subdirectory of your SQL Anywhere installation.

3. Update the iPlanet web server configuration file obj.conf as follows.

   Sample file provided  A complete sample copy of obj.conf, preconfigured for the MobiLink synchronization server, is provided in MobiLink\redirector\nsapi, and is called obj.conf.example. You can use this sample file to confirm where the following sections fit in to the file.

   Note: For some versions of iPlanet, you may need to specify init directives in the magnus.conf file, rather than the obj.conf file. For an example, see the example at the end of this section.

   Update the following sections of obj.conf.

   • Specify where iaredirect.dll 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.dll and redirector.config can be in different locations, although both must be on the same computer as the web server.)

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

   • 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 wish. All requests of the form http://host:port/mlredirect/ml/* will be sent to one of the MobiLink synchronization servers running with the Redirector.

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

   • Specify the objects that are called by the Redirector. After the "default object" section, add two new objects, as follows:

     <Object name="redirectToML">
     Service fn="redirector" serverType="ml"
     </Object>

4. Set the buffer size for the MobiLink upload streams.

   Add a directive to your web server's magnus.conf file to set the buffer size (in bytes) for the upload and download stream. For example:

   ChunkedRequestBufferSize=2000000

   This directive increases the buffer to 2 Mb. The value must be sufficient to accommodate the size of the uploaded data.

5. If you are using HTTPS synchronization, configure your server as follows:

   • Start the iPlanet web server Administration Server.

     Choose Start > Programs > iPlanet Web Server > Start iWS Administration Server.

   • Login to the Administration Server.

     Choose Start > Programs > iPlanet Web Server > Administer Web Server.

     When prompted, enter your user ID and password.

   • On the Servers tab, select your server from the list and click Manage.

   • On the Security tab, click Request a Certificate.

   • Generate a certificate request and have it signed by a certificate authority or using gencert, which requires a separate license.

     • To have the certificate request signed by a certificate authority, fill out the form.

     • To use the gencert utility, fill out the form, supplying your own e-mail address instead of the e-mail address of a certificate authority. Save the text of the certificate request to a file, then run the gencert utility. For more information, see Certificate generation utility.

   • On the Security tab, click Install Certificate. Fill out the form and specify the location of your signed certificate.

   • Click Manage Certificates to verify that your certificate has been installed correctly.

   • On the Preferences tab, click Add Listen Socket. Specify the required parameters. The default port for HTTPS is 443. Select On from the Security dropdown list to activate HTTPS synchronization.

Example 

Following are examples of the sections of obj.conf that configure the Netscape iPlanet web Server to route requests to MobiLink synchronization server.

Init fn="load-modules" shlib="D:/iaredirect.dll"
funcs="redirector,initialize_redirector"
Init fn=" initialize_redirector " configFile="D:/redirector.config"
# For iPlanet 6.0 service pack 1 the preceding Init lines should be
# placed in the magnus.conf file, rather than the obj.conf file.
...
<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.