DOCUMENTATION: Ways to change expiration date (retention levels) of media and backup IDs
Manual: NetBackup (tm) 5.0 Commands for UNIX
Page: 88 - 93
Manual:NetBackup DataCenter (tm) 4.5 System Administrator's Guide for UNIX
Page: 561 - 566
Modification Type: Addition
Frequently, it is required to keep a backup longer, keep it for less time, or just get rid of it. To make changes to the expiration date of tapes, the command bpexpdate is used.
Note: For the bpexpdate -recalculate command:
If the backup is on removable media, the expiration date of the media ID in the media catalog is changed, provided the expiration date on this command is greater than the current expiration of the media ID.
There is this description in the following manual:
NetBackup (tm) 5.0 Commands for UNIX Page: 89
NetBackup DataCenter (tm) 4.5 System Administrator's Guide for UNIX Page: 562
When the retention level is set or changed, it generates the length of time that the backup will remain in the database before it is expired. That expiration date is calculated by adding the length of the retention level to the date of the backup. For example, if the date of the backup is 10/31/76, and the retention level is 2 ( 3 weeks), the backup will expire on 11/21/76.
Here is a list of the default retention levels:
Retention Retention Equivalent
Level Period Days
--------- ----------- ----------
0 1 week 7
1 2 weeks 14
2 3 weeks 21
3 1 month 31
4 2 months 62
5 3 months 93
6 6 months 186
7 9 months 279
8 1 year 365
The use of bpexpdate is quite straightforward. Following is a list of the options related to changing expiration dates and retention levels, along with some examples.
To re-calculate the expiration date of a specific backup ID based on retention level:
/usr/openv/netbackup/bin/admincmd/bpexpdate -recalculate -backupid clear_0988403420 -ret 4 <<-- That number is the retention level.
To do the same with all images from a class:
/usr/openv/netbackup/bin/admincmd/bpexpdate -recalculate -class Hotdog.Class -ret 0
NOTE: For NetBackup 4.5 and later, the -class switch has been changed to -policy. Both options will currently work, but -class may be removed at any time.
To specify the specific expiration date, use -d <date> instead of -ret:
/usr/openv/netbackup/bin/admincmd/bpexpdate -recalculate -backupid clear_0988403420 -d 10/31/01
To do it by media ID, an expiration date has to be used:
/usr/openv/netbackup/bin/admincmd/bpexpdate -ev A00010 -d 10/31/01
(This will change the expiration date for all the images on the tape.)
NOTE: For NetBackup 4.5 and later, the -ev switch has been changed to -m. Both options will currently work, but -ev may be removed at any time.
To change the expiration date so that it never expires:
/usr/openv/netbackup/bin/admincmd/bpexpdate -ev A00010 -d infinity
Or to expire all images on that tape:
/usr/openv/netbackup/bin/admincmd/bpexpdate -ev A00010 -d 0
(This will remove all the backup images on this tape from the database, this is not something that should be used under normal circumstances.)