Social Applications
Networks
Knowledge Base
Support
|
C-Level Executives
Other Roles
|
Support
Education
Partner
Other Tasks
|
The TZUpdater tool is provided to allow you to update installed Java Development Kit (JDK) and Java Runtime Environment (JRE) software with more recent timezone data, to accommodate daylight saving time (DST) changes in different countries.
Oracle recommends that you use the latest Oracle Java SE platform JDK or JRE update release as the preferred means of delivering both timezone data updates and other product improvements, such as security fixes. To see which JDK or JRE update release incorporates the updated timezone data for your locale, see Timezone Data Versions in the JRE Software. However, if you are unable to use Oracle's latest JDK or JRE update release, the TZUpdater tool provides a means of updating timezone data while leaving other system configuration and dependencies unchanged.
The TZUpdater tool supports JDK/JRE version 1.4.0 and later releases (1.4.0, 1.4.1,1.4.2, 5.0, 6, and 7), all updates of those releases, and on all supported platforms.The java.vendor
property value must be Sun Microsystems Inc
. or Oracle Corporation
or BEA Systems,Inc.
If you have already run a previous version of the TZUpdater tool on your JDK/JRE software, you do not need to apply this version of the tool, unless your system requires the specific bug fixes described in Release History table.
Download the TZUpdater tool bundle archive and unzip it into an appropriate directory.
The TZUpdater tool modifies the JDK/JRE software instance that is used to execute the tool. A single image of the JDK/JRE software is modified per execution. To administer the tool to multiple instances of the JDK/JRE software, see the section Systemwide Usage.
You must stop any running instances of the JDK/JRE software to be operated upon before you run the TZUpdater tool on that installed JDK/JRE software image.
Run the TZUpdater tool with the following command:
java -jar tzupdater.jar |
To update timezone data successfully, you should ensure that you have sufficient privileges to modify the JDK_HOME
/jre/lib
or JRE_HOME
/lib
directory. If you do not have sufficient priviledges to modify these directories, contact your system administrator.
If you do not specify any options, the usage message is displayed. To update the timezone data, specify either the -u
or -f
option.
Option | Description |
---|---|
-h, --help | Print the usage to stdout and exit. Other options are ignored if you specify this option. |
-V, --version | Show the tool version number and the tzdata version numbers of the JRE software and the archive embedded in the JAR file and exit. |
-u, --update | Update the time zone data and perform verification tests. You can run the verification tests separately with the -t option. If you specify the -h , -t , or -V options, the command displays the usage to stdout and exits. |
Force update the tzdata even if the version of the tzdata archive is older than the JRE software's tzdata version. This option does not require the -u option to perform the update. This option is not needed under normal operating conditions. | |
-v, --verbose | Display detailed messages to stdout . |
-bc, --backwardcompatible | Keep backward compatibility with the JDK version 1.1 three-letter timezone IDs, "MST," EST,"and "HST." Any timezone IDs that conflict with the JDK version 1.1 timezone IDs will be removed from the installed timezone data. You must specify the -bc option with the -u , -f or -t option. |
-t, --test | Run verification tests only and exit. If the JRE has timezone data that does not match the data in the tool, the verification tests report errors and fail. The -f option is ignored if specified. If you specify the -bc option, any test cases for timezone IDs that conflict with the JDK version 1.1timezone IDs will be ignored. |
The tool tries to restore the original state when it has encountered an unexpected error, such as lack of disk space.
The following table lists the updates made to the TZUpdater tool. The latest version of TZupdater tool can be found at Timezone Data Versions in the JRE Software
Bug ID | Sypnosis | TZUpdater Version |
---|---|---|
Embed tzdata2011n into the TZupdater tool | 1.3.45 | |
Embed tzdata2011m into the TZupdater tool | 1.3.44 | |
Embed tzdata2011l into the TZupdater tool | 1.3.43 | |
Embed tzdata2011k into the TZupdater tool | 1.3.42 | |
Embed tzdata2011i into the TZupdater tool | 1.3.41 | |
Embed tzdata2011h into the TZupdater tool | 1.3.40 | |
Embed tzdata2011g into the TZupdater tool | 1.3.39 | |
Embed tzdata2011e into the TZupdater tool | 1.3.38 | |
Embed tzdata2011d into the TZupdater tool | 1.3.37 | |
Embed tzdata2011c into the TZupdater tool | 1.3.36 | |
Embed tzdata2011b into the TZupdater tool | 1.3.35 | |
Embed tzdata2010o into the TZupdater tool | 1.3.34 | |
Embed tzdata2010l into the TZupdater tool. | 1.3.33 | |
Embed tzdata2010k into the TZupdater tool | 1.3.32 | |
Embed tzdata2010i into the TZupdater tool. | 1.3.31 | |
Embed tzdata2010h into the TZupdater tool | 1.3.30 | |
Embed tzdata2010f into the TZupdater tool. | 1.3.29 | |
Embed tzdata2010e into the TZupdater tool | 1.3.28 | |
Embed tzdata2010c into the TZupdater tool. | 1.3.27 | |
Embed tzdata2010b into the TZupdater tool. | 1.3.26 | |
Embed tzdata2009u into the TZupdater tool. | 1.3.25 | |
Embed tzdata2009s into the TZupdater tool. | 1.3.24 | |
Embed tzdata2009r into the TZupdater tool. | 1.3.23 | |
Embed tzdata2009q into the TZupdater tool. | 1.3.22 | |
Embed tzdata2009p into the TZupdater tool. | 1.3.21 | |
Embed tzdata2009m into the TZupdater tool. | 1.3.20 | |
Embed tzdata2009l into the TZupdater tool. | 1.3.19 | |
Embed tzdata2009k into the TZupdater tool. | 1.3.18 | |
Embed tzdata2009j into the TZupdater tool. | 1.3.17 | |
Embed tzdata2009i into the TZupdater tool. | 1.3.16 | |
Embed tzdata2009g into the TZupdater tool. | 1.3.15 | |
Embed tzdata2009f into the TZUpdater tool. | 1.3.14 | |
Embed tzdata2009e into the TZUpdater tool. | 1.3.13 | |
Embed tzdata2009a into the TZUpdater tool. | 1.3.12 | |
Embed tzdata2008i into the TZUpdater tool. | 1.3.11 | |
Embed tzdata2008h into the TZUpdater tool. | 1.3.10 | |
Embed tzdata2008g into the TZUpdater tool. | 1.3.9 | |
Embed tzdata2008f into the TZUpdater tool. | 1.3.8 | |
Embed tzdata2008e into the TZUpdater tool. | 1.3.7 | |
Embed tzdata2008c into the TZUpdater tool. | 1.3.6 | |
Embed tzdata2008b into the TZUpdater tool. | 1.3.5 | |
Embed tzdata2007k into the TZUpdater tool. | 1.3.3 | |
Embed tzdata2007j into the TZUpdater tool. | 1.3.2 | |
Embed tzdata2007i into the TZUpdater tool. | 1.3.1 | |
Embed tzdata2007h into the TZUpdater tool. | 1.3.0 | |
TZUpdater tool fails to update package metadata database if identical file entries exist in one package. | 1.3.0 | |
Embed tzdata2007g * into the TZUpdater tool. | 1.2.2 | |
Embed tzdata2007f into the TZUpdater tool. | 1.2.1 | |
Embed tzdata2007e into the TZUpdater tool. | 1.2.0 | |
TimezoneUpdater.extract(File, InputStream) fails if the first entry is a file, not a directory. | 1.2.0 | |
TZUpdater build system depends on path specific to Solaris. | 1.2.0 | |
TZUpdater 1.1.0 loops and takes a great deal of time to complete. | 1.2.0 | |
Java DST TZUpdater Breaks Solaris 10 Local Zone Creation. | 1.1.0 | |
TZUpdater makefile needs to name zip file with version number. | 1.1.0 | |
Embed tzdata2007c into the TZUpdater tool. | 1.1.0 | |
Embed tzdata2007a into the TZUpdater tool. | 1.0.1 | |
The tool has a few restrictions due to the TimeZone API and implementation constraints.
java.util.TimeZone.getAvailableIDs(int)
will return values based on the future GMT offset, namely that which will be valid after January 1, 2008. java.util.TimeZone.getAvailableIDs(int)
will return values based on the future GMT offset, namely the one that will be valid after November 4. Using JRE software that has been updated with tzdata2007g, a call to the method java.util.TimeZone.getAvailableIDs(-18000000)
will include return values of Vincenes and Petersburg even though this only becomes correct after the changeover on Nov 4th. -f -bc
options. See Sun Alert 102836 for Java and Background Overview on Sun Alert 102836. /usr/bin/find |
DIRPATH
is a directory path to search under for installed instances of the Java SE platform, for example, /usr
. /usr/bin/find |
DIRPATH
is a directory path to search under for installed instances of the Java SE platform, for example, /usr
. ABSOLUTEPATH
should be replaced with the full path name to the directory into which tzupdater.jar
is expanded. umask
settings on Solaris umask
. A default umask
of 022 should be used for running the TZudpater tool. A more restrictive umask
such as umask 077
will mean files created by the tool are unreadable by other users.TZUpdater is a pure Java tool that does not address platform-specific software management issues. For example, on a Windows system, this means that the additional and backup files created by the tool will not be removed during an uninstall. To uninstall updated JRE software, check the JRE software's install directory and remove it manually once the uninstaller completes.
For Solaris systems, where the JRE software being updated exists as a Solaris package (such as in /usr/j2se
or /usr/jdk/
instances), this has meant that the pkgchk
command would highlight the changes as errors or inconsistencies. Starting with version 1.1.0 of TZUpdater, the tool runs an additional series of package management commands that updates the package database where appropriate.
On a Solaris 10 system where existing package-based JRE software has been updated by the initial release of TZUpdater, and zones have been created, the zones will contain the same pkgchk
errors as the global zone. During zone creation, these pkgchk
errors will be highlighted at the end of the zone installation command.
To resolve Solaris package database errors, take the following steps. However, if you are not running on a Solaris 10 system or your system does not have zones, only step 1 is required. If the system is a Solaris 10 system with additional zones, run step 1 only in the global zone and follow steps 2 and 3.
Run the current version of TZUpdater, with the -f force
option to reapply the timezone update to a previously updated JRE software instance. The update will take place, and the additional package resolution commands will be executed. The update must be executed as the root user and is relevant to the global zone only in a Solaris 10 system.
pkg_resolve.sh
script from the tzupdater.jar
file : /bin/jar xf tzupdater.jar pkg_resolve.sh |
/bin/ksh ./pkg_resolve.sh |
/bin/ksh ./pkg_resolve.sh /usr/jdk/instances/jdk1.5.0/bin/java |
NOTE: The update to the package system removes many files from the package database and reinserts them, so it can take up to 15 minutes.
You must stop any running instances of the JDK/JRE software to be operated upon before you run the TZupdater tool on that installed JDK/JRE software image.
There is currently no option to remove TZUpdater modifications. By following these steps, you can manually remove the modifications made by the current TZUpdater tool:
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.tzdata2007g
, or whatever version was given by the command in step 3. Ensure this does not conflict with the older data directory.zi
.java -jar tzupdater.jar -V
.The following links point to information provided by Oracle Corporation relating to timezones and DST changes and how they affect the Java platform and other Oracle products:
The following external links provide general information about timezones and DST:
Popular Downloads | ||
|