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 https://access.redhat.com.
Procedure 16.13. Extract and Setup the NSAPI Connector
Extract the JBoss Native Components package.The rest of this procedure assumes that directory
lib64/from the Native Components package is extracted to a directory called
/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.
Disable servlet mappings.Open the
IPLANET_CONFIG/default.web.xmlfile 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 (
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.
Configure the iPlanet Web Server to load the NSAPI connector module.Add the following lines to the end of the
IPLANET_CONFIG/magnus.conffile, modifying file paths to suit your configuration. These lines define the location of the
nsapi_redirector.somodule, as well as the
workers.propertiesfile, which lists the worker nodes and their properties.
Init fn="load-modules" funcs="jk_init,jk_service" shlib="IPLANET_CONFIG/connectors/lib/nsapi_redirector.so" shlib_flags="(global|now)" Init fn="jk_init" worker_file="IPLANET_CONFIG/connectors/workers.properties" 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
lib64/nsapi_redirector.so.Save and exit the file.
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.