WebSphere Enterprise Service Bus, Version 6.2.0 Operating Systems: AIX, HP-UX, i5/OS, Linux, Solaris, Windows


Preparing for reinstallation after failed uninstallation on i5/OS systems

Learn how to clean a i5/OS® system if uninstallation of WebSphere® ESB fails. After running the uninstallation program, go through these manual steps to remove registry entries that can prevent you from reinstalling the product into the original directory.

Before you begin

Before performing this procedure, ensure you have uninstalled WebSphere ESB silently, and that the procedure was not completely successful. If the procedure was successful, you do not need to perform this task.

Determine the install_root and profile_root directories for the product so that you remove the correct product and produce a clean system.

For details on default directory locations see Default installation directories for the product, profiles, and tools

The installation wizard and the Profile Management Tool let you specify your own locations for installation root directories. Examine the following files to determine the actual locations:
  • The /QIBM/WAS/.ibm/.nif/.nifregistry file identifies the installation root for all installed WebSphere ESB products.
  • The user_data_root/profileRegistry/logs/manageprofiles/profile_create.log file for each created profile identifies the installation location in the stanza with the <method>invokeWSProfile</method> tag.
Uninstalling the product leaves the user_data_root/profileRegistry/logsdirectory. It also leaves the install_root/logs directory.

About this task

Reinstalling the product into a new directory when files remain from a previous installation can create a coexistence scenario. However, you can delete all files and registry entries to completely remove WebSphere ESB. A clean system lets you reinstall the product into the original directory without coexistence.

Important: Throughout this procedure, steps address removing artifacts left after uninstallation of both WebSphere ESB and WebSphere Application Server or WebSphere Application Server Network Deployment. The WebSphere Application Server product addressed is assumed to be the one underlying the installation of WebSphere ESB.

Perform the following procedure to produce a clean system.

Procedure
  1. Sign onto the i5/OS system with a user profile that has *ALLOBJ and *SECADM special authorities.
  2. In Qshell, go to the install_root directory.
  3. Remove the subdirectory related to the installation you are removing. Delete the installation subdirectory and all files and directories contained in this subdirectory.
    Note: The name of the subdirectory increments with each additional install. For example, the first installation the directory name is ESB, then for the second installation is ESB1, and so on.
  4. Next, go to the user_data_root/profiles directory.
  5. Remove the subdirectory related to the installation you are removing. Delete the installation subdirectory and all files and directories contained in this subdirectory.
    Note: The name of the subdirectory increments with each additional install. For example, the first installation the directory name is ESB, then for the second installation is ESB1, and so on.
  6. Edit the /QIBM/WAS/.ibm/.nif/.nifregistry file. Remove all entries referring to your installation.
  7. If this is the last installation of WebSphere ESB being removed from the system, then you must also delete the i5/OS licensed program registry entry for WebSphere ESB by issuing the following DLTLICPGM command at the i5/OS CL command prompt.
    DLTLICPGM LICPGM(5724I82)

Results

This procedure results in having a clean system. You can reinstall into the same directories now. A clean system has no trace of a previously deleted installation.

What to do next

After you have cleaned your system, go to Installing the software to choose an installation procedure.


task Task topic

Terms of use | Feedback


Timestamp icon Last updated: 21 June 2010


http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r2mx/topic//com.ibm.websphere.wesb620.doc/doc/tins_reinstall_i5.html
Copyright IBM Corporation 2005, 2010. All Rights Reserved.
This information center is powered by Eclipse technology (http://www.eclipse.org).