Sanitizing After a Failed Installation

An installation process can fail at various stages and the installer may not be able to clean up the environment before exiting. It is recommended that you clean up the environment manually before trying to re-install the product.

Consider a simple environment with a single node (BPMNode) on a single host. To sanitize this environment after a failed installation, perform the following steps in the specified order.

Procedure

  1. Shutdown TIBCO Configuration Tool (TCT).
  2. Stop any processes (for example, tibcohost, tibamx_SystemNode, and tibamx_BPMNode) running from the BPM configuration directory specified during installation. For example, if you chose to use the default configuration directory when installing on Windows, C:\ProgramData\amx-bpm\tibco\data.
  3. Delete the BPM configuration directory specified during the installation. For example, if you chose to use the default configuration directory when installing on Windows, delete the folder C:\ProgramData\amx-bpm\tibco\data.
  4. Purge all the queues from the TIBCO Enterprise Message Service (EMS) server. To do so:
    1. Connect to the TIBCO Enterprise Message Service (EMS) Administration tool tibemsadmin as the admin user.
    2. Run the following commands to purge and delete all the queues:
      purge all queues
      delete all queues
      Warning: If you are using TIBCO Enterprise Message Service for another application, then you should not run these purge commands. These commands will purge all queues.

      See TIBCO Enterprise Message Service documentation for details about using the Administration tool.

      Note: The above steps are applicable for a single node environment. Similar steps may be applied to clean up an active-active or a distributed environment. The actual steps however will have to be customized to the environment that needs to be cleaned.