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 entireCONFIG_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 theCONFIG_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.2 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 theTIBCO_HOME
. If the currentTIBCO_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 checkbox, 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.2. TIBCO ActiveMatrix Policy Director Governance is upgraded automatically as a part of ActiveMatrix Service Grid 3.4.2 upgrade.
- Run the diagnostic tests from the TCT Wizard to make sure the pre-requisites are met.