Procedure 19.20. Extract and Setup the NSAPI Connector

1. Extract the JBoss Native Components package.

   The rest of this procedure assumes that the Native Components package is extracted to the EAP_HOME directory. For the rest of this procedure, the directory /opt/oracle/webserver7/config/ is referred to as IPLANET_CONFIG. If your Oracle iPlanet configuration directory is different, 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 -->
   <!--servlet-mapping>
    <servlet-name>default</servlet-name>
    <url-pattern>/</url-pattern>
   </servlet-mapping-->
   <!-- The mapping for the invoker servlet -->
   <!--servlet-mapping>
    <servlet-name>invoker</servlet-name>
    <url-pattern>/servlet/*</url-pattern>
   </servlet-mapping-->
   <!-- The mapping for the JSP servlet -->
   <!--servlet-mapping>
    <servlet-name>jsp</servlet-name>
    <url-pattern>*.jsp</url-pattern>
   </servlet-mapping-->

   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 nsapi_redirector.so module, as well as the workers.properties file, which lists the worker nodes and their properties.

   Init fn="load-modules" funcs="jk_init,jk_service" shlib="EAP_HOME/modules/system/layers/base/native/lib/nsapi_redirector.so" shlib_flags="(global|now)"
   
   Init fn="jk_init" worker_file="IPLANET_CONFIG/connectors/workers.properties" log_level="info" log_file="IPLANET_CONFIG/connectors/nsapi.log" shm_file="IPLANET_CONFIG/connectors/tmp/jk_shm"

   The configuration above is for a 32-bit architecture. If you use 64-bit Solaris, change the string lib/nsapi_redirector.so to lib64/nsapi_redirector.so.
   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.
   • Section 19.9.3, “Configure NSAPI as a Basic HTTP Connector”
   • Section 19.9.4, “Configure NSAPI as a Load-balancing Cluster”