How to upgrade Tomcat 10 in MFT Command Center and Internet Server v8.7.0

How to upgrade Tomcat 10 in MFT Command Center and Internet Server v8.7.0

book

Article ID: KB0138332

calendar_today

Updated On:

Products Versions
TIBCO Managed File Transfer Command Center 8.7.0
TIBCO Managed File Transfer Internet Server 8.7.0

Description

You may need to upgrade Tomcat before TIBCO can release a hotfix for MFT.  This document describes the process of creating an upgrade from the official Tomcat distribution and deploying the upgrade to the MFT servers.  The initial steps of downloading the official distribution of Tomcat and creating the upgrade file can be done on any computer.  It does not have to be the same computer that is hosting MFT.   This upgrade file will later be deployed to the actual MFT installation host.  

Note: Tomcat 10 can only be used with MFT version 8.7.0 and higher.  Prior versions of MFT used Tomcat 9.  The two versions of Tomcat are not compatible.

Environment

All supported environments.

Resolution

Below is a summary of the steps to be followed:

- Download the official Tomcat 10 distribution

- Create a jar file which is a subset of the official distribution

- Copy the jar file to your MFT installation

- Stop the MFT server

- Unjar the Tomcat upgrade 

- Restart the MFT server

 

Tomcat maintains a web page with the latest security updates to Tomcat 10

https://tomcat.apache.org/security-10.html

Prerequisites

You will need software installed to unzip files.

You will need a Java JDK installed in order to use the jar command.  The version of java is not important.  Make sure that java is in your path so that you can run the jar command.  

Download the official Tomcat distribution

Go to the Tomcat 10 download page to get the latest version

https://tomcat.apache.org/download-10.cgi

 

This page will display the latest version available of Tomcat 10

Go to the “Binary Distributions” section

Go to the “Core” subsection

Click on the “zip” link to download the file

image.png

In this example you should now have a file named apache-tomcat-10.1.52.zip on your local filesystem.

Create a jar file which is a subset of the official distribution

We only need the jar files from the official distribution so we need to extract them and generate a new jar file which we will deploy to MFT.

 

Create a blank directory from which you will be working out of.  This will be your “working directory”.  

Copy the apache-tomcat-x.x.x.zip file you downloaded to your working directory and unzip it here.

This will create a directory with the same name as the zip file.

In this example it creates a directory named “apache-tomcat-10.1.52”

Create a directory named “mft” under the working directory

Under the mft folder create a folder named “server”

Under the server folder create two folders named “lib” and “bin”



If you are using Tomcat 10.1.52 then your working folder would look like this.

image.png

Next you will copy the jar files from the Tomcat distribution folder to the mft folder.

Copy all of the files in the apache-tomcat-x.x.x/lib directory to the mft/server/lib directory.

In Tomcat 10.1.52 there are 35 jars in this directory.

 

Copy the following files from the apache-tomcat-x.x.x/bin directory to the mft/server/bin directory

bootstrap.jar

commons-daemon.jar

tomcat-juli.jar

 

Now we just need to jar up the contents of the mft directory

Go into the mft directory

Run the following command

jar cvf tomcat-upgrade.jar .

Note: there is a single dot character at the end of the command.  This means that the contents of the current directory will be jarred up.

You should now have a tomcat-upgrade.jar file in the mft directory

Copy the jar file to your MFT installation

Copy the tomcat-upgrade.jar file to the installation directory of MFT on the host on which it is running.  This install directory contains the installer.jar, install.bat and server.jar files among others.

Stop the MFT server

Unjar the Tomcat upgrade 

Run the following to unjar the upgrade file

jar xvf tomcat-upgrade.jar

You can confirm the upgrade worked by running the version command from the server/bin directory.  This will print out the version of Tomcat.

 

Update the version.properties file in your server directory.  Change the version to match the version you upgraded to.

Below is an example of the contents of the version.properties file

# Tomcat version file

major=10

minor=1

revision=52

hotfix=0

 

You will most likely only need to change the revision number

Restart the MFT server

Issue/Introduction

How to upgrade Tomcat 10 in MFT Command Center and Internet Server v8.7.0