Manually updating Apache Tomcat 9 for the Link application

This procedure defines the steps to manually update the installed Apache Tomcat 9 software for the Link application. If the currently installed version of Apache Tomcat 9 has a security issue that is resolved in a later version, you can follow these steps to update it.

Important: Ensure that you back up the <Link installation folder>tomcat-context/install/restapi/ folder.

To manually update Apache Tomcat 9 for Link application on Linux native platform, complete the following steps:

Download the latest Linux binaries of Apache Tomcat 9 in tar.gz format from the official Apache Tomcat website.
Open a Linux terminal window and change the current directory to the Link installation directory <Link installation folder>.

Important: Ensure that you are logged in as the same user who initially installed the Link application.
Execute the following commands to stop and uninstall the current Link installation:
```
./Link stop
./Link uninstall
```
Change the current directory to the installation directory <Link installation folder>/tomcat-context, run the following command:
```
cd <Link installation folder>/tomcat-context
```
Create a temporary folder and extract the contents of Link hip-core.tar.gz to it, run the following command:
```
mkdir tmp
tar -xf hip-core.tar.gz -C tmp
```
Copy the downloaded tar.gz binaries into <Link installation folder>/tomcat-context/tmp/restapi/tomcat folder.
Open the dtxtomcat.ini configuration file located at <Link installation folder>/tomcat-context/tmp/restapi/tomcat/ location using a Text Editor. Update the string TomcatVersion=9.0.XX to match the version of the downloaded Apache Tomcat 9 from Step 1. Save the changes.
Update the Link hip-core.tar.gz file by running the following command from the <Link installation folder>/tomcat-context/tmp folder:
```
tar -czf ../hip-core.tar.gz .
```
Change the current directory to the Link installation directory <Link installation folder>, by running the following command:
```
cd <Link installation folder>
```
Execute the following commands to install and start Link:
```
./Link install
./Link start
```