Troubleshooting: Errors when uninstalling the fix pack from the WebSphere Commerce instance

NIFException error is logged when you are uninstalling the fix pack from a WebSphere Commerce instance.

Problem

Viewing the log file:
  • WC_installdir/logs/update/maintenance_name/uninstall/updatetrace.log
You see an error message similar to:
(Sep 22, 2010 3:29:35 PM), Install, com.ibm.ws.install.ni.ismp.actions.
InstallNIFPackage, 
err, Failed to delete: zip:///D:/WebSphere/CommerceServer70/instances/demo/
properties/version/update/backup/7.0.0-WS-WCServer-FP00X.pak
(Sep 22, 2010 3:29:35 PM), Install, com.ibm.ws.install.ni.ismp.actions.
InstallNIFPackage, 
err, Failed to delete: zip:///D:/WebSphere/CommerceServer70/instances/demo/
properties/version/update/backup/7.0.0-WS-WCServer-FP00X.pak
(Sep 22, 2010 3:29:35 PM), Install, com.ibm.ws.install.ni.ismp.actions.
InstallNIFPackage, 
err, com.ibm.ws.install.ni.framework.NIFException: Failed to delete: 
zip:///D:/WebSphere/CommerceServer70/instances/demo/properties/version/update
/backup/7.0.0-WS-WCServer-FP00X.pak
       at com.ibm.ws.install.ni.framework.install.NIFPackageApplicationPlugin.
performUpgrade(NIFPackageApplicationPlugin.java:540)
       at com.ibm.ws.install.ni.framework.install.NIFPackageApplicationPlugin.
executeInBackwardCompatibleMode(NIFPackageApplicationPlugin.java:207)
       at com.ibm.ws.install.ni.framework.install.NIFPackageApplicationPlugin.
execute(NIFPackageApplicationPlugin.java:81)
       at com.ibm.ws.install.ni.framework.maintenanceplugins.
FixpackApplicationPlugin.execute(FixpackApplicationPlugin.java:81)
       at com.ibm.ws.install.ni.ismp.actions.InstallNIFPackage.execute
(InstallNIFPackage.java:107)
       at com.installshield.wizard.RunnableWizardBeanContext.run
(RunnableWizardBeanContext.java:20)
where X is the number of the fix pack installed.

Solution

If you receive this message, the uninstall has removed the fix pack from the instance, but has not been able to remove the backup files. To remove the backup files, complete the following steps:
  1. Remove the following file:
    • SolarisLinuxAIXWindowsWC_installdir/instances/instance_name/properties/version/update/backup/maintenance_name.pak
    • For IBM i OS operating systemWC_userdir/instances/instance_name/properties/version/update/backup/maintenance_name.pak
  2. Modify the following file:
    • SolarisLinuxAIXWindowsWC_installdir/instances/instance_name/properties/version/update/backup/NIFStack.xml
    • For IBM i OS operating systemWC_userdir/instances/instance_name/properties/version/update/backup/NIFStack.xml

    Remove the maintenance section from the NIFStack.xml file. An example of the section is shown here:

        <maintenance name="WebSphere Commerce 7.0.0.X" order="0">
        <param name="features" value="commerceear;update"/>
        <param name="wasinstalledasmaintenance" value="true"/>
        <param name="packagetype" value="NA"/>
        <param name="wasinstalledasprimary" value="true"/>
        <param name="uninstallablebyupdi" value="true"/>
        <param name="filename" value="7.0.0-WS-WCServer-FP00X.pak"/>
        <param name="info" value="WebSphere Commerce 7.0.0.X"/>
        <param name="hasprofileupdates" value="false"/>
        <param name="supercedesapars" value=""/>
        <param name="supercedes" value=""/>
        <param name="builddate" value="2010/09/26"/>
        <param name="autouninstallable" value="false"/>
        <param name="iscopyjdkrequired" value="false"/>
        <param name="isbackuppackage" value="false"/>
        <param name="apars" value="IY79965;IY83748;IY83823;IY83995;IY84162;
IY84389;IY84484;IY84567;IY85030;IY85033;IY85037;IY85624;IY85929;IY86088;
IY86468;IY86472;IY86715;IY86766;IY86769;IY87038;IY88549;IY89093;IY89489;
JR22709;JR23657;JR23680;JR23688;JR23695;JR23771;JR23844;JR24147;JR24205;
JR24243;JR24312;JR24336;JR24385;JR24681;LI71252;LI71288;LI71315;LI71375;
SI23474;SI23474;"/>
        <param name="isofficialfix" value="true"/>
        <param name="targetsubproductids" value="wc.server.be"/>
        <param name="targetproductids" value="wc.server.be"/>
    </maintenance>
    where X is the number of the fix pack installed.
  3. WindowsModify the C:\Windows\.nifregistry file and remove the entry that contains the fix pack backup file for the instance. For example, you would remove the following entry: 
        <pak installrooturi="file:///D:/WEBSPH~1/COMMER~1/" name="WebSphere 
Commerce 7.0.0.X" paklocationuri="zip:///D:/WebSphere/CommerceServer70/
instances/demo/properties/version/update/backup/7.0.0-WS-WCServer-FP00X.pak" 
product />
    where X is the number of the fix pack installed.