Manually uninstalling on Linux platforms

This task describes uninstalling the product on Linux platforms.

Before you begin

Use the following procedure to remove all remnants of a WebSphere Application Server product. This produces a clean system that allows you to reinstall the product. Before you begin, verify that you are removing only the product instance that you intend to remove and not coexisting products, or products that you might have migrated and do not intend to delete. It is important to know the installation root directory for the product instance that you are removing.

Why and when to perform this task

Use this procedure to uninstall WebSphere Application Server products. Uninstall the products in the following sequence when you are uninstalling more than one product:

  1. [5.0 only][Version 5.0.1][Version 5.0.2]WebSphere Application Server Enterprise on Network Deployment
  2. WebSphere Application Server Network Deployment
  3. [5.0 only][Version 5.0.1][Version 5.0.2]WebSphere Application Server Enterprise on the base product
  4. WebSphere Application Server (base product)

One of the ways that this procedure completely uninstalls the product is by completely deleting the installation root directory for the product. References to the directory are abbreviated install_root in some of the steps. The default install_root for WebSphere Application Server is the /opt/WebSphere/AppServer directory.

The default directory for IBM HTTP Server is /opt/IBMHttpServer.

[5.0 only][Version 5.0.1][Version 5.0.2]Default installation roots for the Enterprise product are:

Steps for this task

  1. Use the kill -9 java_pid command to kill each Java process that is running.

    If there are Java processes running that are not related to WebSphere Application Server products, and it is not possible to stop them, stop all WebSphere Application Server product-related processes. Use the following command to determine all processes that are running:

    ps -ef | grep java
    Stop all WebSphere Application Server-related processes with the kill -9 java_pid_1 java_pid_2...java_pid_n command.

    Use the killall -9 java command to kill all Java processes that are running, if necessary.

  2. Halt any running WebSphere MQ queue managers.
    1. Type dspmq to show the state of any queue managers.
    2. Type endmqm -i for each running queue manager.
    3. Type $ ipcs -a to check for any IPCs.
    4. Type $ ipcrm -[qms] [ID] to delete the IPCs.
  3. Type kill -9 amq_pid_1 amq_pid_2 ... amq_pid_n to stop any MQ processes that are running.
    You can use a ps -e | grep #AMQ_COMMAND#' command structure to specify the command for amq to find each amq pid.
  4. Search for related packages.
    Type these commands to search for related packages:
    • rpm -qa | grep WS to show packages for the WebSphere Application Server products and the IBM HTTP Server product
    • rpm -qa | grep MQ to show packages related to the embedded messaging feature or to IBM WebSphere MQ
    • rpm -qa | grep wemps to show packages related to the embedded messaging feature or to IBM WebSphere MQ

    Do not remove packages for WebSphere Application Server products that you are not uninstalling. Generally, you can identify packages that belong to V5.1 by the 51 on the end of WSB packages and WSN packages. However, WSBM and WSNM packages are for the embedded messaging feature and do not include the 51 on the end as an identifier.

    Do not remove IBM WebSphere MQ packages if you have installed IBM WebSphere MQ as a separate product.

    Do not remove embedded messaging packages if you intend to leave the embedded messaging feature installed on the machine.

  5. If there are packages to delete, type rpm -e packagename to remove any WebSphere Application Server-related packages for the product you are uninstalling.

    You can remove more than one package with the following command:

    rpm -qa | grep package_prefix | xargs rpm -e
    However you should verify that everything in the list is something you want to remove before adding | xargs rpm -e to the command.

    If you do intend to remove WebSphere MQ or embedded messaging packages, include them in the commands you are running to remove packages. For example, run these commands as root:

    rpm -e MQSeriesClient-5.3.0-1
    rpm -e MQSeriesMsg_Zh_CN-5.3.0-1
    rpm -e MQSeriesMsg_Zh_TW-5.3.0-1
    rpm -e MQSeriesMsg_de-5.3.0-1
    rpm -e MQSeriesMsg_es-5.3.0-1
    rpm -e MQSeriesMsg_fr-5.3.0-1
    rpm -e MQSeriesMsg_it-5.3.0-1
    rpm -e MQSeriesMsg_ja-5.3.0-1
    rpm -e MQSeriesMsg_ko-5.3.0-1
    rpm -e MQSeriesMsg_pt-5.3.0-1
    rpm -e MQSeriesRuntime-5.3.0-1
    rpm -e MQSeriesSDK-5.3.0-1
    rpm -e MQSeriesJava-5.3.0-1
    rpm -e MQSeriesServer-5.3.0-1
    rpm -e MQSeriesJava-5.3.0-1
    rpm -e wemps-runtime-2.1.0-0
    rpm -e wemps-msg-De_DE-2.1.0-0
    rpm -e wemps-msg-Es_ES-2.1.0-0
    rpm -e wemps-msg-Fr_FR-2.1.0-0
    rpm -e wemps-msg-It_IT-2.1.0-0
    rpm -e wemps-msg-Ja_JP-2.1.0-0
    rpm -e wemps-msg-Ko_KR-2.1.0-0
    rpm -e wemps-msg-Pt_BR-2.1.0-0
    rpm -e wemps-msg-Zh_CN-2.1.0-0
    rpm -e wemps-msg-Zh_TW-2.1.0-0
    

    If there is a problem with package dependencies, you can use the following command to remove the packages:

    rpm -e packagename --nodeps --justdb
    

    The nodeps option skips the dependency check. The justdb option updates only the package database, and not the file system. Using only the nodeps option can cause a failure in package removal if there is any mismatch in the dependent file system (files and directories).

  6. Type rm -rf /opt/WebSphere/AppServer/ to remove WebSphere Application Server directories in the instance installed in the /opt/WebSphere/AppServer installation root. Do not remove installation root directories for products that you intend to keep.
  7. Type rm -rf /opt/WebSphere/AppServer/ /opt/WebSphere/DeploymentManager/ to remove multiple directories. Again, do not remove directories for products that you intend to keep.
  8. Type rm -fr /var/wemps /opt/wemps if you are certain that there is no embedded messaging data to preserve.
    If you have other instances of WebSphere Application Server products on the same machine, and if they use the embedded messaging feature, do not remove the embedded messaging packages or directories.
  9. Type rm -rf IBMHttpServer to delete the IBM HTTP Server directory.
  10. If you do not have IBM WebSphere MQ installed as a separate product on this machine, and if you do not have the embedded messaging server and client feature installed on this machine, type rm -fr /var/mqm /opt/mqm if you are certain that there is no embedded messaging data to preserve. If you have other instances of WebSphere Application Server products on the same machine, and if they use the embedded messaging feature, do not remove the embedded messaging packages or directories.

    If you installed IBM WebSphere MQ as a separate product on this host to use as the messaging provider, and if you do not want to continue using WebSphere MQ, you can uninstall the product as described in the WebSphere MQ information.

  11. Edit the vpd.properties file.

    Do not delete or rename the vpd.properties file because the InstallShield for MultiPlatforms (ISMP) program uses it for other products that it installs.

Results

When you finish, the product is completely uninstalled. You are now ready to reinstall. Reinstalling successfully into the same directory is the final indicator of success in removing the original product.

Example

Example of displaying package names beginning with MQ, for the embedded messaging feature

==>rpm -qa | grep MQ
MQSeriesMsg_Zh_CN-5.3.0-1
MQSeriesMsg_Zh_TW-5.3.0-1
MQSeriesMsg_ko-5.3.0-1
MQSeriesClient-5.3.0-1
MQSeriesMsg_de-5.3.0-1
MQSeriesMsg_es-5.3.0-1
MQSeriesMsg_fr-5.3.0-1
WSBMQ1AA-5.0-0
WSBMQ2AA-5.0-0
WSBMQ3AA-5.0-0
MQSeriesMsg_it-5.3.0-1
MQSeriesMsg_ja-5.3.0-1
MQSeriesMsg_pt-5.3.0-1
MQSeriesSDK-5.3.0-1
MQSeriesJava-5.3.0-1
MQSeriesServer-5.3.0-1
MQSeriesRuntime-5.3.0-1

Example of displaying package names beginning with wemps, for the embedded messaging feature

==>rpm -qa | grep wemps
wemps-msg-De_DE-2.1.0-0
wemps-msg-Es_ES-2.1.0-0
wemps-msg-Fr_FR-2.1.0-0
wemps-msg-It_IT-2.1.0-0
wemps-msg-Ja_JP-2.1.0-0
wemps-msg-Ko_KR-2.1.0-0
wemps-msg-Pt_BR-2.1.0-0
wemps-msg-Zh_CN-2.1.0-0
wemps-msg-Zh_TW-2.1.0-0
wemps-runtime-2.1.0-0

Example of displaying package names beginning with WSB, for the base WebSphere Application Server product

# rpm -qa | grep WSB
WSBSR1AA51-5.1-0
WSBMQ4AA-5.0-0
WSBTV1AA51-5.1-0
WSBJD5AA51-1.3-1
WSBDM1AA51-5.1-0
WSBJD7AA51-1.3-1
WSBDT1AA51-5.1-0
WSBMS3AA-5.0-0
WSBAU1AA51-5.1-0
WSBMQ3AA-5.0-0
WSBPL1AA51-5.1-0
WSBMS6AA-5.0-0
WSBPS1AA51-5.1-0
WSBCO5AA51-5.1-0
WSBSR4AA51-5.1-0
WSBCO1AA51-5.1-0
WSBSM1AA51-5.1-0
WSBAC1AA51-5.1-0
WSBMQ1AA-5.0-0
WSBJD9AA51-1.3-1
WSBGK2AA51-5.1-0
WSBES1AA-5.0-0
WSBJA1AA51-5.1-0
WSBLA1AA51-5.1-0
WSBAS1AA51-5.1-0
WSBMQ2AA-5.0-0
WSBIH1AA51-1.3-28

Example of displaying package names beginning with WSN, for the WebSphere Application Server Network Deployment product

# rpm -qa | grep WSN
WSNCO2AA51-5.1-0
WSNWG1AA51-5.1-0
WSNJD5AA51-1.3-1
WSNCF1AA51-5.1-0
WSNUR1AA51-5.1-0
WSNJD9AA51-1.3-1
WSNMQ1AA51-5.1-0
WSNCF4AA51-5.1-0
WSNMC5AA-5.0-0
WSNSR1AA51-5.1-0
WSNCO1AA51-5.1-0

[5.0 only][Version 5.0.1][Version 5.0.2]Example of displaying package names beginning with WSE, for the WebSphere Application Server Enterprise product

==>rpm -qa | grep WSE
WSEOT03AA-5.0-0
WSEOS01AA-5.0-0
WSEOS03AA-5.0-0
WSESA01AA-5.0-0
WSESA04AA-5.0-0
WSEBR01AA-5.0-0
WSEBR0301AA-5.0-0
WSEBR0303AA-5.0-0
WSEBR0304AA-5.0-0
WSEBR0305AA-5.0-0
WSEEM01AA-5.0-0
WSEEM0301AA-5.0-0
WSEEM0303AA-5.0-0
WSEEM0304AA-5.0-0
WSEEM0306AA-5.0-0
WSEDQ01AA-5.0-0
WSEDQ02AA-5.0-0
WSEDQ0401AA-5.0-0
WSEDQ0403AA-5.0-0
WSEDQ0404AA-5.0-0
WSEOS0401AA-5.0-0
WSEOS0403AA-5.0-0
WSEOS0404AA-5.0-0
WSEOS0405AA-5.0-0
WSEOS0406AA-5.0-0
WSESA0301AA-5.0-0
WSESA0304AA-5.0-0
WSESA0305AA-5.0-0
WSESA0306AA-5.0-0
WSEFC01AA-5.0-0
WSEFC0301AA-5.0-0
WSEFC0303AA-5.0-0
WSECF07AA-5.0-0
WSECF01AA-5.0-0
WSECF0203AA-5.0-0
WSECF0207AA-5.0-0
WSECF03AA-5.0-0
WSEJA01AA-5.0-0
WSECF06AA-5.0-0
WSECF04AA-5.0-0

What to do next

After uninstalling the product, see Installing WebSphere Application Server products to begin planning your next installation.

Related tasks
Uninstalling manually
Manually uninstalling on AIX platforms



Searchable topic ID:   tins_uninstallLinux
Last updated: Jun 21, 2007 8:07:48 PM CDT    WebSphere Business Integration Server Foundation, Version 5.0.2
http://publib.boulder.ibm.com/infocenter/wasinfo/index.jsp?topic=/com.ibm.wasee.doc/info/ee/ae/tins_uninstallLinux.html

Library | Support | Terms of Use | Feedback