Copyright © Cloud Software Group, Inc. All Rights Reserved

Upgrading ActiveMatrix Implementation Type for Microsoft CLR to Version 3.3.0

TIBCO provides Ant scripts for upgrading software from a previous version.

To start using ActiveMatrix Implementation Type for Microsoft CLR 3.3.0 on the same node which have ActiveMatrix Implementation Type for Microsoft CLR 3.1.x or 3.2.0 installed, you must run the CLR upgrade script on top of the TIBCO ActiveMatrix Service Grid upgrade.

Note that this information is applicable only for upgrading from ActiveMatrix Implementation Type for Microsoft CLR version 3.1.x or 3.2.0 to 3.3.0.

Prerequisites

•	You must upgrade ActiveMatrix Service Grid to version 3.3.0. For details, see the Upgrade chapter of the TIBCO ActiveMatrix Service Grid Installation and Configuration guide.

•	You must install ActiveMatrix Implementation Type for Microsoft CLR version 3.3.0 in the same TIBCO_HOME in which version 3.1.x or 3.2.0 of ActiveMatrix Implementation Type for Microsoft CLR was installed. For details, see Install the ActiveMatrix Implementation Type for Microsoft CLR.

Upgrading ActiveMatrix Implementation Type for Microsoft CLR from Version 3.2.0

You can upgrade ActiveMatrix Implementation Type for Microsoft CLR to version 3.3.0 by performing the following steps:

1.	Go to the ant script folder at TIBCO_HOME\amx_it_clr\3.3\scripts.

2.	Run the following Ant script:

ant upgrade-clrit -f upgrade-to-3.3.0.xml -Dtibco.config.mgmt.home=CONFIG_HOME
-Denterprise.name=enterprise -Dtibcohost.instance.name=Admin-enterprise-instance -Dadmin.server.name=instance -Dnode.name=node -Denvt.name=DevEnvironment -Dhost.name=SystemHost

where:

CONFIG_HOME is the directory in which configuration data is stored. This is specified when running the TIBCO Configuration Tool (TCT) to create an ActiveMatrix Administrator server and TIBCO Host instance.

enterprise is the name of the enterprise.

instance is the name of the ActiveMatrix instance.

node is the name of the node.

For example:

ant upgrade-clrit -f upgrade-to-3.3.0.xml -Dtibco.config.mgmt.home=C:\ProgramData\amx315UP\data -Denterprise.name=amxadmin -Dtibcohost.instance.name=Admin-amxadmin-instanceOne -Dadmin.server.name=instanceOne -Dnode.name=DevNode -Denvt.name=DevEnvironment -Dhost.name=SystemHost

After completing these steps, the application template is upgraded completely for version 3.3.0, with the user applications running successfully.

Upgrading ActiveMatrix Implementation Type for Microsoft CLR from Version 3.1.x

Upgrading ActiveMatrix Implementation Type for Microsoft CLR from version 3.1.x to version 3.3.0 involves one more step in addition to the steps mentioned for upgrading from version 3.2.0.

1.	Perform the steps mentioned in Upgrading ActiveMatrix Implementation Type for Microsoft CLR from Version 3.2.0.

When the Ant script completes, the ActiveMatrix Implementation Type for Microsoft CLR application template is upgraded to version 3.3.0, but all dependent applications are in the following state: "Deployed with Start Failed".

2.	To resolve this, do one of the following:

−	If the node being updated is on the same machine as ActiveMatrix Administrator, run the following Ant script:

ant clean-up -f upgrade-to-3.3.0.xml -Dtibco.config.mgmt.home=CONFIG_HOME -Denterprise.name=enterprise -Dtibcohost.instance.name=Admin-enterprise-instance -Dadmin.server.name=instance -Dnode.name=node -Denvt.name=DevEnvironment -Dhost.name=SystemHost

where:

CONFIG_HOME is the directory in which configuration data is stored. This is specified when running TIBCO Configuration Tool (TCT) to create an ActiveMatrix Administrator server and TIBCO Host instance.

enterprise is the name of the enterprise.

instance is the name of the ActiveMatrix instance.

node is the name of the node.

For example:

ant clean-up -f upgrade-to-3.3.0.xml -Dtibco.config.mgmt.home=C:\ProgramData\amx315UP\data -Denterprise.name=amxadmin -Dtibcohost.instance.name=Admin-amxadmin-instanceOne -Dadmin.server.name=instanceOne -Dnode.name=DevNode -Denvt.name=DevEnvironment -Dhost.name=SystemHost

−	If the node being upgraded is on a remote machine, you must manually delete the version 3.1.x-specific files from the node\bin directory, as follows:

- Stop the node.

- Create a backup directory with the name “bin-backup” in the node directory.

- Cut and paste all of the .dll, .pdb, and .config files from the node\bin directory to the node\bin-backup directory.

- Restart the node

After completing these steps, the application template is upgraded completely for version 3.3.0, with the user applications running successfully.

Copyright © Cloud Software Group, Inc. All Rights Reserved