8.1 Oracle Reports Services Configuration Files

This section identifies the configuration files associated with Oracle Reports Services. In most cases, you can leave these files untouched. Because they control many aspects of your server environment, you could put that environment at risk if you change a file in some unsupported way. Always keep a back-up of the current version of any configuration file you plan to change.

Note:

Reports application is deployed in No stage mode in following location:

$DOMAIN_HOME/servers/<WLS_SERVER_NAME>/tmp/_WL_user/reports_<version>/<random_string>

Though you can see Reports application configuration files in the configuration directory in the above specified location, they are stale files. Hence, do not edit them. Any modifications done to the Reports application configuration files through Oracle Enterprise Manager or System MBean browser are not reflected in the files located under the configuration directory.

The correct location of Reports application configuration file is:

$DOMAIN_HOME/config/fmwconfig/servers/<WLS_SERVER_NAME>/applications/reports_<version>/configuration.

The configuration files associated with Oracle Reports Services are listed and described in Table 8-1.

Note:

The paths specified in Table 8-1 are the same for both Windows and UNIX environments, though they are expressed here using the Windows backslash convention (\).

Table 8-1 Oracle Reports Services Configuration Files

Component	Configuration File
Reports Server (`rwserver`)	`ORACLE_HOME\reports\dtd\rwserverconf.xsd` For Standalone servers: `ORACLE_INSTANCE\config\ReportsServerComponent\server_name\rwserver.conf` For In-process servers: `$DOMAIN_HOME/config/fmwconfig/servers/<WLS_SERVER_NAME>/applications/reports_<version>/configuration/rwserver.conf` The `rwserverconf.xsd` file contains data type definitions for `rwserver.conf` and `rwbuilder.conf` elements and attributes. The `rwserver.conf` file defines initial values for the Reports Server Cache, the Oracle Reports engine, and security; registers valid destination types; and sets other server-related values. This file is automatically created when you start up the server. For more information, see Section 8.2, "Reports Server Configuration File". Reports Server network configuration file: `ORACLE_INSTANCE\config\ReportsServerComponent\server_name\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".
Oracle Reports Builder (`rwbuilder`) Oracle Reports Runtime (`rwrun`)	ORACLE_HOME\reports\dtd\rwserverconf.xsd ORACLE_INSTANCE\config\ReportsToolsComponent\ReportsTools\rwbuilder.conf 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\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".
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".
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".