iAnywhere.com - NSAPI Redirector for Netscape/Sun web servers

Synchronizing Through a Web Server With the Redirector

NSAPI Redirector for Netscape/Sun web servers

The NSAPI Redirector is provided for the Sun One web server, which was previously the Netscape iPlanet Enterprise Edition web server. Following are setup instructions for Sun One, service pack 1.

This Redirector works only on Windows. To use the Redirector with Netscape/Sun web servers on UNIX, you can use the servlet Redirector. See Servlet Redirector.

To configure the NSAPI Redirector for Sun One

Complete the steps in Configuring Redirector properties (all versions).
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.

Update the Sun One 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.

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

In magnus.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"
```
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 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"
```
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>
```

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.

If you are using any network protocol other than HTTPS, your configuration is complete.
If you are using HTTPS synchronization, configure your server as follows:
- Start the Sun One web server Administration Server.
  
  Choose Start > Programs > iPlanet Web Server > Start iWS Administration Server.
- Log in 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.
  
  For more information about using HTTPS, see MobiLink Transport-Layer Security.

Example

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

Init fn="load-modules" shlib="D:/iaredirect.dll"
funcs="redirector,initialize_redirector"
Init fn=" initialize_redirector " configFile="D:/redirector.config"

Following is an example of the sections of obj.conf that you need to customize.

<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

Call the Redirector using the following syntax:
```
http://host:port/mlredirect/ml/
```
Check the log file to see if the Redirector logged a request.

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