IBM Support

IBM Time Zone Update Utility (JTZU): known problems and diagnostic information

Troubleshooting


Problem

Review the list of JTZU known problems and workarounds. If you do not find a solution to your problem, follow the instructions to collect the information that will be needed for further assistance.

Resolving The Problem


JTZU failed to update a single JVM on Windows

  • JTZU patches one of the Java binaries. On Windows systems, binaries that are in use are locked and cannot be updated. If you attempt to use JTZU to patch the SDK or JRE that you are using to run JTZU, JTZU will fail.
    To work around this problem, run JTZU with a different SDK or JRE. If you do not have another SDK or JRE available, duplicate the JRE you are using to run JTZU.



JTZU cannot find JTZU.jar

  • JTZU uses relative path names to find installation files. Try running JTZU from the directory it was installed into.



JTZU exits with the message 'TimeZone info not found'

  • There are two possible reasons for this problem:
    1. JTZU is not installed correctly. There should be a TimeZoneInfo sub-directory within the JTZU installation directory. If the TimeZoneInfo sub-directory is missing, re-install JTZU. Check that your extract tool is set to extract sub-directories.
    2. You are not running JTZU using runjtzu.bat (Microsoft® Windows®) or runjtzu.sh (other platforms). This script sets up the correct environment for JTZU to find the data it needs. Run JTZU using the supplied script.


JTZU fails to load a library, either <something>.lib or <something>.a

  • You are not running JTZU using runjtzu.bat (Microsoft® Windows®) or runjtzu.sh (other platforms). This script sets up the correct environment for JTZU to find the data it needs. Run JTZU using the supplied script.



JTZU fails to patch a VM, the log reports failure to copy 'TimeZone.class'

  • You are not running JTZU using runjtzu.bat (Microsoft® Windows®) or runjtzu.sh (other platforms). This script sets up the correct environment for JTZU to find the data it needs. Run JTZU using the supplied script.



After running JTZU under superuser permissions, a lower-privileged user can not use the SDK or JRE

  • Where JTZU patches SDKs or JREs using the superuser or 'root' account, the updated files are created with the umask of the privileged account. If the umask is secured, the updated files will be inaccessible when using a lower-privileged account. This can stop lower-privileged users from using the Java system.

    To restore the correct ownership, group access, and permissions to the newly patched content, change the permissions to match the parts of the SDK or JRE that were unchanged.

    Alternatively, when performing the patching of JREs, use the user account that owns that JRE instead of patching under the identity of the superuser profile. Where possible, run JTZU under the superuser account to discover all the SDKs and JREs on the system, then partition the SDKList.txt to patch JREs and SDKs using account of the SDK or JRE owner.




Collecting information required for further assistance

To diagnose JTZU problems, obtain the following files from the JTZU directory and email this information to [email protected].

  1. The JTZU log file Logfile.log.
  2. The directory search file DirectorySearch.txt.
  3. The SDKList.txt file, if present.
  4. The JTZU settings file, runjtzuenv.bat (Microsoft® Windows®) or runjtzuenv.sh (other platforms). Copy and paste the contents of this file into the email because batch and script files are often stripped from emails.
  5. The output of java -version, run from the JTZU directory.


Change History
10 Jul 2009 FAQ information moved to JTZU download page or readme file.
20 Aug 2007 Misc. edits. Updated with nzdst07 keyword
11 Mar 2007 Added FAQ about user privileges
05 Mar 2007 Added FAQ about Time Zone data getting smaller
28 Feb 2007 Updated FAQ in response to recent customer queries
24 Jan 2007 More information on discover only mode
23 Jan 2007 Added questions on rebooting, stopping the JVM, and recent IBM acquisitions
20 Dec 2006 Added link to new JTZU presentation
29 Nov 2006 Added info about Western Australia fix; added 32-bit/64-bit question
20 Nov 2006 Updated following internal webcasts
15 Nov 2006 Initial publication

[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSNVBF","label":"Runtimes for Java Technology"},"Component":"DST","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"},{"code":"PF035","label":"z\/OS"}],"Version":"8.0;7.1;7.0;","Edition":"","Line of Business":{"code":"LOB36","label":"IBM Automation"}}]

Document Information

Modified date:
15 November 2022

UID

swg21249759