Upgrade and Downgrade

Upgrading the TIBCO ActiveMatrix environment entails installing a new release of TIBCO ActiveMatrix and upgrading the configuration of the different runtime objects such as hosts, ActiveMatrix Administrator servers, and nodes. Optionally, it may involve upgrading Enterprise Message Service (EMS) used by the ActiveMatrix Administrator servers and hosts.

You can upgrade to the current release of ActiveMatrix Service Grid using the TIBCO Configuration Tool (TCT) available in TIBCO_HOME\tct\.

If you plan to have a replicated configuration, do so before upgrading to the current release of ActiveMatrix Service Grid.

Note: In a production environment, you can set up your system to include a replicated Administrator server on a second machine. Requests can be processed by either server. If one server is unavailable, the other server can process requests. For more details on a replicated configuration, refer to the Replicate TIBCO ActiveMatrix Administrator Server section.

The upgrade or downgrade process is robust, simple, and seamless. It consists of the following main steps:

  1. Stop hosts before proceeding with the upgrade or downgrade.
  2. Upgrade or downgrade runtime hosts and nodes.
  3. Perform post-upgrade actions (only for an upgrade).
  4. Update runtime object information in ActiveMatrix Administrator.
  5. Restart hosts after a successful upgrade or downgrade.
Note:
  • When upgrading, ActiveMatrix Administrator host or SystemHost must be upgraded first. That is, before upgrading any runtime host and node.
  • When downgrading, ActiveMatrix Administrator host or SystemHost must be downgraded last. That is, after downgrading all runtime hosts and nodes.
  • It is a good practice to have ActiveMatrix Administrator in the Running state while upgrading or downgrading runtime hosts and nodes.
  • If you have hosts that are running as Windows Services and you intend to start them after upgrading or downgrading them, you must start the TIBCO Configuration Tool (TCT) wizard with Administrator privileges.
  • Upgrade is idempotent. That is, if you try to upgrade a host which is already upgraded, it does not affect the host. Also, if you face any issues during upgrade, you can re-run upgrade after resolving the issues.