Uninstalling a TIBCO Host

GUI

  1. Navigate to Hosts list.
  2. In the Hosts list, select one or more Hosts.
  3. Choose a Uninstall option.
    • Uninstall: Uninstalls the Host if it does not have any nodes on it.
    • Force Uninstall: Force-deletes the nodes and unmaps any applications from those nodes. Next, the TIBCO Host is stopped and then uninstallation begins.

On successful completion, TIBCO Host instance folder structure is deleted on the remote machine. The Host State displays as Not Installed in TIBCO ActiveMatrix Administrator. If the host was installed as a Windows service, the service is deleted when the TIBCO Host is un-installed.

CLI

The data.xml file is identical to that shown for install action.

Example of build.xml

<AMXAdminTask action="uninstall" objectSelector="Host" force="false"/>

What to Expect After Uninstalling a TIBCO Host

  • A validation failure, if the TIBCO Host has one or more nodes. Specifying force=true bypasses the validation, but force-deletes the nodes and unmaps any applications from those nodes. Also, with force=true, the TIBCO Host is stopped first before uninstallation begins.
  • On successful completion, TIBCO Host instance folder structure is deleted on the remote machine. The Host state displays as Not Installed in TIBCO ActiveMatrix Administrator.
  • In case of failure, a best effort is made to clean up folder structure of the new TIBCO Host instance on the file system. In some cases, the clean up may fail (when files are locked), leaving behind some remnants inside the TIBCO Host instance folder, and it must be manually cleaned. Refer to the System Node logs to see the exact reason of the failure.
  • If the host was installed as a Windows service, the service is deleted when the TIBCO Host is un-installed.
  • This action cannot be performed on a newly created Host in a remote or different CONFIG_HOME as there will be no running Host to perform the action.