Duplicated copies managed by a Storage Lifecycle Policy created with expiration dates beyond the UNIX epoch (January 19, 2038 03:14:07 UTC) are prematurely expired. This condition does not occur when a retention level set to "infinity" is used.
|Article:TECH200501|||||Created: 2012-12-04|||||Updated: 2012-12-18|||||Article URL http://www.symantec.com/docs/TECH200501|
|NOTE: If you are experiencing this particular known issue, we recommend that you Subscribe to receive email notification each time this article is updated. Subscribers will be the first to learn about any releases, status changes, workarounds or decisions made.|
If assignment of a custom retention level causes an image's expiration time to be set beyond the UNIX epoch time of January 19, 2038 03:14:08 UTC, images managed by a Storage Lifecycle Policy (SLP) will expire after duplication is complete.
No error will be displayed as duplications will succeed; however, these images will not be available for later restore jobs.
This condition will occur when a custom retention level is used which causes an expiry date after Jan 19, 2038 03:14:08 UTC to be assigned to the image. Note: This issue does not occur when a retention period of Infinity is used.
In this example, a retention level of 30 years is specified in the Storage Lifecycle Policy:
The sequence of events when this SLP is used:
A. Successful NetBackup backup (primary copy and copy number 1)
B. Successful NetBackup duplication of the backup (secondary copy and copy number 2) with new expiration date.
C. Duplicate copies will shortly expire after successful job.
Because the first copy made in this example is expired after the duplication completes, after the second copy is prematurely expired there is no remaining copy of the data available for restore.
This issue affects all versions of NetBackup through 220.127.116.11 (including NetBackup 5200/5220 Appliances through 2.5.1) when Storage Lifecycle Policies are in use and configured with these custom retention levels.
NetBackup uses the UNIX ctime clock to calculate time, including the date and time used for the expiration of images. This is a 32-bit clock counting the number of seconds since January 1, 1970 (the "epoch" - ctime 0), and runs out at a ctime value of 2147483647 seconds, which translates to January 19, 2038 at 03:14:07 UTC.
Given this restriction, it is not currently possible to set expiry past that date and time in NetBackup, although it may appear that this configuration is possible. This is also the date and time that is currently used by NetBackup for any images set with Infinity retention (although images with Infinity retention are set to never expire, even when this date is reached).
It is expected that a future version of NetBackup will allow configuration and correctly process image expiry dates beyond January 19, 2038.
The formal resolution for this issue (Etrack 2988370) was scheduled to be included in the following release:
- NetBackup 7.5 Maintenance Release 5 (18.104.22.168), currently scheduled for release in the first quarter of 2013
- NetBackup 5200/5220 Appliances 2.5.2, scheduled to be released simultaneously with NetBackup 22.214.171.124
When NetBackup 126.96.36.199 is available, please access the link below for download and README information:
When NetBackup Appliances 2.5.2 is available, please access this link:
Do not use custom retention values in SLPs which would cause this issue to occur - use a custom retention value set to Infinity. If a specific time period is desired, this retention level can be changed to the desired length of time after NetBackup has been upgraded to a version where this issue is fixed.
If this workaround is unfeasible, please contact NetBackup technical support, referencing this document and Etrack 2988317 to obtain an Emergency Engineering Binary (EEB) bundle containing a fix for this issue for NetBackup 188.8.131.52 and NetBackup Appliances 2.5.1.
Symantec strongly recommends the following best practices:
1. Always perform a full DR backup prior to making any changes to your environment.
2. Always make sure that your environment is running the latest version and patch level.
3. Perform periodic "test" restores.
4. Subscribe to technical articles.
How to Subscribe to Email Notification:
Directly to this Article:
Subscribe to this article by clicking on the Subscribe via email link on this page to receive notification when this article is updated with Release Information.
If you have not received information about this TechNote from the Symantec Email Notification Service as a Software Alert, you may subscribe via email and/or RSS using the links provided at the following page:
NetBackup Enterprise Server: http://www.symantec.com/business/support/index?page=content&key=15143&channel=ALERTS
NetBackup Appliances: http://www.symantec.com/business/support/index?page=content&key=58991&channel=ALERTS
When using a custom retention level configured for 30 years resulting in an expiration date after 2038, SLP expires duplicate copies after duplication completes.
Article URL http://www.symantec.com/docs/TECH200501