[AIX HP-UX Linux Solaris Windows]This topic applies only on the IBM i operating system.

Uninstalling the Web server plug-ins for WebSphere Application Server

You can uninstall the Web server plug-ins for WebSphere® Application Server using the uninstalller program.

Before you begin

You can uninstall Web server plug-ins for WebSphere Application Server without uninstalling the supported Web server or the application server.

On IBM® i, you cannot uninstall the Web server plug-ins without installing the WebSphere Application Server product. Use the removeOs400WebServerDefinition command to delete a Web server definition. For example, to remove the definition for the Web server WEBSERVER1, which is associated with a profile called myHttpProfile, run this command from Qshell:
app_server_root/bin/removeOs400WebserverDefinition
   -webserver.name WEBSERVER1
   -profileName myHttpProfile

If you used the IBM Key Management wizard to create SSL key files in the Web server Plug-ins home directory, back up the files to a directory outside of the Web server Plugins directory. After the uninstall procedure is complete, you can delete the SSL key files if they are no longer required.

About this task

To uninstall the Web server plug-ins, run the uninstaller program. The program deletes the installation root directory for the Web server plug-ins for WebSphere Application Server, which removes the binary plug-ins.

Procedure

  1. Stop the Web server to allow the uninstaller program to change the Web server configuration.
  2. Open a command window.
  3. Change directories to the plugins_root/uninstall directory.
  4. Issue the uninstall command.

    The Uninstall wizard displays a welcome panel.

    The next few steps in this procedure describe using the wizard interactively. You can also issue the uninstall command with a silent parameter to use the wizard without the graphical user interface.

    uninstall -silent
  5. Click Next on the Welcome panel.

    The Uninstaller wizard displays a confirmation panel for you to confirm what is to be uninstalled. Each feature that displays in the panel is a separate Web server installation. Each Web server installation is configured to use one of the binary plug-in modules that is being deleted.

  6. Click Next on the confirmation panel to begin uninstalling the plug-ins.

    The Uninstaller wizard displays a summary panel that provides status.

  7. Click Finish to close the Uninstaller wizard.
    Uninstalling the Web server plug-ins for WebSphere Application Server removes many files in the installation root directory, but leaves the following logs in the plugins_root/log/uninstall directory:
    • ISMP uninstall log: log.txt
    • Configuration uninstall log: masterConfigurationLog.txt
    • Web server deconfiguration log: uninstallweb_server_namePlugin.log, such as the uninstallApachePlugin.log.
  8. Uninstall the IBM Global Security Kit (GSKit).

    The Plug-ins installation wizard does not uninstall GSKit 7 because there is no registry describing products that are enrolled to use the GSKit. Without this critical information, uninstalling the GSKit product might affect other products that use GSKit.

    You can uninstall GSKit once it is no longer in use on your systems.

    On Solaris systems, you must also uninstall GSKit 4 in addition to GSKit 7.

    The Plug-ins uninstaller program unregisters the GSKit. The registry key is HKEY_LOCAL_MACHINE > SOFTWARE > IBM > GSK7 > REGAPPS > WASPlugins60_unique_key.

    If the registry key WASPlugins60_unique_key is the last remaining key in the GSKit registry entry, the wizard also uninstalls the GSK7 product. If another product, such as IBM HTTP Server, is registered to use GSKit, the wizard does not uninstall the GSKit. The wizard always unregisters the registry key for the Web server plug-ins for WebSphere Application Server, which is WASPlugins60_unique_key.

    The GSKit uninstall log is the plugins_root/log/uninstall/uninstallGSKit.log file.

    Possible problem after using the Update Installer to install a maintenance package

    When you apply a WebSphere Application Server plug-in refresh pack, the plug-in installer incorrectly adds an additional registry key that prevents the GSKit from uninstalling.

    See Manually uninstalling Web server plug-ins for WebSphere Application Server for information about manually uninstalling the GSKit.

  9. Change directories to the plugins_root/uninstall directory and issue the uninstall -silent command. OR: Change directories to the plugins_root/bin directory and issue the uninstall command.
  10. Wait until the uninstall completes.
    Uninstalling the Web server plug-ins for WebSphere Application Server removes many files in the installation root directory, but leaves the following logs in the plugins_root/log/uninstall directory:
    • ISMP uninstall log: log.txt
    • Configuration uninstall log: masterConfigurationLog.txt
    • Web server deconfiguration log: uninstallweb_server_namePlugin.log, such as the uninstallApachePlugin.log.
  11. Delete files from the system temporary directory.
    Delete the following files:
    • Install temporary log : temporaryPluginInstallLog.txt
    • Uninstall temporary log : temporaryPluginUnInstallLog.txt
  12. Delete the Web server definition in a standalone application server.

    The uninstaller program for the Web server plug-ins for WebSphere Application Server does not delete Web server definitions. However, you can delete a Web server definition from admin console OR by using the following wsadmin commands:

    $AdminTask deleteServer { -serverName webserver1 -nodeName WebserverHostName-node_node }
    $AdminTask removeUnmanagedNode { -nodeName WebserverHostName-node_node }
    $AdminConfig save
    

Results

After you exit from the plugins_root/uninstPlugin directory, the directory is removed.

The only remaining directory is the plugins_root/logs directory. The logs directory contains the install process log, the uninstall process log, and the Web server creation logs.

Important: The only other files that might exist are the SSL key files that you can create using the IBM Key Management Wizard. You can move these files to a safe location before using the manual uninstalling procedure, if necessary.

What to do next

To reinstall the Web server plug-ins for WebSphere Application Server, launch the installation procedure again.

To reinstall the Web server plug-ins for WebSphere Application Server into the original directory, delete the existing installation root directory for the plug-ins before reinstalling.

See Installing Web server plug-ins for information about installation scenarios for reinstalling Web server plug-ins.

Use any of the installation procedures that are described in Installing Web server plug-ins on IBM i.

See Manually uninstalling Web server plug-ins for WebSphere Application Server for information about manually uninstalling Web server plug-ins.




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: Feb 5, 2014 9:49:51 PM CST
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=compass&product=was-nd-mp&topic=webplugins_uninstall
File name: tins_webplugins_uninstall.html