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 Tomcat configuration file /etc/tomcat7/server.xml.
Upgrade procedure
1.Run the following command to stop the Apache Tomcat service (in some cases, the service name is tomcat7):
sudo systemctl stop tomcat
2.Upgrade Apache Tomcat and Java.
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. |
Linux distribution |
Terminal commands |
---|---|
Debian and Ubuntu distributions |
sudo apt-get update |
CentOS and Red Hat distributions |
yum update |
OpenSUSE |
zypper refresh |
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 the HTTPS connection for Apache Tomcat is configured correctly.
See the additional Web Console configuration for enterprise solutions or low-performance systems.
6.If you have upgraded Java, follow the steps below to configure Apache Tomcat to use the latest Java package installed on your system:
a.Navigate to the Apache Tomcat configuration folder:
cd /usr/share/tomcat/conf/
b.Open the tomcat.conf file in a text editor:
nano tomcat.conf
c.Update the path to the latest installed Java package in the JAVA_HOME variable (the path differs based on the Java package installed on your system):
JAVA_HOME="/usr/lib/jvm/jre-11-openjdk"
d.Save and close the file: Press CTRL+X and then press Y and ENTER.
e.Restart the tomcat service:
sudo systemctl restart tomcat
f.Run the command below to verify the Java package used by Apache Tomcat:
sudo systemctl status tomcat
After upgrading Apache Tomcat to a later major version (for example Apache Tomcat version 7.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 ESMC or an earlier ESET PROTECT version, re-create it for ESET PROTECT 9.1 after upgrading to ensure that you have the latest Offline help matching your ESET PROTECT version. |