DOCUMENTATION: Ways to change expiration date (retention levels) of media and backup IDs

Article:TECH11408  |  Created: 2006-01-06  |  Updated: 2013-10-24  |  Article URL http://www.symantec.com/docs/TECH11408
Article Type
Technical Solution


Environment

Issue



DOCUMENTATION: Ways to change expiration date (retention levels) of media and backup IDs


Solution




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

Modification:

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      
   9             infinity  


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.)

 



Legacy ID



237159


Article URL http://www.symantec.com/docs/TECH11408


Terms of use for this information are found in Legal Notices