Uninstalling

Before You Begin

About this task

This chapter explains how to uninstall products using the IBM webMethods Uninstaller. The chapter provides general instructions for uninstalling; your products might require additional instructions. See your product installation guide for product-specific instructions.

Procedure

Shut down all non-IBM applications that are running on the machine from which you are going to uninstall. If these applications are not shut down, the uninstaller will not be able to remove key files that are locked by the operating system.
You must shut down all IBM products you are going to uninstall, as well as all other IBM products that are running in the same installation directory, so the uninstaller can remove key files that are locked by the operating system. For instructions, see the product documentation.
Log on to the machine as the same user that installed the products.
If you are going to uninstall from a Mac OS X or other UNIX system, and the products to uninstall are on a remote machine, do the following:
1. Allow the remote machine to access your local machine’s X11 display. If your local machine is a UNIX system, you can use the command xhost +remote_machine. If your local machine runs a X11 emulation on Windows, you might have to set a property in your emulation software.
2. Log on to the remote machine and set the shell variable DISPLAY to the value of your local machine’s X11 display. For example, if you are using a sh, ksh, or bash shell, you can use export DISPLAY=local_machine:0.0. If you are using a csh or tcsh shell, you can use setenv DISPLAY=local_machine:0.0.
3. When you start the uninstaller GUI (see Start the Uninstaller), start it in the same shell.
Uninstall as many fixes as possible from the products you are going to uninstall. (Not all fixes can be uninstalled.) For instructions, see Using IBM webMethods Update Manager.
If you are going to uninstall all products from the target installation directory, the uninstaller will delete all files from the Software AG_directory/install directory except the logs and the installer-maintained history.txt file. If you want to keep files that are stored in the Software AG_directory/install directory, move the files to a non-IBM directory.
Reboot your system.
The uninstaller does not delete files that were created after you installed your products (for example, user-created or configuration files), nor in most cases does it delete the directory structure that contains the files. You can delete these files and directory structure after uninstallation is complete. If you are going to reinstall into the same directory, you must delete the product directories after uninstallation is complete or, if you want to save the files, move them.

Start the Uninstaller

Edit online

The IBM webMethods Uninstaller was automatically downloaded when you download the IBM webMethods Installer.

The following table explains how to start the IBM webMethods Uninstaller on each supported operating system.

System	Mode	Steps
Windows	GUI	Open the Add or Remove Program or Programs and Features control panel (depending on your operating system) and select the entry for the installation directory that contains the products to uninstall (for example, IBM Products release installation_directory).
Mac OS X or other UNIX	GUI	Open a command window, go to the `Software AG_directory`/bin directory for the installation directory that contains the products uninstall, and run the command `uninstall`.
Mac OS X or other UNIX	Console	Open a command window, go to the `Software AG_directory`/bin directory for the installation directory that contains the products to uninstall, and run the command `uninstall -console`.

The uninstaller looks almost identical to the IBM webMethods Installer. You can change the same logging options that you can change in the installer.

Uninstall Selected Products from Local or Remote Machine

Edit online

Start the uninstaller (see Start the Uninstaller).
On the product selection tree, choose the products to uninstall.
If you choose a product that is required by other products, the uninstaller warns that it will also uninstall those other products. If you do not want the uninstaller to do this, deselect the product that is required by the other products.
Continue through the uninstaller until uninstallation is complete.

Uninstall All Products from Local or Remote Machine with No User Input in GUI Mode

Edit online

Start the uninstaller in GUI mode (see Start the Uninstaller).
On the Welcome panel, click Advanced Options, and then click the Silent tab.
Click the Uninstall all products silently check box.
After all products are uninstalled successfully, by default, the uninstaller exits immediately. If you want the uninstaller to instead display the Finish panel until you choose to exit, select Display Finish panel.
If errors occur while products are being uninstalled, uninstallation fails. By default, the uninstaller shows the errors and does not exit. You can choose instead to Exit immediately or to Display error then exit after number_of_seconds seconds.

Uninstall All Products from Local or Remote Machine with No User Input (Silently) in Console Mode

Edit online

Start the uninstaller in console mode (see Start the Uninstaller). Specify the -readUninstallScript parameter on the command, as follows:

uninstall -readUninstallScript -console

After a script runs successfully, by default, the uninstaller exits immediately. If you want the uninstaller to instead allow you to choose when to exit after the script completes, specify the -scriptNoExit parameter at the end of the command.

If errors occur while a script is running, uninstallation fails. By default, the uninstaller shows the errors and does not exit. If you want the uninstaller to exit immediately with a non-zero exit value, specify the -scriptErrorInteract no parameter at the end of the command. If you want the uninstaller to show the errors and pause for a specified number of seconds before exiting, specify the -scriptErrorInteract number_of_seconds parameter at the end of the command.

Uninstall Using a Script in GUI Mode

Edit online

Start the uninstaller in GUI mode (see Start the Uninstaller). On the Welcome panel, click Advanced Options, and then click the Scripts tab.

The steps you perform to create, edit, and uninstall using a script in GUI mode are the same steps you perform to create, edit, and install using a script in GUI mode (see Install from a Script Using the GUI).

Uninstall Using a Script in Console Mode

Edit online

Create a Script

Edit online

To create an uninstallation script and uninstall products from the local machine, specify the -writeUninstallScript parameter on the command you run to start the uninstaller (see Start the Uninstaller). For example:
```
uninstall -writeUninstallScript full_path_to_new_script_file -console
```
To create an uninstallation script without uninstalling products on the local machine, specify the -editUninstallScript parameter on the command you run to start the uninstaller (see Start the Uninstaller). For example:
```
uninstall -editUninstallScript full_path_to_new_script_file -console
```
To create an uninstallation script using an existing script as a template, specify the -readUninstallScript and -writeUninstallScript parameters on the command you run to start the uninstaller (see Start the Uninstaller). For example:
```
uninstall -readUninstallScript full_path_to_existing_script_file
```
```
-writeUninstallScript full_path_to_new_script_file -console
```

Edit an Existing Script

Edit online

To edit an existing uninstallation script, specify the -editUninstallScript parameter on the command you run to start the uninstaller (see Start the Uninstaller). For example:

uninstall -editUninstallScript full_path_to_existing_script_file -console

Uninstall Using a Script

Edit online

To uninstall on a Windows system, in console mode, using an uninstallation script, enter the command below.

IBM_webMethods_Install_Windows_x64.exe -readUninstallScript full_path_to_existing_script_file 
-installDir full_path_to_installation_directory -debugOut -console

To uninstall on a UNIX system using an uninstallation script, enter the command below.

sh IBMwebMethodsInstalleryyyymm.bin -readUninstallScript full_path_to_existing_script_file

-installDir full_path_to_installation_directory -console

After a script runs successfully, by default, the uninstaller exits immediately. If you want the uninstaller to instead allow you to choose when to exit after the script completes, specify the -scriptNoExit parameter at the end of the command.

If errors occur while a script is running, uninstallation fails. By default, the uninstaller shows the errors and does not exit. If you want the uninstaller to exit immediately with a non-zero exit value, specify the -scriptErrorInteract no parameter at the end of the command. If you want the uninstaller to show the errors and pause for a specified number of seconds before exiting, specify the -scriptErrorInteract number_of_seconds parameter at the end of the command.

Windows Usage Notes

Edit online

The Windows Add or Remove Program or Programs and Features control panel (depending on your operating system) might continue to show the entry for the installation directory that contained the products you uninstalled (for example, IBM Products release installation_directory) for a few minutes after uninstallation while it performs post-installation cleanup.

If you uninstalled from a Windows Vista, 2008, or 7 system, you might see a Program Compatibility Assistant dialog box that says This program might not have uninstalled correctly. Select the option This program uninstalled correctly.