Skip to main content
Delphix

Understanding the Advanced Section of the Retention Policy Wizard (KBA6030)

 

KBA

KBA# 6030

Applicable Delphix Versions

Click here to view the versions of the Delphix engine to which this article applies
Major Release All Sub Releases
6.0 6.0.0.0, 6.0.1.0, 6.0.1.1, 6.0.2.0

5.3

5.3.0.0, 5.3.0.1, 5.3.0.2, 5.3.0.3, 5.3.1.0, 5.3.1.1, 5.3.1.2, 5.3.2.0, 5.3.3.0, 5.3.3.1, 5.3.4.0, 5.3.5.0 5.3.6.0, 5.3.7.0, 5.3.7.1, 5.3.8.0, 5.3.8.1, 5.3.9.0

5.2

5.2.2.0, 5.2.2.1, 5.2.3.0, 5.2.4.0, 5.2.5.0, 5.2.5.1, 5.2.6.0, 5.2.6.1

5.1

5.1.0.0, 5.1.1.0, 5.1.2.0, 5.1.3.0, 5.1.4.0, 5.1.5.0, 5.1.5.1, 5.1.6.0, 5.1.7.0, 5.1.8.0, 5.1.8.1, 5.1.9.0, 5.1.10.0

5.0

5.0.1.0, 5.0.1.1, 5.0.2.0, 5.0.2.1, 5.0.2.2, 5.0.2.3, 5.0.3.0, 5.0.3.1, 5.0.4.0, 5.0.4.1 ,5.0.5.0, 5.0.5.1, 5.0.5.2, 5.0.5.3, 5.0.5.4

4.3

4.3.1.0, 4.3.2.0, 4.3.2.1, 4.3.3.0, 4.3.4.0, 4.3.4.1, 4.3.5.0

4.2

4.2.0.0, 4.2.0.3, 4.2.1.0, 4.2.1.1, 4.2.2.0, 4.2.2.1, 4.2.3.0, 4.2.4.0 , 4.2.5.0, 4.2.5.1

4.1

4.1.0.0, 4.1.2.0, 4.1.3.0, 4.1.3.1, 4.1.3.2, 4.1.4.0, 4.1.5.0, 4.1.6.0

How to use the advanced section of the retention policy wizard

The retention policy wizard allows the user to either modify the existing default retention policy or create a new one based on their requirements.

As outlined in the Delphix documentation - Policies for Scheduled Jobs, retention time for snapshots must be equal to, or longer than, the retention time for logs.

However, it is possible to further customise the policy for snapshots, to allow individual snapshots to be retained for period longer than the general retention policy.

The purpose of this article is to explain how the advanced section of the retention policy wizard is administered, and what results should be expected as a result of the changes made.

To use the advanced section of the retention policy wizard

 

Editing the general policy

  1. Log in to the Management Application
  2. Navigate to Manage > Policies
  3. Switch to the Retention tab
  4. Either edit an existing retention policy or create a new one

clipboard_e3200c9e12bea375986dd1cc0659d110a.png

  1. After setting how long logs and snapshots should be set for, click Show Advanced

clipboard_ebf00f53dd5d56feb679d019dc1e12b17.png

Editing the advanced section

clipboard_ee9ac54e8b5d2d95aa12ff0e2e21d8355.png

In the advanced section you have 4 additional settings that can be harnessed to retain snapshots outside the realm of the regular retention policy.

Each section will behave as follows:

  1. Keep n Snapshot(s) everyday

- Keep 1 snapshot for the n most recent days, where there has been a snapshot taken on that day, including the most recent day, even if it is inside the regular retention policy for snapshots.

  1. Keep n Snapshot(s) on every <day of the week>

- Keep 1 snapshot for the n most recent <day of the week>, where there has been a snapshot taken on that <day of the week>, including the most recent <day of the week>, even if it is inside the regular retention policy for snapshots.

  1. Keep n Snapshot(s) on <day number> of every month

- Keep 1 snapshot for the n most recent <day number> of the month, where there has been a snapshot taken on the <day number> of the month, including the most recent <day number> of the month, even if it is inside the regular retention policy for snapshots.

  1. Keep n Snapshot(s) on <month and day> every year

- Keep 1 snapshot for the n most recent <month and day> of the year, where there has been a snapshot taken on the <month and day> of the year, including the most recent <month and day> of the year, even if it is inside the regular retention policy for snapshots.

Example retention policy with advanced parameters set

  • In this engine, 4 snapshots have been taken on Wednesday on the last 4 weeks

clipboard_ec5961d1ef5147bd4ff913261e97cc690.png

  • The retention policy has been set to "Keep 3 snapshot(s) on every Wednesday" and "Other snapshots/logs will be removed after 7 days"

clipboard_edbd7d647c5b91b636cdb1379c46b89f3.png

  • After the policy has run, we can see that all of the snapshots for Wed May 20th have been removed, 1 is left on Wed May 27th and Wed Jun 3rd, and all 4 snapshots remain on Wed Jun 10th as this is less than the 7 days retention period

clipboard_ee8c4b9e9e0c1e1f3a93dd17c5208fd66.png