You can uninstall a feature pack product by running the
feature pack uninstall command from your IBM i 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 IBM i 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 IBM i 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 IBM
i server.
The host server jobs allow the installation
code to run on IBM i. On a CL command line, enter the following command:
- Uninstall the feature pack from your WebSphere Application
Server for IBM i installation on your IBM i server.
To uninstall the feature pack, run the one of
the following commands from the Qshell command line in the app_server_root/uninstall_ejb3 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 IBM i. 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 IBM i 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/ejb3 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/ejb3 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.