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
- Log on as the same user ID who installed the product.
- 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.
- 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.
- 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.
- 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.
- 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
- Select Edit > Delete from the menu bar for each
related key.
- Select Yes when asked to confirm deletion of
the key.
- Select Registry > Exit from the menu bar when
you are finished.
- Delete the installation root directory for the product
that you uninstalled.
- Using regedit, delete
any registry keys of the form HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\IBMWAS61Service that
are associated with the installation you uninstalled.
- Determine all of the profile directories and remove the
directories.
- 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:
- 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).
- Open the Application Server V6.1 or Application
Server Network Deployment V6.1 folder.
- Right-click the Profile Management Tool subfolder
and select Properties, then select the Shortcut tab.
- 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.
- 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.
- 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).
- 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.
- 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.