This chapter describes how to perform the following supported upgrade procedures:
• Upgrading a vFabric tc Server 2.1.X Installation to 2.6
• Upgrading a 2.6.X tc Runtime to the Latest Version
Upgrading a 2.0.X, 2.1.X, or 2.5.X tc Server Installation to 2.6
This section describes how to upgrade an existing 2.0.X, 2.1.X, or 2.5.X tc Server installation to tc Server 2.6.X. The upgrade procedure includes the following tasks:
• Upgrade Hyperic Server to vFabric Hyperic 4.6
• Install Hyperic Agent 4.6 on computers that have tc Runtime
• Install tc Server 2.6
• Upgrade existing tc Runtime instances to 2.6
Upgrade Hyperic Server to Hyperic 4.6
If you are using an older version of Hyperic Hyperic Server, Hyperic 4.6 Server includes new features and support for new releases of supported resources. To take advantage of these improvements in Hyperic 4.6, upgrade Hyperic Server on the computer where it is installed. The Hyperic 4.6 setup has an upgrade mode that updates an existing Hyperic Server installation.
For complete instructions, see "Upgrade Hyperic Components/Server Upgrade Procedure" in vFabric Hyperic Installation Guide.
Install Hyperic Agent 4.6
After you have upgraded Hyperic Server to Hyperic 4.6, you can use the Hyperic user interface to upgrade Hyperic Agents on computers with tc Runtime instances. Follow the instructions to upgrade Hyperic components in "Upgrade Hyperic Components/
Agent Upgrade Procedure" in vFabric Hyperic Installation Guide.
Install tc Server 2.6
Install tc Server 2.6 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.6 in a different directory than your current installation. For example, if you have installed tc Server 2.1 in the directory /opt/vmware/
springsource-tc-server-2.1, you can install vFabric tc Server 2.6 in the directory /opt/vmware/vfabric-tc-server-2.6.
Upgrade Existing tc Runtime Instances to 2.6
Use the tcruntime-instance.sh|bat upgrade command to upgrade your tc Server 2.0 or 2.1 runtime instances to tc Server 2.6. The upgrade command, new in tc Server 2.6, migrates configuration information and applications from an existing instance to a new 2.6 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.6 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.6 installation directory.
The script creates the upgraded instances in your tc Server 2.6 installation directory. For example, to upgrade the tc Server 2.1 instance at /opt/vmware/springsource-tc-server-2.1/myInstance, enter the following command in your tc Server 2.6 directory:
prompt$ ./tcruntime-instance.sh upgrade ../springsource-tc-server-2.1/myInstance
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 upgrade -i myNewInstance -v 7.0.6.A.RELEASE ../springsource-tc-server-2.1/myInstance
See tcruntime-instance.sh Reference for more information about using this command.
Upgrading a 2.6.X tc Runtime to the Latest Version
The procedure in this section describes how to upgrade a tc Runtime installation (such as 2.6.0) to a later version (such as 2.6.1).
The instructions assume your existing tc Runtime environment is the result of following the Quick Start instructions This section does not describe in detail how to upgrade your existing Hyperic components because those tasks follow the standard Hyperic upgrade procedures.
You can follow the instructions in the section to upgrade a tc Runtime 2.6.X release to a later 2.6.X release. If you want to upgrade from an earlier release, for example from 2.1.X to 2.6.X, follow the instructions at Upgrading a 2.1.x tc Server Installation to 2.6.
Understanding the Overall tc Server Upgrade Process
Upgrading a 2.6.X tc Server installation to a later version consists of the following subtasks:
• Optionally upgrade your existing Hyperic Server and Agent to a later version than you have currently installed. See the Release Notes for the fully-qualified version of the Hyperic Server and Agent that a particular version of tc Server supports.
The release notes also indicate the version of Hyperic that contains a particular version of the tc Server Hyperic plug-in.
To perform this subtask, you download the Hyperic EE distribution and use its setup.sh -upgrade (Unix) or
setup.bat -upgrade (Windows) command script to perform the upgrade. To upgrade an existing Hyperic Agent, unzip the latest version alongside the existing one.
For details, see "Upgrade Hyperic Components" in vFabric Hyperic Installation Guide.
• Install the new 2.6.X tc Runtime in a new directory.
To perform this subtask, unzip the appropriate tc Server distribution into a newly created installation directory. Then, if required, use the tcruntime-instance.sh upgrade command to upgrade each tc Runtime instance.
For details, see the next section.
Depending on how you have configured your tc Server installation, you might perform different subtasks on different computers.
For example, on the computer on which you have installed the Hyperic Agent and runtime component (called a managed node), you perform only the Agent and Runtime upgrade. On the computer on which you installed the Hyperic Server (and nothing else), you perform only the Hyperic Server upgrade. If you installed all components on the same computer, then simply execute all subtasks on the same computer.
Most of the examples in this section use Unix syntax; if you are upgrading on Windows, change the forward slashes to back-slashes and replace the *.sh suffix with *.bat when running a command script. Other changes between the two platforms are called out.
tc Runtime Upgrade Procedure
The examples in this procedure assume you are upgrading a 2.6.0 tc Runtime to version 2.6.1 (unless otherwise noted.) The procedure describes only how to upgrade the tc Runtime and associated instances. To upgrade Hyperic components follow the instructions in "Upgrade Hyperic Components" in vFabric Hyperic Installation Guide.
To upgrade your 2.6.X tc Runtime to a later 2.6.X version, follow these steps:
1. Unix only: Read Important Note When Installing on Unix Platforms to ensure your tar command works with tc Server bundles.
2. Back up your existing tc Runtime installation, including all your tc Runtime instances.
3. Start a terminal (Unix) or Command Prompt (Windows).
4. If they are running, stop your tc Runtime instances. For example, if you installed tc Runtime in /opt/vmware/
vfabric-tc-server-standard-2.6.0.RELEASE and you have a tc Runtime instance called myserver:
prompt$ cd /opt/vmware/vfabric-tc-server-standard-2.6.0.RELEASE prompt$ ./tcruntime-ctl.sh myserver stop
If your tc Runtime instance is located in a directory other than the main tc Server installation directory, use the INSTANCE-DIR/bin/tcruntime-ctl.sh script to stop the instance; in this case, you do not specify the name of the instance as a parameter to the script. For example:
prompt$ cd /var/opt/vmware/vfabric-tc-server-standard//myserver/bin prompt$ ./tcruntime-ctl.sh stop
5. Windows only. If you installed the tc Runtime instances as Windows services, uninstall them. For example, if you installed the runtime in \opt\vmware\vfabric-tc-server-standard-2.6.0.RELEASE and you created a tc Runtime instance called myserver:
prompt> cd \opt\vmware\vfabric-tc-server-standard-2.6.0.RELEASE prompt> tcruntime-ctl.bat myserver uninstall
If your tc Runtime instance is located in a directory other than the main tc Server installation directory, use the INSTANCE-DIR\bin\tcruntime-ctl.bat script to stop the instance; in this case, you do not specify the name of the instance as a parameter to the script. For example:
prompt> cd \var\opt\vmware\vfabric-tc-server-standard\myserver\bin prompt> tcruntime-ctl.bat uninstall
See Windows: Starting and Stopping tc Runtime Instances as Windows Services.
6. Download the appropriate tc Server distribution file from the VMware Download Center.
Typically, you download the Standard Edition of tc Server in either the compressed TAR or ZIP format; for example:
• vfabric-tc-server-standard-2.6.1.RELEASE.tar.gz
• vfabric-tc-server-standard-2.6.1.RELEASE.zip
7. Unzip or untar the new 2.6.X package into a new directory, parallel to your existing tc Server installation. For example, if your existing tc Server is installed in /opt/vmware/vfabric-tc-server-standard-2.6.0.RELEASE and you downloaded the new package into the /home/Downloads directory:
prompt$ cd /opt/vmware
prompt$ unzip /home/Downloads/vfabric-tc-server-standard-2.6.1.RELEASE.zip
The preceding command creates a new directory alongside the existing tc Server installation directory.
8. Upgrading tc Runtime instances. This step describes how to upgrade your existing tc Runtime instances to the new version. From your terminal (Unix) or Command Prompt (Windows), change to the new tc Server installation directory. For example:
prompt$ cd /opt/vmware/vfabric-tc-server-standard-2.6.1.RELEASE
For each existing tc Runtime instance you want to upgrade, run the following command:
prompt$ ./tcruntime-instance.sh upgrade --instance-directory instanceDir instance
where:
• instanceDir refers to the full or relative pathname of the directory in which the instance lives.
• instance refers to the name of the subdirectory that contains the tc Runtime instance you want to upgrade, such as myserver
For example, to upgrade an instance named myserver from tc Server 2.6.0 to tc Server 2.6.1, issue these commands:
prompt$ cd /opt/vmware/vfabric-tc-server-standard-2.6.1.RELEASE
prompt$ ./tcruntime-instance.sh upgrade --instance-directory ../tc-server-standard-2.6.0.RELEASE myserver
Because you do not specify a specific tc Runtime version, the tcruntime-instance.sh|bat script pins the instance to the latest version of tc Runtime it can find when it starts. Generally, this is the tc Runtime version bundled with the new tc Server distribution you are installing. The upgrade command cannot change the major tc Runtime version (tc Runtime 6 or tc Runtime 7), but it will upgrade the instance to the latest minor version available in the tc Server installation directory.
9. Start the tc Runtime instances as described in Starting and Stopping tc Runtime Instances. The startup messages should indicate that the instance is now using the latest tc Runtime version (such as 6.0.32.A) as its core. For example:
prompt$ cd /opt/vmware/vfabric-tc-server-standard-2.6.1.RELEASE prompt$ ./tcruntime-ctl.sh myserver start
INFO Instance name: myserver
INFO Script directory: /opt/vmware/vfabric-tc-server-standard-2.6.1.RELEASE INFO tc Runtime location:/opt/vmware/vfabric-tc-server-standard-2.6.1.RELEASE INFO Instance base: /opt/vmware/vfabric-tc-server-standard-2.6.1.RELEASE
INFO Binary dir: /opt/vmware/vfabric-tc-server-standard-2.6.1.RELEASE/tomcat-6.0.32.A.RELEASE INFO Runtime version: 6.0.32.A.RELEASE
INFO Script version: 2.6.1.RELEASE
Using CATALINA_BASE: /opt/vmware/vfabric-tc-server-standard-2.6.1.RELEASE/myserver
Using CATALINA_HOME: /opt/vmware/vfabric-tc-server-standard-2.6.1.RELEASE/tomcat-6.0.32.A.RELEASE Using CATALINA_TMPDIR: /opt/vmware/vfabric-tc-server-standard-2.6.1.RELEASE/myserver/temp
Using JRE_HOME: /var/opt/java/jdk1.6.0_24
Using CLASSPATH: /opt/vmware/vfabric-tc-server-standard-2.6.1.RELEASE/myserver/bin/tomcat-juli.jar:
/opt/vmware/vfabric-tc-server-standard-2.6.1.RELEASE/tomcat-6.0.32.A.RELEASE/bin/bootstrap.jar
When you complete this procedure, you will have successfully upgraded your existing 2.6.X tc Runtime to a later version of 2.6.