WebSphere 5.0/5.1 update installer fails during update of adapter component
 Technote (troubleshooting)
 
Problem(Abstract)
The IBM® WebSphere® Application Server 5.0/5.1update installer fails during a Fix Pack or cumulative fix installation, while updating the adapter component with the error:

"Result: WASX7017E: Exception received while running file '/opt/WebSphere/DeploymentManager/util/ManualEdit.jacl' ".
 
Cause
The ManualEdit.jacl file uses a file rename command that is implemented through the Java™ method File.renameTo(). This is not guaranteed to work across file systems for all platforms. The file rename is done to move the jdbc-resource-provider-templates.xml file from config/templates/system to properties/version/backup, which can fail if these subdirectories are split onto different file systems for space or high availability reasons.
 
Resolving the problem
ManualEdit.jacl has been changed with APAR PQ95908 to check for failure of the intended file rename operation. However, this APAR cannot be applied individually to fix an existing installation or an existing Fix Pack; it is effective only when included in Fix Packs later than 5.0.2.8 and 5.1.1.2. There is no fix for existing Fix Packs or cumulative fixes because the affected Fix Packs lay down the prior copy of ManualEdit.jacl before invoking it.
If possible, you can avoid the problem by making sure that the subdirectories beneath /WebSphere/AppServer/config/ and /WebSphere/AppServer/properties/ reside on the same file system before applying the Fix Pack in question.

An easier workaround is to attempt the failing Fix Pack once. This produces a jdbc-resource-provider-templates_NEW.xml file in the config/templates/system directory. This file is updated by the Fix Pack.

Create a manual backup of the original jdbc-resource-provider-templates.xml file, then delete the original. Leave the jdbc-resource-provider-templates_NEW.xml file in place, and retry the Fix Pack installation. The installation should complete successfully and skip the update/rename of the deleted xml file.

After the successful update, rename the jdbc-resource-provider-templates_NEW.xml file to the original name, jdbc-resource-provider-templates.xml.
 
 
Cross Reference information
Segment Product Component Platform Version Edition
Application Servers Runtimes for Java Technology Java SDK
 
 


Document Information


Product categories: Software > Application Servers > Distributed Application & Web Servers > WebSphere Application Server > Install
Operating system(s): Windows
Software version: 5.1.1.2
Software edition:
Reference #: 1190022
IBM Group: Software Group
Modified date: Nov 2, 2004