You can find and fix inconsistencies within the content store or between the content store and external namespaces.
You can create content maintenance tasks and run content store
maintenance on demand. You can run content maintenance tasks at
a scheduled time or based on a trigger, such as a database refresh
or an email .
You can schedule content maintenance tasks as part of a job
or
as part of an agent
.
You can also view the run history of content maintenance tasks
.
Content maintenance tasks can check for inconsistencies within the content store due to missing data or obsolete data or between the content store and external namespaces.
Missing data within the content store may cause updates to fail. Obsolete data may prevent you from creating new objects. When a content store maintenance task fixes the content store, it adds default values for the missing data, which you can update later. It also permanently deletes any obsolete data. To ensure that you do not lose any data that you wanted to keep, we recommend that you choose the find mode first and check the results before fixing the content store.
When you find and fix the data, the content store is not fixed while the content maintenance task is running. Instead, Content Manager fixes the inconsistencies in the content store the next time it starts up.
Important: After you run a content maintenance task to find and fix the content store, back up your content store before you restart Content Manager.
We recommend that you perform internal maintenance checks regularly, but it is particularly important to do so before you upgrade, to ensure the consistency of the content stores.
When you delete users in external namespaces using a third-party
authentication provider, user account information remains in the
content store. You can use the Cognos Administration to find user
information that still exists in the content store and fix the content
store by deleting any users that do not exist in your external namespaces.
You can also delete individual user profiles from the content stores .
If you want to run a content maintenance task on more than one namespace, do one of the following:
If you want to run the content maintenance task now, simply log on to the namespaces and create the content maintenance task.
If you want to schedule a content maintenance task to run in the future or on a recurring basis, keep in mind that a scheduled content maintenance task runs against the namespaces that you select when you create the content maintenance task. Before you schedule a content maintenance task, ensure that your credentials contain logon information for each namespace by renewing the credentials after you log on to every namespace that you select to run the content maintenance task against.
Tip: Click My Area, My Preferences, click the Personal tab, and then click Renew the credentials.
You must have logon permission for each selected external namespace and read permission for all user accounts on each external namespace.
If you do not have read permission for a user account on the external namespace, it is assumed that the user was deleted from the namespace. When you run a content maintenance job, the user information on the content store is either listed as inconsistent (for find) or automatically deleted (for find and fix).
You must have the required permissions to access Cognos Administration functionality. See Secured Functions and Features.
Start Cognos Connection.
In the upper-right corner, click Launch, Cognos Administration.
On the Configuration tab, click Content Administration.
Click the arrow on the new content maintenance button on the toolbar, and then click New
Consistency Check.
Type a name and, if you want, a description and screen tip and click Next.
Choose the consistency check that you want:
To check the content store for inconsistencies, click Internal references.
To run content maintenance on namespaces, click References to external namespaces and select the namespaces that you want.
Click Next.
Choose the action that you want:
To run the task now or later, click Save and run once and click Finish. 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 and click Finish. Then, select frequency and start and end dates. Click Find only or Find and fix and click OK.
Tip: To temporarily disable the schedule, select the Disable the schedule check box. To view the schedule status, see Manage Scheduled Activities.
To save the task without scheduling or running, click Save only and click Finish.
Start Cognos Connection.
In the upper-right corner, click Launch, Cognos Administration.
On the Configuration tab, click Content Administration.
Click Run with options next to the content maintenance task.
Select the Now check box to run the content maintenance task immediately or the Later check box to set a day and time.
Click Find or Find and fix.
Click Run.