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 DatabaseThere 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.
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
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 2000Server 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