Netscape iPlanet Web Server NSAPI Adaptor for WebObjects


Installing the adaptor

Note: Spacing is significant to configuration information; please read carefully. Items in brackets "<>" denote names or directory paths that you configure).

For additional information, check the documentation from Sun.

  1. In a text editor, open the magnus.conf file for your iPlanet Web Server 6.0 (e.g. /opt/iplanet/servers/https-/config/magnus.conf).
  2. At the end of the block of configuration items that are prefixed with Init, add the following two lines:

    Init fn="load-modules" funcs="WebObjects_init,WebObjectsNameTrans,WebObjectsRequest" shlib=<pathToNSAPIadaptor>
    Init fn="WebObjects_init" root=<pathToWebServer'sDocRoot> config=<woconfigurl>

    where:

    The URL entered will depend on how you wish to retrieve adaptor configuration:

    1. to read configuration from a static URL:
       
      file:///Local/Library/WebObjects/Configuration/WebObjects.xml
      http://www.company.com/private/woappconfig.xml
      
    2. to find applications running on known hosts:
       
      http://woserv1:1085,http://woserv2:1085,http://woserv2:1085 
      
    3. to discover hosts using multicast:
       
      webobjects://239.128.14.2:1085
      
    To set the re-read interval for either the host list or multicast mechanisms, add a separate configuration option (on the same init line) named "confinterval" and set it's value to the desired re-read interval in seconds.
  3. In a text editor, open the obj.conf file for your iPlanet Web Server 6.0 (e.g. /opt/iplanet/servers/https-/config/obj.conf).

  4. Add the following line as the very first line after the line containing <Object name=default>:

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

  5. Add the following three lines at the very end of the file:

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

Notes about using the iPlanet socket routines

WebObjects 5.0 now uses non-blocking sockets nbsocket.c even for NSAPI adaptor. These functions provide a thread safe, platform independent socket api. This is fine for most installations. It used to be iPlanet's socket cover functions (the nssocket.c transport).