JVM 1.3.1 time zone updater tool
This document (5002880) is provided subject to the disclaimer at the end of this document.
patches this patch supersedes
patches that supersede this patch
patch attributes
document
abstract
JVM 1.3.1 time zone updater tool for use with NetWare 5.1 and NetWare 6.0
details
Overview:
Starting in 2007, the standard North American period for Daylight Saving Time will be increased by 4 weeks. It will start the second Sunday in March (11th) and will end the first Sunday in November (4th).
Currently the Java Runtime Environment (JRE) on NetWare does not include the updates for Daylight Saving Time changes.
System Requirements:
NetWare 5.1 , NetWare 6.0 & JVM 1.3.1
Installation:
Copy the tzupdater131.jar to a likely spot (maybe sys:\java\lib) then execute a command line such as the following:
java -jar sys:\java\lib\tzupdater131.jar [flags go here]
The java environment doesn't need to be restarted as this updates the rt.jar file in place. Java.nlm is, of course, not touched.
Additional information from Sun:
Sun J2SE 1.3.1 TZupdater tool
Introduction
The tzupdater tool is provided to allow the updating of installed JDK/JRE images with more recent timezone data in order to accomodate the U.S. 2007 daylight saving time changes (US2007DST) originating with the "U.S. Energy Policy Act of 2005." The US2007DST data changes were incorporated into the following releases: 1.3.1_18, 1.4.2_11, 5.0u7.
Sun recommends utilizing the latest Sun Java SE JDK/JRE update release as the preferred vehicle for delivering both timezone data updates and other product improvements such as security fixes.
If the end-user or system-administrator is unable to use the latest Sun JDK/JRE update release, this tool provides a route of updating timezone data while leaving other system configuration and dependencies unchanged.
System Requirements
This tool supports Sun's JDK/JRE 1.3.1 only, including all updates of that release. The java.vendor property value must be "Sun Microsystems Inc.".
This tool operates on the JRE's rt.jar file, and makes a backup copy in jre/lib, named rt.jar.TZbackup. This means that there are temporary disk space requirements of around 45MB, of which around 14MB will be required
permanently for the backup file.
*** It is important that the tool is NOT stopped, killed or otherwise interrupted during this processing.
Usage
The tzupdater tool modifies the JDK/JRE image used to execute the tool.
A single JDK/JRE image is modified per execution. For administering to multiple JDK/JRE instances, read below under "System-wide Usage".
Any executing instances of the JDK/JRE to be operated upon must be stopped prior to running the tzupdater tool against that installed JDK/JRE on-disk image.
The command line interface is as follows: java -jar tzupdater131.jar options
Options
If no options are specified, the usage message is displayed. To perform time zone data update, either the -u or -f option must be specified.
-h, --help Print the usage to stdout and exit. Other options are ignored if specified.
-V, --version Show the tool version number and the tzdata version numbers of the JRE and the archive embedded in the jar file and exit.
-u, --update Update the time zone data and perform verification tests. The verification tests can be run separately with the -t option. If this option is specified with -h, -t or -V option, the command displays the usage to stdout and exits.
-f, --force Force update the tzdata even the version of the tzdata archive is older then the JRE's tzdata version. This option doesn't require the -u option to perform the update. Not needed under normal operating conditions.
-v, --verbose Display detailed messages to stdout.
-t, --test Runs verification tests only and exit. The included tests are applicable to a 1.3.1 JDK only.
Note: in J2SE 1.3.1 the time zone data is not dynamic, meaning the tool can either update, or test, the time zone information. The -t and -u options are therefore mutually exclusive.
Error Handling
The tool tries to restore the original state when it has encountered an unexpected error, such as lack of disk space.
System-wide Usage
Any executing instances of the JDK/JRE to be operated upon must be stopped prior to running the tzupdater tool against that installed JDK/JRE on-disk image.
It is possible for systems to accrete multiple copies of JDK/JRE images, so one may need to apply the tool individually to each JDK/JRE image. Locating multiple installed copies of the JDK/JRE on Unix derivative systems is shown below. Microsoft Windows users can use the desktop search utility.
(1) Find locally installed JDK/JRE instances for Unix derived systems:
/usr/bin/find DIRPATH -fstype nfs -prune -o -fstype autofs -prune -o -name java -print -exec {} -version \;
where DIRPATH is a directory path to search under for installed Java SE instance, for instance /usr.
(2) Automate updating of locally installed instances:
/usr/bin/find DIRPATH -fstype nfs -prune -o -fstype autofs -prune -o -name java -print -exec {} -jar /ABSOLUTEPATH/tzupdater131.jar -u \;
where DIRPATH is a directory path to search under for installed Java SE instance, for instance /usr.
ABSOLUTEPATH should be replaced with the full pathname to the directory where tzupdater131.jar is expanded into.
Software Package Management errors
The current tzupdater tool works outside of the native operating environment software package management infrastructure. Once users have used tzupdater to install newer timezone data files, commands such as Solaris pkgchk will report errors concerning the files altered by tzupdater.
Removing tzupdater Tool Changes
Any executing instances of the JDK/JRE to be operated upon must be stopped prior to running the tzupdater tool against that installed JDK/JRE on-disk image.
There does not currently exist a tzupdater modification removal option. The modifications the current tzupdater tool results in can be manually removed by following these steps:
(1) Locate the rt.jar file under the modified JAVAHOME/jre/lib directory. This is the newer data.
(2) Locate a rt.jar.TZbackup file in the same JAVAHOME/jre/lib directory. This is the replaced, older data.
(3) Copy the rt.jar.TZbackup over the updated rt.jar
(4) Restart applications on this JDK/JRE instance as desired.
file contents
Compressed File Name: novpatch3880.zip
| Files Included | Size | Date |
|---|---|---|
| readme_5002880.html | N/A | 2008-05-05 01:36:28 |
disclaimer
The Origin of this information may be internal or external to Novell. Novell makes all reasonable efforts to verify this information. However, the information provided in this document is for your information only. Novell makes no explicit or implied claims to the validity of this information. Any trademarks referenced in this document are the property of their respective owners. Consult your product manuals for complete trademark information.
Novell is a registered trademark of Novell, Inc. in the United States and other countries. SUSE is a registered trademark of SUSE Linux AG, a Novell business. *All third-party trademarks are the property of their respective owners.
© 2007 Novell, Inc. All Rights Reserved.