Uninstalling a DMZ Secure Proxy Server for IBM WebSphere Application Server

Use this topic to uninstall a DMZ Secure Proxy Server for IBM® WebSphere® Application Server using the launchpad.

Before you begin

The uninstaller program created during installation removes registry entries, uninstalls the server, and removes all related features. The uninstaller program does not remove log files in the installation root directory. The uninstaller program is launched by the uninstall command.

Attention: The uninstaller is able to detect other products that extend the secure proxy server and have a dependency on the server. If you have installed other products that extend the server, you must uninstall those products before uninstalling the secure proxy server. Products that extend the server are feature packs and other products that rely on the server runtime environment.
[Windows] Avoid trouble: If an administrative user uninstalls a secure proxy server that was installed by another user, then all registry entries for all secure proxy server instances owned by the administrator will also be removed. To uninstall a secure proxy server originally installed by a non-administrator, log in with the same non-administrator profile.gotcha

About this task

The time required to uninstall the DMZ Secure Proxy Server for IBM WebSphere Application Server depends on the processing speed of your machine. As a guideline, uninstalling the core product files and one profile takes approximately 10 minutes when using the uninstall command.

Complete the following steps to uninstall a DMZ Secure Proxy Server for IBM WebSphere Application Server.

Procedure

  1. Log on using the same user ID that was used when the product was installed.
    • [AIX] [HP-UX] [Linux] [Solaris] Issue the ls -al command at the root of the installation directory to find the user ID that was used to install the product.
    • [Windows] Log on as an Administrative user or as the user who installed the product.
  2. Optional: Back up configuration files and log files to refer to them later if necessary. The uninstaller program removes all profiles by default, including all of the configuration data and applications in each profile.

    Use the AdminTask command scripting interface to create a configuration archive file of an existing profile, for example. You can back up the config folder and the logs folder of each profile; however, the secure proxy server cannot reuse profiles; therefore, you are not required to back up an entire profile.

  3. Issue the uninstall command from the directory where the server is installed. Refer to the information topic on directory conventions, if needed:

    The uninstaller wizard begins and displays the Welcome panel.

  4. Click Next to begin uninstalling the product.

    The uninstaller wizard displays a confirmation panel that lists a summary of the components that you are uninstalling.

    1. Click Next to continue uninstalling the product.

      When using the wizard, a panel allows you to choose whether or not the uninstaller deletes all profiles before it deletes the core product files. By default, all profiles are deleted, but this option can be deselected on the panel.

      To change the default behavior, start the wizard with this command:
      uninstall -OPT removeProfilesOnUninstall="false"

      After uninstalling profiles, the uninstaller program deletes the core product files in component order.

    2. Click Finish to close the wizard after the wizard removes the product.
  5. Review the log file.
    The log file records file system or other unusual errors. Look for the INSTCONFSUCCESS indicator of success in the log:
    (date_time), 
    Uninstall, com.ibm.ws.install.ni.ismp.actions.
    SetExitCodeAction, msg1, 
    CWUPI0000I: EXITCODE=0
    (date_time), 
    Uninstall, com.ibm.ws.install.ni.ismp.actions.
    ISMPLogSuccessMessageAction, msg1, 
    INSTCONFSUCCESS
    [Windows] If you are uninstalling on Windows operating systems, then you might see the following error in the uninstallation log:
    Failed to delete: file:/C:<input type = "hidden">/Installed/FI_INS_11/properties/version/nif/config/uninstall/lib/instcas.jar
    java.io.IOException: Failed to delete: file:/C:/Installed/FI_INS_11/properties/version/nif/config/uninstall/lib/instcas.jar
    The instcas.jar file is locked by the operating system and cannot be deleted by the uninstaller. You can manually delete this file after the uninstallation with other files that have not yet been deleted.
  6. If any product files remain, uninstall those files manually before reinstalling the secure proxy server.

Results

This procedure results in uninstalling the DMZ Secure Proxy Server for IBM WebSphere Application Server.




In this information ...


Related reference

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    

Terms of Use | Feedback

Last updated: Oct 22, 2010 2:23:46 AM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=compass&product=was-nd-dist&topic=tjpx_uninstallsecpx
File name: tjpx_uninstallsecpx.html