If you are using an older version of Hyperic HQ Server, Hyperic 4.5 HQ Server includes new features and support for new releases of supported resources. To take advantage of these improvements in Hyperic 4.5, upgrade HQ Server on the computer where it is installed. The Hyperic 4.5 setup has an upgrade mode that updates an existing HQ Server installation. For complete instructions, see the vFabric Hyperic Documentation website.

After you have upgraded HQ Server to Hyperic 4.5, you can use the HQ user interface to upgrade HQ Agents on computers with tc Runtime instances. Follow the instructions to upgrade Hyperic components on the Hyperic Documentation website.

Install tc Server 2.5 in a new installation directory and create any new tc Runtime instances you want. Follow the instructions at Installing tc Server to perform the installation. To avoid overwriting files, be sure to install tc Server 2.5 in a different directory than your current installation. For example, if you have installed tc Server 2.1 in the directory /home/tcserver/springsource-tc-server-2.1, you can install vFabric tc Server 2.5 in the directory /home/tcserver/vfabric-tc-server-2.5.

Use the tcruntime-instance.sh|bat upgrade command to upgrade your tc Server 2.0 or 2.1 runtime instances to tc Server 2.5. The upgrade command, new in tc Server 2.5, migrates configuration information and applications from an existing instance to a new 2.5 instance.

By default, the upgrade command creates a new instance that uses the same version of tc Runtime as the current instance. If you want to keep the same tc Runtime version, you must ensure that the corresponding tc Runtime release exists in your tc Server 2.5 installation directory. Otherwise, the upgrade command will display an error message and quit. If necessary, copy the tc Runtime release directory from the previous tc Server installation directory into the tc Server 2.5 installation directory.

The script creates the upgraded instances in your tc Server 2.5 installation directory. For example, to upgrade the tc Server 2.1 instance at /home/tcserver/springsource-tc-server-2.1/myInstance, enter the following command in your tc Server 2.5 directory:

prompt$ ./tcruntime-instance.sh ../springsource-tc-server-2.1/myInstance upgrade

This command creates an upgraded instance with the same name as the original (myInstance) using the same version of tc Runtime.

To change the name of the upgraded instance, include the -i instanceDir option on the command.

To specify a different tc Runtime version, include the -v version option. When upgrading an unpinned instance, you must specify this option. The following example specifies a new instance name and pins the instance to tc Runtime release 7.0.6.A.RELEASE.

prompt$ ./tcruntime-instance.sh ../springsource-tc-server-2.1/myInstance upgrade 
   -i myNewInstance -v 7.0.6.A.RELEASE

See tcruntime-instance.sh Reference for more information about using this command.