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


Chapter 1 Upgrading to Release 5.10.0 : Upgrade Overview

Upgrade Overview
TIBCO Runtime Agent provides libraries and functionality to TIBCO applications including TIBCO Adapter, TIBCO Administrator, TIBCO Designer, TIBCO ActiveMatrix BusinessWorks and other TIBCO applications.
This section describes the upgrade process, compatibility among releases, and identifies changes to the configuration files that are preserved and modified.
Why Upgrade?
Upgrading to TIBCO Runtime Agent 5.10 is necessary when another TIBCO product requires it, or if you want to do one of the following:
Configuration Data
Many TIBCO applications use property files (*.tra files) to store configuration information such as classpaths and Java properties that are used to launch TIBCO applications. Classpaths and properties can be modified by upper-level TIBCO products that are dependent on lower-level products in the stack.
When upgrading to TIBCO Runtime Agent 5.10, configuration and domain data from the latest 5.x installation on your machine is imported into the new installation. This means you do not have to recreate or reconfigure applications and domains and that the classpaths in the .tra files are valid.
For example, if you have both 5.7 and 5.8 installed on your machine, the designer.tra file from the TIBCO Designer 5.7 (latest resident release) is copied by the 5.10 installer and modified, so that the classpath includes the 5.8 adapter palette code as well as the 5.10 code. This enables you to use previously installed adapter palettes in TIBCO Designer 5.10 after installing release 5.10.
You should specifically check for hawkagent_domain_name.tra and tibcoadmin_domain_name.tra for each domain. The other .tra files are typically under the bin directory of each TIBCO product.
Deployed Project Data
Deployed applications will continue using the previous version of TIBCO Runtime Agent until the UpgradeManager is used on the machines where they are deployed. When those applications are redeployed, their .tra files will be updated to TIBCO Runtime Agent 5.10. This is not affected by upgrading the domain itself to use TIBCO Runtime Agent 5.10 on the target machine or TIBCO Administrator server machine. See Upgrade Applications for information on upgrading your applications.
TIBCO Product Coexistence
TIBCO products (TIBCO Runtime Agent 5.10 and TIBCO Designer 5.10) can coexist on the same machine with previous releases, but you cannot have two administration domains of the same name even if they are different versions.
Uninstalling the Previous Release
After upgrading all the domains to release 5.10 and redeploying all the applications, you can use TIBCO Installation Manager to uninstall the previous releases. You can also choose not to uninstall a previous release if you have applications that will continue to use a previous release.

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