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.
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.
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
- Log on using the same user ID that was used when the product
was installed.
- 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.
- Stop all deployment managers, node agents and server processes. For instructions on how to stop these processes, see Stopping servers and nodes.
- 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.
Restriction: You cannot uninstall a
WebSphere ESB for i5/OS installation with the GUI.
This uninstallation must be performed silently.
- If uninstalling interactively using the uninstallation
wizard only: Do the following:
- Issue the uninstall command from
a command line using one of the following commands, depending on platform:

install_root/uninstall.wbi/uninstall
install_root\uninstall.wbi\uninstall.exe
The uninstallation wizard starts and the Welcome panel is
displayed.
- 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.
- 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.
- 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.
- Click Finish to close the wizard
after the wizard removes the product.
Go to step 7.
- 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:
install_root/bin/uninstall_wbi -OPT isUmbrellaUninstall="true"
-OPT removeProfilesOnUninstall="true"

install_root/uninstall.wbi/uninstall
-OPT isUmbrellaUninstall="true" -OPT removeProfilesOnUninstall="true" -silent
install_root\uninstall.wbi\uninstall.exe
-OPT isUmbrellaUninstall="true" -OPT removeProfilesOnUninstall="true" -silent
If you encounter any problems during the uninstallation,
examine the log.txt file in the install_root/logs/wbi/uninstall directory.
- 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.
- 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.
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
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