You can uninstall a feature pack product by running the feature
pack uninstall command from your iSeries server.
Before you begin
The uninstall command calls the uninstaller
program that is created during installation. The uninstaller program is customized
for each product installation, with specific disk locations and routines for
removing installed features.
Uninstall any feature packs first before you
uninstall the application server. If you have a feature pack installed, then
uninstalling the WebSphere Application Server product using the uninstaller
program causes the feature pack to stop working. However, you should still
uninstall the feature pack after uninstalling the application server to remove
all feature pack product entries and artifacts which might prevent a successful
reinstallation. See Troubleshooting for more information. This same limitation
applies if you are uninstalling a
customized installation package (CIP)
created with the Installation Factory.
About this task
Use this procedure to uninstall a feature pack from a WebSphere
Application Server for i5/OS installation. Uninstallation
unaugments application server profiles that were previously augmented with
the feature pack, rendering them unusable. It is recommended that you delete
these profiles. However, deployment manager profiles will still be usable
after unaugmentation.
Procedure
- Log on to the iSeries system with a user profile that has *ALLOBJ special
authority.
- Stop all processes for the application server product for which
you are uninstalling the feature pack.
Stop the application
server and any other product processes. For example, for the Network Deployment
product, stop the deployment manager, the node agent, and all application
server processes.
- Verify that the host server jobs have started on your iSeries server.
The host server jobs allow the installation code to run on iSeries.
On a CL command line, enter the following command:
- Uninstall the feature pack from your WebSphere Application Server
for i5/OS installation on your iSeries server.
To
uninstall the feature pack, run the one of the following commands from the
Qshell command line in the app_server_root/uninstall_websv directory:
Table 1. Uninstallation commands
Command |
Description |
uninstall -silent |
Use this command to uninstall the feature pack silently
from Base and Express editions of the application server. |
uninstall -silent -OPT unaugmentDmgrProfiles="true" |
Use this command to uninstall the feature pack silently
on the Network Deployment edition of WebSphere Application Server for i5/OS.
The -OPT unaugmentDmgrProfiles="true" option is required
only if you have a deployment manager profile augmented with the feature pack. |
Uninstalling
the feature pack from the iSeries server removes feature pack libraries and
directories. If you do not specify the option to delete all the profiles when
you invoke the uninstall command, the user-defined information
is not removed but you can reuse the information only if you reinstall the
feature pack. If you later decide that you do not need the user-defined data,
you can manually remove it. See the uninstall command page for more information.
User data consists of directories and files
in the profile_root directory, which is the directory specified
as the value for the profilePath parameter when creating
the profile with the manageprofiles command.
Manually delete any files or directories that you no longer need. See the
manageprofiles command page for more information.
- Review any log files if necessary. Log files
are located in the app_server_root/logs/uninstall/webservices directory.
- Delete the application server profiles
that can no longer be used with the manageprofiles command.
The invalid profiles are listed in the log file. See the manageprofiles command
page for more information.
Results
After completing the procedure, the feature pack is uninstalled.
If
the feature pack does not uninstall successfully, examine the logs in the app_server_root/logs/uninstall/webservices directory to identify
why the uninstallation failed. Correct the problems identified and try uninstalling
the product again.
Any application server
profile that previously was enabled with the feature pack is not valid and
is flagged as such in the feature pack uninstallation log. Delete the profiles
indicated in the uninstallation log file. If a profile has been enabled with
more than one feature pack, then after the uninstallation of one feature pack
delete that profile. Any deployment manager profile that previously was augmented
for the feature pack is unaugmented resulting in a deployment manager profile
that is still valid.