Oracle® Business Intelligence Presentation Services Administration Guide > Administering the Oracle BI Presentation Catalog > Replicating Presentation Catalogs >

Creating the config.xml File for Replication


The structure of the Oracle BI Presentation Services Replication Agent's configuration file (config.xml), located in SAROOTDIR\web\bin\sawrepaj (where SAROOTDIR is the installation directory), is as follows:

<Config>
   <General>
      < ExportDirectory />
      < LogExpiresHours/>
      < RetryAttempts/>
   </General>
   <Server/>
   <Folderset>
      <Folder/>
   </Folderset>
   <ReplicationTask/>
</Config>

Table 12 describes the elements that you can set in the config.xml file.

Table 12. Elements in the config.xml File
Element
Parent
Occurrences
Description

Config

N/A

1

XML root element.

General

Config

1

Contains general settings applicable to all instances and replication tasks.

Export Directory

General

1

Contains the UNC path to the shared directory where export files should be placed. It should be accessible by the same name from all instances of Oracle BI Presentation Services.

In addition, the user account under which an instance of Oracle BI Presentation Services is running must have read/write permissions to this directory.

LogExpiresHours

General

1

Specifies the time in hours (as a double value) that replication logs expire on all instances of Oracle BI Presentation Services.

Set this element to the value of the ReadLogRecordsSinceHoursAgo element that is the lowest among all instances of Oracle BI Presentation Services participating in replication. For more information on the ReadLogRecordsSinceHoursAgo element, see Editing the instanceconfig.xml File for Replication.

RetryAttempts

General

1

Specifies the number of times an attempt to change an item is to be retried.

(An attempt to change an item may need to be retried, for example, if an item was locked.)

Server

Config

1...n

Defines connection information for each Oracle BI Presentation Server. Its attributes are:

  • name. The logical id of the server, which is used to identify it in replication tasks and in the sawrepaj command line.
  • url. The URL of the instance of Oracle BI Presentation Services, such as:
    http://localhost/analytics/saw.dll
  • user. The user name.
  • pwd. The password.

Folderset

Config

0...n

Defines a list of catalog folders. Its only attribute is:

  • name

Folder

Folderset

0...n

Adds a folder to the folderset. It specifies the full path to the catalog folder.

ReplicationTask

Config

0...n

Defines the replication tasks. Its attributes are:

  • source. The source server name. This must match an instance defined in the Server element.
  • destination. The destination server name. This must match an instance defined in the Server element.
  • folders. The name of the folders set. This must match a folder set defined in the Folderset element.
  • lastPerformed. The timestamp of the last successful run of this task. The sawrepaj utility updates this value.
  • localChanges. Specifies whether changes made directly on the source server are to be exported:
    • true. Changes are to be exported.
    • false. Changes are not to be exported.

      Default: true

  • remoteChanges. Specifies whether changes that were made on another server and that were replicated on the source server are to be reexported:
    • true. Changes are to be reexported.
    • false. Changes are not to be reexported.

      Default: false

Example config.xml File

The following XML file is an example of the config.xml file:

   <?xml version="1.0" encoding="UTF-8"?>
   <!-- Oracle BI Presentation Services Replication Agent Configuration File -->
   <!-- The following example specifies that the entire Presentation Catalog (that is all folders) on Server 1 is to be replicated on server 2 and that the entire Presentation Catalog on Server 2 is to be replicated on server 1. -->

   <Config>
      <General>
         <ExportDirectory>\\host1\shared</ExportDirectory>
      </General>

      </Server name="1" pwd="" url="http://host1/analytics/saw.dll" user="administrator"       pwd=""/>
      </Server name="2" pwd="" url="http://host2/analytics/saw.dll" user="administrator"       pwd=""/>

      <Folderset name="all">
         <Folder>/</Folder>
      </Folderset>

      <ReplicationTask destination="2" source="1" folders="all" />
      <ReplicationTask destination="1" source="2" folders="all" />
   </Config>

Oracle® Business Intelligence Presentation Services Administration Guide Copyright © 2007, Oracle. All rights reserved.