Managing Hosts

TIBCO ActiveMatrix Administrator allows lifecycle management of TIBCO Host instances on remote machines. This includes the ability to create, edit, install, start, stop, uninstall and delete TIBCO Host instances.

To use this lifecycle management, you need at least one pre-created TIBCO Host instance on a remote machine that is registered with TIBCO ActiveMatrix Administrator (done via TIBCO Configuration Tool). Then, using this instance, TIBCO ActiveMatrix Administrator can create additional TIBCO Host instances on the remote machine and can perform lifecycle operations.

Administrator CLI XSD schemas are provided in the installation at <TIBCO_HOME>/administrator/<version>/schemas.

Here are the main actions:

  • Creating a host — Creates a new new TIBCO Host instance.
  • Adding a host — Adds a logical entry for a new TIBCO Host instance in the TIBCO ActiveMatrix Administrator database.
  • Editing a host — Edits the logical entry for the TIBCO Host instance in the TIBCO ActiveMatrix Administrator database.
  • Installing a host — Creates the folder structure for an actual runtime TIBCO Host instance on the remote machine.
  • Starting a host — Starts the TIBCO Host process and auto-registers it (on the very first launch) with TIBCO ActiveMatrix Administrator.
  • Stopping a host — Stops the TIBCO Host process.
  • Uninstalling a host — Removes the folder structure for the runtime TIBCO Host instance.
  • Deleting a host — Removes the logical entry for the TIBCO Host instance from the TIBCO ActiveMatrix Administrator database.

How TIBCO ActiveMatrix Administrator manages TIBCO Host instances on remote machines

On a fresh machine with TIBCO ActiveMatrix installed, you must first create a TIBCO Host instance using TIBCO Configuration Tool (TCT) and register it with TIBCO ActiveMatrix Administrator. Once available and running, TIBCO ActiveMatrix Administrator then uses this first instance to create and manage additional TIBCO Host instances.

When creating any additional TIBCO Host instances on that machine, TIBCO ActiveMatrix Administrator contacts an already existing TIBCO Host instance (called Source TIBCO Host) remotely via JMX and commands it to create the new instances. As such, any TIBCO Host instance that is already running and registered can play the role of the Source TIBCO Host, not necessarily the first one that was created on that machine via TCT.

You can specify which TIBCO Host instance to use as the Source TIBCO Host. By default (that is, when it is not specified), TIBCO ActiveMatrix Administrator automatically chooses a running TIBCO Host instance as the Source TIBCO Host by matching machine names in the Management URL that you specify for the new TIBCO Host instance.

Note: New TIBCO Host instances are always created (and assumed to be) in the same CONFIG_HOME as the Source TIBCO Host.