[Version 5.0.2 and later]uninstall command

The uninstall command uninstalls the product. Uninstalling the product also selects the feature uninstaller programs, such as the uninstaller program for the IBM HTTP Server if you installed IBM HTTP Server as a feature of the base product. The uninstaller wizard prompts you to uninstall the embedded messaging feature because other product instances might share the feature.

Before you begin uninstalling the product

If servers are running and security is enabled, the uninstaller program cannot shut down the servers and the uninstall procedure fails Manually stop all servers before uninstalling the product.

Overview of uninstalling the product

The uninstaller wizard displays a panel when it begins. Click Next to begin uninstalling the product when the embedded messaging feature is not installed, or to display a panel with a prompt for uninstalling the embedded messaging feature, if the feature is installed.

If the embedded messaging feature is installed, click the check box to clear the selection and leave the embedded messaging feature installed. You can do this legally only when there is another instance of a WebSphere Application Server product on the machine that also uses the embedded messaging feature and shares the embedded messaging code. Another example of properly retaining the embedded messaging code occurs when migrating to a new version or release of a WebSphere Application Server product that also uses the embedded messaging code.

Leave the check box selected to uninstall the embedded messaging feature.

Click Next to begin uninstalling the product.

Location of the command file[5.0 only]

The command file is located in the install_root/_uninst directory on a Linux or UNIX-based platform, and in the install_root\_uninst directory on a Windows platform on a base product or Network Deployment product system. The command file is located in the install_root/_uninstPME directory on a Linux or UNIX platform. and in the install_root\_uninstPME directory on a Windows platform on an Enterprise system.

The command file is named uninstall for Linux and UNIX-based platforms and Uninstall.exe on Windows platforms. The command file for V5.0.x on Linux for S/390 platforms* is named uninstall.sh. For V5.1 the command file is named uninstall, as it is on other Linux platforms.

*Linux for S/390 platforms refers to the Linux distributions available from Linux distributors that run on IBM eServer zSeries and S/390 systems in 31-bit mode.

Command syntax[5.0 only]

Command parameters are described at the end of this topic. This section describes the recommended command syntax, which starts the Uninstaller wizard.

Command syntax for uninstalling Network Deployment

Uninstalling the base product or Network Deployment when uninstalling Integration Server

You can uninstall the base product or the Network Deployment product when you uninstall the WebSphere Business Integration Server Foundation product, depending on which product the Integration Server is extending. A panel appears that prompts you to uninstall the extended product. If you select to uninstall the product, the uninstaller program removes the product along with the Integration Server. If you select to leave the extended product, the uninstaller program does not remove the product as it uninstalls the Integration Server.

Logging the results of the uninstall procedure

On Linux and UNIX-based platforms, the return code from the uninstaller program is "1" to indicate success; any other response code indicates failure. There is no return code on Windows platforms.

Examine the install_root/logs/uninstlog.txt file to verify that there were no file system or other unusual errors while uninstalling. If there are problems, correct them, and see Uninstalling manually before reinstalling the product.

After uninstalling a WebSphere Application Server product, delete the installation root directory before reinstalling into the same directory. Deleting the old directory avoids invalid XML configurations that result from retaining old files. To delete all files so that you can reinstall with a clean system, see Uninstalling manually.


Related tasks
Uninstalling the product
Uninstalling when the embedded messaging client feature is installed
Uninstalling manually
Related reference
vpd.properties file



Searchable topic ID:   rinsuninst
Last updated: Jun 21, 2007 4:55:42 PM CDT    WebSphere Application Server Network Deployment, Version 5.0.2
http://publib.boulder.ibm.com/infocenter/wasinfo/index.jsp?topic=/com.ibm.websphere.nd.doc/info/ae/ae/rins_uninst.html

Library | Support | Terms of Use | Feedback