Removing a failed installation on Windows

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:

Removing a failed first time installation

Use the following steps to remove a partially installed IBM Tivoli Monitoring installation:

1. 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.
2. Open the Windows® Explorer and navigate to the IBM Tivoli Monitoring installation directory (C:\IBM\ITM by default).
3. Launch the Manage Tivoli Enterprise Monitoring Services utility by double-clicking the KinConfg.exe file located in either the Install or InstallITM subdirectory.
4. 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.
5. Open the Windows Control Panel.
6. Double-click Administrative Tools and then double-click Services.
7. Verify that all related IBM® Tivoli® Monitoring services have been removed. These services match those listed in the Manage Tivoli Enterprise Monitoring Services window.
8. Open the Registry Editor by clicking Start → Run and typing regedt32. Click OK.
   Note:
   Create a backup of the registry before editing it.
9. Expand the key HKEY_LOCAL_MACHINE registry key.
10. Expand the SOFTWARE registry key.
11. Expand the Candle registry key and record any sub-keys that are present. If the Candle key does not exist, proceed to step 15.
12. Expand the OMEGAMON registry key under the Candle key and record the content of the OMEGAMON key values.
13. Delete the Candle registry key and all sub-keys.

    On Windows XP, you can right-click the Candle registry key and click Delete.

14. Close the Registry Editor.
15. Open the Windows Explorer and find the IBM Tivoli Monitoring installation location on your system. The default value is C:\IBM\ITM.
16. Delete this directory and all subdirectories.
17. Remove the IBM Tivoli Monitoring bookmark from the Start menu:
    1. Click Start from the Windows desktop to display the Start menu items.
    2. Click Programs.
    3. Right-click IBM Tivoli Monitoring to display the bookmark menu options.
    4. 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 

If neither exist, then the installation failed before the files were copied. See Installation failed before files were copied.

If both entries exist, the installation failed after the files were copied. See Installation failed after files were copied

Installation failed before files were copied

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.

If neither are available, see Neither products are available in the Add and Remove Programs tool.

If one is available see One product is available in the Add and Remove Programs tool.

If both are available, Both products are available in the Add and Remove Programs tool.

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:

1. 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.
2. 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.
3. 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.
4. Open the Windows Control Panel.
5. Double-click Administrative Tools and then double-click Services.
6. 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.
7. Open the Registry Editor by clicking Start → Run and typing regedt32. Click OK.
   Note:
   Create a backup of the registry before editing it.
8. Expand the key HKEY_LOCAL_MACHINE registry key.
9. Expand the SOFTWARE registry key.
10. Expand the Candle registry key and record any sub-keys that are present. If the Candle key does not exist, proceed to step 14.
11. Expand the OMEGAMON registry key under the Candle key and record the content of the OMEGAMON key values.
12. Delete the Candle registry key and all sub-keys.

    On Windows XP, you can right-click the Candle registry key and click Delete.

13. Close the Registry Editor.
14. 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.
15. Delete this directory and all subdirectories.
16. Use the steps in Verifying the uninstallation to verify that you successfully removed the failed upgrade.
17. Remove the IBM Tivoli Monitoring bookmark from the Start menu:
    1. Click Start from the Windows desktop to display the Start menu items.
    2. Click Programs.
    3. Right-click IBM Tivoli Monitoring to display the bookmark menu options.
    4. Click Delete to remove the IBM Tivoli Monitoring bookmark from the Windows desktop start menu.

One product is available in the Add and Remove Programs tool

Use the following steps if an entry for either Candle OMEGAMON or IBM Tivoli Monitoring exists in the Add and Remove Programs tool:

1. Attempt to uninstall both releases from the Add and Remove Programs entry.
2. If this is successful, proceed to Verifying the uninstallation.
3. If this is not successful and the entry has been removed from the Add and Remove Programs tool, see Neither products are available in the Add and Remove Programs tool.
4. 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.
5. 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:

1. Uninstall IBM Tivoli Monitoring through the Add and Remove Programs tool.
2. Uninstall Candle OMEGAMON through the Add and Remove Programs tool.
3. Proceed to Verifying the uninstallation.

Verifying the uninstallation

Use the following steps to verify that you successfully removed the failed installation:

1. Verify that the installation home directory and all contents have been removed.
2. Open the Registry Editor by clicking Start → Run and typing regedt32. Click OK.
3. Expand the key HKEY_LOCAL_MACHINE registry key.
4. Expand the SOFTWARE registry key.
5. Verify that the Candle registry key and all sub-keys have been removed from HKEY_LOCAL_MACHINE\SOFTWARE.

You are now ready to install IBM Tivoli Monitoring.

[ Top of Page | Previous Page | Next Page | Contents | Index ]