Oracle® Process Manager and Notification Server Administrator's Guide
10g Release 2 (10.1.2) B13996-02 |
|
Previous |
Next |
This chapter describes Oracle Application Server Web Cache (OracleAS Web Cache) configuration in the OPMN opmn.xml
file.
It features the following topics:
The following lines load and identify the OracleAS Web Cache process module. Management of OracleAS Web Cache processes by the process module are identified by the module
id
.
<module path="$ORACLE_HOME/opmn/lib/libopmnwc.so"> <module-id id="WebCache" /> <module-id id="WebCacheAdmin" /> </module>
The following lines represent the minimum configuration for OracleAS Web Cache. Default values are assigned to all other configuration elements and attributes for OracleAS Web Cache.
<ias-component id="WebCache"> <environment> <variable id="LD_LIBRARY_PATH" value="$ORACLE_HOME/lib:$ORACLE_HOME/opmn/lib" append="true"/> </environment> <process-type id="WebCache" module-id="WebCache"> <process-set id="WebCache" numprocs="1"/> </process-type> <process-type id="WebCacheAdmin" module-id="WebCache-admin"> <process-set id="WebCacheAdmin" restart-on-death="false" numprocs="1"/> </process-type> </ias-component>
The following example represents the complete configuration for OracleAS Web Cache. It contains all possible configuration elements and attributes that can be used with OracleAS Web Cache.
<ias-component id="WebCache"> <environment> <variable id="LD_LIBRARY_PATH" value="$ORACLE_HOME/lib:$ORACLE_HOME/opmn/lib" append="true"/> </environment> <process-type id="WebCache" module-id="WebCache"> <process-set id="WebCache" restart-on-death="true" numprocs="1"/> <module-data> <category id=start-parameters> <data id ="command-line" value="Option1 Option2"/> </category> </module-data> </process-set> </process-type> <process-type id="WebCacheAdmin" module-id="WebCache"-admin"> <process-set id="WebCacheAdmin" restart-on-death="false" numprocs="1"/> <module-data> <category id=start-parameters> <data id ="command-line" value="Option1 Option2"/> </category> </module-data> </process-set> </process-type> </ias-component>
This section describes the attributes that are specific for OracleAS Web Cache.
The OracleAS Web Cache attributes are described with the following format:
Title: This is the attribute name and value being defined. For example, id="WebCache".
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, WebCache
.
Path: This field defines in which elements the attribute can appear. For example, ias-component.
WebCache
ias-component
ias-component/process-type
ias-component/process-type/process-set
This id
is required and cannot be changed. The id
must match the targets.xml
entry or Application Server Control Console will not work.
ias-component/process-type
ias-component/process-type/process-set
The id
name is required and cannot be changed. The id
must match the targets.xml
entry or elements and attributes will not work.
environment
ias-component
The environment segment must add $ORACLE_HOME
/lib
and $ORACLE_HOME
/opmn/lib
to the LD_LIBRARY_PATH
.
WebCache
, WebCache-admin
ias-component/process-type
The module id
defines whether the child process-set
element defines a WebCache
server process or a WebCache
administrative process. At least one WebCache
server process must be defined in the WebCache
component.
restart-on-death
true
or false
ias-component/process-type/process-set
The restart-on-death
attribute defines whether the process will be restarted if it exits unexpectedly. By default after Oracle Application Server installation, this attribute is set to true
for the OracleAS Web Cache server, and false
for the OracleAS Web Cache administrative process.
numprocs="1"
ias-component/process-type/process-set
This attribute gives the number of OracleAS Web Cache processes started for the process-set
. The value must be set to 1.
id=start-parameters
ias-component/process-type/process-set/module-data/category
The start-parameters
category contains the parameters that are relevant for the startup of OracleAS Web Cache or OracleAS Web Cache Administrator.
id ="command-line"
ias-component/process-type/process-set
The options specified for the value of command-line will be added to the command-line for OracleAS Web Cache or OracleAS Web Cache Administrator.