![]() ![]() ![]() ![]() ![]() ![]() ![]() |
The Oracle JRockit Time Zone Updater (TZUpdater) allows you to update installed JDK/JRE images with more recent time zone data to accommodate the U.S. 2007 daylight saving time changes (US2007DST) originating with the U.S. Energy Policy Act of 2005.
Oracle recommends using the latest Oracle JRockit JDK release as the preferred vehicle for delivering both time zone data updates and other product improvements, such as security fixes. If you are unable to use the latest JRockit JDK/JRE update release, this tool provides a route of updating time zone data while leaving other system configuration and dependencies unchanged.
This section contains information on the following subjects:
http://www.oracle.com/technology/software/products/jrockit/index.html
To upgrade a specific Java installation, you need to include the full path to the Java executable of that installation. If tzupdater.jar
is run by just running java -jar...
, or by double-clicking the tzupdater.jar
file, this will invoke Sun’s Java on many systems, which will result in an error message being displayed. The section Example of the Default way of Using TZUpdater explains the typical use of TZUpdater.
A single JDK/JRE image is modified per execution. For administering of multiple JDK/JRE instances, see System-wide Usage.
Prior to running the TZUpdater, you need to stop any running instances of the specific JDK/JRE that you will operate upon.
The TZUpdater modifies and updates the JVM it is run with, thus it is important to run the tool as a command-line application, see Command-line Options Described.
The TZUpdater supports Oracle’s JDK/JRE releases 1.4 or later on all supported platforms.
The command-line interface is the following:
JAVA_HOME/bin/java -jar tzupdater.jar options
If no command-line option is specified, the usage message is displayed. To perform time zone data update, either the -u
or -f
option must be specified, see Table 22-1 for a list of all available command line options.
Keeps backward compatibility with the 3-letter time zone IDs of JDK 1.1. Any time zone IDs that conflict with the JDK 1.1 time zone IDs will be removed from the installed time zone data. See Known Issues for details. This option must be specified with the
-u , -f , or -t option.
|
||
Below is an example of the default way of using the TZUpdater to upgrade time zone data on a Java installation at, for example, /opt/bea/jrockit90_150_06
.
> /opt/bea/jrockit90_150_06/bin/java -jar tzupdater.jar -V
tzupdater version: 1.0.0-b03
JRE time zone data version: tzdata2005n
Embedded time zone data version: tzdata2007a
> /opt/bea/jrockit90_150_06/bin/java -jar tzupdater.jar -u
> /opt/bea/jrockit90_150_06/bin/java -jar tzupdater.jar -V
tzupdater version: 1.0.0-b03
JRE time zone data version: tzdata2007a
Embedded time zone data version: tzdata2007a
The TZUpdater tries to restore the original state when it has encountered an unexpected error, such as lack of disk space. Such errors will generate a TzRuntimeException
.
Stop any running instances of the JDK/JRE that you will operate on before running the TZUpdater for that JDK/JRE.
It is possible for systems to accrete multiple copies of JDK/JRE images, so you might need to apply the tool individually to each JDK/JRE image. Microsoft Windows users can use the desktop search utility to find each image. To locate multiple installed copies of the JDK/JRE on a UNIX derivative system, follow these steps:
/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 for installed Java SE instance, for example, /usr
.
/usr/bin/find DIRPATH -fstype nfs -prune -o -fstype autofs -prune -o -name java -print -exec {} -jar /ABSOLUTEPATH/tzupdater.jar -u ;
where DIRPATH
is a directory path to search for installed Java SE instance, for example, /usr
. Replace ABSOLUTEPATH
with the full pathname to the directory where tzupdater.jar
is expanded.\
Use the command tzinfo
to see which version of TZUpdater you’re using. Enter the command from your JRockit JDK installation directory’s bin\
directory. The system will respond with complete version information; for example, if you entered:
\jrockits\R27.3.0_R27.3.0-45_1.5.0\bin\tzinfo
The system would respond:
java version "1.5.0_10"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_10-b03)
BEA JRockit(R) (build R27.3.0-45-79733-1.5.0_10-20070330-1521-windows-ia32,
compiled mode)
Time zone data version: tzdata2006k
Stop any running instances of the JDK/JRE that you will operate on before running the TZUpdater for that JDK/JRE.
The modifications the current TZUpdater results in can only be manually removed by following these steps:
zi
directory under the modified JAVAHOME/jre/lib
directory. This is the newer data.zi.tzdata*
directory in the same JAVAHOME/jre/lib
directory. This is the replaced, older data.java -jar tzupdater.jar -V
.zi
directory to something like “zi.tzdata2007a
” or whatever the version command in step 3 gave. Make sure that this renaming does not conflict with the older data directory.zi
.java -jar tzupdater.jar -V
.
The tool has a few restrictions due to the TimeZone API and implementation constraints.
![]() ![]() ![]() |