MediaSense deployments provide pruning options to address varied deployment scenarios. Pruning options are specified on the
Administration > Prune Policy Configuration page.
These pruning options allow you to enter the following modes:
-
New Recording Priority mode—In this mode, the priority is on providing space for newer recordings, by automatically pruning
older recordings. This is the default behavior. The default age after which recordings will be pruned is 60 days. Old recordings
will also be pruned if disk space is required for new recordings.
-
Old Recording Retention mode—In this mode, priority is placed on retaining older recordings. Old recordings are not automatically
pruned.
To focus priority on making new recordings in the New Recording Priority mode, check Automatically prune recordings after they are more than __days old, and when disk space is needed for new recordings check box. When this check box is checked, a recording is deleted when one of the following conditions is met:
-
The age of the recording is equal to or greater than the retention age that you specify in the field for this option (valid
range is from 1 to 3650 days).
For example, if you are within your disk usage percentage and if you want to automatically delete all recordings older than
90 days, you must enter 90 in the Automatically prune recordings after they are more than __days old, and when disk space is needed for new recordings field. In this case, all recordings which are older than 90 days are automatically deleted. The default value is 60 days.
 Note |
A day is identified as 24 hours from the precise time you change this setting—it is not identified as a calendar day. For
example, if you change the retention period at 23.15.01 on April 2, 2010, the specified recordings will be deleted only at
23.15.01 on April 3, 2010. The recordings will not be deleted at 00:00:01 on April 3, 2010.
|
-
The disk usage has crossed the 90 percent mark. When the disk usage crosses the 90 percent mark, some sessions are pruned
based on age criteria. This pruning continues until the disk usage is acceptable.
 Note |
-
When you use this option to automatically delete recordings, MediaSense removes older recording data irrespective of contents.
The priority is provided to newly recorded media and disk space is overwritten to accommodate new recordings.
-
If you want to use the preceding option (New Recording Priority mode) and, at the same time, you want to protect a particular
session from being automatically pruned, be sure to store that session in MP4 format, download the MP4 file, and save it to
a suitable location in your network. You can also use the downloadUrl parameter in the Session Query APIs and download the raw recording to a location of your choice.
|
When sessions are pruned, the corresponding metadata is not removed from the database; nor is the data marked as deleted in
the database. MediaSense also provides options (radio buttons) that allow you to choose (or decline) to have this associated
session data removed automatically.
The following options allow you choose how to handle data associated with pruned sessions:
-
To have MediaSense remove the associated data automatically, select the Automatically remove associated data and mp4 files radio button.
-
If you select the Do not automatically remove associated data and mp4 files radio button, the associated data will not be removed automatically. Instead, your client application must explicitly remove
automatically pruned recordings, by way of the getAllPrunedSessions
API and the deleteSessions
API. When the deleteSessions
API is executed, the metadata is marked as deleted, and the MP4 files are deleted.
To place the priority on retaining older recordings (Old Recording Retention mode), uncheck the Automatically prune recordings after they are more than __days old, and when disk space is needed for new recordings check box. If this check box is unchecked, Cisco MediaSense does not automatically prune data for those recordings that are
created after the check box is unchecked. To remove unwanted data and free up disk space, use your client application. For
more information, see the Cisco MediaSense Developer Guide.
 Note |
If this check box is unchecked, the Old Recording Retention mode is applicable only to those recordings that are created after
the box is unchecked; it does not prevent prior recordings that were created previously from being pruned.
|
 Caution |
If you do not clean up unwanted data periodically, the call control service rejects new calls and drops existing recordings
at the emergency threshold level (ENTER_EMERGENCY_STORAGE_SPACE). For more information, see the System Thresholds section.
|