How to apply the Java Runtime Environment Timezone Database Update tool to the VRTSjre and Veritas Enterprise Administrator for Daylight Saving Time (DST) changes

Article:TECH50838  |  Created: 2007-01-15  |  Updated: 2008-01-12  |  Article URL http://www.symantec.com/docs/TECH50838
Article Type
Technical Solution

Product(s)

Issue



How to apply the Java Runtime Environment Timezone Database Update tool to the VRTSjre and Veritas Enterprise Administrator for Daylight Saving Time (DST) changes

Solution



Beginning in 2007 the U.S.A. and other countries changed the way Daylight Savings Time is scheduled.  The U.S.A DST has changed and now starts on the second Sunday of March and ends on the first Sunday of November. Many regions of Canada and Mexico have changed as well.  In addition, New Zealand will have three weeks more daylight saving following the decision by the Labour-led Government to extend the period to 27 weeks.
The Symantec provided Java Runtime Environments (JREs), VRTSjre,  and VRTSjre15, are affected by the changes in DST. This will cause the time reported internally by the JRE to be off by 1 hour for 4 weeks each year, causing incorrect date and time processing for Symantec applications relying on these JREs. The new DST rules will went into effect in March 2007. To comply with the DST changes, updates to the JREs must be provided.  This is done by either by applying an update to your Symantec product (see  http://entsupport.symantec.com/docs/286461 ) or with a JRE update tool provided by the vendor as described below.
This affects VRTSjre (Java 1.4), VRTSjre15 (Java 1.5),  and 3.2 / 3.3 versions of Veritas Enterprise Administrator (VEA) on all platforms currently supported by these components. Currently Symantec ships JREs from three vendors -- Sun, IBM, and HP. Each of these JREs is affected. The table below shows product wise which vendors are used for each supported platform.
VRTSjre
 
PlatformVendor
AIX 4.3 / 5.xIBM
HP-UX 11.xx PAHP
HP-UX 11.xx IA64HP
Solaris 8+ SPARCSun
Solaris 10 x86/x64Sun
Linux x86/x64Sun
Linux PPCIBM
Windows x86/x64/IA64Sun


VEA
 
PlatformVendor
AIX 5.x IBM
HP-UX 11.xx PAHP
HP-UX 11.xx IA64HP
Solaris 7+ SPARCSun
Solaris 7+ x86/x64Sun
Solaris Opteron*Sun
Linux x86/x64/IA64Sun
Linux PPC*IBM
Windows x86/x64/IA64Sun
Windows OpteronSun
Windows Vista*Sun


* indicates that the JRE shipped on these platforms contain the DST timezone fixes
There are tools available from Sun, IBM, and HP to correct the time zone database in the VRTS Java Runtime Environment and VEA Java Runtime Environment. Download and run these tools with root or administrator privileges to update the implementation of your JRE (VEA JRE or VRTSjre) as follows:
I. VRTSjre
For Solaris, Linux, and Windows systems:
1. Go to:    http://java.sun.com/javase/tzupdater_README.html
2. Under the Installation section, select the link to the Sun Java SE download site
3. On the downloads page, select the JDK US DST Timezone Update Tool - 1.2.2 from the list to download the latest version of the update tool
4. You must log in using a valid Sun Online account to download.  There is an option to register and create a new account if needed. Log in using your Sun Online account
5. Once you are logged in, agree to the license. This is required to download the tool
6. Click on the Java(TM) 2 SDK, Standard Edition - US DST timezone tool 1.2.2 to download the tzupdater-1_2_2-2007g.zip file
7. Extract the files to a temporary directory on the system, e.g. /tmp/javatz on Solaris and Linux, C:\javatz on Windows
8. Update the implementation of the JRE based on platform as follows:
For Solaris and Linux systems:
# cd /opt/VRTSjre/jre1.5/bin
# ./java -jar /tmp/javatz/tzupdater.jar -f -bc -v
To verify:
# ./java -jar /tmp/javatz/tzupdater.jar -t -v
For Windows systems:
% cd C:\Program Files\Common Files\VERITAS Shared\VRTSjre\jre1.5\bin
% java -jar C:\javatz\tzupdater.jar -f -bc -v
To verify:
% java -jar C:\javatz\tzupdater.jar -t -v

For AIX systems:
1. Go to:    http://www-128.ibm.com/developerworks/java/jdk/dst/index.html
2. Under the "JTZU utility downloads", click the "jtzu-1.3.7f.zip" link to download the JTZU version 1.3.7f.
3. Extract the files to a temporary directory on the system, e.g. /tmp/javatz
4. Edit the /tmp/javatz/runjtzuenv.sh file and set the configuration values:
JAVA_HOME=/opt/VRTSjre/jre1.5
NOGUI=true
DISCOVERONLY=true
5. Overwrite the existing content of the DirectorySearch.txt file with +/opt/VRTSjre  
6. Run the utility in 'Discover only' mode:
# sh /tmp/javatz/runjtzu.sh
7. In the 'Discover only' mode, the utility scans the list of directories specified in the DirectorySearch.txt file and writes the list of Java installations detected with their time zone versions to the file SDKList.txt
8. Edit the/tmp/javatz/runjtzuenv.sh file to run the utility in 'Patch' mode by setting
DISCOVERONLY=false          
9. Run the utility in 'Patch' mode:
# sh /tmp/javatz/runjtzu.sh
In this mode, the utility checks the SDKList.txt file and patches the Java installations listed in it with the new time zone information.

For HP-UX systems:
1. Go to:    http://www.hp.com/products1/unix/java/DST-US.html
2. Under "Downloads," click the tzupdater Tool 1.0.3f link.
3. Accept the license and fill in the required contact information, then click Finish
4. Download the tzupdater-1.0.3f.tar file
5. Extract the files to a temporary directory on the system, e.g. /tmp/javatz
6. Update the implementation of the JRE:
# cd /opt/VRTSjre/jre1.5/bin
# ./java -jar /tmp/javatz/tzupdater.jar -f -bc -v
To verify:
# ./java -jar /tmp/javatz/tzupdater.jar -t -v

II. VEA Java Runtime Environment
For Solaris, Linux, and Windows systems:
1. Go to:    http://java.sun.com/javase/tzupdater_README.html
2. Under the Installation section, select the link to the Sun Java SE download site
3. On the downloads page, select the JDK US DST Timezone Update Tool - 1.2.2 from the list to download the update tool.
4. You must log in using a valid Sun Online account to download.  There is an option to register and create a new account if needed. Log in using your Sun Online account
5. Once you are logged in, agree to the license. This is required to download the tool
6. Click on the Java(TM) 2 SDK, Standard Edition - US DST timezone tool 1.2.2 to download the tzupdater-1_2_2-2007g.zip file
7. Extract the files to a temporary directory on the system, e.g./tmp/javatz on Solaris and Linux, C:\javatz on Windows
8. Update the implementation of the JRE based on platform as follows:
For Solaris and Linux systems:
# cd /opt/VRTSob/jre/bin
# ./java -jar /tmp/javatz/tzupdater.jar -f -bc -v
To verify:
# ./java -jar /tmp/javatz/tzupdater.jar -t -v
For Windows systems:
% cd c:\Program Files\VERITAS\VERITAS Object Bus\jre\bin
% java -jar C:\javatz\tzupdater.jar -f -bc -v
To verify:
% java -jar C:\javatz\tzupdater.jar -t -v

For AIX systems:
1. Go to:    http://www-128.ibm.com/developerworks/java/jdk/dst/index.html
2. Under "JTZU utility downloads", click the "jtzu-1.3.7f.zip" link to download JTZU version 1.3.7.f.
3. Extract the files to a temporary directory on the system, e.g. /tmp/javatz
4. Edit the/tmp/javatz/runjtzuenv.sh file and set the configuration values:
JAVA_HOME=/opt/VRTSob/jre
NOGUI=true
DISCOVERONLY=true
5. Overwrite the existing content of DirectorySearch.txt file with +/opt/VRTSob  
6. Run the utility in 'Discover only' mode:
# sh /tmp/javatz/runjtzu.sh
7. In the 'Discover only' mode, the utility scans the list of directories specified in the DirectorySearch.txt file and writes the list of Java installations detected with their time zone versions to the file SDKList.txt
8. Edit the/tmp/javatz/runjtzuenv.sh file to run the utility in 'Patch' mode by setting
DISCOVERONLY=false          
9. Run the utility in 'Patch' mode:
# sh /tmp/javatz/runjtzu.sh
In this mode, the utility checks the SDKList.txt file and patches the Java installations listed in it with the new time zone information.
For HP-UX systems:
1. Go to:    http://www.hp.com/products1/unix/java/DST-US.html
2. Under "Downloads," click the tzupdater Tool 1.0.3f link.
3. Accept the license and fill in the required contact information, then click Finish
4. Download the tzupdater_1.0.3f.tar file
5. Extract the files to a temporary directory on the system, e.g./tmp/javatz
6. Update the implementation of the JRE:
# cd /opt/VRTSob/jre/bin
# ./java -jar /tmp/javatz/tzupdater.jar -f -bc -v
To verify:
# ./java -jar /tmp/javatz/tzupdater.jar -t -v





Legacy ID



287483


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


Terms of use for this information are found in Legal Notices