Technote

(troubleshooting)
Maintenance Installation Fails using GUI installation if directory is missing
Problem(Abstract)
When you apply maintenance (Fix Pack or APAR) to a WebSphere Commerce instance using the GUI installation, it fails.
Symptom In the WC_installdir/logs/update/6.0.0.x-WS-WCServer-XXXXXXXXX.install/updatelog.txt you see this error:

(Sep 7, 2007 4:41:54 PM), Install, com.ibm.ws.install.ni.ismp.actions.InstallNIFMaintenance, msg1, Deploying the WebSphere Commerce instance from /tmp/wcupdate directory.
(Sep 7, 2007 4:42:05 PM), Install, com.ibm.ws.install.ni.ismp.actions.InstallNIFMaintenance, msg1, Failed to deploy the WebSphere Commerce instance from /tmp/wcupdate directory.
(Sep 7, 2007 4:42:05 PM), Install, com.ibm.ws.install.ni.ismp.actions.InstallNIFMaintenance, msg1, For more information, see the log file: "/opt/IBM/WebSphere/CommerceServer60/logs/
update/actions/install/deployear_WC_dev.log".
(Sep 7, 2007 4:42:05 PM), Install, com.ibm.ws.install.ni.ismp.actions.InstallNIFMaintenance, err, IOException
(Sep 7, 2007 4:42:05 PM), Install, com.ibm.ws.install.ni.ismp.actions.InstallNIFMaintenance, err, IOException
(Sep 7, 2007 4:42:05 PM), Install, com.ibm.ws.install.ni.ismp.actions.InstallNIFMaintenance, err, com.ibm.ws.install.ni.framework.NIFException: IOException
at com.ibm.ws.install.ni.ismp.utils.ISMPLogUtils.logException(ISMPLogUtils.java:46)
at com.ibm.ws.install.ni.ismp.actions.InstallNIFMaintenance.execute(InstallNIFMaintenance.java:105)
at com.installshield.wizard.RunnableWizardBeanContext.run(RunnableWizardBeanContext.java:21)
Caused by: java.io.IOException: IOException
at com.ibm.commerce.install.updi.product.wc.
WCDeployEARComponentAction.execute (WCDeployEARComponentAction.java:334)
....
In the WC_installdir/logs/update/actions/install/deployear_WC_dev.log you see this error:

backupEar:

BUILD FAILED
file:/opt/IBM/WebSphere/CommerceServer60/config/deployment/
xml/deployEar.xml:146:
/tmp/wcupdate/WC_dev/properties/version/update not found. Cause The error is caused because the WC_profiledir/properties/version/update directory does not exist.
Previously, ANT would give a warning. However, a change in ANT behavior now causes ANT to give an error. Resolving the problem This problem is resolved in WebSphere Commerce Fix pack 6.0.0.3 or a newer fix pack for version 6.0.0. The newest fix pack can be found on the WebSphere Commerce fixes by version page.

If you cannot upgrade to WebSphere Commerce Fix pack 6.0.0.3 and are required to apply maintenance...

  1. Follow the instructions included in the troubleshooting section at the back of the Fix Pack 6.0.0.3 Installation Guide Appendix A. Troubleshooting -> Problem deploying WebSphere Commerce to delete the files created during the failed installation attempt.

  2. Run the WebSphere Commerce UpdateInstaller again to attempt to install your maintenance on the WebSphere Commerce instance.

  3. When the UpdateInstaller has finished exporting the EAR file and prompts you to continue, first create a directory named update in the temporary directory that is listed in the error.

    For example with this error:
    file:/opt/IBM/WebSphere/CommerceServer60/config/
    deployment/xml/deployEar.xml:146:

    /tmp/wcupdate/WC_demo/properties/version/update not found.

    Create a directory named update in the /tmp/wcupdate/WC_demo/properties/version/ directory.

  4. Return to the UpdateInstaller and accept the prompt to continue with the installation.

Cross Reference information
Segment Product Component Platform Version Edition
Commerce WebSphere Commerce Enterprise Implementation / Usage AIX, i5/OS, Linux, Linux iSeries, Linux pSeries, Linux xSeries, Linux zSeries, Solaris, Windows 6.0, 6.0.0.1, 6.0.0.2
Commerce WebSphere Commerce - Express AIX, i5/OS, Linux, Linux iSeries, Linux pSeries, Linux xSeries, Linux zSeries, Solaris, Windows 6.0, 6.0.0.1, 6.0.0.2
Commerce WebSphere Commerce Professional AIX, i5/OS, Linux, Linux iSeries, Linux pSeries, Linux xSeries, Linux zSeries, Solaris, Windows 6.0, 6.0.0.1, 6.0.0.2
Commerce WebSphere Commerce Developer Enterprise AIX, i5/OS, Linux, Linux iSeries, Linux pSeries, Linux xSeries, Linux zSeries, Solaris, Windows 6.0, 6.0.0.1, 6.0.0.2
Commerce WebSphere Commerce Developer Professional AIX, i5/OS, Linux, Linux iSeries, Linux pSeries, Linux xSeries, Linux zSeries, Solaris, Windows 6.0, 6.0.0.1, 6.0.0.2
Commerce WebSphere Commerce Developer Express AIX, i5/OS, Linux, Linux iSeries, Linux pSeries, Linux xSeries, Linux zSeries, Solaris, Windows 6.0, 6.0.0.1, 6.0.0.2
 

Product Alias/Synonym
wcs wc wcs6 wc6
   

Document Information

Current web document: http://www.ibm.com/support/docview.wss?uid=swg21271127