Creating and running a content store consistency check

You can run a consistency check to detect instances of objects that violate the containment rules for multitenancy. Content that does not follow the tenant containment rules might not be accessible to the intended users or might not be deleted when the tenant that it belongs to is deleted.

The tenant containment rules require that the tenant ID of an object must be the same as the tenant ID of its parent, unless the parent tenant ID is public. For more information, see Containment rules for multitenancy.

Before you begin

Back up the content store before running a content store consistency check.

About this task

Instances where an object violates the tenant containment rules are resolved automatically if you use the Find and fix option when running the content store consistency check task. The tenant-related inconsistencies are fixed by assigning the parent tenant ID to the child object that is causing the error. You do not need to start the IBM Cognos service for these types of errors to be fixed. However, other types of content store inconsistencies are not fixed until the IBM Cognos service is started. A summary of each repair is created under the task execution history.

If you want to review and manually resolve the instances of tenant containment rules violation you can use the Find only option when running the content store consistency check. A summary of each error is created under the task execution history, assuming that the user who runs the task is a system administrator. This option might be safer because it gives you the time to investigate each object individually and assign the correct tenant ID to the object.

Procedure

In IBM Cognos Administration, on the Configuration tab, click Content Administration.
Click the new content maintenance icon in the toolbar, and then click Consistency Check.
Type the task name, and optionally a description and screen tip.
Click Internal references to check the content store for inconsistencies.
Choose how to run the task:
- To run the task now or later, click Save and run once. Specify a time and date for the run. Click Find only or Find and fix, and then click Run. Review the run time and click OK.
- To schedule the task at a recurring time, click Save and schedule. Select frequency and start and end dates. Click Find only or Find and fix and click OK.
- To save the task without scheduling or running, click Save only.

Results

The new task appears on the Configuration tab, under Content Administration. You can modify or run the task later. For more information about using these types of tasks in an IBM Cognos environment, see Content store maintenance tasks.