Editing the Server Configuration File

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 Configuring Oracle Reports Services 8-73 process-type id=ReportsBridge module-id=ReportsBridgeServices process-set id=your_bridge_name restart-on-death=true numprocs=1 environment variable id=PATH value=your_oracle_home_directoryjdkjrebin append=true variable id=PATH value=your_shell_path append=true variable id=CLASSPATH value=your_oracle_home_directoryjlibzrclient.jar append=true variable id=CLASSPATH value=your_oracle_home_ directoryreportsjlibrwrun.jar append=true environment process-set process-type ias-component Example 8–2 Full Configuration for Oracle Reports Bridge ias-component id=your_bridge_name status=enabled id-matching=false process-type id=ReportsBridgemodule-id=ReportsBridgeServices process-set id=your_bridge_name restart-on-death=true numprocs=1 environment variable id=PATH value=your_shell_path append=true variable id=CLASSPATH value=your_oracle_home_directoryjlibzrclient.jar append=true variable id=CLASSPATH value=your_oracle_home_ directoryreportsjlibrwrun.jar append=true environment module-data category id=restart-parameters data id=reverseping-timeout value=120 category category id=start-parameters data id=jvm-options value==-Xms128mb -Xmx256mb data id=bridge-options value=start_options_if_any category category id=stop-parameters data id=jvm-options value=-Xms128mb -Xmx256mb data id=bridge-options value=stop_options_if_any category module-data start timeout=120 retry=3 stop timeout=120 restart timeout=120 retry=0 process-set process-type ias-component

8.8.1.4 COS Naming Service Specification

By default, Oracle Reports uses the built-in broadcast mechanism for Reports Server discovery. Alternatively, Oracle Reports clients can use the Common Object Service COS naming service for Reports Server discovery to submit report requests when the built-in broadcast mechanism is not suitable for your environment, as in the following scenarios: ■ Oracle Reports is installed on a machine that is connected to a network using VPN. ■ You want to avoid broadcast traffic on your network.