ESET Online Help

Search English
Select the category
Select the topic

Upgrade Apache Tomcat and Java (Linux)

Apache Tomcat is a mandatory component required to run the ESET PROTECT Web Console.

Before upgrading

1.Execute the following command to see the installed version of Apache Tomcat (in some cases, the folder name is tomcat7 or tomcat8):

cd /usr/share/tomcat/bin && ./version.sh

2.If a later version is available:

a.Ensure that the later version is supported.

b.Back up the server.xml Tomcat configuration file. (File location may vary based on the Linux distribution, for example /etc/tomcat9/server.xml).

Upgrade procedure

1.Run the following command to stop the Apache Tomcat service (in some cases, the service name is tomcat9):

sudo systemctl stop tomcat

2.Upgrade Apache Tomcat and Java.


warning

Packages may have different names and may not be available in the default repository

Example package names below may differ from your Linux distribution repository packages.

The default repository of your Linux distribution may not contain the latest supported version of Apache Tomcat and Java.

For installation and configuration of Apache Tomcat, see the Apache Tomcat documentation.

Linux distribution

Terminal commands

Debian and Ubuntu distributions

sudo apt-get update
sudo apt-get install openjdk-17-jdk tomcat9

Red Hat distributions

yum update
yum install java-17-openjdk tomcat

SUSE Linux

zypper refresh
sudo zypper install java-17-openjdk tomcat9

3.Replace the server.xml file with the server.xml file from your backup.

4.Ensure the HTTPS connection for Apache Tomcat is configured correctly.

See the additional Web Console configuration for enterprise solutions or low-performance systems.


note

If you have upgraded Java, ensure to configure Apache Tomcat to use the latest Java package installed on your system.


important

After upgrading Apache Tomcat to a later major version (for example, 8.x to 9.x):

1.Deploy ESET PROTECT Web Console again (see ESET PROTECT Web Console installation - Linux)

2.Reuse %TOMCAT_HOME%/webapps/era/WEB-INF/classes/sk/eset/era/g2webconsole/server/modules/config/EraWebServerConfig.properties to preserve any custom settings in ESET PROTECT Web Console.

The Web Console and Apache Tomcat upgrade clears the Offline help files. If you used Offline help with an earlier ESET PROTECT On-Prem version, re-create it for ESET PROTECT On-Prem 11.1 after upgrading to ensure that you have the latest Offline help matching your ESET PROTECT On-Prem version.