Menu Close
Settings Close

Language and Page Formatting Options

16.9.2. Configure the NSAPI Connector on Oracle Solaris


The NSAPI connector is a module that runs within Oracle iPlanet Web Server.


  • Your server is running Oracle Solaris 10 or greater, on either a 32-bit or 64-bit architecture.
  • Oracle iPlanet Web Server 7.0.15 or later for Intel architectures, or or 7.0.14 or later for SPARC architectures, is installed and configured, aside from the NSAPI connector.
  • JBoss EAP 6 is installed and configured on each server which will serve as a worker node. Refer to Section 16.3.5, “Configure JBoss EAP 6 to Accept Requests From an External HTTPD”.
  • The JBoss Native Components ZIP package is downloaded from the Customer Service Portal at

Procedure 16.13. Extract and Setup the NSAPI Connector

  1. Extract the JBoss Native Components package.

    The rest of this procedure assumes that directory lib/ or lib64/ from the Native Components package is extracted to a directory called connectors/ in /opt/oracle/webserver7/config/. For the rest of this procedure, this directory will be referred to as IPLANET_CONFIG. If your Oracle iPlanet configuration directory is different, or you are running Oracle iPlanet Web Server 6, modify the procedure accordingly.
  2. Disable servlet mappings.

    Open the IPLANET_CONFIG/default.web.xml file and locate the section with the heading Built In Server Mappings. Disable the mappings to the following three servlets, by wrapping them in XML comment characters (<!-- and -->).
    • default
    • invoker
    • jsp
    The following example configuration shows the disabled mappings.
    <!-- ============== Built In Servlet Mappings =============== -->
    <!-- The servlet mappings for the built in servlets defined above. -->
    <!-- The mapping for the default servlet -->
    <!-- The mapping for the invoker servlet -->
    <!-- The mapping for the JSP servlet -->
    Save and exit the file.
  3. Configure the iPlanet Web Server to load the NSAPI connector module.

    Add the following lines to the end of the IPLANET_CONFIG/magnus.conf file, modifying file paths to suit your configuration. These lines define the location of the module, as well as the file, which lists the worker nodes and their properties.
    Init fn="load-modules" funcs="jk_init,jk_service" shlib="IPLANET_CONFIG/connectors/lib/" shlib_flags="(global|now)"
    Init fn="jk_init" worker_file="IPLANET_CONFIG/connectors/" log_level="debug" log_file="IPLANET_CONFIG/config/connectors/nsapi.log" shm_file="IPLANET_CONFIG/conf/connectors/jk_shm"
    The configuration above is for a 32-bit architecture. If you use 64-bit Solaris, change the string lib/ to lib64/
    Save and exit the file.
  4. Configure the NSAPI connector.

    You can configure the NSAPI connector for a basic configuration, with no load balancing, or a load-balancing configuration. Choose one of the following options, after which your configuration will be complete.