Upgrade and Migration Guide

Please review the Upgrade Best Practices Guide which provides best practices on upgrading.

Note: It is not possible to use the upgrade command to upgrade between tc Runtime major versions for example: A tc Runtime instance using tc Runtime 9.0.85.A.RELEASE can not be upgraded to 10.1.18.A.RELEASE. It is recommended to use instance descriptor files to create instances which allows instances to be recreated with a newer tc Runtime major version later.

Upgrade an Instance to a Newer tc Runtime Binary

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

For example, suppose that your tc Server release came bundled with 10.1.16.A.RELEASE. Later, you could decide to upgrade to the 10.1.18.A.RELEASE (or another version) when it is released. The instructions in this section enable you to stay current with new tc Runtime releases without fully installing the full tc Server installation. This lets you take advantage of getting the latest features, security vulnerability fixes, and bug fixes.

Before You Start

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

Procedure

Download and install the new version of tc Server containing the desired tc Runtime version then change directory to the new tc Server installation directory. For example:
```
cd -10.1.20.A
```
Run the upgrade subcommand of tcserver. Pointing it at the instance. This will upgrade in place the instance.
```
tcserver upgrade ../instances/myinstance
```

This will upgrade the instance to use the latest version of tc Runtime available to the tcserver command.

Upgrading Java Version

It is recommended to create a duplicate instance prior to upgrading Java. The duplicate instance can be used for testing purposes.

To upgrade the java version, the JAVA_HOME variable in bin/setenv.sh (Unix) or bin/setenv.bat (Windows)