Web Console installation

note

Note

You can install the ESMC Web Console on a different computer than the computer where the ESMC Server is installed.

To install the ESMC Web Console component on Windows, follow the steps below:

1.Make sure the following prerequisites are met:

ESMC Server installed.

Web Console file (era.war) saved to your local hard drive. Visit the ESET Security Management Center download section to download a standalone installer for this ESMC component (era.war).

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

a)Download the latest supported version of the Apache Tomcat installer file (32-bit/64-bit Windows Service Installer) apache-tomcat-[version].exe from https://tomcat.apache.org.

b)Run the installer.

c)During the installation, select the path to Java (parent folder of Java bin and lib folders).

d)After the installation, make sure that the Apache Tomcat service startup type is set to Automatic (in services.msc).

Apache Tomcat requires Java/OpenJDK.

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.

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.

2.Copy era.war to the Apache Tomcat web applications folder:

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

3.Allow a few minutes for file extraction and ESMC Web Console installation.

4.Continue with the next steps applicable for you:

If you installed th ESMC Web Console on the same computer as the ESMC Server:

a)Restart the Apache Tomcat service. Navigate to Start  > Services > right-click the Apache Tomcat service and select Stop. Wait for 30 seconds and then click Start.

b)Open the ESMC Web Console in your browser: http://localhost:8080/era/; a login screen will be displayed.

note

Note

The default HTTP port is set to 8080 during the Apache Tomcat installation. You can also set up an HTTPS connection for Apache Tomcat.

If you installed the ESMC Web Console on a different computer than the ESMC Server, perform these additional steps to enable communication between ESMC Web Console and ESMC Server:

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

b)Run Notepad as an Administrator and edit the C:\Program Files\Apache Software Foundation\[ Tomcat folder ]\webapps\era\WEB-INF\classes\sk\eset\era\g2webconsole\server\modules\config\EraWebServerConfig.properties.

c)Find the server_address=localhost.

d)Replace localhost with the IP address of your ESMC Server and save the file.

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

f)Open the ESMC Web Console in your browser: https://Server-IP/era/ (substitute Server-IP with the IP address of your ESMC Server); a login screen will be displayed.

Web Console configuration for enterprise solutions

The default Web Console configuration can suffer from instability when working with a high number of objects. Change the Tomcat settings to prevent memory shortages. Make sure you system have enough RAM (16 GB or more) before making these changes.

Windows

1.Open the tomcat9w.exe or run the Configure Tomcat application.

2.Switch to Java tab.

3.Change the values Initial memory pool to 2048 MB and Maximum memory pool to 16384 MB.

4.Restart the Tomcat service.

 

ESMC Virtual Appliance / CentOS Linux

1.Open the virtual machine and open the Terminal.

2.Open the file /etc/sysconfig/tomcat

3.Add the following line to the file:
JAVA_OPTS="-Xms2048m -Xmx16384m"

4.Save the file and restart the Tomcat service.
service tomcat restart

 

Debian Linux

1.Open the Terminal as root or use sudo.

2.Open the file /etc/default/tomcat9

3.Add the following line to the file:
JAVA_OPTS="-Xms2048m -Xmx16384m"

4.Save the file and restart the Tomcat service.
service tomcat restart