Fusion Middelware - OPMN.xml configuration file

About

OPMN.xml is the main configuration file for OPMN that is used to launch each system component (such as Oracle Business Intelligence).
It specifies environment variable (path, …)
PATH
LD_LIBRARY_PATH
ODBC - ODBC.ini
port number for OPMN
optional SSL configuration.
The opmn.xml file contains specific configuration for:
PM (Process Management)
and system component. The opmn.xml file shows you which system components OPMN is managing on your system.
The opmn.xml file is divided into three main sections:
log files,
notification-server,
and process-manager.
The opmn.xml is located in the following directory: ORACLE_INSTANCE/config/OPMN/opmn/opmn.xml
Articles Related

Sections

Log

The log files configuration by default fully enables the standard log but disables the debug log
Notification

The notification-server configuration includes the OPMN listener ports as well as secure connection definition.
Process manager

The process-manager configuration includes all information required for each managed component.
Property meaning

append=“false” means that the variable (for instance LD_LIBRARY_PATH) will be replaced by the whole value
append=“true” adds some basic confniguration (for instance for LD_LIBRARY_PATH /u01/app/oracle/product/fmw/Oracle_BI1/opmn/lib:/u01/app/oracle/product/fmw/Oracle_BI1/lib)
Example

<?xml version = '1.0' encoding = 'UTF-8'?>
<opmn xmlns="http://www.oracle.com/ias-instance">
	<log comp="internal;ons;pm" rotation-size="1500000"/>
	<debug comp="" rotation-size="1500000"/>
	<notification-server interface="any">
		<port local="6700" remote="6701"/>
		<ssl enabled="true" wallet-file="/u01/app/oracle/product/fmw/instances/instance1/config/OPMN/opmn/wallet"/>
	</notification-server>
	<process-manager>
		<process-modules>
			<module path="$ORACLE_HOME/opmn/lib/libopmnohs">
				<module-id id="OHS2"/>
			</module>
			<module path="$ORACLE_HOME/opmn/lib/libopmncustom">
				<module-id id="CUSTOM"/>
			</module>
			<module path="$ORACLE_HOME/opmn/lib/libopmnoid">
				<module-id id="OID"/>
			</module>
			<module path="$ORACLE_HOME/opmn/lib/libopmnbi">
				<module-id id="BIServer"/>
				<module-id id="BIScheduler"/>
				<module-id id="BIPresentationServices"/>
				<module-id id="BIClusterController"/>
				<module-id id="BIJavaHost"/>
			</module>
			<module path="$ORACLE_HOME/opmn/lib/libopmnovd">
				<module-id id="OVD"/>
			</module>
			<module path="$ORACLE_HOME/opmn/lib/libopmnwc">
				<module-id id="WebCache"/>
				<module-id id="WebCache-admin"/>
			</module>
			<module path="$ORACLE_HOME/opmn/lib/libopmnreports">
				<module-id id="ReportsServices"/>
				<module-id id="ReportsBridgeServices"/>
			</module>
			<module path="$ORACLE_HOME/opmn/lib/libopmndisco">
				<module-id id="Disco_ServicesStatus"/>
				<module-id id="Disco_SessionServer"/>
				<module-id id="Disco_PreferenceServer"/>
			</module>
			<module path="$ORACLE_HOME/opmn/lib/libopmnemagent">
				<module-id id="EMAGENT"/>
			</module>
			<module path="$ORACLE_HOME/products/Essbase/EssbaseServer/bin/libopmness">
				<module-id id="ESS"/>
			</module>
		</process-modules>
		<ias-instance id="instance1" name="instance1">
			<environment>
				<variable id="TEMP" value="/tmp"/>
				<variable id="TMP" value="/tmp"/>
			</environment>
			<ias-component id="coreapplication_obis1" inherit-environment="true">
				<environment>
					<variable id="ORACLE_BI_OPMNMANAGED" value="true"/>
					<variable id="ORACLE_BI_APPLICATION" value="coreapplication"/>
					<variable id="ORA_NLS10" value="$ORACLE_HOME/nls/data"/>
					<variable id="UNIXPERFDIR" value="$ORACLE_INSTANCE/tmp/$COMPONENT_TYPE/$COMPONENT_NAME"/>
					<variable id="LD_LIBRARY_PATH" value="$ORACLE_HOME/common/ODBC/Merant/5.3/lib$:$ORACLE_HOME/bifoundation/server/bin$:$ORACLE_HOME/bifoundation/web/bin$:$ORACLE_HOME/clients/epm/Essbase/EssbaseRTC/bin$:$ORACLE_HOME/bifoundation/odbc/lib$:$ORACLE_INSTANCE$:$ORACLE_HOME/lib:/u01/app/oracle/product/TimesTen/tt1122/lib" append="true"/>
					<variable id="ODBCINI" value="$ORACLE_INSTANCE/bifoundation/OracleBIApplication/$ORACLE_BI_APPLICATION/setup/odbc.ini"/>
					<variable id="PATH" value="$ORACLE_HOME/common/ODBC/Merant/5.3/lib$:$ORACLE_HOME/bifoundation/server/bin$:$ORACLE_HOME/bifoundation/web/bin$:$ORACLE_HOME/clients/epm/Essbase/EssbaseRTC/bin$:$ORACLE_HOME/bifoundation/odbc/lib$:$ORACLE_INSTANCE$:$ORACLE_HOME/lib$:$PATH$:$/bin" append="true"/>
					<variable id="ESSBASEPATH" value="$ORACLE_HOME/clients/epm/Essbase/EssbaseRTC"/>
					<variable id="TIMESTEN_DLL" value="/u01/app/oracle/product/TimesTen/tt1122/lib/libttclient.so"/>
				</environment>
				<process-type id="OracleBIServerComponent" module-id="CUSTOM">
					<module-data>
						<category id="start-parameters">
							<data id="start-executable" value="$ORACLE_HOME/bifoundation/server/bin/biserver.sh"/>
							<data id="start-args" value="-quiet"/>
							<data id="no-stdio" value="false"/>
						</category>
						<category id="stop-parameters">
							<data id="stop-executable" value="integrator"/>
						</category>
						<category id="ping-parameters">
							<data id="ping-type" value="integrator"/>
						</category>
						<category id="ready-parameters">
							<data id="use-ping-for-ready" value="true"/>
						</category>
					</module-data>
					<start timeout="600" retry="1"/>
					<stop timeout="120"/>
					<restart timeout="720" retry="1"/>
				</process-type>
			</ias-component>
			<ias-component id="coreapplication_obips1">
  <!-- Environment variables for the process -->
  <!--
    Note that COMPONENT_NAME (=ias-component id) and
    COMPONENT_TYPE(=process-type id) are automatically passed by OPMN
  -->
				<environment>
					<variable id="ORACLE_BI_OPMNMANAGED" value="true"/>
					<variable id="ORACLE_BI_APPLICATION" value="coreapplication"/>
    <!--
      Temporarily required to pass ORACLE_BIPS_INSTANCE_CONFIGDIR since
      the COMPONENT_CONFIGDIR passed automatically from OPMN is
      incorrect
    -->
					<variable id="ORA_NLS10" value="$ORACLE_HOME/nls/data"/>
					<variable id="ORACLE_BIPS_INSTANCE_CONFIGDIR" value="$ORACLE_INSTANCE/config/$COMPONENT_TYPE/$COMPONENT_NAME"/>
    <!-- Location of Perf dump files -->
					<variable id="UNIXPERFDIR" value="$ORACLE_INSTANCE/tmp/$COMPONENT_TYPE/$COMPONENT_NAME"/>
					<variable id="ODBCINI" value="$ORACLE_INSTANCE/bifoundation/OracleBIApplication/$ORACLE_BI_APPLICATION/setup/odbc.ini"/>
					<variable id="LD_LIBRARY_PATH" value="$ORACLE_HOME/common/ODBC/Merant/5.3/lib$:$ORACLE_HOME/bifoundation/server/bin$:$ORACLE_HOME/bifoundation/web/bin$:$ORACLE_HOME/bifoundation/odbc/lib$:$ORACLE_INSTANCE$:$ORACLE_HOME/lib" append="true"/>
					<variable id="PATH" value="$ORACLE_HOME/common/ODBC/Merant/5.3/lib$:$ORACLE_HOME/bifoundation/server/bin$:$ORACLE_HOME/bifoundation/web/bin$:$ORACLE_HOME/bifoundation/odbc/lib$:$ORACLE_INSTANCE$:$ORACLE_HOME/lib" append="true"/>
				</environment>
				<process-type id="OracleBIPresentationServicesComponent" module-id="CUSTOM">
					<module-data>
						<category id="start-parameters">
							<data id="start-executable" value="$ORACLE_HOME/bifoundation/web/bin/sawserver"/> 
        <!-- enable console log to be able to see process startup error -->
							<data id="no-stdio" value="false"/>
						</category>
						<category id="stop-parameters">
							<data id="stop-executable" value="integrator"/>
						</category>
						<category id="ping-parameters">
							<data id="ping-type" value="integrator"/>
						</category>
						<category id="ready-parameters">
							<data id="use-ping-for-ready" value="true"/>
						</category>
					</module-data>
					<start timeout="600" retry="1"/>
					<stop timeout="120"/>
					<restart timeout="720" retry="1"/>
				</process-type>
			</ias-component>
			<ias-component id="coreapplication_obijh1">
				<environment>
					<variable id="ORACLE_BI_OPMNMANAGED" value="true"/>
					<variable id="ORACLE_BI_APPLICATION" value="coreapplication"/>
					<variable id="JAVA_HOME" value="$ORACLE_HOME/jdk"/>
					<variable id="COMMON_COMPONENTS_HOME" value="$ORACLE_HOME/../oracle_common"/>
					<variable id="XDO_FONT_DIR" value="$ORACLE_HOME/common/fonts"/>
					<variable id="UNIXPERFDIR" value="$ORACLE_INSTANCE/tmp/$COMPONENT_TYPE/$COMPONENT_NAME"/>
					<variable id="LD_LIBRARY_PATH" value="$ORACLE_HOME/common/ODBC/Merant/5.3/lib$:$ORACLE_HOME/bifoundation/server/bin$:$ORACLE_HOME/bifoundation/web/bin$:$ORACLE_HOME/bifoundation/odbc/lib$:$ORACLE_INSTANCE$:$ORACLE_HOME/lib" append="true"/>
					<variable id="PATH" value="$ORACLE_HOME/common/ODBC/Merant/5.3/lib$:$ORACLE_HOME/bifoundation/server/bin$:$ORACLE_HOME/bifoundation/web/bin$:$ORACLE_HOME/bifoundation/odbc/lib$:$ORACLE_INSTANCE$:$ORACLE_HOME/lib" append="true"/>
				</environment>
				<process-type id="OracleBIJavaHostComponent" module-id="CUSTOM">
					<module-data>
						<category id="start-parameters">
							<data id="start-executable" value="$ORACLE_HOME/jdk/bin/java"/>
							<data id="start-args" value="-server -Xmx1024M -Djava.security.manager=default -DXDO_FONT_DIR=$ORACLE_HOME/common/fonts -Djava.security.policy=$ORACLE_INSTANCE/config/$COMPONENT_TYPE/$COMPONENT_NAME/java.policy -Djava.util.logging.config.class=oracle.core.ojdl.logging.LoggingConfiguration -Doracle.core.ojdl.logging.config.file=$ORACLE_INSTANCE/config/$COMPONENT_TYPE/$COMPONENT_NAME/logging-config.xml -Doracle.home=$ORACLE_HOME -Doracle.instance=$ORACLE_INSTANCE -Doracle.component.type=$COMPONENT_TYPE -Doracle.component.name=$COMPONENT_NAME -classpath $COMMON_COMPONENTS_HOME/modules/oracle.odl_11.1.1/ojdl.jar$:$ORACLE_HOME/bifoundation/javahost/lib/core/sautils.jar$:$ORACLE_HOME/bifoundation/javahost/lib/core/mad.jar$:$ORACLE_HOME/bifoundation/javahost/lib/core/sawconnect.jar$:$ORACLE_HOME/bifoundation/javahost/lib/core/javahost.jar$:$COMMON_COMPONENTS_HOME/modules/oracle.xdk_11.1.0/xmlparserv2.jar$:$ORACLE_HOME/opmn/lib/ons.jar$:$COMMON_COMPONENTS_HOME/modules/oracle.jps_11.1.1/jps-manifest.jar$:$COMMON_COMPONENTS_HOME/modules/oracle.jps_11.1.1/jps-api.jar$:$COMMON_COMPONENTS_HOME/modules/oracle.jps_11.1.1/jps-common.jar$:$COMMON_COMPONENTS_HOME/modules/oracle.jps_11.1.1/jps-internal.jar$:$COMMON_COMPONENTS_HOME/modules/oracle.nlsrtl_11.1.0/orai18n.jar$:$COMMON_COMPONENTS_HOME/modules/oracle.nlsrtl_11.1.0/orai18n-collation.jar$:$COMMON_COMPONENTS_HOME/modules/oracle.nlsrtl_11.1.0/orai18n-mapping.jar$:$COMMON_COMPONENTS_HOME/modules/oracle.dms_11.1.1/dms.jar com.siebel.analytics.javahost.standalone.Main"/>
							<data id="java-proc" value="true"/>
							<data id="no-stdio" value="true"/>
						</category>
						<category id="stop-parameters">
							<data id="stop-executable" value="integrator"/>
						</category>
						<category id="ping-parameters">
							<data id="ping-type" value="integrator"/>
						</category>
						<category id="ready-parameters">
							<data id="use-ping-for-ready" value="true"/>
						</category>
					</module-data>
					<start timeout="600" retry="1"/>
					<stop timeout="120"/>
					<restart timeout="720" retry="1"/>
				</process-type>
			</ias-component>
			<ias-component id="coreapplication_obisch1">
				<environment>
					<variable id="ORACLE_BI_OPMNMANAGED" value="true"/>
					<variable id="ORACLE_BI_APPLICATION" value="coreapplication"/>
					<variable id="ORA_NLS10" value="$ORACLE_HOME/nls/data"/>
					<variable id="UNIXPERFDIR" value="$ORACLE_INSTANCE/tmp/$COMPONENT_TYPE/$COMPONENT_NAME"/>
					<variable id="LD_LIBRARY_PATH" value="$ORACLE_HOME/common/ODBC/Merant/5.3/lib$:$ORACLE_HOME/bifoundation/server/bin$:$ORACLE_HOME/bifoundation/web/bin$:$ORACLE_HOME/bifoundation/odbc/lib$:$ORACLE_INSTANCE$:$ORACLE_HOME/lib" append="true"/>
					<variable id="PATH" value="$ORACLE_HOME/common/ODBC/Merant/5.3/lib$:$ORACLE_HOME/bifoundation/server/bin$:$ORACLE_HOME/bifoundation/web/bin$:$ORACLE_HOME/bifoundation/odbc/lib$:$ORACLE_INSTANCE$:$ORACLE_HOME/lib$:$PATH" append="true"/>
					<variable id="ODBCINI" value="$ORACLE_INSTANCE/bifoundation/OracleBIApplication/$ORACLE_BI_APPLICATION/setup/odbc.ini"/>
				</environment>
				<process-type id="OracleBISchedulerComponent" module-id="CUSTOM">
					<module-data>
						<category id="start-parameters">
							<data id="start-executable" value="$ORACLE_HOME/bifoundation/server/bin/bischeduler.sh"/> 
        <!-- enable console log to be able to see process startup error -->
							<data id="no-stdio" value="false"/>
						</category>
						<category id="stop-parameters">
							<data id="stop-executable" value="integrator"/>
						</category>
						<category id="ping-parameters">
							<data id="ping-type" value="integrator"/>
						</category>
						<category id="ready-parameters">
							<data id="use-ping-for-ready" value="true"/>
						</category>
					</module-data>
					<start timeout="600" retry="1"/>
					<stop timeout="120"/>
					<restart timeout="720" retry="1"/>
				</process-type>
			</ias-component>
			<ias-component id="coreapplication_obiccs1">
				<environment>
					<variable id="ORACLE_BI_OPMNMANAGED" value="true"/>
					<variable id="ORACLE_BI_APPLICATION" value="coreapplication"/>
					<variable id="ORA_NLS10" value="$ORACLE_HOME/nls/data"/>
					<variable id="UNIXPERFDIR" value="$ORACLE_INSTANCE/tmp/$COMPONENT_TYPE/$COMPONENT_NAME"/>
					<variable id="LD_LIBRARY_PATH" value="$ORACLE_HOME/common/ODBC/Merant/5.3/lib$:$ORACLE_HOME/bifoundation/server/bin$:$ORACLE_HOME/bifoundation/web/bin$:$ORACLE_HOME/bifoundation/odbc/lib$:$ORACLE_INSTANCE$:$ORACLE_HOME/lib" append="true"/>
					<variable id="PATH" value="$ORACLE_HOME/common/ODBC/Merant/5.3/lib$:$ORACLE_HOME/bifoundation/server/bin$:$ORACLE_HOME/bifoundation/web/bin$:$ORACLE_HOME/bifoundation/odbc/lib$:$ORACLE_INSTANCE$:$ORACLE_HOME/lib" append="true"/>
				</environment>
				<process-type id="OracleBIClusterControllerComponent" module-id="CUSTOM">
					<module-data>
						<category id="start-parameters">
							<data id="start-executable" value="$ORACLE_HOME/bifoundation/server/bin/nqsclustercontroller"/>
							<data id="no-stdio" value="true"/>
						</category>
						<category id="stop-parameters">
							<data id="stop-executable" value="integrator"/>
						</category>
						<category id="ping-parameters">
							<data id="ping-type" value="integrator"/>
						</category>
						<category id="ready-parameters">
							<data id="use-ping-for-ready" value="true"/>
						</category>
					</module-data>
					<start timeout="600" retry="1"/>
					<stop timeout="120"/>
					<restart timeout="720" retry="1"/>
					<process-set id="BIClusterController" numprocs="1"/>
				</process-type>
			</ias-component>
		</ias-instance>
		<rmd-definitions>
         <!-- Audit Loader Setup TODO
              Update the interval for Audit Loader to control how frequently
              the Standalone Audit Loader gets invoked (seconds).
         -->
			<rmd name="AuditLoader" interval="315360000">
				<conditional>
                 ({time}>=00:00)
             </conditional>
             <!-- Audit Loader Setup TODO
                  Before Updating the action snippet below, please update the
                  password in the Secret Store
             -->
             <!-- Audit Loader Setup TODO
                  Update the jdbcString (@%host%:%port%:%sid%)
                  Update the username (%username%)
                  Update the password (%password%) in Secret Store by adding
                  2 more system properties:
                     -Dstore.password=true
                     -Dauditloader.password=%password%
             -->
				<action value="exec $ORACLE_HOME/jdk/bin/java -classpath $COMMON_COMPONENTS_HOME/modules/oracle.osdt_11.1.1/osdt_cert.jar$:$COMMON_COMPONENTS_HOME/modules/oracle.osdt_11.1.1/osdt_core.jar$:$ORACLE_HOME/jdbc/lib/ojdbc5.jar$:$COMMON_COMPONENTS_HOME/modules/oracle.iau_11.1.1/fmw_audit.jar$:$COMMON_COMPONENTS_HOME/modules/oracle.pki_11.1.1/oraclepki.jar -Doracle.home=$ORACLE_HOME -Doracle.instance=$ORACLE_INSTANCE -Dauditloader.jdbcString=jdbc:oracle:thin:@%host%:%port%:%sid% -Dauditloader.username=%username% oracle.security.audit.ajl.loader.StandaloneAuditLoader" timeout="60"/>
				<exception value="exec /bin/echo PERIODICAL CALL FOR Audit Loader FAILED"/>
			</rmd>
		</rmd-definitions>
		<launch-targets>
			<launch-target id="logquery">
				<exec path="$ORACLE_HOME/jdk/bin/java"/>
				<argument value="-classpath"/>
				<argument value="$COMMON_COMPONENTS_HOME/modules/oracle.odl_11.1.1/ojdl.jar$:$COMMON_COMPONENTS_HOME/modules/oracle.odl_11.1.1/ojdl2.jar"/>
				<argument value="-Djava.encoding=utf-8"/>
				<argument value="oracle.as.management.logging.tools.LogQuery"/>
				<argument value="-i"/>
				<argument value="$ORACLE_INSTANCE"/>
			</launch-target>
			<launch-target id="createcomponent" timeout="600">
				<exec path="$ORACLE_INSTANCE/bin/opmnctl$BAT_EXT"/>
				<argument value="createcomponent"/>
			</launch-target>
			<launch-target id="deletecomponent" timeout="600">
				<exec path="$ORACLE_INSTANCE/bin/opmnctl$BAT_EXT"/>
				<argument value="deletecomponent"/>
			</launch-target>
			<launch-target id="reload" reload-timeout="0">
				<exec path="$ORACLE_INSTANCE/bin/opmnctl$BAT_EXT"/>
				<argument value="reload"/>
			</launch-target>
		</launch-targets>
	</process-manager>
</opmn>
where you can find the environment variables by system component. For instance for BI Server (ISA component, coreapplication_obis1), you can find the location of the ODBC.INI file of OBI.
Documentation / Reference

Oracle Fusion Middleware Oracle Process Manager and Notification Server Administrator's Guide Release 11g (11.1.1.2.0) - The opmn.xml File