Post Upgrade Actions

The TIBCO Configuration Tool (TCT) Upgrade or Downgrade wizard uses the updateManifest command of the Host Manager internally to update the software dependencies to be compatible with the current release of ActiveMatrix Service Grid. This includes system application dashboard client component dependency and the javax.servlet package dependency.

In the post-update action, manifest files of the jars and plugins running in the host are updated to expand the javax.servlet package dependency range so that it works with Jetty. With this, the current version of the jars running in the host are compatible with ActiveMatrix 3.4.0 without user intervention.

This action updates all the features installed by ActiveMatrix platform, ActiveMatrix system applications, all web applications (both system and user) and the features/applications uploaded by the users.

Note: To see what are the changes that the post install action will be doing, you can perform a dry run of the post install action before upgrading. This can be done using the dryRun option of the updateManifest command of the HostManager.

For example, run the following command: 

>tibco_hostmgr.exe updateManifest -configHomeLocation <CONFIG_HOME> -instanceNames <my-instance> -clearCache -dryRun
A sample output of the command is shown below: 
Following is the list of all tibcohost instances in config_home E:\amxconfig\admin1
Admin-amxadmin-instanceOne
Updating the manifest for following instance : "Admin-amxadmin-instanceOne"
 
INFO: Updating the bundles in Node name: "DevNode" 
The Manifest Updater searching in the directory : 'E:\amxconfig\admin1\tibcohost\Admin-amxadmin-instanceOne\data_3.2.x\nodes\DevNode\work\cf'
    
INFO: Updating the bundles in Node name: "SystemNode" 
The Manifest Updater searching in the directory : 'E:\amxconfig\admin1\tibcohost\Admin-amxadmin-instanceOne\data_3.2.x\nodes\SystemNode\work\cf'
        
The Component Details
Application name : 'com.tibco.amx.platform.dashboard'  
Component Name : 'DashBoardWebApp' 
Component ID : '76d6dc95-3fc2-4a8f-a941-93f8cd15a16a' 
Component Path : 'E:\amxconfig\admin1\tibcohost\Admin-amxadmin-instanceOne\data_3.2.x\nodes\SystemNode\work\cf\76d6dc95-3fc2-4a8f-a941-93f8cd15a16a' 
Before com.tibco.amx.dashboard.client version = [1.0.0,1.0.100) 
After com.tibco.amx.dashboard.client version = [1.0.0,2.0.0) 
INFO: Bundle file updated of location : 'E:\amxconfig\admin1\tibcohost\Admin-amxadmin-instanceOne\data_3.2.x\nodes\SystemNode\work\cf\76d6dc95-3fc2-4a8f-a941-93f8cd15a16a\bundle'

The Component Details
Application name : 'com.tibco.amx.platform.artifactserver'
Component Name : 'ArtifactServer'
Component ID : '911ff791-ea69-4de0-b939-fb41b7744c61'
Component Path : 'E:/amxconfig/admin1\tibcohost\Admin-amxadmin-instanceOne/data_3.2.x/nodes/SystemNode/work/cf/911ff791-ea69-4de0-b939-fb41b7744c61'
Before javax.servlet.http version = [2.5.100,3.0.0)
After javax.servlet.http version = [2.5.100,4.0.0)

You can refer to the Example: Upgrade Scenario section for a sample output of the logs after updating the javax.servlet package dependency.

To skip the post install step, you can uncheck the post install action check box in the TCT Upgrade/Downgrade summary screen.

It is recommended to enable post-upgrade action on the Administrator instance. If you do not want to run the post-upgrade action, manually update the applications to depend on the new javax.servlet package and un-check post upgrade action while upgrading.

Note: If the dependencies are not updated, node start fails with errors in the node logs.

In this case, update the application depending on javax.servlet package manually and re-deploy the application OR select the post install action checkbox and run the upgrade again.

Note: If you have existing CLI scripts that were running with ActiveMatrix Service Grid 3.3.x setup and if you have upgraded to ActiveMatrix Service Grid 3.4.0, the existing build.xml CLI scripts must be updated to include <import file="${TIBCO_HOME}/administrator/3.4/scripts/basic_cli.xml" /> instead of <import file="${TIBCO_HOME}/administrator/3.3/scripts/basic_cli.xml" /> .