Oracle Reports Services Configuration Files

Configuring Oracle Reports Services 8-3 Oracle Reports Builder rwbuilder Oracle Reports Runtime rwrun ORACLE_HOME\reports\dtd\rwserverconf.xsd ORACLE_ INSTANCE\config\ReportsToolsComponent\ReportsTools\rwbuilder.c onf The rwserverconf.xsd file contains data type definitions for rwserver.conf and rwbuilder.conf elements and attributes. See Section 8.2.1, Reports Server Configuration Elements . The rwbuilder.conf file configures the Reports Server that is embedded in Oracle Reports Builder and Oracle Reports Runtime. All run requests must go through Reports Server, meaning that Oracle Reports Builder requires a server to run reports. Oracle Reports Builder automatically starts a Reports Server to handle its requests. When you run a report from Oracle Reports Builder, this file provides the configuration for the in-process Reports Server instance that is invoked. Like the rwserver.conf file, this file relies on the rwserverconf.xsd file for its data type definitions, though the following elements do not apply: persistFile and security . Reports Builder network configuration file: ORACLE_ INSTANCE\config\ReportsToolsComponent\ReportsTools\rw network.conf ORACLE_HOME\reports\dtd\rwnetworkconf.xsd The rwnetworkconf.xsd contains data type definitions for rwnetwork.conf elements and attributes. For more information, see Section 8.5, Network Configuration File . Oracle Reports Servlet rwservlet ORACLE_HOME\reports\dtd\rwservlet.xsd DOMAIN_HOME\config\fmwconfig\servers\WLS_SERVER_ NAME\applications\reports_ version\configuration\rwservlet.properties The rwservlet.xsd file contains data type definitions for rwservlet.properties parameters. For more information, see Section 8.3, Oracle Reports Servlet Configuration File . Reports Servlet network configuration file: DOMAIN_ HOME\config\fmwconfig\servers\WLS_SERVER_ NAME\applications\reports_ version\configuration\rwnetwork.conf ORACLE_HOME\reports\dtd\rwnetworkconf.xsd The rwnetworkconf.xsd contains data type definitions for rwnetwork.conf elements and attributes. For more information, see Section 8.5, Network Configuration File . Table 8–1 Cont. Oracle Reports Services Configuration Files Component Configuration File 8-4 Publishing Reports to the Web with Oracle Reports Services

8.2 Reports Server Configuration File

The configuration settings for the Reports Server component of Oracle Reports Services are stored in the XML file rwserver.conf and rwbuilder.conf, located in the directories specified in Table 8–1 . Both files are supported by the rwserver.template file in ORACLE_ HOME\reports\conf, which contains default server configuration values on both Windows and UNIX. The rwserver.conf file is the default server configuration file. The rwbuilder.conf file configures the server instance used in-process by Oracle Reports Builder. The rwserver.conf and rwbuilder.conf files are nearly identical. The only difference between them is that rwbuilder.conf does not use the persistFile or security configuration elements, described later in this section. Both of these files are created automatically, under the following circumstances: ■ The rwserver.conf file is created when a new Reports Server component is created. ■ The rwbuilder.conf file is pre-configured out-of-the-box. This section describes: ■ Reports Server Configuration Elements ■ Dynamic Environment Switching

8.2.1 Reports Server Configuration Elements

The rwserverconf.xsd file provides the following data type definitions for configuring rwserver.conf and rwbuilder.conf elements and attributes: ■ ORBPorts Oracle Reports Bridge rwbridge ORACLE_HOME\reports\dtd\bridgeconfig.xsd ORACLE_INSTANCE\config\ReportsBridgeComponent\bridge_ name\rwbridge.conf The bridgeconfig.xsd file contains data type definitions for rwbridge.conf elements and attributes. For more information, see Section 8.4, Oracle Reports Bridge Configuration File . Reports Bridge network configuration file: ORACLE_ INSTANCE\config\ReportsBridgeComponent\bridge_ name\rwnetwork.conf Note: The directory, ORACLE_ INSTANCE\config\ReportsBridgeComponent is not created by default. Instead, it is created when a user creates a Reports Bridge through opmnctl. ORACLE_HOME\reports\dtd\rwnetworkconf.xsd The rwnetworkconf.xsd contains data type definitions for rwnetwork.conf elements and attributes. For more information, see Section 8.5, Network Configuration File . Table 8–1 Cont. Oracle Reports Services Configuration Files Component Configuration File Configuring Oracle Reports Services 8-5 ■ pluginParam ■ cache ■ cluster ■ connection ■ destination ■ environment ■ envVariable ■ engine ■ job ■ jobRecovery ■ jobStatusRepository ■ log ■ jobRepository ■ notification ■ oidconnection ■ orbClient ■ persistFile ■ identifier ■ property ■ queue ■ folderAccess ■ security ■ proxyServer ■ domain ■ bypassProxy ■ proxyServers ■ proxyInfo ■ webLayout ■ dbProxyKey ■ dbProxyConnKeys ■ jobThresholds ■ server These elements along with their related attributes and sub-elements are discussed in the following subsections. Note that these are XML elements, and XML is case-sensitive. Additionally, when you add any of these elements to the rwserver.conf or rwbuilder.conf configuration file, you must follow the order of elements as described in rwserverconf.xsd. 8-6 Publishing Reports to the Web with Oracle Reports Services

8.2.1.1 ORBPorts

The ORBPorts element is defined in rwserverconf.xsd as follows: xs:element name=ORBPorts xs:complexType xs:attribute name=value use=required type=xs:string xs:complexType xs:element Example In rwserver.conf, the ORBPorts element may be specified as shown in this example: To specify a port range: ORBPorts value=17000-17010 To specify specific ports: ORBPorts value=17000,17010,17020,17030,17040 RequiredOptional Optional. By default, CORBA objects use any available port for communication. Since Reports Server uses CORBA for communication, it will use any available free port for communication. If you want Reports Server to use predefined ports instead of random ports, you must include the ORBPorts element in the server configuration file. Description The ORBPorts element specifies either a range of ports or specific ports for CORBA communication. When ORBPorts is specified, Reports Server will choose one of the ports from the list specified for ORB internal communication. One port is needed for Reports Server and one for each engine. You cannot specify port numbers for individual engines. Each engine picks up the next port number in the list. Suppose you have the maxengine attribute of the engine element set to 5 for rwEng, and URLEng is also enabled, then you must specify a minimum of 7 ports in the ORBPorts element 1 for Reports Server + 5 for rwEng + 1 for rwURLEng. The ORBPorts element attribute is described in Table 8–2 . Note: The ORBPorts element is used to assign specific ports to Reports Server and engines for running report and other requests. Do not confuse these ports with those you see in Oracle Enterprise Manager through the Ports link, which are ports reserved for Reports Server discovery mechanism and the Oracle Reports Bridge component. Table 8–2 Attribute of the ORBPorts Element Attribute Valid Values Description value Range of values or Numbers separated by commas The port range that can be used for Reports Server and engine communication through CORBA.