Oracle^® Business Intelligence Presentation Services Administration Guide > Administering Oracle BI Presentation Services >

Making Oracle BI Presentation Services Configuration Changes

This section provides procedures for making configuration changes. You need to make changes only if you want to change default elements, such as the name of the Presentation Catalog, or override internal default settings, such as the time for client connections to expire.

You make configuration changes by modifying the Oracle BI Presentation Services configuration file (instanceconfig.xml), which holds configuration settings for Oracle BI Presentation Services.

For organizations that use Oracle Application Server, Oracle recommends that you use Oracle Application Server Control to modify configuration files. For organizations that use other application servers, Oracle recommends that you use JConsole. For more information, see the Oracle Business Intelligence Infrastructure Installation and Configuration Guide.

NOTE:  If you have previously made configuration changes by modifying the Windows registry, you should migrate those changes to the Oracle BI Presentation Services configuration file (instanceconfig.xml). In the Windows registry, entries under the Common key remain valid.

For general background information about customizing the Oracle BI Presentation Services XML files, read Customizing the Oracle BI Presentation Services User Interface Using XML Message Files.

To make changes to the configuration file instanceconfig.xml

1. Navigate to:

   SADATADIR\web\config

   where SADATADIR is the data directory.

   CAUTION:  Always make a backup copy of the instanceconfig.xml file before you make any changes.

2. Locate the instanceconfig.xml file and make a backup copy.
3. Use a text editor to open the instanceconfig.xml file.
4. Place your entries between the elements <ServerInstance> and </ServerInstance>, using the values described throughout this chapter.
5. Save the file when you are done.

   Your changes take effect when the service for Oracle BI Presentation Services is restarted.

Example instanceconfig.xml File

The following XML file is an example of the Oracle BI Presentation Services configuration file (instanceconfig.xml):

   <?xml version="1.0" ?>
   <!-- Oracle BI Presentation Services Configuration File -->
   <!-- The following example shows initialization settings for a server instance. -->

   <WebConfig>
      <ServerInstance>
         <CatalogPath>/OracleBIData/web/catalog/default</CatalogPath>
         <DSN>AnalyticsWeb</DSN>
      </ServerInstance>
   </WebConfig>

Several entries are present in the file instanceconfig.xml by default, including the path to the Presentation Catalog, and the name of the Oracle Business Intelligence Server data source name used by Oracle BI Presentation Services to access Oracle BI Server.

For example, the path to the Presentation Catalog is shown between the <CatalogPath> and </CatalogPath> elements:

• In Windows, an example path might be the following:

  <CatalogPath>c:\OracleBIData\web\catalog\default</CatalogPath>

• In UNIX, an example path might be the following:

<CatalogPath>/usr/local/OracleBIData/web/catalog/default</CatalogPath>