Configuring the URL Engine

Configuring Oracle Reports Services 8-71

8.8.1 opmn.xml

Components are configured with OPMN in the opmn.xml file located in INSTANCE_ HOMEconfigOPMNopmnopmn.xml This section describes how to configure the following components through OPMN: ■ Module Specification ■ Standalone Reports Server Specification ■ Oracle Reports Bridge Specification ■ COS Naming Service Specification

8.8.1.1 Module Specification

The module tag is included by default in opmn.xml and tells OPMN to load a particular module. In the case of Reports Server, the OracleAS Reports Services module must be loaded. This module is loaded with the following information, by default, in opmn.xml: module path=privateoraclehomeopmnliblibopmnreports module-id id=ReportsServices module

8.8.1.2 Standalone Reports Server Specification

In the case of the standalone Reports Server, the Reports Server is running in its own component. Therefore, you must specify a separate component for Reports Server to control the server through OPMN. For example: ias-component id=ServerName process-type id=ReportsServerComponent module-id=ReportsServices process-set id=ServerName restart-on-death=true numprocs=1 environment variable id=PATH value=PATH environment variable environment module-data category id=general-parameters data id=batch value=yes category category id=restart-parameters data id=reverseping-timeout value=120 category module-data start timeout=75 retry=2 stop timeout=120 restart timeout=75 ping timeout=30 interval=30 process-set process-type ias-component See Also: For a detailed description of OPMNconfiguration and the contents of opmn.xml: ■ Oracle Fusion Middleware Administrators Guide Note: The timeout values in the preceding example are all in number of seconds. 8-72 Publishing Reports to the Web with Oracle Reports Services The key segments of this specification for Oracle Reports are described below. ias-component id=RSName ... This tag specifies the name of Reports Server. It must match the Reports Server internal name from targets.xml process-type id=ReportsServer module-id=ReportsServices This tag defines the process for the named Reports Server and associates it with the OracleAS Reports Services process module. process-set id=RSName restart-on-death=true numprocs=1 This tag defines the process characteristics for the named Reports Server. It indicates whether Reports Server should be restarted when it fails. It also specifies the number of Reports Servers started for this process set, which has to be 1 because the process-set id identifies a single Reports Server name. variable id=PATH value=your_shell_path The first tag specifies the value for the PATH environment variable for the process. This variable must be set for the start script to find uname. This environment element is not needed on the Microsoft Windows platform. category id=general-parameters data id=batch value=yes category This group of tags gathers together all of the data parameters common to the process. In this particular example, it provides a way to specify that the BATCH parameter be sent to Reports Server. batch=yes|no is an option to the start and stop commands of Reports Server. If it is not configured, this option is not passed in to Reports Server. category id=restart-parameters data id=reverseping-timeout value=120 category This group of tags indicates the restart parameters category, which defines parameters to be used in detecting whether the process has failed and needs to be restarted. If a notification is not received within the specified reverseping-timeout period, then the process is considered failed and will be restarted.

8.8.1.3 Oracle Reports Bridge Specification

The Oracle Reports bridge runs within its own component. Therefore, you must specify a separate ias-component tag for the Oracle Reports bridge to control the bridge through OPMN. For troubleshooting scenarios and diagnosis, see Section D.8, Diagnosing Oracle Reports Bridge Problems The following are examples for a minimum bridge configuration as well as a full bridge configuration. Example 8–1 Minimum Configuration for Oracle Reports Bridge ias-component id=your_bridge_name status=enabled id-matching=false xmlns=http:www.oracle.comias-instance See Also: Chapter 19, Managing and Monitoring OracleAS Reports Services for more information on targets.xml. See Also: For more information on opmn.xml and its contents: ■ Oracle Application Server Administrators Guide