Troubleshooting
Problem
This document will provide instruction on how to manually uninstall the IBM WAS v6.1 or v7.0 products.
Symptom
Product is no longer needed or supported on the current IBM i OS VRM.
Environment
IBM i OS; IBM WebSphere Application Server v6.1 or v7.0
Resolving The Problem
NOTE: If you are looking to uninstall the IBM WebSphere Application Server v6.0 product, please refer to the "IBM WebSphere Application Server Version 6.0 Fails to Install" IBM Support Technical Document.
If you are looking to uninstall the IBM WebSphere Application Server V8.0 and later product, please refer to the "How To Uninstall IBM WebSphere Application Server v8.0 and Later and the Installation Manager Products on the IBM i OS" IBM Support Technical Document.
If the IBM WebSphere Application Server Version 6.1 or 7.0 product fails to install, cleanup of the previous installation attempt must be done before the next installation is attempted.
For IBM i OS v7.1 and earlier ONLY!!!
================================
For IBM i 7.2 OS and newer, proceed to Step 2.
1) To clean up and uninstall the IBM WAS v6.1 or 7.0 product, you would first execute the following uninstall Qshell script:
STRQSH
[appsvr_root]/bin/uninstall
[appsvr_root] = The IBM WAS v6.1 or 7.0 product installation path. You can use the /qibm/was/bin/querywasinstalls Qshell script to determine the Installation Location. The Installation Location is equal to the [appsvr_root].
NOTE: If uninstalling multiple WAS editions for a specific version, you will need to execute the uninstall script against each WAS edition.
Once the uninstall script completes successfully and returns to a $ sign prompt, you will need to perform some additional cleanup to completely remove the WAS version or edition from the IBM i OS.
NOTE: DO NOT run this command on IBM i 7.2 and newer for the IBM WebSphere Application Server V6.1 product. The uninstall script will fail since the required JDK LPP is no longer available at IBM i 7.2 and newer.
For ALL IBM i OS Versions
2) Recursively remove the ProdData and UserData directories for the IBM WAS v6.1 or 7.0 product by executing the following commands:
STRQSH
To only remove a specific WAS edition:
rm –R /QIBM/ProdData/WebSphere/AppServer/<version>/<edition >
rm –R /QIBM/UserData/WebSphere/AppServer/<version>/<edition>
To remove the entire WAS version:
rm –R /QIBM/ProdData/WebSphere/AppServer/<version>
rm –R /QIBM/UserData/WebSphere/AppServer/<version>
<version> = V61 or V7
<edition> = Express, Base or ND
To remove the entire WAS product for all versions and editions. NOTE: This will COMPLETELY delete the WAS product from your IBM i server!!!!!!
rm –R /QIBM/ProdData/WebSphere
rm –R /QIBM/UserData/WebSphere
3) In addition, complete the following steps to clear or modify the .nifregistry file created with each WAS v6.1 and 7.0 installation.
NOTE: All WAS v6.1 and 7.0 version and edition installations are listed in the .nifregistry file. If you have multiple WAS v6.1 and 7.0 installations and are NOT uninstalling all of them, you will need to edit the .nifregistry file and delete the entries for the specific WAS version and edition you are uninstalling.
1. | From the operating system command line, run the following command: WRKLNK '/QIBM/WAS' DSPOPT(*ALL) |
2. | Select Option 5 on the WAS directory. |
3. | Select Option 5 on the .ibm directory. |
4. | Select Option 5 on the .nif directory. |
5. | Make a copy of the .nifregistry file to your /home directory or your PC as a backup. |
6. | Select Option 2 to edit the .nifregistry file or Option 4 on the .nifregistry file to delete the file. NOTE: If you have other versions of WAS that you are still using, you will need to edit this file and only remove the entries for the version and edition you are uninstalling. |
<pak installrooturi="file:///QIBM/ProdData/WebSphere/AppServer/V7/Express/" name="was.primary.pak"
<pak installrooturi="file:///QIBM/ProdData/WebSphere/AppServer/V7/Express/" name="was.embed.common.pak"
<pak installrooturi="file:///QIBM/ProdData/WebSphere/AppServer/V7/Express/" name="was.embed.pak"
<pak installrooturi="file:///QIBM/ProdData/WebSphere/AppServer/V7/Express/" name="was.license.pak"
<pak installrooturi="file:///QIBM/ProdData/WebSphere/AppServer/V7/Express/" name="was.server.samples.pak"
<pak installrooturi="file:///QIBM/ProdData/WebSphere/AppServer/V7/Express/" name="was.server.samples.common.pak"
<pak installrooturi="file:///QIBM/ProdData/WebSphere/AppServer/V7/Express/" name="was.expressonly.pak"
<pak installrooturi="file:///QIBM/ProdData/WebSphere/AppServer/V7/Express/" name="was.itlm.express.pak"
<pak installrooturi="file:///QIBM/ProdData/WebSphere/AppServer/V7/Express/" name="was.cim.core.pak"
<pak installrooturi="file:///QIBM/ProdData/WebSphere/AppServer/V7/Express/" name="was.thinclient.common.pak"
<pak installrooturi="file:///QIBM/ProdData/WebSphere/AppServer/V7/Express/" name="was.server.pak"
<pak installrooturi="file:///QIBM/ProdData/WebSphere/AppServer/V7/Express/" name="was.server.common.pak"
4) Finally, make sure the product library (QWAS61 or QWAS7) has been deleted.
If the product has been installed multiple times, there could be additional libraries (QWAS61A, QWAS61B, and so on). If you have multiple installs and you are only trying to remove one of them, make sure you delete the correct library. The querywasinstalls script can be used to help identify which library is associated with each installation. Here is a sample of what querywasinstalls will show:
/qibm/was/bin/querywasinstalls
...
----------------------------------------------------------------------------
Offering ID: BASE
Version: 6.1.0.27
Installation Location: /QIBM/ProdData/WebSphere/AppServer/V61/Base
Installation Library: QWAS61B
Default Profile Location:/QIBM/UserData/WebSphere/AppServer/V61/Base
----------------------------------------------------------------------------
Offering ID: BASE
Version: 7.0.0.13
Installation Location: /QIBM/ProdData/WebSphere/AppServer/V7/Base
Installation Library: QWAS7A
Default Profile Location:/QIBM/UserData/WebSphere/AppServer/V7/Base
----------------------------------------------------------------------------
Note: If the product library is not deleted, you will still see the LPP listed in GO LICPGM Option 10.
5) The IBM WAS v6.1 or V7.0 product is now fully uninstalled. You can now attempt to reinstall the product if you are uninstalling the product due to an installation failure.
Historical Number
481655947
Was this topic helpful?
Document Information
Modified date:
18 December 2019
UID
nas8N1018768