|
Introduction
The tzupdater 1.3.11 tool is provided to allow the updating of installed JDK/JRE images with more recent timezone data to accommodate the latest world-wide changes to the Olson database. See http://java.sun.com/javase/timezones/tzdata_versions.html for more information.
HP recommends using the latest HP Tru64™ UNIX® Java SE JDK/JRE update release as the preferred vehicle for delivering both timezone data updates and other product improvements such as security fixes; however, if the end user or system administrator is unable to use the latest HP Tru64 UNIX JDK/JRE update release, this tool provides a way to update timezone data while leaving other system configuration and dependencies unchanged.
This version of the tzupdater tool delivers Olson timezone data version tzdata2008i. For information about the time-zone changes and the tzupdater tool, please visit http://h18012.www1.hp.com/java/alpha/DST-US.html.
System Requirements
The tzupdater 1.3.11 tool supports HP's JDK/JRE releases on all supported platforms, including Tru64 UNIX JDK/JRE 1.4.0 and later (1.4.0, 1.4.1, 1.4.2), and all updates of those releases. The java.vendor property value must be "Hewlett-Packard Company" or "Compaq Computer Corp."
Installation
Download the tool bundle tzupdater_1.3.11.tar from the HP Tru64 UNIX Java Technology site and extract the files from tzupdater_1.3.11.tar.
Note : This version supersedes any previous versions.
Usage
The tzupdater 1.3.11 tool modifies the JDK/JRE image used to execute the tool.
A single JDK/JRE image is modified per execution. To use the tzupdater tool on multiple JDK/JRE instances, see "System-wide Usage" below .
Any executing instances of the JDK/JRE to be operated upon must be stopped before running the tzupdater tool against that installed JDK/JRE on-disk image. Write permission on the JDK/JRE directories is needed.
The command-line interface is: java -jar tzupdater.jar options
Options
If no options are specified, the usage message is displayed. To perform timezone 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 this option is 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 timezone 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 if the version of the tzdata archive is older then the JRE's tzdata version. This option doesn't require the -u option for the update to be performed. Not needed under normal operating conditions.
|
-v, --verbose |
Display detailed messages to stdout. |
-bc, --backwardcompatible |
Keep backward compatibility with the 3-letter timezone IDs of JDK 1.1. Any timezone IDs that conflict with the JDK 1.1 timezone IDs will be removed from the installed timezone data. This option must be specified with the -u, -f or -t option.
A few timezone IDs in JDK 1.1 and the Olson timezone database IDs (industry standard IDs) conflict. The conflicting timezone IDs are "EST", "MST" and "HST" as of this release.
If these IDs are used in your applications, the -bc option needs to be specified.
|
-t, --test |
Runs verification tests only and exit. If the JRE has timezone data that doesn't match the one in the tool, the verification tests report errors and fail.The -f option is ignored if specified. If the -bc option is specified, any test cases for timezone IDs that conflict with the JDK 1.1 timezone IDs will be ignored.
|
Error Handling 3
The tool tries to restore the original state when it has encountered an unexpected error, such as lack of disk space.
Known Restrictions
The tool has a few restrictions due to the TimeZone API and implementation constraints.
Timezone display names
This tool will not update timezone display names of timezones that are completely new or have display name related changes. The complete support of all timezone display names requires installation of the latest HP Java SE JDK/JRE update release.
System-wide Usage
Any executing instances of the JDK/JRE to be operated upon must be stopped before running the tzupdater tool against that installed JDK/JRE on-disk image.
Systems can accumulate multiple copies of JDK/JRE images, so you might need to apply the tool individually to each JDK/JRE image. Follow these steps to locate multiply-installed copies of the JDK/JRE on Tru64 UNIX systems:
- Find locally installed JDK/JRE instances:
/usr/bin/find DIRPATH -fstype nfs -prune -o -name java -print -exec {} -version \;
where
DIRPATH is a directory path to search under for installed Java
SE instance, for instance /usr.
- Automate updating of locally installed instances:
/usr/bin/find DIRPATH -fstype nfs -prune -o -name java -print -exec {} -jar /ABSOLUTEPATH/tzupdater.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 tzupdater.jar is expanded into.
Double checking the JDK/JRE instances installation before running the automated updating is recommended.
Removing tzupdater Tool Changes
Any executing instances of the JDK/JRE to be operated upon must be stopped before running the tzupdater tool against that installed JDK/JRE on-disk image.
A tzupdater modification removal option does not currently exist. Follow these steps to manually remove the modifications created by the current tzupdater tool:
- Locate the zi directory under the modified JAVAHOME/jre/lib directory. This is the newer data.
- Locate a zi_tzdata* directory in the same JAVAHOME/jre/lib directory. This is the replaced, older data.
- Obtain the currently installed timezone data version from the command `java -jar tzupdater.jar -V`.
- Rename the current zi directory to something like "zi_tzdata2008i" or whatever the version command in step 3 gave.
- Insure this does not conflict with the older data directory.
- Rename the older data directory to zi.
- Validate the change in currently active timezone data by executing `java -jar tzupdater.jar -V`.
- Restart applications on this JDK/JRE.
|
Printable
version
