OBIPS - runcat (Web Catalog Manager client)

Saw Object


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



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:


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: -consoleLog -noExit

Command Line options

To get all the command:

runcat.cmd or -help

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

runcat.cmd or -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

Discover More
Saw Object
OBI Presentation Service (Webcat) - User

User management for the presentation services (ie the webcat) The “system account” is the user that is used when opening the catalog in offline mode with the catalog manager or runcat (ie local access)...
Obiee Catalog
OBIEE 10G/11G - The (Web|Presentation) Catalog (Webcat)

Old Presentation Catalog... The Oracle BI Presentation Catalog stores BI Presentation Service object such as: answer, dashboard, prompt folders, shortcuts, KPIs, Oracle BI Publisher...
Saw Object
OBIPS - Patch Management

Webcat Patch Management with the runcat command. where: -folder default to /shared and /system/metadata. where: -folder default to /shared and /system/metadata. -verbosity
Obiee Catalog Manager Preference
OBIPS - Webcat Object Copying and Archiving

All copying a webcat object (Generally an answer or a dashboard) from the same environment or to another. To copy/paste an object, you can perform it in two different operations Archive/Unarchive...

Share this page:
Follow us:
Task Runner