Upgrade Applications

If you do not uninstall your existing 5.x TIBCO Runtime Agent release, you need not upgrade your applications. They will continue to run using the Runtime Agent release they were configured to use. However, if you want your applications to use release 5.13.0, you must follow the steps in this section to enable them to do so.

If a machine with prior versions of TIBCO Runtime Agent already has applications deployed on it, the deployed application’s .tra files will continue to refer to the previous versions of TRA, TPCL, and JRE. Installing TIBCO Runtime Agent 5.13.0 and re-deploying those applications will not update the TRA, TPCL, and JRE references in the deployed services’ .tra files.

You must use the traUpgradeManager utility to upgrade the references in the product’s .tra template file, and then undeploy and redeploy each service. The traUpgradeManager utility is in the TIBCO_HOME/tra/version/bin folder. A product’s template file is located in the product’s bin directory.

After updating the BusinessWorks template file and using TIBCO Administrator to undeploy and redeploy a BusinessWorks process instance, its .tra file will be updated to use TIBCO Runtime Agent 5.13.0.

    Procedure

  1. In the command line, change the directory to TIBCO_HOME/tra/5.13.0/bin.

  2. Invoke the following command. The first option is the location of the BusinessWorks home and the second option is the TIBCO Runtime Agent release number to upgrade to.

    traUpgradeManager -path TIBCO_HOME\bw\5.x -traversion 5.13.0 -jre TIBCO_HOME\tibcojre64/17 -rv TIBCO_HOME\tibrv\8.7

  3. Using TIBCO Administrator, undeploy and redeploy each TIBCO BusinessWorks 5.x process instance.

  4. As EMS libraries are no longer shipped with TIBCO Runtime Agent, run traUpgradeManager with -ems option to update the tibcoadmin_domainname.tra and hawkagent_domainname.tra files in case the domain uses EMS transport. The traUpgradeManager utility will update the path and classpath in the tra files by adding the location of the EMS libraries.

    traUpgradeManager -path <TIBCO_HOME or the domain path> -ems location where EMS is installed.

    traUpgradeManager -path c:/tibco/tra/domain/<domain name> -ems c:/tibco/ems/x.x

    traUpgradeManager -path c:/tibco/administrator/domain/<domain name> -ems c:/tibco/ems/x.x

    traUpgradeManager -path c:/tibco/bw/5.x -ems c:/tibco/ems/x.x

Repeat the same steps for other products whose services you need to update, and then use TIBCO Administrator to undeploy and redeploy each product service instance.