Specifying Long-Term Retention Policy

You can configure long-term retention policy to keep weekly, monthly or yearly full backups.

IMPORTANT

After you configure a long-term retention policy, you must enable long-term retention for the backup job. Otherwise, the long-term retention will not work. For more information on enabling long-term retention, see Enabling Long-Term Retention Policy.

Configuring Long-Term Retention Policy to Keep Weekly Full Backups

To configure long-term retention policy to keep weekly full backups, use the following command:

veeamconfig gfs set --jobid <job_id> weekly --on <weekday> --keep <weeks>

veeamconfig gfs set --jobname <job_name> weekly --on <weekday> --keep <weeks>

where:

<job_id> — ID of the backup job for which you want to configure the long-term retention policy. You should look up the job ID in advance, before configuring the schedule, for example, with the veeamconfig job list command. To learn more, see Viewing List of Backup Jobs.

<job_name> — name of the backup job for which you want to configure the long-term retention policy.

<weekday> — week day when Veeam Agent must assign a weekly GFS flag to a full restore point — for example, Tue or Tuesday.
<weeks> — number of weeks to keep the weekly GFS flag on the full restore point.

For example:

user@srv01:~$ veeamconfig gfs set --jobid 4849a3ae-1935-4969-98a3-d8acd2f6c73f weekly --on Saturday --keep 1

Configuring Long-Term Retention Policy to Keep Monthly Full Backups

To configure long-term retention policy to keep monthly full backups, use the following command:

veeamconfig gfs set --jobid <job_id> monthly --on <week_number> --keep <months>

veeamconfig gfs set --jobname <job_name> monthly --on <week_number> --keep <months>

where:

<job_id> — ID of the backup job for which you want to configure the long-term retention policy. You should look up the job ID in advance, before configuring the schedule, for example, with the veeamconfig job list command. To learn more, see Viewing List of Backup Jobs.

<job_name> — name of the backup job for which you want to configure the long-term retention policy.

<week_number> — number of the week when Veeam Agent must assign a monthly GFS flag to a full restore point. Possible values: First, Second, Third, Fourth or Last.
<months> — number of months to keep the monthly GFS flag on the full restore point.

For example:

user@srv01:~$ veeamconfig gfs set --jobid 4849a3ae-1935-4969-98a3-d8acd2f6c73f monthly --on Second --keep 6

Configuring Long-Term Retention Policy to Keep Yearly Full Backups

To configure long-term retention policy to keep yearly full backups, use the following command:

veeamconfig gfs set --jobid <job_id> yearly --on <month> --keep <years>

veeamconfig gfs set --jobname <job_name> yearly --on <month> --keep <years>

where:

<job_id> — ID of the backup job for which you want to configure the long-term retention policy. You should look up the job ID in advance, before configuring the schedule, for example, with the veeamconfig job list command. To learn more, see Viewing List of Backup Jobs.

<job_name> — name of the backup job for which you want to configure the long-term retention policy.

<month> — month when Veeam Agent must assign a yearly GFS flag to a full restore point — for example, Jan or January.
<years> — number of years to keep the yearly GFS flag on the full restore point.

For example:

user@srv01:~$ veeamconfig gfs set --jobid 4849a3ae-1935-4969-98a3-d8acd2f6c73f yearly --on January --keep 3