Upgrade Apache Tomcat (Linux)

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

Before upgrading Apache Tomcat

1.Ensure that Java is updating correctly on your system.

Verify that the openjdk package has been updated (see below).

2.Check to see which version of Apache Tomcat is currently used. If a newer version is available, perform an upgrade:

Execute the following command: cd /usr/share/tomcat/bin && ./version.sh (in some cases the folder name is tomcat7 or tomcat8)

3.Check our list of supported versions of Apache Tomcat to ensure that the new version is compatible with ESET products.

4.Backup Tomcat configuration file /etc/tomcat7/server.xml.

How to upgrade

1.Stop the Apache Tomcat service:

Execute the following command: service tomcat stop (in some cases the service name is tomcat7)

2.Upgrade Apache Tomcat and Java. Use the terminal commands depending on your Linux distribution(s). Example package names below may differ from packages available in your Linux distribution repository.

Debian and Ubuntu distributions

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

CentOS, Red Hat and Fedora distributions

yum update
yum install java-1.8.0-openjdk tomcat

OpenSUSE

zypper refresh
zypper install java-1_8_0-openjdk tomcat

3.Replace the /etc/tomcat9/server.xml file with the server.xml file from your backup.

4.Open the server.xml file and make sure the keystoreFile path is correct.

5.Make sure HTTPS connection for Apache Tomcat is set up properly.

note

Note

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

important

Important

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

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

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 ERA/ESMC or an older ESET PROTECT version, re-create it for ESET PROTECT 8.0 after upgrading. This ensures that you have the latest Offline help matching the version of your ESET PROTECT.