Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 1 Upgrading to Release 5.10.0 : Upgrade Steps

Upgrade Steps
 
Upgrade Each Primary and Secondary Administration Server
The primary administration server runs on the primary machine. A secondary administration server runs on a secondary machine. The primary administration server and secondary administration servers must use the same version of TIBCO Administrator and TIBCO Runtime Agent.
1.
If you are using a file based repository, backup your 5.x domain directories and files in TIBCO_HOME/administrator/domain. This step should be performed for each administration domain you intend to upgrade.
2.
3.
After installation, the installer launches a database configuration GUI for you to configure the path for a vendor-supplied database driver. If you skip this step by clicking Cancel, you must carefully follow the instructions given in Configuring Vendor-supplied Database Drivers later to configure your TIBCO Runtime Agent installation and administration domains.
a.
Keep the Use Vendor Native Driver selected and supply the directory path to your vendor-supplied driver.
b.
Click Next to finish.
4.
After installation, the installer launches TIBCO Domain Utility to upgrade the administration domains you select. Refer to TIBCO Runtime Agent Domain Utility User’s Guide for details.
5.
As EMS libraries are no longer shipped with TRA, 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/8.0
traUpgradeManager -path c:/tibco/administrator/domain/<domain name> -ems c:/tibco/ems/8.0
6.
If you use a vendor-supplied database driver, for each domain on the primary machine you have just upgraded, change the database driver from DataDirect to the one whose path you configured in step 3, by following the instructions in TIBCO Runtime Agent Domain Utility User’s Guide. Skip this step if you did not configure the path of a vendor-supplied database driver.
7.
If you use a vendor-supplied database driver, for each domain on the primary machine you have just upgraded, you need to run the traDBConfig utility to configure the path of the vendor-supplied database driver for the tibcoadmin_domain_name.tra file.
8.
9.
10.
a.
Be sure to configure a vendor-supplied database driver, as you have done on the primary machine.
b.
After installation, the installer launches TIBCO Domain Utility to upgrade the administration domains you select.
In case the EMS is used as a domain transport, run traUpgradeManager with –ems option. Refer step 5.
c.
d.
11.
Upgrade Each Client Machine
Client machines need not be upgraded and can be upgraded one at a time. They can be upgraded before or after the administration servers are upgraded. Installation can be done without upgrading some or all domains, with upgrading occurring later.
Follow the steps below for each client machine:
1.
2.
After installation, the installer launches a database configuration GUI for you to configure the path for a vendor-supplied database driver. If you skip this step by clicking Cancel, you must carefully follow the instructions given in Configuring Vendor-supplied Database Drivers later to configure your TIBCO Runtime Agent installation and administration domains.
a.
Keep the Use Vendor Native Driver selected and supply the directory path to your vendor-supplied driver.
b.
Click Next to finish.
3.
a.
Invoke: TIBCO_HOME/tra/5.10/bin/domainutility
b.
Click Next in the splash screen.
c.
Click Migration in the left panel.
d.
Click Upgrade Domains to 5.10 and click Next.
e.
f.
Click Next.
g.
Click Next.
4.
If you use a vendor-supplied database driver, for each domain you have just migrated, change the database driver from DataDirect to the one whose path you configured in step 2. If you didn’t select a native driver in step 2, you need to run the traDBConfig utility prior to upgrading the domain or manually change it by following the instructions in TIBCO Runtime Agent Domain Utility User’s Guide. Skip this step if you have configured the path of a vendor-supplied database driver.
5.
6.
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.10, 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.10 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.
For example, the following steps explain how to upgrade the TIBCO BusinessWorks 5.13 template file to use TIBCO Runtime Agent release 5.10 on Windows 32-bit platform. 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.10.
1.
2.
traUpgradeManager -path TIBCO_HOME\bw\5.13 -traversion 5.10 -jre TIBCO_HOME\tibcojre\1.8.0 -rv TIBCO_HOME\tibrv\8.4
3.
4.
As EMS libraries are no longer shipped with TRA, 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/8.0
traUpgradeManager -path c:/tibco/administrator/domain/<domain name> -ems c:/tibco/ems/8.0
traUpgradeManager -path c:/tibco/bw/5.13 -ems c:/tibco/ems/6.0
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.
 

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved