Manually uninstalling on Windows platforms

This task describes how to uninstall the product on a Windows platform.

Before you begin

Use the following procedure to remove all remnants of a WebSphere Application Server product. This produces a clean system that allows you to reinstall the product. Before you begin, verify that you are removing only the product instance that you intend to remove and not coexisting products, or products that you might have migrated and do not intend to delete. It is important to know the installation root directory for the product instance that you are removing.

Why and when to perform this task

Use this procedure to uninstall WebSphere Application Server products. Uninstall the products in the following sequence when you are uninstalling more than one product:

  1. [5.0 only][Version 5.0.1][Version 5.0.2]WebSphere Application Server Enterprise on Network Deployment
  2. WebSphere Application Server Network Deployment
  3. [5.0 only][Version 5.0.1][Version 5.0.2]WebSphere Application Server Enterprise on the base product
  4. WebSphere Application Server (base product)

This procedure helps you to delete three items that completely remove the WebSphere Application Server product or feature: files, registry entries, and the MSI record (when you have installed the embedded messaging feature). If you are uninstalling in a coexistence environment, registry entries exist only for the installation image that you installed last.

If you are uninstalling any version but the last image that you installed, delete only the file structure for that installation image. You do not need to delete registry entries or the MSI record. If you are using the embedded messaging feature in other product instances on the machine, delete only the file structure for the installation image you are deleting. You do not need to delete the MSI record.

This procedure completely uninstalls the installation root directory for the product. References to the directory are abbreviated install_root in some of the steps.

Steps for this task

  1. Verify that you have an Emergency Recovery Disk. Instructions for creating this disk are in the Windows help documentation.
  2. Use the regback.exe program from the Windows Resource Kit to back up the Registry.
  3. If you have not installed IBM WebSphere MQ as a separate product on this machine, and if you do not have other product instances that are using the embedded messaging feature, verify that the embedded messaging feature has been uninstalled. If you have other instances of WebSphere Application Server products on the same machine, and if they use the embedded messaging feature, do not remove the embedded messaging registry entries or directories.
    1. If you are not using the embedded messaging feature or the WebSphere MQ product on other instances on the machine, use the Add/Remove program to verify if the following programs are still listed:
      IBM WebSphere EMPS
      IBM WebSphere MQ
    2. If either of these programs is still listed, complete the following steps:
      If you have other instances of WebSphere Application Server products on the same machine, and if they use the embedded messaging feature, do not complete these steps to remove the embedded messaging registry entries or directories.
      1. Delete any broker or queue manager defined for WebSphere Application Server.
        • To delete any broker defined for WebSphere Application Server, run the wempsdeletebroker.exe program, if it still exists:
          drive:\IBM\WebSphere MQ\WEMPS\bin\wempsdeletebroker.exe brokername -q

          The -q option deletes the Broker's WebSphere MQ queue manager. For example:

          drive:\IBM\WebSphere MQ\WEMPS\bin\wempsdeletebroker.exe WAS_nodename_server1 -q

        • To delete any Queue Manager defined for WebSphere Application Server, run the dltmqm command, if it still exists:
          drive:\IBM\WebSphere MQ\bin\dltmqm.exe queuemanagername
      2. If you are not using the embedded messaging feature or the WebSphere MQ product on other instances on the machine, use the Add/Remove utility to remove the following programs, if listed:
        IBM WebSphere EMPS
        IBM WebSphere MQ

        If you installed IBM WebSphere MQ as a separate product, do not remove it now. If you have other instances of WebSphere Application Server products on the same machine, and if they use the embedded messaging feature, do not remove the embedded messaging registry entries or directories.

    3. If you are not using the embedded messaging feature or the WebSphere MQ product on other instances on the machine, remove the WebSphere MQ Windows tray icon if it present.

      The MQ Windows tray icon in the lower right corner indicates that a WebSphere MQ process (amqmtbrn.exe) is running. Remove the tray icon to close the process.

      To remove the tray icon, right click the icon and click Hide.

  4. Delete WebSphere Application Server product registry entries only if the instance you are removing was the last instance installed.
    This step is optional in a coexistence environment. Perform this step only if you are removing the image that you last installed.

    If you are not using the embedded messaging feature or the WebSphere MQ product on other instances on the machine, remove any WebSphere Application Server product or feature that appears in the Add/Remove Programs panel, which is available from the Control Panel.

  5. Invoke regedit.exe from a command prompt, to edit the Windows system registry.
    This step is optional in a coexistence environment. Perform this step only if you are removing the image that you last installed.

    Handle the Registry with care: You can easily make a mistake while using the regedit.exe editor to view and edit registry contents. The editor does not warn you of editing errors, which can be extremely dangerous. A corrupt Registry can disrupt your system to the point where your only option is to reinstall the Windows operating system.

    1. Use Ctrl-F to search for all instances of WebSphere, IBM HTTP Server, or IBM MQSeries, to determine whether you should delete each entry. You might not be able to remove all of the entries related to WebSphere Application Server, which is not a problem.
      If you have other instances of WebSphere Application Server products on the same machine, and if they use the embedded messaging feature, do not remove the embedded messaging registry entries or directories.
    2. Expand and select keys related to WebSphere Application Server and its features, IBM HTTP Server, and IBM WebSphere embedded messaging.

      Delete the following keys:

      • [5.0 only][Version 5.0.1][Version 5.0.2]HKEY_LOCAL_MACHINE\ SOFTWARE\ IBM\ HTTP Server\ 1.3.26
      • [5.0 only][Version 5.0.1][Version 5.0.2]HKEY_LOCAL_MACHINE\ SOFTWARE\ IBM\ WebSphere Application Server\ 5.0.x.y, where x and y identify the specific modification and service levels
      • HKEY_LOCAL_MACHINE\ SOFTWARE\ IBM\ WebSphereEmbeddedMessagingPublishAndSubscribe

        If you have other instances of WebSphere Application Server products on the same machine, and if they use the embedded messaging feature, do not remove this embedded messaging registry entry.

      • HKEY_LOCAL_MACHINE\ SOFTWARE\ IBM\ WebSphere Network Deployment\ 5.0.x.0
      • If you have installed IBM WebSphere MQ as a separate product on this machine, or if you have other instances of WebSphere Application Server products on the same machine that use the embedded messaging feature, do not remove the following embedded messaging registry entry: HKEY_LOCAL_MACHINE\ SOFTWARE\ IBM\ MQSeries\ CurrentVersion

    3. Click Edit > Delete from the menu bar for each related key.
    4. Click Yes when asked to confirm deletion of the key.
    5. Click Registry > Exit from the menu bar when you are finished.
  6. Restart the Windows platform.
    Reboot before reinstalling any of the products.
  7. If you have installed IBM WebSphere MQ as a separate product on this machine, or if you have other instances of WebSphere Application Server products on the same machine that use the embedded messaging feature, do not perform this step. If you intend to delete the IBM WebSphere MQ program, or to delete the embedded messaging feature from this machine, use the Microsoft MSI Cleanup Utility to remove MRI records.
    The utility is available from the Microsoft Web site as msicuu.exe. Click on the msicuu.exe file after downloading it, to install the utility. Once installed, the utility appears on the program menu.

    When MSI starts, it lists all products that it knows about. To uninstall using this technique:

    1. Select a product and click Remove to remove its MSI record.
      These WebSphere MQ product entries might be present:
      • IBM WebSphere EMPS
      • IBM WebSphere MQ
      Do not remove the entry for IBM WebSphere MQ if you installed the product separately. If you have other instances of WebSphere Application Server products on the same machine, and if they use the embedded messaging feature, do not remove the embedded messaging registry entries or directories.
  8. Delete the Network Deployment installation root directory, drive:\WebSphere\DeploymentManager, and all subdirectories if it is the installation root directory for the instance you are uninstalling.
  9. Delete the IBM HTTP Server installation root, which is usually in the drive:\Program Files\IBMHttpServer directory by default.
  10. Delete the drive:\IBM\WebSphere MQ\WEMPS directory if there are no other product instances on this machine that are using the embedded messaging feature.
  11. Depending on whether you installed IBM WebSphere MQ as a separate product and whether you installed the embedded messaging feature on any other installation instances on the machine, delete the WebSphere MQ directory.
    If you do not have IBM WebSphere MQ installed as a separate product on this machine and if you do not use the embedded messaging feature on another installation instance on the machine, delete the drive:\IBM\WebSphere MQ directory for the embedded messaging feature.

    If you installed IBM WebSphere MQ as a separate product on this host to use as the messaging provider, and do not want to continue using WebSphere MQ, you can uninstall the product as described in the WebSphere MQ information.

  12. Delete the drive:\Program Files\IBM\gsk7 directory to remove the IBM Key Management utility.
  13. Delete the drive:\WINDOWS\IsUninst.exe file.
  14. Delete the drive:\WINDOWS\gsk7bui.exe file.
  15. Edit the vpd.properties file.

    Do not delete or rename the vpd.properties file because the InstallShield for MultiPlatforms (ISMP) program uses it for other products that it installs.

  16. Restart your machine if you removed the embedded messaging feature.

Results

When you finish, the product is completely uninstalled. You are now ready to reinstall. Reinstalling successfully into the same directory is the final indicator of success in removing the original product.

What to do next

After uninstalling the product, see Installing WebSphere Application Server products to begin planning your next installation.

Related tasks
Uninstalling manually
Uninstalling when the embedded messaging client feature is installed



Searchable topic ID:   tins_uninstallWindows
Last updated: Jun 21, 2007 4:55:42 PM CDT    WebSphere Application Server Network Deployment, Version 5.0.2
http://publib.boulder.ibm.com/infocenter/wasinfo/index.jsp?topic=/com.ibm.websphere.nd.doc/info/ae/ae/tins_uninstallWindows.html

Library | Support | Terms of Use | Feedback