An aborted WebSphere UpdateInstaller attempt can corrupt the event.history file and prevent uninstall and/or re-install of failed maintenance.
 Technote (troubleshooting)
 
Problem(Abstract)
An installation of a IBM® WebSphere® Application Server Refresh Pack, Fix Pack or Cumulative Fix that is stopped before completion can cause corruption of the event.history file. This file's corruption can cause failures when trying to uninstall or re-install the failed update.
 
Cause
Due to a problem during the installation of WebSphere V5.1.1 Cumulative Fix 11, the update process may hang and the user may manually stop the process. When the update is attempted again it fails. This particular failure occurred and is noted in the ...selective-install.log and the ...wsexception_install.log. These logs are specific to the maintenance which is being applied, consist of a date/time stamp, and are found in the <WAS_HOME>/logs/update directory.

The error shown in the <date-time>selective-install.log is as follows:

Exception: WUPD0248E: Fix pack update failure: The processing of fix pack was511_cf11_linux, component wsexception failed. See the log file /opt/WebSphere/AppServer/logs/update/20060630_193240_was511_cf11_linux_wsexception_install.log for processing details.

The error shown in the <date-time>wsexception_install.log is as follows:

2006-06-30T15:47:34-04:00 Error 9 -- IOException verifying jar file entries : No such file or directory /tmp/ptfs/was511_cf11_linux/components/wsexception/update.jar
2006-06-30T15:47:34-04:00 java.util.zip.ZipException: No such file or directory /tmp/ptfs/was511_cf11_linux/components/wsexception/update.jar
at java.util.zip.ZipFile.open(Native Method)
at java.util.zip.ZipFile.<init>(ZipFile.java:140)
at java.util.jar.JarFile.<init>(JarFile.java:157)
at java.util.jar.JarFile.<init>(JarFile.java:109)
at com.ibm.websphere.update.delta.Extractor.verifyJarFile(Extractor.java:5000)
at com.ibm.websphere.update.delta.Extractor.basicProcess(Extractor.java:1355)
at com.ibm.websphere.update.delta.Extractor.process(Extractor.java:200)
at com.ibm.websphere.update.ptf.PTFInstaller.runComponentInstall(PTFInstaller.java:816)
at com.ibm.websphere.update.ptf.PTFInstaller.installComponentUpdate(PTFInstaller.java:441)
at com.ibm.websphere.update.ptf.PTFInstaller.installComponentUpdates(PTFInstaller.java:382)
at com.ibm.websphere.update.ptf.PTFInstaller.baseInstall(PTFInstaller.java:319)
at com.ibm.websphere.update.ptf.PTFInstaller.install(PTFInstaller.java:292)
at com.ibm.websphere.update.ptf.PTFBatchUpdater.install(PTFBatchUpdater.java:255)
at com.ibm.websphere.update.ismp.ptf.actions.PTFInstall.install(PTFInstall.java:200)
at com.ibm.websphere.update.ismp.ptf.actions.PTFInstall$1.run(PTFInstall.java:255)
at java.lang.Thread.run(Thread.java:567)

When the user tries to run the uninstall in an attempt to remove a partially installed update, the following message is displayed in the GUI wizard:

Review of the event.history file may show the successful start of the Cumulative fix update, but may be truncated before it is supposed to show a successful closure of the update.

An example from the event.history file, showing the start of the update:
backup-name="/opt/WebSphere/AppServer/properties/version/backup/20060630_193134_PQ97083_acwa_undo.jar"
start-time-stamp="2006-06-30T15:31:34-04:00"
end-time-stamp="2006-06-30T15:31:34-04:00"
result="succeeded"
result-message="Successful uninstall">
</update-event>
</update-event>
<update-event
event-type="ptf"
id="was511_cf11_linux"

From the event.history, the end of the update:

<update-event
event-type="component"
parent-id="was511_cf11_linux"
id="idl"
is-custom="false"
primary-content="update.jar"
update-action="install"
update-type="replace"
is-ext

Note that there is no closing to the update-event or to the event-history XML tags to end the file.

 
Resolving the problem
To resolve the issue, the event.history needs to be cleared of the failed update attempt of Cumulative Fix 11. The last XML tags above the failed attempt should be properly closed and the changes saved so that the end of the event.history looks something like this:
log-name="/opt/WebSphere/AppServer/logs/update/20060630_193134_PQ99966_admin.jmx_uninstall.log"
backup-name="/opt/WebSphere/AppServer/properties/version/backup/20060630_193134_PQ99966_admin.jmx_undo.jar"
start-time-stamp="2006-06-30T15:31:34-04:00"
end-time-stamp="2006-06-30T15:31:34-04:00"
result="succeeded"
result-message="Successful uninstall">
</update-event>
</update-event>
</event-history>

Once the changes are saved the installation of Cumulative Fix 11 may be restarted and should complete successfully.
 
 
Cross Reference information
Segment Product Component Platform Version Edition
Application Servers Runtimes for Java Technology Java SDK
 
Product Alias/Synonym
WUPD0248E
wsexception_install
wsexception
Error 9
 
 
 


Document Information


Product categories: Software > Application Servers > Distributed Application & Web Servers > WebSphere Application Server > Install
Operating system(s): z/OS
Software version: 5.1
Software edition:
Reference #: 1242203
IBM Group: Software Group
Modified date: Jun 7, 2007