READ ME

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. 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

This tool supports Sun's JDK/JRE 1.3.1 only, including all updates of that release. The java.vendor property value must be "Hewlett-Packard Company" or "Compaq Computer Corp."

This tool operates on the JRE's rt.jar file, and makes a backup copy in jre/lib, named rt.jar.TZbackup or 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.

Note: It is important that the tool is NOT stopped, killed or otherwise interrupted during this processing.

Installation

Download the tzupdater131 1.0.1 tool kit

HP-AXPVMS-TZUPDATER131-V0100--1.PCSI_SFX_AXPEXE

Execute the

HP-AXPVMS-TZUPDATER131-V0100--1.PCSI_SFX_AXPEXE
file to get the actual kit files:
HP-AXPVMS-TZUPDATER131-V0100--1.PCSI$COMPRESSED
HP-AXPVMS-TZUPDATER131-V0100--1.PCSI$COMPRESSED_ESW

Then do:

$ PRODUCT INSTALL TZUPDATER131/NORECOVERY

This will produce:

README.txt
license.txt
tzupdater131.jar

files in the install location -- probably

SYS$COMMON:[TZUPDATER131]

Usage

The tzupdater131 1.0.1 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 tzupdater131 tool against that installed JDK/JRE on-disk image. Write permission on the JDK/JRE directories is needed.

The command line interface is as follows:

$ java -jar "tzupdater131.jar" options

See important note below before using this tool.

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.

Usage: java -jar "tzupdater131.jar" options

Note: update and test options are alternatives, and cannot be performed in the same invocation of this tool.

Typical Usage

IMPORTANT NOTE: Please read the following before using tzupdater:

It is important to identify the kind of disk which contains the release of Java that you are about to operate upon (ODS-5 vs. ODS-2). This can be determined by doing a:

$! See disk and directory where Java was installed
$ type sys$manager:java$150_setup.com
$ show device/full diskname

If it is an ODS-5 disk, then the following logicals must be defined in order to have tzupdater function correctly:

$  DEFINE/JOB DECC$ARGV_PARSE_STYLE ENABLE
$  DEFINE/JOB DECC$EFS_CASE_PRESERVE ENABLE
$  DEFINE/JOB DECC$EFS_CHARSET ENABLE

If the release resides on an ODS-2 formatted disk then these logicals must NOT be defined.

Running the tzupdater:

$! set up to run a specific version of Java
$ @sys$manager:java$131_setup.com Fast

$! set default to where the tzupdate131.jar resides
$ set default SYS$COMMON:[TZUPDATER131]

$! check dates of current time zone info
$ java -jar "tzupdater131.jar" --version

You will see results like:
tzupdater131 version 1.0.1-b03
JRE contains standard TimeZoneData for version: 1.3.1

$ ! force update to happen
$ java -jar "tzupdater131.jar" -f
This will take a minute or so ... and you will see:

Backing up /sys$common/java$131/jre/lib/rt.jar to /sys$common/java$131/jre/lib/rt.jar.TZbackup
Time zone data update is complete.

When tzupdater131 operates it replaces rt.jar in the Java installed directory tree. The new file will have an ownership and protection that are those of the job running tzupdater131. In some cases these ownership and protections will not be the same as the original files had.

$! Fix up protection on new rt.jar file -- check current settings
$ dir sys$common:[java$131...]rt.jar*/secur

You will see something like:

Directory SYS$COMMON:[JAVA$131.JRE.LIB]

RT.JAR;3     [SYSTEM]    (RWED,RWED,RE,)
RT.JAR;2     [SYSTEM]    (RWED,RWED,RE,RE)
RT.JAR;1     [SYSTEM]    (RWED,RWED,RE,RE)

$! Correct protection
$ set security /protection=(W:RE) -
SYS$COMMON:[JAVA$131.JRE.LIB]RT.JAR

$! repeat the check dates of current time zone info
$ java -jar "tzupdater131.jar" -t

You will see:
All tested TimeZones passed.

Error Handling

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.

Time zone display names

This tool will not update time zone display names of time zones that are completely new or have display name related changes. The complete support of all time zone 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 prior to running the tzupdater131 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.

Removing tzupdater Tool Changes

Any executing instances of the JDK/JRE to be operated upon must be stopped prior to running the tzupdater131 tool against that installed JDK/JRE on-disk image.

There does not currently exist, a tzupdater131 modification removal option.

Manually you can undo the update by doing:

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.