Uninstalling the Application Client for WebSphere Application Server feature pack

Uninstall the feature pack files, leaving the Application Client intact.

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.

If you have a feature pack installed, uninstalling Application Client using the Version 6.1 uninstaller program causes the feature pack to stop working because the uninstallation removes the server. However, you can uninstall the feature pack after uninstalling the WebSphere Application Server product.

Procedure

  1. [AIX] [HP-UX] [Linux] [Solaris] Log on using the same user ID that was used when the product was installed.

    Issue the ls -al command at the root of the Feature Pack for EJB 3.0 Client installation to find the user ID that was used to install the product.

  2. [Windows] Log on as a user who belongs to the administrators group or as the user who installed the product.
  3. Stop each running application server with the stopServer command.
    Stop all server processes in all profiles on the machine. For example, issue the following command from the profile_root/bin directory to stop the server1 process in the application server profile:
    ./stopServer.sh server1
    If a server is running and security is enabled, use the following command:
    ./stopServer.sh server1 -user user_ID -password password
    If you have multiple servers, you can use the serverStatus command to find running application servers. Issue the following command from the profile_root/bin directory to determine which servers, if any, are running:
    ./serverStatus.sh -all
  4. Optional: Back up log files to refer to them later if necessary.
  5. Run the uninstall command in the app_client_root/uninstall_ejb3 directory:
    • [AIX] [HP-UX] [Linux] [Solaris] uninstall.sh
    • [Windows] uninstall.exe

    The uninstaller wizard begins and displays the Welcome panel.

    You can also uninstall silently by running the uninstall command with the following parameters:

    Table 1. Silent uninstallation options
    Command Description
    uninstall -silent Use this command to uninstall the feature pack silently on the Application Client.
  6. If you are using the wizard, 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.
    2. Click Finish to close the wizard after the wizard removes the product.
  7. If the uninstallation program did not uninstall the feature pack enablement extensions, use the Update Installer to uninstall the enablement extensions.

    See Uninstalling fix packs, interim features, test fixes, or fix packs delivered as a CIP slip install.

  8. Review the uninstallation log files located in app_client_root/logs/uninstall/ejb3.
  9. If necessary, delete the uninstall_ejb3 directory for Feature Pack for EJB 3.0 Client.

Results

Application Client for WebSphere Application Server is uninstalled.

What to do next

Verify the uninstall procedure by viewing the app_server_root/logs/uninstall/log.txt file for errors. Look for the INSTCONFSUCCESS, indicating a successful uninstall in the log file:
Uninstall, com.ibm.ws.install.ni.ismp.actions.ISMPLogSuccessMessageAction, msg1, 
   INSTCONFSUCCESS
The uninstaller program records uninstallation events in the uninstallation log files. Examine messages that the uninstallation program displays. If the Application Client for WebSphere Application Server does not uninstall successfully, read the messages to identify why the uninstallation failed. Correct the problems identified and try uninstalling the product again.
Tip: If you are logged in as non-root or non-admin user, the uninstall may not be successful. When the uninstaller program runs, a log file is created in your home directory. If the uninstaller program fails, an attempt is made to move the log to the app_server_root directory; however, without the necessary permission to move the file to the app_server_root directory, the attempt to move fails and the log remains in your home directory. Look for the following log files in the user_home/waslogs directory:
  • log.txt
  • trace.txt.gz
  • trace.xml.gz

Troubleshooting:

The following scenario may result in a uninstall failure
  • Install Application Client for WebSphere Application Server V6.1
  • Install the Application Client for WebSphere Application Server feature pack V6.1.0.9
  • Install the Application Client for WebSphere Application Server feature pack V6.1.0.11, using Update Installer
  • Uninstall the Application Client for WebSphere Application Server feature pack, which fails.
The following steps provides a workaround to successfully uninstall the feature pack.
  • Uninstall the Application Client for WebSphere Application Server feature pack V6.1.0.11, using Update Installer
  • Uninstall the Application Client for WebSphere Application Server feature pack successfully



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 Task topic    

Terms and conditions for information centers | Feedback

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