Documentation Archive Developer
Search
Table of Contents Previous Section

Installing and Configuring NSAPI Adaptors

 If you have a Netscape server, use one of the NSAPI adaptors. Which NSAPI adaptor to use, and the procedure for configuring it, depends on the type of server you have. Adaptors are located in NextLibrary/WOAdaptors/NSAPI.

If you have server... use adaptor...
Netscape 2.0
 (FastTrack/Enterprise)
 2.0/WebObjects-NSAPI.[dll|so]
Netscape 2.0.1
 (FastTrack/Enterprise)
 2.0.1/WebObjects-NSAPI.[dll|so]
Netscape 3.0
 (FastTrack/Enterprise)
 3.0/WebObjects-NSAPI.[dll|so]

Note: There is no requirement for installing an adaptor anywhere other than its original location. If you wish, you can copy the adaptor to the server's executable or configuration directories, but ensure that the configuration specifications refer to its proper location. The following procedures assume the original installed locations.

To configure Netscape 2.0, 2.0.1, or 3.0NSAPI adaptors for all platforms, complete the following procedure:

  1. Locate the server configuration file in the directory cgi-bin/config/obj.conf where cgi-bin is the server's cgi-bin directory.

  2. Edit the configuration file to insert one an line similar to one of the following:

    In the obj.conf file insert the following:

    Init fn=load-modules shlib=c:/NeXT/NextLibrary/WOAdaptors/NSAPI/2.0/WebObjects-NSAPI.dll funcs="WONetscapeInterface,WONSInterfaceFindWebObjects"

    This example is specific to Windows NT and NSAPI 2.0; for Solaris and HPUX the name of the adaptor executable is WebObjects-NSAPI.so.

  3. Locate the following line in obj.conf:

    NameTrans from="/cgi-bin" fn="pfx2dir" dir="cgi_bin_dir" name="cgi"

    Just before this line, insert the following line:

    NameTrans from="/cgi-bin/WebObjects" fn="WONSInterfaceFindWebObjects" name="webobjects"

  4. At the end of obj.conf, add the following text, just as it appears here:

    <Object name="webobjects">
    Service fn="WONetscapeInterface"
    </Object>

  5. Restart your server.

Notes

 On Windows NT, you can restart your server from the Services control panel by stopping and then starting it (clicking the Stop button, then clicking the Start button). However, it is better to use the browser interface provided for administration to restart the server. If there are errors, you can check the error activity log to find out what they are.

When you test an API-based adaptor to verify that it's properly configured, you should eliminate the CGI adaptor as a factor. To do this, rename WebObjects (or WebObjects.exe) to something like "WebObjects_test" (or "WebObjects_test.exe") and test the API-based adaptor. If you wish later to restore the CGI adaptor, simply undo the changes you made previously.

Table of Contents Next Section