The following sections describe the process for removing a release that
is partially installed and cannot be removed by using the Add and Remove Programs
tool. The following topics are discussed:
Table 11. Removing a failed installation on Windows
Goal
Where to find information
Remove a failed installation from computer that has
never had IBM Tivoli Monitoring or Candle® OMEGAMON® installed.
Use the following steps to remove a partially installed IBM Tivoli Monitoring installation:
Ensure that there is no entry in the Add and Remove Programs tool for
the component that you attempted to install. If there is an entry, use that
entry to uninstall the product. If there is no entry, proceed to the next
step.
Open the Windows® Explorer and navigate to the IBM Tivoli Monitoring installation
directory (C:\IBM\ITM by default).
Launch the Manage Tivoli Enterprise Monitoring Services utility by double-clicking the KinConfg.exe
file located in either the Install or InstallITM subdirectory.
If any agents, the portal server, or the monitoring server are listed
in the Manage Tivoli Enterprise Monitoring Services window, right-click each and click Advanced > Unconfigure. Repeat this step for all components that are
listed. Close the Manage Tivoli Enterprise Monitoring Services utility.
Open the Windows Control Panel.
Double-click Administrative Tools and then double-click Services.
Verify that all related IBM® Tivoli® Monitoring services have been removed.
These services match those listed in the Manage Tivoli Enterprise Monitoring Services window.
Open the Registry Editor by clicking Start → Run and typing regedt32. Click OK.
Note:
Create a backup of the registry before editing it.
Expand the key HKEY_LOCAL_MACHINE registry key.
Expand the SOFTWARE registry key.
Expand the Candle registry key and record any sub-keys that are present.
If the Candle key does not exist, proceed to step 15.
Expand the OMEGAMON registry key under the Candle key and record
the content of the OMEGAMON key values.
Delete the Candle registry key and all sub-keys.
On Windows XP,
you can right-click the Candle registry key and click Delete.
Close the Registry Editor.
Open the Windows Explorer and find the IBM Tivoli Monitoring
installation location on your system. The default value is C:\IBM\ITM.
Delete this directory and all subdirectories.
Remove the IBM Tivoli Monitoring bookmark from the Start menu:
Click Start from the Windows desktop to display the Start menu
items.
Click Programs.
Right-click IBM Tivoli Monitoring to display the bookmark menu options.
Click Delete to remove the IBM Tivoli Monitoring bookmark from the Windows desktop start menu.
You can now install IBM Tivoli Monitoring.
Removing a failed upgrade
To remove a failed upgrade, first ensure that there is no entry in the
Add and Remove Programs tool for the new component you are attempting to install.
If there is an entry, use that entry to uninstall the product. If there is
no entry, use the following steps to remove the failed upgrade.
The first step to removing a failed upgrade is to determine where the install
failed: either before the files were copied or after the files were copied.
For GUI installations, the files are copied after you click Next on the Start Copying Files window. If you performed a silent installation,
look for a pair of entries separated by a blank line:
FirstUIBefore exiting to file copy
FirstUIAfter entry after file copy
Check to see if the entry for your previous installation exists in the
Add and Remove Programs tool. If it does not exist, follow the instructions
in Removing a failed first time installation. Your previous installation is too corrupt
to use and must be completely removed. You must either completely reinstall
the previous release and then upgrade to IBM Tivoli Monitoring or just install IBM Tivoli Monitoringwithout
attempting to upgrade.
If the entry exists in the Add and Remove Programs tool, you can still
use your existing Candle OMEGAMON installation. Launch Manage Candle Services
to start all components.
Installation failed after files were copied
If your installation failed after the files were copied, your current installation
has been corrupted by the partial installation of IBM Tivoli Monitoring. You must either completely
reinstall the previous release and then upgrade to IBM Tivoli Monitoring or just install IBM Tivoli Monitoring without
attempting to upgrade.
Check the Add and Remove Programs tool to see if either your previously
installed Candle OMEGAMON or IBM Tivoli Monitoring is available.
Neither products are available in the Add and Remove Programs tool
Use the following steps if neither Candle OMEGAMON or IBM Tivoli Monitoring exists in the Add and Remove
Programs tool:
Open the Windows Explorer and navigate to the IBM Tivoli Monitoring installation
directory. By default, the installation location is C:\IBM\ITM\Install, C:\IBM\ITM\InstallITM,
C:\Candle\Install, or C:\Candle\InstallITM.
Launch the Manage Tivoli Enterprise Monitoring Services utility by double-clicking the KinConfg.exe
file located in either the Install or InstallITM subdirectory. Launch the
KinConfg.exe from the InstallITM directory if possible.
If any agents, the portal server, or the monitoring server are listed
in the Manage Tivoli Enterprise Monitoring Services window, right-click each and click Advanced > Unconfigure. Repeat this step for all components that are
listed. Close the Manage Tivoli Enterprise Monitoring Services utility.
Open the Windows Control Panel.
Double-click Administrative Tools and then double-click Services.
Verify that all related Candle OMEGAMON and IBM Tivoli Monitoring services have been removed.
These services match those listed in the Manage Tivoli Enterprise Monitoring Services window.
Open the Registry Editor by clicking Start → Run and typing regedt32. Click OK.
Note:
Create a backup of the registry before editing it.
Expand the key HKEY_LOCAL_MACHINE registry key.
Expand the SOFTWARE registry key.
Expand the Candle registry key and record any sub-keys that are present.
If the Candle key does not exist, proceed to step 14.
Expand the OMEGAMON registry key under the Candle key and record
the content of the OMEGAMON key values.
Delete the Candle registry key and all sub-keys.
On Windows XP,
you can right-click the Candle registry key and click Delete.
Close the Registry Editor.
Open the Windows Explorer and find the Candle OMEGAMON and IBM Tivoli Monitoring installation directories. The default value for Candle OMEGAMON is C:\Candle;
the default value for IBM Tivoli Monitoring is C:\IBM\ITM.
If the entry is still present in the Add and Remove Programs tool, copy
the KINWIINS.VER file (from the \WINDOWS\VERFILES\KINWIINS.VER directory on
the installation CD) to the <itm_installdir>\Install\Ver
directory, where <itm_installdir> is the IBM Tivoli Monitoring
installation directory.
Delete the KINWIINSMSTR.VER file from this directory
if it exists.
Note:
You might need to create the Install\Ver
subdirectory if it is does not exist.
Attempt to uninstall the release again. If it fails again, contact IBM Software
Support for assistance.
Both products are available in the Add and Remove Programs tool
Use the following steps if both the Candle OMEGAMON or IBM Tivoli Monitoring entries exist in the Add
and Remove Programs tool:
Uninstall IBM Tivoli Monitoring through the Add and Remove Programs tool.
Uninstall Candle OMEGAMON through the Add and Remove Programs
tool.