Description:
Description:
============

"nodeutil" removes application components from a node. Use this utility
when an application undeploy operation does not complete successfully and
application component remain on a node. The utility supports an
interactive mode as well as a non-interactive (scripted) mode.

Environment:
===========

- TIBCO ActiveMatrix Service Grid 3.0.x (+ Hotfixes)
- TIBCO ActiveMatrix Service Bus 3.0.x (+ Hotfixes)
- TIBCO ActiveMatrix Service Grid 3.1.x (+ Hotfixes)
- TIBCO ActiveMatrix Service Bus 3.1.x (+ Hotfixes)
- TIBCO ActiveMatrix BPM 1.1.x (+ Hotfixes) and 1.2.0
  (requires accompanying TIBCO ActiveMatrix BPM database cleanup utility)
- TIBCO ActiveMatrix BusinessWorks Service Engine 5.9.x (+ Hotfixes)

Symptoms:
========

After failing to completely undeploy or force undeploy an application stale
application state will prevent the application from being
deployed at a later time. The following error will be reported by Administrator:
"Cannot add component &ltcomponentName> because a component with the same URI
is already registered.""


Cause:
=====

When force operations (delete, undeploy) are used sometimes parts of application
state are removed from the Administrator database but not from the node's
file system.

Resolution:
==========

1. Undeploy or force undeploy an application using Administrator UI or
   CLI. This step should remove application components from a node.
2. Delete an application using Administrator UI or CLI. This step
   removes information about the application and its components from
   the Administrator database.
3. If any of the preceding steps fail, execute force delete using the
   Administrator UI or CLI to remove information about the application
   and its components from the Administrator database.
4. Run nodeutil to remove those components from the node.

Attachments:
===========

TIB_amx_3.x.x_hotfix-nodeutil2_readme.txt.

References:
==========