Index Retention Parameters (Indexing Version 1)

After being backed up, a subclient's index and log files are kept in the MediaAgent's index cache for a set number of days, which is defined by an indexing retention parameter called Retain index for n days (the default setting for this parameter is 15 days).

However, if the index cache is low on free space, the system may override the Retain index for n days retention parameter and delete the index files immediately. This form of cleanup, called an event-driven cleanup, can be configured by additional retention parameters described below. For more information about cleanup processes, including event-driven cleanup, see Index Cache Directory Cleanup.

Procedure

Note

You can change the retention properties for index caches on multiple MediaAgents by running the Change Index Cache Configuration workflow.

  1. From the CommCell Browser, expand Storage Resources > MediaAgents.

  2. Right-click the MediaAgent > Properties.

  3. On the Catalog tab of the MediaAgent Properties dialog box, change the value of the Retain index for n days parameter as desired. When an index becomes older than this parameter, the system runs a cleanup job that automatically deletes the index and log files within 24 hours.

  4. Change additional event-driven retention parameters as desired. These settings trigger the event-driven cleanup based on the amount of space allocated to the index cache and the amount of that allocated space that remains available, either as a percentage or an actual quantity. These settings are shown below.

    Note

    Statistics about the current space usage of the index cache (for example, total index cache directory size, disk space used by index files, disk space used by other files, and free space in the directory) are shown at the bottom of the Catalog tab of the MediaAgent Properties dialog box. For a full description of these statistics, see Viewing Index Cache Directory Usage Statistics.

    Generate alerts when free space falls below n GB: If the amount of free space in the index cache falls below this parameter (default = 50GB), the system sends alerts to the administrator email account. For more information, see the predefined alert "Disk space low on MediaAgent" in Alerts and Notifications - Predefined Alerts.

    Note

    If you want to set this parameter to 10 GB or less, you must use the Change Index Cache Configuration workflow. You cannot set this parameter to 10 GB or less in the MediaAgent Properties dialog box.

    Take the Index offline when free space falls below n GB: This is the total space that must be available in the index cache for it to remain online. If free space falls below this parameter (default = 10GB), the system takes the index cache offline and begins event-driven cleanup. For more information, see "Event-Driven Cleanup" in Index Cache Directory Cleanup.

    Note

    If you want to set this parameter to 1 GB or less, you must use the Change Index Cache Configuration workflow. You cannot set this parameter to 1 GB or less in the MediaAgent Properties dialog box.

    Cleanup until free space is at least: During an event-driven cleanup, the system checks to see if the percentage of free space remaining is greater than or equal to this parameter. If the percentage of free space remaining is less than this parameter, even after aged indexes are deleted, then additional indexes will be removed on a least-recently-used basis, until the free disk space percentage becomes greater than or equal to this value. For more information, see "Event-Driven Cleanup" in Index Cache Directory Cleanup.

  5. Click OK.

Loading...