Step 8: Configuring Properties for Full-Text Catalog Search Manually

Configuring and Managing the Oracle BI Presentation Catalog 17-43 ■ Section 17.12.4.1, mark ■ Section 17.12.4.2, remotecopy ■ Section 17.12.4.3, run

17.12.4.1 mark

Adds or removes the specified catalog folders from the list of catalog folders that are to be replicated on all or the specified computers that run Presentation Services. The list of catalog folders to be replicated is stored in a configuration item that is located in the presentationcatalogpathrootsystemreplication directory, where presentationcatalogpath is the full path to the Oracle BI Presentation Catalog directory. Adding a catalog folder to the list does not mean that the corresponding catalog object is immediately replicated. Only future modifications are noted in the replication log file and subsequently replicated. When you replicate and the Oracle BI Presentation Catalog exists on another instance, the list of catalog folders to be replicated might be incorrect. Use the mark command to maintain the list of catalog folders to be replicated. The syntax for the mark command is: sawrepaj [C path] mark {all|servername} [n] [catalogfolders] ■ all | servername. The name of the computer that is running Presentation Services or all, on which to run the mark command. If you use a specific server, then the name that you specify must match the name attribute of the corresponding server element in the config.xml file. ■ n . If present, indicates that the catalog folder should be removed from the list of catalog folders to be replicated. Otherwise, the folder is added. ■ catalogfolders. A list of catalog folders to add or remove from the list of catalog folders to be replicated. Separate each folder name in the list with a space. To add or remove the entire Oracle BI Presentation Catalog including all folders and such information as system privileges, Catalog Group membership, and so on, use . If you do not specify any folders, then the mark command is executed on every folder for the servers that are specified in the config.xml file. The following line shows a sample command for mark: sawrepaj C MyOracleHome\bifoundation\web\bin\sawrepaj mark all

17.12.4.2 remotecopy

Exports the contents of the specified catalog folders from the source computer and imports them into the folders on the destination computer. The syntax for the remotecopy command is: sawrepaj [C path] remotecopy sourceServer destinationServer catalogfolders ■ sourceServer. The name of the source computer as specified in the config.xml file. ■ destinationServer. The name of the destination computer as specified in the config.xml file. ■ catalogfolders. A list of catalog folders to copy remotely. Separate each folder name in the list with a space. If you do not specify any folders, then the remotecopy command is executed on every folder for the servers that are specified in the config.xml file. 17-44 System Administrators Guide for Oracle Business Intelligence Enterprise Edition The following line shows a sample command for remotecopy: sawrepaj C MyOracleHome\bifoundation\web\bin\sawrepaj remotecopy Server1 Server2 users shared

17.12.4.3 run

Executes all replication tasks that are specified in config.xml file and that have not expired. This command has no run-time parameters. The syntax for the run command is: sawrepaj [C path] run The following line shows a sample command for run: sawrepaj C MyOracleHome\bifoundation\web\bin\sawrepaj run

17.12.5 Creating the config.xml File for Replication

You must create the Replication Agents configuration file to specify which folders on which instances of Presentation Services are to be replicated. The config.xml file is located in the ORACLE_HOME\bifoundation\web\bin\sawrepaj directory. The following sections describe the config.xml file: ■ Section 17.12.5.1, Structure of the Configuration File ■ Section 17.12.5.2, Elements of the Configuration File ■ Section 17.12.5.3, Example config.xml File For information about manual editing, see Section 3.4, Using a Text Editor to Update Configuration Settings.

17.12.5.1 Structure of the Configuration File

The structure of the Replication Agents config.xml file is as follows: Config General ExportDirectory LogExpiresHours RetryAttempts General Server Property Server Folderset Folder Folderset ReplicationTask Config

17.12.5.2 Elements of the Configuration File

Table 17–5 describes the elements that you can set in the Replication Agents config.xml file. You must enter the elements manually as they do not exist by default. Table 17–5 Replication Agent Configuration Elements in config.xml Element Description Config Serves as the root element for the configuration file.