Upgrade and Migration Guide

Several upgrade procedures are supported for this release of vFabric tc Server.


Upgrade a tc Server Instance to a New Version of tc Server

RHEL: Upgrade Using the VMware RPM Repository

Ubuntu: Upgrade Using the vFabric Debian Package Repository

Run an ERS Tomcat Instance on tc Server

Migrate an ERS Tomcat Instance to tc Server

Upgrade a tc Server Instance to a New version of tc Server

This section has instructions for upgrading tc Server instances to a new version of tc Server.

You use the tcruntime-instance.sh upgrade or (tcruntime-instance.bat upgrade) command to upgrade an existing tc Server instance to a new version of tc Server. The upgrade command migrates configuration information and applications from an existing instance to the new one. The command takes this form:

 tcruntime-instance.sh -v
        tcRuntimeVersion -i PathToNewInstanceDirectory PathToOldInstance  


tcRuntimeVersion is the Tomcat binary that you want the new instance to use, for example, 7.0.37.B.RELEASE. Note that:

  • The tc Runtime binary must exist in the new tc Server installation directory. If you want to use a binary that exists in your previous tc Server installation, but not the new one, you must copy it into the new tc Server installation directory.

  • If you do not use the -v option to specify a binary, the upgrade assumes you do not want to upgrade the binary and tries to create the new instance with the same binary. If the older instance uses a version of Tomcat that does not exist in the new version of tc Server, you must copy it from the older tc Server installation to the new one, or the upgrade will fail.

PathToNewInstanceDirectory specifies the directory in which you want the upgraded instance to be created. Note that:

  • If you do not use the -i option specify a directory, the instance will be created in the current working directory.

  • If you specify the directory where the old instance runs, that instance will be upgraded in place.

PathToOldInstance points to the instance that you wish to upgrade.

Before You Start

Be sure to stop a tc Server instance before you upgrade. For instructions, see Starting and Stopping tc Runtime Instances.


The example commands in the instructions below assume you are upgrading a tc Server 2.8.2 instance to 2.9.1.

  1. Install the new version of tc Server in a new installation directory, as described in Installing vFabric tc Server. For example, if tc Server 2.8.2 is installed in /opt/vmware/vfabric-tc-server-standard-2.8.2.RELEASE, install tc Server 2.9.1 in /opt/vmware/vfabric-tc-server-standard-2.9.1.RELEASE.

  2. If the directory where you want the upgraded server instance to be installed does not exist, create it.

  3. Change directory to new TCS installation directory. For example:

    cd /opt/vmware/vfabric-tc-server-standard-2.9.1.RELEASE 
  4. Run the upgrade command. For example:

    tcruntime-instance.sh upgrade -i ../tcs-2.9.1-instances -v 7.0.37.B.RELEASE  ../tcs-2.8.2-instances/myserver1

    The command above creates an upgraded version of the "myserver1" instance in the /tcs-2.9.1-instances directory.