How to manually upgrade the tc Runtime version if the machine hosting tc Server is unable to access the tc Runtime version using the command "tcserver get-runtime"

Products

• VMware Tanzu tc Server

Issue/Introduction

This article covers how to install a new tc Runtime without direct internet access. 

According to Upgrade and Migration Guide - Upgrading Java Version, when upgrading tc Runtime instances to a new version of the tc Runtime, we need to use the get-runtime command to download and install a specific runtime version. 

However, you may be using an internet restricted environment and you need to download the package from Network.io and extract this runtime package into tc Server's base directory.

 

Environment

Product Version: 4.0

Resolution

To install a new tc Runtime without direct internet access, follow these steps:

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

2. Copy zip file to CATALINA_HOME (/opt/stargate/tcserver/pivotal-tc-server/runtimes/) and unzip the file. This creates tomcat-9.0.x.x.RELEASE at the same path.

3. Run the followng command from server installation directory (/opt/stargate/tcserver/pivotal-tc-server/standard) to upgrade tc Runtime version to v9.0.x.

/opt/stargate/tcserver/pivotal-tc-server/standard/tcserver modify-version <instance-name> -i /opt/stargate -v 9.0.x.x.RELEASE 

Note: Command modify-version: Modify the version of Tomcat that an instance runs with the command modify-version. 

4. Startup the tc Server instance and verify the current tc Runtime version.

Nov 03 14:30:08 server02v sh[10856]: Instance Name:           instance-name
Nov 03 14:30:08 server02v sh[10856]: CATALINA_BASE:           /opt/stargate/instance-name
Nov 03 14:30:08 server02v sh[10856]: CATALINA_HOME:           /opt/stargate/tcserver/pivotal-tc-server/runtimes/tomcat-9.0.x.x.RELEASE
Nov 03 14:30:08 server02v sh[10856]: tc Runtime Version:        9.0.x.x.RELEASE
Nov 03 14:30:08 server2v sh[10856]: tc Server Version:         4.0.x.RELEASE 

Tomcat version explained 

There is a letter in the Tomcat version, for example, 9.0.54.A.RELEASE. Engineering added a letter to the Tomcat version to indicate any changes that they have made.

• When the version is .A, this means there are no patches applied to the tomcat version. 
• .B or .C indicates there have been patches applied. This is usually because they have applied security or bug fixes to the tomcat version.