remotecopy Using the Oracle BI Presentation Services Replication Agent

17-48 System Administrators Guide for Oracle Business Intelligence Enterprise Edition 1. Open the instanceconfig.xml file for editing, as described in Section 3.6, Where Are Configuration Files Located? 2. Locate the section in which you must add the elements that are described in Table 17–6 . 3. Include the elements and their ancestor elements as appropriate, as shown in Example 17–1 . 4. Save your changes and close the file. 5. Restart Presentation Services. Example 17–1 instanceconfig.xml Files on Multiple Servers for Replication Suppose that you have two servers for which you want to enable replication. You set the instanceconfig.xml file to the following values on Server1: ServerInstance ps:Catalog xmlns:ps=oracle.bi.presentation.servicesconfigv1.1 Replication EnabledtrueEnabled Note: Do not insert multiple Catalog elements into a single instanceconfig.xml file. Search for an existing Catalog element and if it exists, use that element for holding the elements that are shown in this example. Table 17–6 Elements for Configuring Catalog Replication Element Description Default Value Enabled Specifies whether the instance of Presentation Services is to participate in replication, as either a publisher or subscriber. False ReadLogRecordsSince HoursAgo Specifies the time period in hours from which replication log files are to be read for replication operations. 168 RecordsInFileLimit Specifies the number of records to be kept in a replication log file. 5000 IDsInCluster Identifies, by ID, all instances of Presentation Services that are in the cluster. Separate each ID by a comma. This element is required in a clustered environment. NA MyInstanceID Identifies which of the IDs that were specified in the IDsInCluster element to use as the suffix for log files that are generated by this instance of Presentation Services. Log files are named as follows: ■ For change log files: sawchange_InstanceID_SequenceNum.log ■ For playback log files: sawplayback_InstanceID_SequenceNum.log See Table 17–7 for example file names. This element is required in a clustered environment. NA Configuring and Managing the Oracle BI Presentation Catalog 17-49 ReadLogRecordsSinceHoursAgo120ReadLogRecordsSinceHoursAgo RecordsInFileLimit4000RecordsInFileLimit Cluster IDsinClusterID_FOR_S1, ID_FOR_S2IDsinCluster MyInstanceIDID_FOR_S1MyInstanceID Cluster Replication ps:Catalog ServerInstance On Server2, you set the instanceconfig.xml file to these same values, with one exception. You set the MyInstanceID element to a value of ID_FOR_S2 to indicate that log files that are generated by the instance of Presentation Services on this server use a suffix of ID_FOR_S2. MyInstanceIDID_FOR_S2MyInstanceID Table 17–7 shows sample replication log files names that are generated by Server1 and Server2. Each node in the cluster must know the names of the other server log files to read replication information that is generated by the other servers.

17.12.7 Resuming Replication if Replication Log Files Are Unavailable

If, for some reason, replication log files are unavailable in an instance of Presentation Services, then you can resume replication by copying over the Oracle BI Presentation Catalog folders that the instance subscribes to. However, this method loses the catalog contents that were not replicated to other instances. The following method preserves all catalog contents. To resume replication if replication log files are unavailable: 1. Use Catalog Manager to erase all replication logs in the presentationcatalogpathreplicationchangelog and presentationcatalogpathreplicationplayback folders, where presentationcatalogpath is the full path to the Oracle BI Presentation Catalog folder. Table 17–7 Replication Log File Names by Server Log File Type Server1 Server2 Change log sawchange_ID_FOR_S1_1.log sawchange_ID_FOR_S1_2.log sawchange_ID_FOR_S1_3.log sawchange_ID_FOR_S1_4.log sawchange_ID_FOR_S2_1.log sawchange_ID_FOR_S2_2.log sawchange_ID_FOR_S2_3.log sawchange_ID_FOR_S2_4.log Playback log sawplayback_ID_FOR_S1_1.log sawplayback_ID_FOR_S1_2.log sawplayback_ID_FOR_S1_3.log sawplayback_ID_FOR_S1_4.log sawplayback_ID_FOR_S2_1.log sawplayback_ID_FOR_S2_2.log sawplayback_ID_FOR_S2_3.log sawplayback_ID_FOR_S2_4.log Note: If you must resume replication after Presentation Services has been offline for a time period in excess of that specified in the ReadLogRecordsSinceHoursAgo element in the instanceconfig.xml file, then you can adjust the value of ReadLogRecordsSinceHoursAgo so that log files in the offline period are replicated. Then, reset ReadLogRecordsSinceHoursAgo back to its original setting.