Removing a maintenance package from an instance silently

Complete the following steps to remove a maintenance package from your WebSphere Commerce instance.

Before you begin

  • Identify the WebSphere Commerce instance that contains the maintenance package that you want to remove. If you created the instance after you applied the maintenance package, you cannot uninstall the maintenance package from that instance. Because the instance was created after the maintenance package was applied, the instance was never updated. UPDI does not know that the maintenance package is applied on the instance and the metadata does not indicate an update. In such a case, instead of removing the maintenance package from the instance, you must delete the instance so that you can complete the steps to uninstall the maintenance package.
LinuxAIXNote: Maintenance packages that were installed by the root user must be uninstalled by the root user.

Procedure

  1. Windows Log on with a user ID that is a member of the Windows Administration group.
  2. LinuxAIX Log on.
    • Log on as the root user
      • If you are already signed onto the system, issue the command su - root. Do not use the command su root. This command does not load the necessary root user's profile and environment.
    • Or log on as a non-root user that owns WC_installdir.
  3. For IBM i OS operating system Log on with a user profile that has *SECOFR authority.
  4. Ensure that your WebSphere Commerce administrative server is started.
    For example,
    • If WebSphere Commerce is managed by WebSphere Application Server Deployment Manager (dmgr), start the deployment manager and all node agents. Your cluster can also be started.
    • If WebSphere Commerce is not managed by WebSphere Application Server Deployment Manager (dmgr), start the WebSphere Application Server server1.
    Note: During the removal of maintenance from the WebSphere Commerce instance, the Update Installer stops the WebSphere Commerce application automatically.
  5. Go to the UPDI_installdir/responsefiles directory and open the uninstall.txt file in a text editor. Edit the following lines:
    1. Update the -W backup.package entry with the name of the maintenance package you intend to uninstall.
      For example: 8.0.0-WS-WCServer-FP002.pak.
      Note: If the -W backup.package is not specified, the most recently installed maintenance package is uninstalled.
    2. Update the -W product.location with the location of the WebSphere Commerce installation directory.
    3. Complete one of the following steps.
      • If you are updating a WebSphere Commerce instance, add the following lines to the end of the uninstall.txt file: 
        -W update.instancename="instance_name"
    4. Save the file changes.
  6. For IBM i OS operating system Open the Qshell by typing QSH at the command prompt.
  7. Run one of the following commands from the UPDI_installdir directory:
    • LinuxAIX./update.sh -silent -options UPDI_installdir/responsefiles/uninstall.txt
    • For IBM i OS operating systemupdate -options UPDI_installdir/responsefiles/uninstall.txt
    • Windowsupdate.bat -silent -options UPDI_installdir/responsefiles/uninstall.txt

    WindowsWhen the prompt returns wait for the Java process that is associated with the Update Installer to finish.

  8. Refer to the log files in the following directory to verify that your uninstall was successful: WC_installdir/logs/update/7.0.0-WS-WCServer-FP000X.uninstall/.
  9. Restore the database backup to the point where it was before you applied the maintenance package on the instance.
  10. Complete one of the following steps.
    • If you have a WebSphere Commerce instance, restart the WebSphere Commerce application.

What to do next

If you applied the maintenance package to multiple WebSphere Commerce instances, repeat this process for each instance.