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.
Diagnosing The Problem
Common JTZU problems
- JTZU failed to update a single JVM on Windows
- JTZU cannot find JTZU.jar
- JTZU exits with the message 'TimeZone info not found'
- JTZU fails to load a library, either <something>.lib or <something>.a
- JTZU fails to patch a VM, the log reports failure to copy 'TimeZone.class'
- After running JTZU under superuser permissions, a lower-privileged user can not use the SDK or JRE
Obtaining further assistance
Note: IBM SDK, Java Technology Edition versions 7 Release 1, 7, and 6 are no longer supported unless you have an extended support contract with IBM.
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 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:
- 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.
- 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 jtzu@uk.ibm.com.
- The JTZU log file Logfile.log.
- The directory search file DirectorySearch.txt.
- The SDKList.txt file, if present.
- 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.
- 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 |
Related Information
Was this topic helpful?
Document Information
Modified date:
15 November 2022
UID
swg21249759