Prerequisites for Upgrading or Downgrading

Before proceeding with upgrading or downgrading your enterprise, ensure that you perform the following steps:

  • Backup the CONFIG_HOME folder of your enterprise.

    In case of a failure, the TCT wizard reverts the changes made to runtime automatically. However, it is recommended that you take a backup.

  • Backup the database instance that is configured with ActiveMatrix Administrator.

  • Backup the database used by the Payload and Logging service, if they are not using the same database as the ActiveMatrix Administrator database.

  • Make sure the minimum hard disk space is available. For example, the total disk space required is approximately 200MB for each host in the CONFIG_HOME and an additional 300MB for the entire CONFIG_HOME.
  • If you plan to upgrade multiple hosts at the same time, increase the maximum memory in the TIBCOConfigurationTool.ini file that is located at TIBCO_HOME\tct\. If the CONFIG_HOME has more than 30 hosts and you are planning to upgrade all of them together in one TCT session, increase the maximum memory.
  • Stop all hosts and nodes that are being upgraded or downgraded.
  • Install ActiveMatrix Service Grid 3.4.1 on the same TIBCO_HOME where the earlier version was installed.
    Note: The Installation Profile should be selected depending on the profiles that are already existing in the TIBCO_HOME. If the current TIBCO_HOME contains ActiveMatrix Administrator or Business Studio or Runtime Host profiles, select and install the respective installation profile or combination of them using the Universal Installer.
  • Install the Runtime Host profile Mediation Runtime Feature, if a Node managed by the Runtime Host contains an Application that is running Mediation. To install the Runtime Host profile Mediation Runtime Feature, during installation, select the Customize Installation check box, select the Runtime Host profile, and select Mediation Runtime as shown in the following screen. This is because ActiveMatrix Administrator automatically provisions the Mediation Product Feature to the Runtime Host while installing the application on the Node even though the Mediation feature was not installed on that TIBCO_HOME.

  • In the above scenario, when the runtime host is upgraded without installing the Mediation Feature, upgrade fails with the following error (sample from the TCT console log): 
    [patchmgr.Upgrade] Exception : product feature com.tibco.amx.it.mediation.product.feature: 3.6.0 not found in any local machine model

    In this case, install the Runtime Profile again on the TIBCO_HOME along with the Mediation feature. After installing, upgrade the Runtime Host again.

  • To upgrade TIBCO ActiveMatrix Policy Director Governance, select the TIBCO ActiveMatrix PD Governance installation profile while installing ActiveMatrix Service Grid 3.4.1. TIBCO ActiveMatrix Policy Director Governance is upgraded automatically as a part of ActiveMatrix Service Grid 3.4.1 upgrade.
  • Run the diagnostic tests from the TCT Wizard to make sure the pre-requisites are met.