Document ID: 286497
http://support.veritas.com/docs/286497
E-Mail Colleague IconE-Mail this document to a colleague

How to update the Java Runtime Environment within Symantec's Veritas NetBackup (tm) to properly handle Daylight Savings Time starting in March of 2007 (last updated 3/9/2007)

Details:
The Energy Policy Act of 2005 resulted in a change to the beginning and end of Daylight Savings Time (DST). These changes took effect starting in March of 2007. Daylight savings time began at 2 a.m. local time on the second Sunday in March and ended at 2 a.m. on the first Sunday in November.  

Workarounds for known DST issues:
There are two options for updating the Java Runtime Environment (JRE) to properly handle the transition to and from daylight savings time. All NetBackup master servers, media servers,  and clients that use the NetBackup Java GUIs must be updated.

The NetBackup 6.0 Maintenance Pack 5 (MP5) release will contain an updated version of the JRE.  These workarounds will not be required once a system has been upgraded to NetBackup 6.0 MP5. The NetBackup 6.0 MP5 release will not be available until after the "spring forward" transition to DST has occurred.  Until this release is available,  use one of the workarounds listed below.

There are currently no plans to address this issue by way of a maintenance pack for the 5.x release.  For NetBackup 5.x systems, use one of the workarounds listed below.

Option1: Using tools to update the JRE Time Zone Database
There are tools available from Sun, IBM,  and HP to correct the time zone database for the Java Runtime Environment (JRE) version 1.4.0. Download and run this tool to update the NetBackup implementation of the JRE.  This option is available for systems running the NetBackup 4.5 Feature Pack (FP), NetBackup 5.x or NetBackup 6.0 releases.  These versions have the JRE 1.4.0 bundled with the software.  The NetBackup 4.5 Maintenance Pack (MP) and prior releases, see Option 2 below.

**NOTE** Some vendors have released newer versions of the tzupdater tool.  These newer versions contain fixes for known installation errors as well as updated time zone rules. (ex. "America/Indiana/Winamac")  For systems that have already run the tzupdater tool it will be necessary to check the vendor's Web site to determine if a newer version is available. If a newer version is available, and it contains any updates for your local time zone, then the newer version should be installed.

For Solaris, Linux,  and Windows systems go to:  http://java.sun.com/javase/tzupdater_README.html
a. Under the Installation section,  select the link to download the timezone update tool.
Or for the Sun Java SE download site go to:  http://java.sun.com/javase/downloads/index.jsp
On the downloads page, select the JDK US DST Timezone Update Tool from the list.
b. You must log in using a valid Sun Online account to download the tool.  There is an option to register and create a new account if needed.
c. Once you are logged in, review the license. This is required to download the tool.
d. Click on the Java(TM) 2 SDK, Standard Edition - US DST timezone tool to download the most recent version of the timezone update tool.
e. Extract the file to a temporary directory on the system. (e.g. /tmp/javatz on Solaris and Linux, C:\javatz on Windows)  
A <tz_dir> subdirectory will be created once the files are extracted.  Please note the directory name.  This will be needed in the next step.  
f. Update the NetBackup implementation of the JRE:
For Solaris and Linux systems:
# cd /usr/openv/java/jre/bin
# ./java -jar /tmp/javatz/<tz_dir>/tzupdater.jar -u -v
Where <tz_dir> is the directory name that was extracted in Step e.
Note: Be sure to use the ./java instead of just java.  This will ensure the NetBackup Java binary is used.  Failure to this could result in the first Java binary in the path being updated instead of the NetBackup JRE.  The installation will list the JRE that is being updated.
To verify the installation was successful run:
# ./java -jar /tmp/javatz/<tz_dir>/tzupdater.jar -V
The JRE time zone data version: and the Embedded time zone data version: must match.  If the JRE time zone data version: is an earlier release then the installation was not successful.

For Windows systems:
% cd <install_dir>\VERITAS\Java\jre\bin
% java -jar C:\javatz\<tz_dir>\tzupdater.jar -u -v
Where <tz_dir> is the directory name that was extracted in Step e.
To verify the installation was successful run:
% java -jar C:\javatz\<tz_dir>\tzupdater.jar -V
The JRE time zone data version: and the Embedded time zone data version: must match.  If the JRE time zone data version: is an earlier release then the installation was not successful.
a. Click on the download link for the appropriate platform under the JTZU utility downloads section
b. Extract the files to a temporary directory on the system, e.g. /tmp/javatz
c. Edit the /tmp/javatz/runjtzuenv.sh file and set the configuration values:
JAVA_HOME=/usr/openv/java/jre
NOGUI=false
DISCOVERONLY=true
d. Launch the IBM Time Zone Update Utility for Java.  This is a GUI utility and the system DISPLAY setting must point to a valid system:
# export DISPLAY=<hostname>:0
# sh /tmp/javatz/runjtzu.sh
e. Select Interactive Mode and click Start
f. Enter the location of the NetBackup implementation of the JRE (/usr/openv/java/jre) and click Update.  The shell window will display the status of the upgrade.  Check the output to ensure the installation is successful.
g. Wait until the upgrade is successful then select Exit once the upgrade is complete
a. Click on the tzupdater Tool link under the 1.4/5.0 tzupdater tool section
b. Review the license and fill in the required contact information,  then click Finish
c. Click on Download (1.4/5.0 tool)  to download the most recent version of the timezone update tool.
d. Extract the files to a temporary directory on the system. (e.g. /tmp/javatz)  
A <tz_dir> subdirectory will be created once the files are extracted.  Please note the directory name.  This will be needed in the next step.  
e. Update the NetBackup implementation of the JRE:
# cd /usr/openv/java/jre/bin
# ./java -jar /tmp/javatz/<tz_dir>/tzupdater.jar -u -v
Where <tz_dir> is the directory name that was extracted in Step d.
Note: Be sure to use the ./java instead of just java.  This will ensure the NetBackup Java binary is used.  Failure to this could result in the first Java binary in the path being updated instead of the NetBackup JRE.  The installation will list the JRE that is being updated.

To verify the installation was successful run:
# ./java -jar /tmp/javatz/<tz_dir>/tzupdater.jar -V
The JRE time zone data version: and the Embedded time zone data version: must match.  If the JRE time zone data version: is an earlier release then the installation was not successful.
a. Click on the JDK - Tzupdater link for the Tru64 platform under the Tzupdater for Java 1.5.0-x, Java 1.4.2-x releases section
b. Review the license and fill in the required contact information, then click Submit
c. Download the tzupdater utility.
d. Extract the files to a temporary directory on the system, e.g. /tmp/javatz)
e. Update the NetBackup implementation of the JRE:
# cd /usr/openv/java/jre/bin
# ./java -jar /tmp/javatz/tzupdater.jar -u -v
Note: Be sure to use the ./java instead of just java.  This will ensure the NetBackup Java binary is used.  Failure to this could result in the first Java binary in the path being updated instead of the NetBackup JRE.  The installation will list the JRE that is being updated.

To verify the installation was successful run:
# ./java -jar /tmp/javatz/tzupdater.jar -V
The JRE time zone data version: and the Embedded time zone data version: must match.  If the JRE time zone data version: is an earlier release then the installation was not successful.

Option2: Manually changing the DST through the Java GUI
Symantec recommends that Option 1 be applied to ensure DST occurs at the correct date and time.  For environments running NetBackup 4.5 Maintenance Pack (MP) or prior releases, the following steps can be manually performed in the GUI to work around this issue.  
1. Launch the NetBackup Java Administration Console
2. Go to File > Adjust Application Time Zone...
3. Check the Use custom time zone box to set a custom time zone
4. Verify the base time zone and offset are set correctly.  These should be inherited from the existing time zone.
5. Under the Daylight savings time starts section,  select Absolute date from the Use method: pull down.  Then enter the correct Month, day,  and time that daylight savings time will begin (Figure 1)
6. Repeat these steps for the Daylight savings time ends section
7. Check the Save as default time zone box to make the change permanent
8. Repeat these steps for any other system running the NetBackup Java Administration console
Since the start dates for DST vary each year, these steps will need to be repeated each year to ensure DST occurs on the correct dates.

Figure 1 - Example of a custom time zone
 

For additional information on configuring the application time zone of the NetBackup Java Administration console, refer to the NetBackup System Administrator's Guide II for UNIX.  These guides can be found below in the Related Documents section.

Revision History:
2/21/2007 - Added tzupdater instructions for Tru64 systems.
3/1/2007 - Added steps for each platform to verify installation was successful.
3/7/2007 - Added which systems require JRE updates and also updated 6.0 and 5.x patch information
3/9/2007 - Updated Sun/Linux/Windows and HP/Tru64 installation steps to reflect tzupdater version changes on the Sun and HP Web sites.



Products Applied:
 NetBackup BusinesServer 4.5, 4.5 (FP3), 4.5 (FP4), 4.5 (FP5), 4.5 (FP6), 4.5 (FP7), 4.5 (FP8), 4.5 (FP9), 4.5 (MP1), 4.5 (MP2), 4.5 (MP3), 4.5 (MP4), 4.5 (MP5), 4.5 (MP6), 4.5 (MP7), 4.5 (MP8), 4.5 (MP9)
 NetBackup DataCenter 4.5, 4.5 (FP3), 4.5 (FP4), 4.5 (FP5), 4.5 (FP6), 4.5 (FP7), 4.5 (FP8), 4.5 (FP9), 4.5 (MP1), 4.5 (MP2), 4.5 (MP3), 4.5 (MP4), 4.5 (MP5), 4.5 (MP6), 4.5 (MP7), 4.5 (MP8), 4.5 (MP9)
 NetBackup Enterprise Server 5.0, 5.0 MP1, 5.0 MP2, 5.0 MP3, 5.0 MP4, 5.0 MP5, 5.0 MP6, 5.0 MP7, 5.1, 5.1 MP1, 5.1 MP2, 5.1 MP3, 5.1 MP4, 5.1 MP5, 5.1 MP6, 6.0, 6.0 MP1, 6.0 MP2, 6.0 MP3, 6.0 MP4
 NetBackup Server 5.0, 5.0 MP1, 5.0 MP2, 5.0 MP3, 5.0 MP4, 5.0 MP5, 5.0 MP6, 5.0 MP7, 5.1, 5.1 MP1, 5.1 MP2, 5.1 MP3, 5.1 MP4, 5.1 MP5, 5.1 MP6, 6.0, 6.0 MP1, 6.0 MP2, 6.0 MP3, 6.0 MP4

Last Updated: April 07 2008 02:36 PM GMT
Expires on: 365 days from publish date
Subscribe Via E-Mail IconSubscribe to receive critical updates about this document

Subjects:
 NetBackup BusinesServer
   Application: Informational
NetBackup DataCenter
   Application: Informational
NetBackup Enterprise Server
   Nbu Application Basics: Scheduling
NetBackup Server
   Nbu Application Basics: Scheduling

Languages:
 English (US)

Operating Systems:
Windows 2000

Server SP4

AIX

4.3.3.10, 5.1, 5.2, 5.3

TRU64

5.1A, 5.1B, 5.1B2, 5.1B3

HP-UX

11.0, 11.11, 11i v2 (IA64), 11i v2 (PA-RISC)

Solaris

10, 7.0, 8.0, 9.0

Linux

RHAS 2.1, RHEL 3.0 (AS, ES, WS), RHEL 4.0, Red Flag DC Server 4.1, SLES 8, SLES 9

Windows Server 2003

DataCenter, Enterprise Server, R2, Standard Server, Web Server