Upgrade Apache Tomcat using the All-in-one installer (Windows)

Apache Tomcat is a mandatory component required to run the ESMC Web Console. You can use this method to quickly upgrade Apache Tomcat using the latest ESMC 7.1 All-in-one installer. Alternatively, you can upgrade Apache Tomcat manually.

1.Back up the following files:

C:\Program Files\Apache Software Foundation\[ Tomcat folder ]\.keystore
C:\Program Files\Apache Software Foundation\[ Tomcat folder ]\conf\server.xml
C:\Program Files\Apache Software Foundation\[ Tomcat folder ]\webapps\era\WEB-INF\classes\sk\eset\era\g2webconsole\server\modules\config\EraWebServerConfig.properties

If you are using a custom SSL certificate store in the Tomcat folder, also back up that certificate.

warning

Warning

If a custom version of Apache Tomcat is installed (manual installation of the Tomcat service), the subsequent ESMC Web Console upgrade via the All-in-one installer or via Components Upgrade Task is not supported.

Apache Tomcat upgrade will delete the era folder located in C:\Program Files\Apache Software Foundation\[ Tomcat folder ]\webapps\. If you use the era folder to store additional data, make sure to backup the data before upgrading.

If C:\Program Files\Apache Software Foundation\[ Tomcat folder ]\webapps\ contains additional data (other than the era and ROOT folders), the Apache Tomcat upgrade will not take place and only the Web Console will be upgraded.

2.Launch the All-in-one installer by double-clicking the setup.exe file and in the Welcome screen, click Next.

3.Select Upgrade all components and click Next.

package_installation_upgrade

4.After accepting the EULA, click Next.

5.The All-in-one installer automatically detects if the upgrade is available: there are check boxes next to the upgradable ESMC components. Click Next.

package_upgrade_tomcat

6.Select a Java installation on the computer. Ensure that Java/OpenJDK is up to date.

warning

Warning

Starting January 2019, Oracle JAVA SE 8 public updates for business, commercial or production use require a commercial license. If you do not purchase a JAVA SE subscription, you can use this guide to transition to a no-cost alternative and install one of listed supported Java editions.

important

Important

64-bit Java is required.

If you have multiple Java versions installed on your system, we recommend that you uninstall older Java versions (the oldest supported version is Java 8) and keep only the latest version of Java.

7.Click Upgrade to complete the upgrade and then click Finish.

8.If you installed the Web Console on a different computer than the ESMC Server:

a) Stop the Apache Tomcat service: Navigate to Start  > Services > right-click the Apache Tomcat service and select Stop.

b)Restore the EraWebServerConfig.properties file (from step 1) to its original location.

c) Start the Apache Tomcat service: Navigate to Start > Services > right-click the Apache Tomcat service and select Start.

9.Connect to the ESMC Web Console and ensure that the program works correctly.

Troubleshooting

If the upgrade of Apache Tomcat fails, install your previous version and apply the configuration from step 1.