9 Oracle HTTP Server

This chapter describes issues associated with Oracle HTTP Server. It includes the following topics:

Section 9.1, "Using Oracle Containers for J2EE Plug-in with iPlanet Web Server"

9.1 Using Oracle Containers for J2EE Plug-in with iPlanet Web Server

This section describes how to install and configure the Oracle Containers for J2EE Plug-in to work with an iPlanet Web server. It includes the following tasks:

Install a Standalone Oracle HTTP Server Instance
Configure Oracle Process Manager and Notification Server to Work with Oracle Containers for J2EE Plug-in
Install Oracle Containers for J2EE Plug-in for iPlanet Web Server
Configure Oracle Containers for J2EE Plug-in
Create the opii.conf File

9.1.1 Install a Standalone Oracle HTTP Server Instance

If the Oracle HTTP Server component is not installed as part of an Oracle Containers for J2EE cluster, then you will need to install it as standalone instance. Follow the instructions in Administering a Standalone Deployment Based on Apache 2.0 10g (10.1.3.1.0).

9.1.2 Configure Oracle Process Manager and Notification Server to Work with Oracle Containers for J2EE Plug-in

The following procedure describes how to configure Oracle Process Manager and Notification Server (OPMN) to work with Oracle Containers for J2EE Plug-in:

Stop Oracle HTTP Server using the following command:

$ORACLE_HOME/opmn/bin/opmnctl stopproc process-type=HTTP_Server

Make a backup copy of the opmn.xml file.

Edit the opmn.xml to include the cluster topology and disable the Oracle HTTP Server process, as shown in bold in the following:

<?xml version="1.0" encoding="UTF-8"?>
<opmn xmlns="http://www.oracle.com/ias-instance">  <log path="$ORACLE_HOME/opmn/logs/opmn.log" comp="internal;ons;pm"
    rotation-size="1500000"/>
  <debug path="$ORACLE_HOME/opmn/logs/opmn.dbg" comp=""
    rotation-size="1500000"/>
  <notification-server interface="ipv4">
 <port local="6101" 
          remote="6201"
          request="6004"/>
    <ssl enabled="true" wallet-file="$ORACLE_HOME/opmn/conf/ssl.wlt/default"/>
<!-example using a static list>
    <topology>
       <discover list="node1:6200,node2:6200"/> 
    </topology>  
</notification-server>
  <process-manager>
    <process-modules>
      <module path="$ORACLE_HOME/opmn/lib/libopmnohs">
        <module-id id="OHS"/>
        <module-id id="GENERIC_APACHE"/>
        <module-id id="OHS2"/>
      </module>
    </process-modules>
    <ias-instance id="IAS-1"
    name="IAS-1">
      <environment> 
        <variable id="TMP" value="/tmp"/> 
      </environment> 
      <module-data>
        <category id="start-parameters">
          <data id="routing-id" value="g_rt_id"/>
        </category>
      </module-data>
<!-disable http server process>
      <ias-component id="HTTP_Server" status="disabled">
        <process-type id="HTTP_Server" module-id="OHS2">
          <module-data>
            <category id="start-parameters">
              <data id="start-mode" value="ssl-enabled"/>
            </category>
          </module-data>
          <process-set id="HTTP_Server" numprocs="1"/>
        </process-type>
      </ias-component>
    </ias-instance>
  </process-manager>
</opmn>

Restart OPMN using the following commands:

$ORACLE_HOME/opmn/bin/opmnctl stopall
$ORACLE_HOME/opmn/bin/opmnctl startall

Check the status using the following command:
```
$ORACLE_HOME/opmn/bin/opmnctl status
```
The following message should be returned:
```
No processes running...
```

9.1.3 Install Oracle Containers for J2EE Plug-in for iPlanet Web Server

To install the Oracle Containers for J2EE Plug-in, copy the shared library from the OracleAS Companion CD as described in the following table:

Table 9-1 OC4J Plug-in Shared Libraries

Platform	File Name	Location and Description	Instructions
UNIX	`opii.so`	`opii.so` is the OC4J plug-in for iPlanet Web listener. It is located in the `/plugins/solaris/sunone` directory	To install the plug-in into the listener, place `opii.so` in a directory to which the listener has read and execute privileges.
Windows	`opii.dll`	`opii.dll` is the OC4J plug-in file for the iPlanet Web listener. It is located in the `/plugins/win32/iis` directory.	To install the plug-in into the listener, copy `opii.dll` to a directory the listener can access.

9.1.4 Configure Oracle Containers for J2EE Plug-in

Configure the Oracle Containers for J2EE Plug-in using the instructions in Appendix C, "Configuring OC4J Plug-in on Sun ONE" of Oracle HTTP Server Administrator's Guide.

9.1.5 Create the opii.conf File

The opii.conf file controls the directives for Oracle Containers for J2EE Plug-in, and supports all the directives supported by the mod_oc4j module. The basic file should look as follows:

Oc4jOracleHome path_to_ORACLE_HOME_OPMN_installation
#this is the default oc4j routing id
Oc4jRoutingID g_rt_id
Oc4jRoutingMode Dynamic

For example, you might have the following for your installation:

Oc4jOracleHome /opt/oracle/product/10.1.3/OracleAS_2
#this is the default oc4j routing id
Oc4jRoutingID g_rt_id
Oc4jRoutingMode Dynamic

To use static routing for group names, the file should look similar to the following:

Oc4jOracleHome /opt/oracle/product/10.1.3/OracleAS_2
Oc4jRoutingMode Static
Oc4jRoutingID g_rt_id
Oc4jMount /em/* mygroup