Windows instructions (All-in-one installer)

Apache Tomcat is a mandatory component required to run ESMC Web Console.

You can use this method to quickly upgrade Apache Tomcat to the latest version using the latest ESMC All-in-one installer (do not use an earlier ESMC All-in-one installer). Alternatively, you can upgrade Apache Tomcat manually.

Before upgrading

1.Ensure that Java/OpenJDK is up to date.

validation-status-icon-error 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.

validation-status-icon-warning IMPORTANT

If you have multiple Java versions installed on your system, we recommend that you uninstall earlier Java versions and keep only the latest version of Java.

Make sure that Java, ESMC, and Apache Tomcat have the same bitness (32-bit or 64-bit).

2.Check to see which version of Apache Tomcat is currently available.

a.Navigate to the Apache Tomcat installation folder:
C:\Program Files\Apache Software Foundation\[ Tomcat folder ]\

b.Open the RELEASE-NOTES file in a text editor and check the version number (for example 7.0.90).

c.If a more recent supported version is available, perform an upgrade.

How to upgrade

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

Close Tomcat7w.exe if it is running in your system tray.

2.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, back up the certificate too.

3.Uninstall the current version of Apache Tomcat. If you do not see Apache Tomcat in the list of installed programs, run the Command Prompt as Administrator and delete the Tomcat7 service:
sc delete Tomcat7

4.Delete the following folder if it is still present on your system:

C:\Program Files\Apache Software Foundation\[ Tomcat folder ]\

5.Optional step: If you want to upgrade Apache Tomcat to a higher version than the version packed in the latest ESMC All-in-one installer:

a.Download the latest supported version of the Apache Tomcat .zip file (32-bit/64-bit Windows zip) apache-tomcat-[version]-windows-[x86/x64].zip from https://tomcat.apache.org.

b.Navigate to the folder where you saved the All-in-one installer.

c.Move the downloaded apache-tomcat-[version]-windows-[x86/x64].zip into x86\installers or x64\installers directory. Delete the old Tomcat installation file from this directory.

6.Open a Command Prompt, navigate to the All-in-one installer folder and run the following command:

Setup.exe --mode webconsole

7.Follow the installation wizard and install ESMC Web Console (together with Apache Tomcat).

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

9.Restore .keystore, server.xml, EraWebServerConfig.properties, and custom certificates to their original location.

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

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