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


Uninstalling the product using the GUI or silently

Learn how to uninstall WebSphere® ESB and the underlying copy of WebSphere Application Server Network Deployment with Feature Pack for Web Services using either the uninstallation wizard graphical user interface (GUI) or silently using a command-line invocation.

Before you begin

Before uninstalling WebSphere ESB using this procedure, do the following:
  • Determine if you want to uninstall WebSphere ESB interactively or silently. Steps that you must perform for each procedure will be identified in the overall procedure in this topic.
    For i5/OS operating system Restriction: You can only uninstall WebSphere ESB on i5/OS® silently.
  • Determine if you want to uninstall the underlying WebSphere Application Server Network Deployment with Feature Pack for Web Services product when you are uninstalling WebSphere ESB. If you uninstall this product, the uninstaller program also removes all profiles by default, including all of the configuration data and applications in each profile. You can choose not to delete the profiles.
    For i5/OS operating system Note: WebSphere Application Server Network Deployment with Feature Pack for Web Services is uninstalled by default. You must change this option in the uninstall command if you don't want to uninstall this product.
  • Back up the config folder, the installableApps folder, and the installedApps folder of each profile, if necessary. Back up all applications that are not stored in another location.
  • Remove the event messaging enterprise application, the event database, and the configuration for the Common Event Infrastructure application, in that order.
  • Ensure that you are uninstalling the product using the same user ID that was used when the product was installed.
Restriction: You cannot perform partial, custom, or incremental uninstallations.

About this task

The uninstallation program is created during product installation. It is customized for each product installation, with specific disk locations and routines for removing installed features.

To uninstall WebSphere ESB, perform the following steps.

Procedure
  1. Log on using the same user ID that was used when the product was installed.
  2. If you are uninstalling the underlying WebSphere Application Server Network Deployment with Feature Pack for Web Services, run the uninstallation program for the Web server plug-ins for WebSphere Application Server.

    If your system includes a Web server configured to run with the underlying WebSphere Application Server product, you must uninstall the plug-ins to remove the configuration from the Web server. See the uninstallation procedure for the plug-ins in the following topic in the WebSphere Application Server Network Deployment information center: Uninstalling the Web server plug-ins for WebSphere Application Server.

  3. Stop all deployment managers, node agents and server processes. For instructions on how to stop these processes, see Stopping servers and nodes.
  4. Optional: Back up configuration files and log files to refer to them later, if necessary.

    The uninstallation program does not remove log files in the install_root directory. If you elect to uninstall the underlying WebSphere Application Server Network Deployment with Feature Pack for Web Services, it does remove all profiles and all of the data in all profiles by default.

    Back up the config folder and the logs folder of each profile to refer to later, if necessary. You cannot reuse profiles so there is no need to back up an entire profile.

    If you want to uninstall with the interactive GUI interface, go to step 5. If you want to uninstall silently, go to step 6.

    For i5/OS operating system Restriction: You cannot uninstall a WebSphere ESB for i5/OS installation with the GUI. This uninstallation must be performed silently.
  5. If uninstalling interactively using the uninstallation wizard only: Do the following:
    1. Issue the uninstall command from a command line using one of the following commands, depending on platform:
      • For Linux operating systemFor UNIX operating system install_root/uninstall.wbi/uninstall
      • For Windows operating system install_root\uninstall.wbi\uninstall.exe

      The uninstallation wizard starts and the Welcome panel is displayed.

    2. In the Welcome panel, select whether to uninstall any underlying products when uninstalling WebSphere ESB.
      • If you want to uninstall the underlying product, select one of the following check boxes, depending on which product is installed:
        • Uninstall the underlying IBM® WebSphere Application Server Network Deployment with Feature Pack for Web Services, Version 6.1
        • Uninstall the underlying IBM Feature Pack for Web Services, Version 6.1 (This selection is displayed if a product in addition to WebSphere ESB and Feature Pack for Web Services is installed on top of WebSphere Application Server Network Deployment. In this case, you cannot uninstall WebSphere Application Server Network Deployment; you can only uninstall the Feature Pack for Web Services.)
      • If you do not want to uninstall the underlying product, clear the check box.
      Click Next.
    3. The panel that is displayed depends on whether you chose to uninstall the underlying product and on which product that is.
      • If you chose to uninstall IBM WebSphere Application Server Network Deployment with Feature Pack for Web Services underlying WebSphere ESB, the Profile deletion confirmation panel lets you choose whether to remove all profiles associated with the installation you are uninstalling. Check the check box to delete all profiles; clear the check box to keep any that have not been augmented by WebSphere ESB. Any profiles augmented by WebSphere ESB will be rendered unusable by the uninstallation process and will be deleted by the uninstallation process even if you have cleared the check box. By default, all profiles are deleted.
      • If you chose to uninstall an installation of IBM Feature Pack for Web Services (meaning you cannot uninstall the underlying WebSphere Application Server Network Deployment), a warning panel identifies any profiles that have been augmented with WebSphere ESB profile templates and that will be deleted by the uninstallation process. Any profiles augmented by WebSphere ESB will be rendered unusable by the uninstallation process and will be deleted by the uninstallation process.
      • If you chose not to uninstall the underlying product, a warning panel identifies any profiles that have been augmented with WebSphere ESB profile templates and that will be deleted by the uninstallation process. Any profiles augmented by WebSphere ESB will be rendered unusable by the uninstallation process and will be deleted by the uninstallation process even if you elected not to uninstall the underlying product.
      Click Next. The uninstaller checks if any servers associated with the installation are still running.
    4. The panel that is displayed depends on whether you chose to uninstall the underlying product and on whether any servers associated with the installation are running.
      • If no servers are running, the uninstaller displays a confirmation panel that lists a summary of the components that you are uninstalling. Click Next to begin the uninstallation.
      • If servers are running and you chose to uninstall IBM WebSphere Application Server Network Deployment with Feature Pack for Web Services, the uninstaller shuts them down. A confirmation panel is displayed that lists a summary of the components that you are uninstalling. Click Next to begin the uninstallation.
      • If servers are running and you chose to uninstall IBM Feature Pack for Web Services, a warning panel directs you to stop the servers. Stop any running servers manually and click OK to close the warning panel. The Welcome panel is displayed so you can restart the uninstallation process. Go to step 5.b above.
      • If servers are running and you did not choose to uninstall the underlying product, a warning panel directs you to stop the servers. Stop any running servers manually and click OK to close the warning panel. The Welcome panel is displayed so you can restart the uninstallation process. Go to step 5.b above.
    5. Click Finish to close the wizard after the wizard removes the product.

      Go to step 7.

  6. If uninstalling silently only: Run the command that uninstalls WebSphere ESB. Issue the following command to silently uninstall WebSphere ESB and the underlying WebSphere Application Server product and to remove all profiles:
    • For i5/OS operating system
      install_root/bin/uninstall_wbi -OPT isUmbrellaUninstall="true"
       -OPT removeProfilesOnUninstall="true"  
    • For Linux operating systemFor UNIX operating system
      install_root/uninstall.wbi/uninstall 
      -OPT isUmbrellaUninstall="true" -OPT removeProfilesOnUninstall="true" -silent
    • For Windows operating system
      install_root\uninstall.wbi\uninstall.exe 
      -OPT isUmbrellaUninstall="true" -OPT removeProfilesOnUninstall="true" -silent
    Issue the following command to silently uninstall WebSphere ESB and the underlying WebSphere Application Server product and to retain all profiles:
    • For i5/OS operating system
      install_root/bin/uninstall_wbi -OPT isUmbrellaUninstall="true"
       -OPT removeProfilesOnUninstall="false" 
    • For Linux operating systemFor UNIX operating system
      install_root/uninstall.wbi/uninstall 
      -OPT isUmbrellaUninstall="true" -OPT removeProfilesOnUninstall="false" -silent
    • For Windows operating system
      install_root\uninstall.wbi\uninstall.exe 
      -OPT isUmbrellaUninstall="true" -OPT removeProfilesOnUninstall="false" -silent
    Issue the following command to silently uninstall WebSphere ESB and keep the underlying WebSphere Application Server product. This command deletes all profiles:
    • For i5/OS operating system
      install_root/bin/uninstall_wbi -OPT isUmbrellaUninstall="false" 
    • For Linux operating systemFor UNIX operating system
      install_root/uninstall.wbi/uninstall 
      -OPT isUmbrellaUninstall="false" -silent
    • For Windows operating system
      install_root\uninstall.wbi\uninstall.exe -OPT isUmbrellaUninstall="false" 
      -silent

    If you encounter any problems during the uninstallation, examine the log.txt file in the install_root/logs/wbi/uninstall directory.

  7. Remove any configuration entries in the managed node that describe a deleted deployment manager.

    A common topology is to install the core product files on multiple workstations. One workstation has the deployment manager and other workstations have managed nodes created from custom profiles. If you delete an installation where you created a data manager into which you federated a custom profile from another installation, you must update the configuration of those custom profiles.

    The official statement of support for a node configuration problem in the managed node is that you use the backupConfig command after the initial installation. Use the command again whenever you make significant changes to the configuration that you must save. With a valid backup of the configuration, you can always use the restoreConfig command to get back to a previously existing state in the configuration.

    You can also use one of the following commands on the machine with the managed node to remove the node. In this example, profile_root represents the installation directory of the managed node profile:
    • For i5/OS operating system profile_root/bin/removeNode -force
    • For Linux operating systemFor UNIX operating system profile_root/bin/removeNode.sh -force
    • For Windows operating system profile_root\bin\removeNode.bat -force
  8. Remove any configuration entries in the deployment manager that describe a deleted managed node.

    Open the administrative console of the deployment manager and click System administration > Nodes. Select the check box beside the node you wish to delete and then select Remove node.

    If the administrative console cannot successfully remove the node, run the following command with the deployment manager running:
    • For i5/OS operating system install_root/bin/cleanupNode node_name
    • For Linux operating systemFor UNIX operating system install_root/bin/cleanupNode.sh node_name
    • For Windows operating system install_root\bin\cleanupNode.bat node_name

    The official statement of support for a node configuration problem in the deployment manager is that you use the backupConfig command after the initial installation. Use the command again whenever you make significant changes to the configuration that you must save. With a valid backup of the configuration, you can always use the restoreConfig command to get back to a previously existing state in the configuration.

Results

This procedure uninstalls WebSphere ESB, and if selected, WebSphere Application Server Network Deployment with Feature Pack for Web Services. After running the uninstallation wizard, the directory structure has only a few remaining directories, including the logs directory.

The uninstallation program leaves some log files in this directory, including the following:
  • For i5/OS operating system install_root/logs/wbi/uninstall/log.txt
  • For Linux operating systemFor UNIX operating system install_root/logs/wbi/uninstall/log.txt
  • For Windows operating system install_root\logs\wbi\uninstall\log.txt
The uninstlog.txt file records file system or other unusual errors. Look for the INSTCONFSUCCESS indicator of success in the log:
Uninstall, com.ibm.ws.install.ni.ismp.actions.
   ISMPLogSuccessMessageAction, msg1, 
   INSTCONFSUCCESS

What to do next

If you intend to reinstall the product into the same installation root directory, you must do one of the following, depending on the success of the uninstallation:
  • If uninstallation was successful, you must manually remove the install_root directory.
    Important: You need to uninstall both WebSphere ESB and the underlying WebSphere Application Server, WebSphere Application Server Network Deployment, or WebSphere Application Server Network Deployment with Feature Pack for Web Services product if you uninstall and plan to reinstall WebSphere ESB into the same directory. Therefore the install_root directory, which you must manually remove, must be empty.
  • If uninstallation was not successful, you must manually uninstall the remaining artifacts of the product. See Preparing for reinstallation after failed uninstallation for more information. If you do not plan to reinstall, you do not need to perform this task.
For more information on the commands mentioned in this topic, see the following topics in the Command-line utilities section in the WebSphere Application Server Network Deployment information center:
  • stopManager
  • stopNode
  • stopServer
  • backupConfig
  • restoreConfig

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_gui_uninstall.html
Copyright IBM Corporation 2005, 2010. All Rights Reserved.
This information center is powered by Eclipse technology (http://www.eclipse.org).