8 Configuring Oracle Application Server Port Tunnel

This chapter describes Oracle Application Server Port Tunnel (OracleAS Port Tunnel) configuration in the OPMN opmn.xml file.

It features the following topics:

• Section 8.1, "OracleAS Port Tunnel Process Module Configuration"

• Section 8.2, "OracleAS Port Tunnel Minimum Configuration"

• Section 8.3, "OracleAS Port Tunnel Complete Configuration"

• Section 8.4, "OracleAS Port Tunnel Attribute Descriptions"

  
  

  See Also: Oracle HTTP Server Administrator's Guide

  
  

8.1 OracleAS Port Tunnel Process Module Configuration

The following lines load and identify the OracleAS Port Tunnel process module. Management of OracleAS Port Tunnel processes by the process module are identified by the module id.

<module path="$ORACLE_HOME/opmn/lib/libopmniaspt.so">
   <module-id id="IASPT" />
</module>

8.2 OracleAS Port Tunnel Minimum Configuration

The following lines represent the minimum configuration for OracleAS Port Tunnel. Default values are assigned to all other configuration elements and attributes for OracleAS Port Tunnel.

<ias-component id="IASPT">
   <process-type id="IASPT" module-id="IASPT">
      <process-set id="IASPT" numprocs="1"/>
   </process-type>
</ias-component>

8.3 OracleAS Port Tunnel Complete Configuration

The following example represents the complete configuration for OracleAS Port Tunnel. It contains all possible configuration elements and attributes that can be used with OracleAS Port Tunnel.

<module path="$ORACLE_HOME/opmn/lib/libopmniaspt.so">
   <module-id id="IASPT" />
</module>
<ias-component id="IASPT" status="enabled" id-matching="false">
   <process-type id="IASPT" module-id="IASPT">
      <port id="ajp" range="6701-6703"/>
   <process-set id="IASPT" restart-on-death="true" id="ajp"/>
   </process-type>
</ias-component>

8.4 OracleAS Port Tunnel Attribute Descriptions

This section describes the attributes that are specific for OracleAS Port Tunnel.

The OracleAS Port Tunnel attributes are described with the following format:

• Title: This is the attribute name and value being defined. For example, id="IASPT".

• Required: This field defines whether or not the attribute is required in the component definition.

• Default: This defines the default value assigned to the attribute. The default value appears in the installed version of the opmn.xml file or is assigned internally if the attribute is not present.

• Valid values: If applicable, this field defines the valid values for the attribute. For example, IASPT.

• Path: This field defines in which elements the attribute can appear. For example, ias-component.

id="IASPT"

Required: true
Default: none
Valid values: IASPT
Path: ias-component
Path: ias-component/process-type
Path: ias-component/process-set

The id name is required and cannot be changed. The id name must match the entry in the targets.xml file.

module-id="IASPT"

Required: true
Default: none
Path: ias-component/process-type

The module-id name defines the type of process and associates the configuration with a process module.

id="ajp"

Required: false
Default: none
Valid values: ajp
Path: ias-component/process-type/port

The id value should be used together with range in port property to specify the ajp ports to be used by the OracleAS Port Tunnel server. If the id is specified, the port number configured in the iaspt.conf file is overwritten.

range="6701-6703"

Required: false
Default: none
Valid values: Any single port or a range of ports
Path: ias-component/process-type/port

The range value should be used together with ajp in port property to specify the ajp ports to be used by OracleAS Port Tunnel servers.

numprocs="3"

Required: true
Default: none
Valid values: Any number
Path: ias-component/process-type/process-set

This attribute tells how many OracleAS Port Tunnel server processes to be started. The ajp range should be configured in the port property if the value is 1. If the value is greater than 1, ajp range has to be configured to specify enough ports for each OracleAS Port Tunnel server process. Typically, the value is 1 port for each process.