Table of Contents

About

The runcat utility permits to perform webcat operations from the command line (scripted)

Management

Location

The runcat.cmd (.sh) start script is located here: ORACLE_INSTANCE\bifoundation\OracleBIPresentationServicesComponent\coreapplication_obips1\catalogmanager as it has all the necessary env populated correctly by the installer.

The runcat is at the source a jar located below ORACLE_HOME/bifoundation/web/catalogmanager/startup.jar

Prerequisite Variable Environment

Setting this environment are not needed if you use the runcat script.

Catalogmanager execution requires these variables to be set in the environment:

  • ORACLE_HOME
  • ORACLE_INSTANCE
  • ORACLE_BI_APPLICATION
  • COMPONENT_NAME
  • COMPONENT_TYPE

And PATH (or LD_LIBRARY_PATH on Linux) needs to include:

  • %ORACLE_HOME%\bin;%ORACLE_HOME%\bifoundation\server\bin;%ORACLE_HOME%\bifoundation\web\bin;%JAVA_HOME%\bin;

Log File

Log file is in ORACLE_INSTANCE\bifoundation\OracleBIPresentationServicesComponent\coreapplication_obips1\catalogmanager\workspace\.metadata\.log Or you can get the log on the console:

runcat.sh -consoleLog -noExit

Command Line options

To get all the command:

runcat.cmd or runcat.sh -help

For more help on any one of these commands, please enter:

runcat.cmd or runcat.sh -cmd <command> -help

The whole help Command

createFolder		Creates folder in the catalog
delete			Deletes the given path from the catalog
maintenanceMode		Puts the catalog into or out of Maintenance Mode (aka ReadOnly)
rehash			Rehashes /users in the catalog
rename			Renames an item in the catalog
report			Generates a report on the contents of the catalog
replace			Search and replace on the contents of the catalog
repair			Repairs damage caused by errant 3rd party ftp programs
localize		Enables localization for catalog contents
archive			Creates an archive of a subset of the catalog
unarchive		Extracts an archive into the catalog
archiveContent		Returns the List of Objects in the Archive File
setItemProperties	Sets the properties for an object in the web catalog

  • Multi-Tenancy
provisionTenant		Provisions tenants into a web catalog
unprovisionTenant	Unprovisions tenants out of a web catalog
migrateUsersToTenant	Migrates users for a particular tenant from /users to /tenants/<tenant>/users

tag			Tags all XML documents in a catalog with a unique id and common version string
diff			Compares two catalogs
inject			Injects a single item to a diff file
injectBatch		Injects multiple items to a diff file
createPatch		Creates a patch to upgrade a catalog from one version to another
applyPatch		Applies a patch to a catalog
publisherPermissionsImport	Imports BI Publisher Permissions into the web catalog
detectConflicts		Compares two diff files
combineDiffs		Combines multiple diff files to produce single diff file

renameAccounts		Renames users or groups in the catalog
forgetAccounts		Removes users or groups from the catalog
replaceAccountInPermissions	Replaces a specified account with another in all catalog object ACLs


clearQueryCache		Clears the query cache