Faster processing of content retention rules

As of Cognos® Analytics 11.2.4 FP3, content retention rules are applied more efficiently. This is the result of the retention rules being applied at different times than in previous releases.

A new method of processing

Asset owners can set retention rules on stored content that determine whether objects should be retained or deleted from the Content Store. Previously, retention rules were applied immediately: either when an asset's retention rule was updated or when a new object, governed by a retention rule, was added to the Content Store. This processing method resulted in Add or Update requests taking a long time to complete. In some cases, when many objects were flagged for removal, some objects were not removed, even though they met the retention criteria.

As of 11.2.4 FP3, retention rules are not applied immediately. They are instead applied as part of background processes that run at a regular interval.

Benefits

The processing of retention rules in this manner provides the following benefits:

  • Add or Update requests are faster.
  • Delete operations are done in small batches, reducing the transaction size.
  • Expired objects (controlled by duration-based retention rules) are now removed on time (roughly within 10 minutes).
Note: You may occasionally see more retained objects than are specified by your retention rules. These extra objects will be removed the next time that the background processing runs (the default interval is 10 minutes).
Tuning

For tuning purposes, the administrator can adjust the interval that the background processes are run. This is accomplished by changing the values of these two Content Manager advanced settings:

Upgrade implications
As a result of the new retention processing feature, the 11.2.4 FP3 Content Store schema is at a higher version and therefore not compatible with the lower-version schema in releases 12.0.0, 12.0.1, or 12.0.2.
Important:
Do not upgrade your 11.2.4 FP3 content to version 12.0.0, 12.0.1, or 12.0.2. If you do so, you may need to run specialized scripts before you can do another upgrade to version 12.0.3 or later. If you want to upgrade 11.2.4 FP3 content to version 12.0.x, you must wait until 12.0.3 or later to do so.
Reason:

Schema changes are made in the content store of 11.2.4 FP3 (and future releases) to support faster processing of content retention rules. Therefore, when you upgrade from 11.2.4 FP3 (or later), you must upgrade to a release with the same content store enhancements, for example, 12.0.3 (or later).

You can still upgrade any 11.2.x content other than 11.2.4 FP3 to any version of 12.0.x.

Setting retention rules on Content Store objects

You can set retention rules for your content by specifying these settings:

  • the maximum number of versions of an asset that can be retained
  • the maximum number of days or months that an asset is retained
Window for setting retention rules

For more information, see the following topics: