WebSphere Enterprise Service Bus, Version 6.2.0 Operating Systems: AIX, HP-UX, i5/OS, Linux, Solaris, Windows


Preparing for reinstallation after a failed uninstallation on Windows systems

Learn how to clean a Windows® system if uninstallation of WebSphere® ESB fails. After running the uninstallation program, go through these manual steps to remove registry entries that can prevent you from reinstalling the product into the original directory.

Before you begin

Before performing this procedure, ensure you have uninstalled WebSphere ESB using the uninstallation wizard or silently, and that the procedure was not completed successfully. If the procedure was successful, you do not need to perform this task.

Determine the install_root directory for the product so that you remove the correct product and produce a clean system.

For details on default directory locations see Default installation directories for the product, profiles, and tools.

The installation wizard and the Profile Management Tool let you specify your own locations for installation root directories. Examine the following files to determine the actual locations:
  • The .nifRegistry file identifies the installation root for all installed WebSphere ESB products; it also identifies the installation root for all installed WebSphere Application Server products. It is located as follows:
    • If the user ID that installed the product had administrative privileges, the file is located in the Windows root directory (C:\Windows or C:\WINNT on most Windows systems).
    • If the user ID that installed the product did not have administrative privileges, the file is located in the home directory of that user ID.
  • The install_root\logs\manageprofiles\profile_name_create.log file for a profile identifies the location of that profile. Search on the text profilePath= in this file to obtain the location of the profile.

Uninstalling the product leaves the profile_root directory, including the profile_root\logs directory, where profile_root represents the installation location of the profile. It leaves the install_root\logs directory as well.

About this task

Reinstalling the product into a new directory when files remain from a previous installation can create a coexistence scenario. However, you can delete all files and registry entries to completely remove WebSphere ESB. A clean system lets you reinstall the product into the original directory without coexistence.

Important: Throughout this procedure, steps address removing artifacts left after uninstallation of both WebSphere ESB and WebSphere Application Server or WebSphere Application Server Network Deployment. The WebSphere Application Server product addressed is assumed to be the one underlying the installation of WebSphere ESB.

Perform the following procedure to produce a clean system.

Procedure
  1. Log on as the same user ID who installed the product.
  2. Optional: Verify that you have an Emergency Recovery Disk. Instructions for creating this disk are in the Windows help documentation.

    This step is a safeguard. This procedure does not require the recovery disk.

  3. Optional: Use the regback.exe program from the Windows Resource Kit to back up the registry.

    This step is a safeguard. This procedure does not require the backup copy of the registry.

  4. Delete product registry entries for the WebSphere ESB and WebSphere Application Server products that you uninstalled.

    Invoke regback.exe from a command prompt, to edit the Windows system registry.

    CAUTION:
    Handle the Registry with care. You can easily make a mistake while using the registry 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," to determine whether you should delete each entry. You might not be able to remove all of the entries related to WebSphere ESB and WebSphere Application Server, which is not a problem.
    2. Expand and select keys related to WebSphere ESB and WebSphere Application Server products.
      Delete the following keys if present for the WebSphere Application Server product:
      • HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\MenuOrder\Start Menu2\Programs\IBM WebSphere\Application Server Network Deployment V6.1
      • HKEY_CURRENT_USER\Software\IBM\WebSphere Application Server Network Deployment\6.1.0.0
      • HKEY_LOCAL_MACHINE\Software\IBM\Web server Plug-ins for IBM WebSphere Application Server\6.1.0.0

      Delete the following key if present for the WebSphere Application Server 6.1 Feature Pack for Web Services product: HKEY_CURRENT_USER\Software\IBM\WebSphere Application Server 6.1 Feature Pack for Web Services\6.1.0.9.

      Delete the following keys if present for the WebSphere ESB product:
      • HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\MenuOrder\Start Menu2\Programs\IBM WebSphere\Enterprise Service Bus 6.2
      • HKEY_CURRENT_USER\Software\IBM\WebSphere Enterprise Service Bus\6.2
    3. Select Edit > Delete from the menu bar for each related key.
    4. Select Yes when asked to confirm deletion of the key.
    5. Select Registry > Exit from the menu bar when you are finished.
  5. Delete the installation root directory for the product that you uninstalled.
  6. Using regedit, delete any registry keys of the form HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\IBMWAS61Service that are associated with the installation you uninstalled.
  7. Determine all of the profile directories and remove the directories.
  8. Open a Windows Explorer window and browse to the following directory (where user_id is the user who installed the product): C:\Documents and Settings\user_id\Start Menu\Programs\IBM WebSphere
    If you have only one installation of WebSphere Application Server, delete the following folder if present:
    Application Server V6.1
    
    If you have only one installation of WebSphere Application Server Network Deployment, delete the following folder if it is present:
    Application Server Network Deployment V6.1
    If you have only one installation of WebSphere ESB, delete the following folder if it is present:
    Enterprise Service Bus 6.2
    If you have multiple versions of WebSphere Application Server or WebSphere ESB installed, the folder names will be appended with a number, for example, Application Server Network Deployment V6.1 (2) or Enterprise Service Bus 6.2 (2). In this case, you can use the following procedure to determine which folder or folders to delete:
    1. In Windows Explorer, open C:\Documents and Settings\user_id\Start Menu\Programs\IBM WebSphere\ (where user_id is the user who installed the product).
    2. Open the Application Server V6.1 or Application Server Network Deployment V6.1 folder.
    3. Right-click the Profile Management Tool subfolder and select Properties, then select the Shortcut tab.
    4. Examine the Target property and determine if the Target directory points to the WebSphere Application Server installation that failed to uninstall. If that is the case, delete the Application Server V6.1 or Application Server Network Deployment V6.1 folder.
    5. Repeat steps b through d, but this time for step b start with the Enterprise Service Bus 6.2 subfolder, and for step d, determine if the Target directory points to the WebSphere ESB installation that failed to install.
    6. Repeat steps b through e for each additional set of folders (for example, Application Server Network Deployment V6.1 (2) and Enterprise Service Bus 6.2 (2).
  9. Edit your entries in the .nifRegistry file.
    The .nifRegistry file is located as follows:
    • If the user ID that installed the product had administrative privileges, the file is located in the Windows root directory (C:\Windows or C:\WINNT on most Windows systems).
    • If the user ID that installed the product did not have administrative privileges, the file is located in the home directory of that user ID.

    The .nifRegistry file contains a one-line entry for each WebSphere ESB product installation and each WebSphere Application Server product installation.

    You can delete this file if there is just one line that identifies the product that you removed. Otherwise, use a flat-file editor to remove the line that identifies the installation root directory of the product that you removed. Leave the other lines intact. Do not delete the .nifRegistry file unless you removed all of the installations listed in the file.

  10. Restart your server if a prompt is displayed that directs you to restart.

Results

This procedure results in having a clean system. You can reinstall into the same directories now. A clean system has no trace of a previously deleted installation.

What to do next

After you have cleaned your system, go to Installing the software to choose an installation procedure.


task Task topic

Terms of use | Feedback


Timestamp icon Last updated: 21 June 2010


http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r2mx/topic//com.ibm.websphere.wesb620.doc/doc/tins_uninstall_windows.html
Copyright IBM Corporation 2005, 2010. All Rights Reserved.
This information center is powered by Eclipse technology (http://www.eclipse.org).