This topic applies only on the i5/OS operating system.

Uninstalling the feature pack on IBM i

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

  1. Log on to the IBM i system with a user profile that has *ALLOBJ special authority.
  2. 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.

  3. 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:

    STRHOSTSVR SERVER(*ALL)
  4. 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_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 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.

  5. Review any log files if necessary. Log files are located in the app_server_root/logs/uninstall/webservices directory.

  6. 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.




In this information ...


IBM Redbooks, demos, education, and more

(Index)

Use IBM Suggests to retrieve related content from ibm.com and beyond, identified for your convenience.

This feature requires Internet access.

Task topic Task topic    

Terms and conditions for information centers | Feedback

Last updatedLast updated: Aug 31, 2013 1:23:07 AM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=pix&product=was-nd-dist&topic=tins_is_uninstall_fep
File name: tins_is_uninstall_fep.html