Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
HP.com home

READ ME

JDK TZupdater131 1.0.1 for the Tru64™ UNIX® Operating System

for the Java™ Platform

» 

Java on Alpha

Site information

» Products
» Downloads
» Solutions
» Documentation
» FAQs
» Support

Performance and related products

» Fast VM paper
» Swift Compiler

Promotions

» Test Drive
» DSPP Partner Edge

Related links

» Software
» Java on HP-UX
» Java on NonStop
» Visual Threads
» Systems
» HP Alpha
» HP OpenVMS
» HP-UX
» NonStop
 
 
 
Content starts here

Introduction
The TZupdater131 1.0.1 tool is provided to allow the updating of installed JDK/JRE images with more recent timezone data in order to accommodate the U.S. 2007 daylight saving time changes (US2007DST) originating with the "U.S. Energy Policy Act of 2005."

HP recommends utilizing 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 route of updating timezone data while leaving other system configuration and dependencies unchanged.

This version of the TZupdater131 tool delivers Olson data tz2007a. For information about the time zone changes and the TZupdater131 tool, please visit http://h18012.www1.hp.com/java/alpha/DST-US.html.

System Requirements

The TZupdater131 1.0.1 tool supports HP's Tru64 UNIX JDK/JRE release 1.3.1. The java.vendor property value must be "Hewlett-Packard Company" or "Compaq Computer Corp."

Installation

Download the tool bundle tzupdater131_1.0.tar from the HP Tru64 UNIX Java Technology site and extract the files from tzupdater131_1.0.tar.

Note : This version supersedes any previous versions.

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 tzupdater.jar options

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.

-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 time zone 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.
-t, --test

Run verification tests only and exit. If the JRE has time zone data that doesn't match the one in the tool, the verification tests report errors and fails. The -f option is ignored if specified.

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. Locating multiple installed copies of the JDK/JRE on HPUX systems is shown below:

  1. Find locally installed JDK/JRE instances:
    /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 under for installed Java
    SE instance, for instance /usr.

  2. Automate updating of locally installed instances:
    /usr/bin/find DIRPATH -fstype nfs -prune -o -fstype autofs -prine -o -name java -print -exec {} -jar /ABSOLUTEPATH/tzupdater131.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 tzupdater131.jar is expanded into.

It is recommended to double check the JDK/JRE instances installation before running the automated updating.

Removing TZupdater131 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. The modifications the current TZupdater131 tool results in can be manually removed by following these steps:

  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.
Printable version Java and all Java-based marks are trademarks or registered trademarks of Sun Microsystems, Inc., in the U.S. and other countries.
Privacy statement Using this site means you accept its terms Feedback to Java on Alpha
© 2007 Hewlett-Packard Development Company, L.P.