This task describes how to uninstall WebSphere Application Server Network Deployment from the root user on a Linux platform or a UNIX-based platform, or from a user ID that belongs to the administrator group on a Windows platform.
Before you begin
IBM Support offers tutorials on various WebSphere Application Server installation topics. See the installation best practices tutorials at the WebSphere education on demand Web site at the http://www.ibm.com/support/docview.wss?rs=180&context=SSEQTP&q1=educationondemand&uid=swg27004762 IBM Web address for more information. One topic describes uninstalling WebSphere Application Server products.
Several factors affect the procedure for uninstalling WebSphere Application Server products:
WebSphere Application Server Network Deployment provides an uninstaller program, which you can call with the uninstall command.
Before issuing the command, locate your particular scenario for uninstalling and follow the recommended procedure. The potential exists for losing the embedded messaging feature code for WebSphere Application Server products that remain on the machine unless you follow the particular procedure. Another possible consequence of not following the correct procedure for uninstalling is losing the configuration of a federated node after migration.
Why and when to perform this task
The uninstaller program removes registry entries, uninstalls the product, and removes all related features and products, such as plug-ins. However, the uninstaller program does not remove some files. The uninstaller program does not delete any configuration files that are changed as the result of selecting installation options, or running Samples, for example. The uninstaller program does not delete log files.Uninstalling products in the proper sequence
Uninstall WebSphere Application Server products in the following sequence when you are uninstalling more than one product:
If you do not have the Network Deployment product installed, open the information center for the base WebSphere Application Server to find recommended procedures for uninstalling unfederated base product nodes.
Planning for time to uninstall The time required to uninstall a product depends on the number of configured servers. The uninstaller program attempts to stop all running servers. As a result, the time required to uninstall is directly proportional to the number of defined servers. The uninstaller program attempts to contact each configured server and waits for a timeout before assuming that a server is not running. Therefore, uninstalling many servers can take several minutes. The uninstaller program can run slightly faster if all servers are running, which avoids waiting for a timeout condition.
Examining logs from the uninstalling operation
The return
code from the uninstaller program is "1" to indicate success; any other
response code indicates failure. Examine the install_root/logs/uninstlog.txt file
and the install_root/logs/WAS.PME.uninst.log file to verify
that no file system or other unusual errors occurred.
Examine the install_root/logs/uninstlog.txt file to verify that no file system or other unusual errors occurred.
Steps for this task
Another scenario involving security is when a federated Application Server is stopped. The uninstall procedure fails because the uninstaller program cannot remove the node from the cell when security is enabled.
For example, if you have a federated base product with the embedded messaging server and client feature installed on the same Linux machine, use the following command from the /opt/WebSphere/AppServer/bin directory to stop the jmsserver process:
./stopServer.sh jmsserver
./stopServer.sh server1 ./stopNode.shIf you have another installation instance of WebSphere Application Server, V5.0.x or V5.1, stop all servers that are running on the other instances too.
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.
./wsinstance.sh -name shasti -host planetlinux -delete
./stopManager.sh
The uninstaller program leaves some log and configuration files that were changed during installation. You can manually uninstall the product to remove all artifacts of the product instance from the platform. This step is required before you can reinstall the product into the same installation root directory.
Results
You can uninstall the product.