READ ME

Introduction

The tzupdater 1.3.3 tool is provided to allow the updating of installed JDK/JRE images with more recent timezone data in order 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 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 JDK/JRE update release, this tool provides a route of updating timezone data while leaving other system configuration and dependencies unchanged.

This version of the tzupdater tool delivers Olson timezone data version tzdata2007k. 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.3 tool supports HP's JDK/JRE releases 1.4.0 and later (1.4.0, 1.4.1, 1.4.2, 5.0), all updates of those releases, and on all supported platforms. The java.vendor property value must be "Hewlett-Packard Company" or "Compaq Computer Corp."

Installation

Download the tzupdater 1.3.3 tool kit

HP-AXPVMS-TZUPDATER-V0103-3-1.PCSI_SFX_AXPEXE

Execute the

HP-AXPVMS-TZUPDATER-V0103-3-1.PCSI_SFX_AXPEXE
file to get the actual kit files:
HP-AXPVMS-TZUPDATER-V0103-3-1.PCSI$COMPRESSED
HP-AXPVMS-TZUPDATER-V0103-3-1.PCSI$COMPRESSED_ESW

Then do:

$ PRODUCT INSTALL TZUPDATER/NORECOVERY

This will produce:

README.txt
license.txt
tzupdater.jar

The default location is:

SYS$COMMON:[TZUPDATER]

Usage

The tzupdater 1.3.3 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. Write permission on the JDK/JRE directories is needed.

The command line interface is as follows:

$ java -jar "tzupdater.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. We recommend using '-f' option.

Typical Usage

IMPORTANT NOTE: Please read the following before using tzupdater:

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

   $! 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 ensure that these logical names are NOT defined.

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

Before you run tzupdater, set the default to WORLD:RE, as shown in the following example:

Example:

   $! set up to run a specific version of Java, e.g. Java 1.5.0 
   $ @sys$manager:java$150_setup.com Fast 
      
   $! where the tzupdater.jar resides
   $ set default SYS$COMMON:[TZUPDATER]  
      
   $! check dates of current time zone info 
   $ java -jar tzupdater.jar --version
          You will see results like:
              tzupdater version 1.3.3-b01
              JRE time zone data version: unknown
              Embedded time zone data version: tzdata2007k
          
   $! Ensure the default world protection to read+execute
   $ set prot=world:re/def   
      
   $! force update to happen - takes a minute or so...
   $ java -jar tzupdater.jar;1 -f  
      
   $! repeat the check dates of current time zone info 
   $ java -jar tzupdater.jar --version    
          You will see results like:
              tzupdater version 1.3.3-b01
              JRE time zone data version: tzdata2007k
              Embedded time zone data version: tzdata2007k
      
   Before updating other versions of Java, undo the Java environment 
   with the appropriate cancel routine: 
      
   $! Undo Java 1.5.0 logicals
   $ @sys$manager:java$150_cancel_setup.com  

3. (Optional) If you are updating a JRE that was installed as part of another product's installation, you will need to make sure that the new timezone files in this directory tree have the same protection that the original files had.

   Before you run TZupdater, check the protections of the timezone files that will be updated and note their protections.

   $! Check protection of typical timezone file
   $ DIR/SECURE disk$:[directory.java$150.jre.lib.zi]GMT.;

   After you have finished running TZupdater, make sure that new timezone files in this directory tree have the same protection that the original files had. If not, use the following to set them to their original value:

   $ set security /owner=(...) /protection=(...

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

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 zi directory under the modified JAVAHOME/jre/lib directory. This is the newer data.
2. Locate a zi.tzdata* directory in the same JAVAHOME/jre/lib directory. This is the replaced, older data.
3. Obtain the currently installed timezone data version from the command `java -jar "tzupdater.jar" --version`.
4. Rename the current zi directory to something like "zi_tzdata2007k" or whatever the version command in step 3 gave.
5. Insure this does not conflict with the older data directory.
6. Rename the older data directory to zi.
7. Validate the change in currently active timezone data by executing `java -jar "tzupdater.jar" --version`.
8. Restart applications on this JDK/JRE.