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

Note

This section does not describe in detail how to upgrade your existing Hyperic components because those tasks follow the standard Hyperic upgrade procedures.

Important

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.