ESET PROTECT On-Prem – Table of Contents

Web Console installation—Linux

Copy current article URL Share via email

This article (PDF) Whole documentation (PDF)

Follow these steps to install the ESET PROTECT Web Console:

You can install the ESET PROTECT Web Console on a different computer from the computer running the ESET PROTECT Server. This procedure requires additional steps.

1.Install the Apache Tomcat and Java packages.

Packages may have different names and may not be available in the default repository

•Example package names below may differ from your Linux distribution repository packages. The Apache Tomcat service name may vary: tomcat, tomcat9, or tomcat10.

•Your Linux distribution's default repository may not contain the latest supported version of Apache Tomcat and Java. For example, the default repository may contain the unsupported Apache Tomcat 11.

•For installation and configuration of Apache Tomcat, see the Apache Tomcat documentation.

Debian, Ubuntu	sudo apt update sudo apt install openjdk-21-jdk tomcat10 -y
Red Hat, Rocky Linux	sudo dnf update sudo dnf install java-21-openjdk tomcat -y
SUSE Linux Enterprise Server	sudo zypper refresh sudo zypper install java-21-openjdk tomcat10 -y

2.Download the Web Console file (era_x64.war):

wget https://download.eset.com/com/eset/apps/business/era/webconsole/latest/era_x64.war

3.Rename the era_x64.war file to era.war:

mv era_x64.war era.war

4.If you have installed Apache Tomcat 9.x, skip this step. If you have installed Apache Tomcat 10.x, follow these instructions to migrate era.war to the new Jakarta EE format supported by Apache Tomcat 10.x:

a)Navigate to the tomcat10 folder:

Debian, Ubuntu	cd /var/lib/tomcat10/
Red Hat, Rocky Linux	cd /var/lib/tomcat/
SUSE Linux Enterprise Server	cd /usr/share/tomcat/webapps/

b)Create a new webapps-javaee folder:

sudo mkdir temp webapps-javaee

c)Set the ownership and permissions for the webapps-javaee folder:

sudo chown tomcat temp webapps-javaee
sudo chgrp adm temp webapps webapps-javaee
sudo chmod 2777 temp webapps webapps-javaee

d)Open the tomcat10 configuration file sudo nano /etc/systemd/system/multi-user.target.wants/tomcat10.service, add the following two lines and save the updated file:

ReadWritePaths=/var/lib/tomcat10/webapps-javaee/

ReadWritePaths=/var/lib/tomcat10/temp/

e)Install the Tomcat Migration Tool for Jakarta EE:

Debian, Ubuntu	sudo apt install tomcat-jakartaee-migration -y
Red Hat, Rocky Linux	sudo dnf install tomcat-jakartaee-migration -y
SUSE Linux Enterprise Server	sudo zypper install tomcat-jakartaee-migration -y

f)Copy the migration tool (jakartaee-migration-shaded.jar) to the tomcat folder:

sudo cp /usr/share/tomcat-jakartaee-migration/lib/jakartaee-migration-shaded.jar /usr/share/tomcat10/lib/

5.Copy the era.war file to the Tomcat folder (select the command based on your Tomcat version):

Debian, Ubuntu

•9: sudo cp era.war /var/lib/tomcat9/webapps/

•10: sudo cp era.war /var/lib/tomcat10/webapps-javaee/

Red Hat, Rocky Linux

•9: sudo cp era.war /var/lib/tomcat/webapps/

•10: sudo cp era.war /var/lib/tomcat/webapps-javaee/

SUSE Linux Enterprise Server

•9: sudo cp era.war /usr/share/tomcat/webapps/

•10: sudo cp era.war /usr/share/tomcat/webapps-javaee/

6.Reload the systemd manager configuration:

sudo systemctl daemon-reload

7.Restart the Tomcat service to deploy the era.war file:

sudo systemctl restart tomcat

The Apache Tomcat service name may vary: tomcat, tomcat9, or tomcat10.

8.Verify the era folder is present in the Tomcat folder (replace Path_to_Tomcat with the Tomcat folder):

ls Path_to_Tomcat

The output should look like this: era era.war

9.Add the Tomcat service to the systemd configuration:

sudo vi /etc/systemd/system/multi-user.target.wants/tomcat10.service

10. Set the Tomcat service to start at boot: sudo systemctl enable tomcat

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

a)Stop the Tomcat service: sudo systemctl stop tomcat

b)Edit the EraWebServerConfig.properties file:

sudo nano /var/lib/tomcat/webapps/era/WEB-INF/classes/sk/eset/era/g2webconsole/server/modules/config/EraWebServerConfig.properties

If the EraWebServerConfig.properties file is not present in the above path, you can use the following command to find the file on your system:

find / -iname "EraWebServerConfig.properties"

c)Find the server_address=localhost

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

e)Restart the Tomcat service: sudo systemctl restart tomcat

f)Set the Tomcat service to start at boot: sudo systemctl enable tomcat

12. Open the ESET PROTECT Web Console in a supported web browser to see a login screen:

•From the computer hosting the ESET PROTECT Web Console: http://localhost:8080/era

•From any computer with internet access to the ESET PROTECT Web Console (substitute IP_ADDRESS_OR_HOSTNAME with the IP address or hostname of your ESET PROTECT Web Console): http://IP_ADDRESS_OR_HOSTNAME:8080/era

13. Configure the Web Console after the installation:

•The default HTTP port is set to 8080 during the manual installation of Apache Tomcat. We recommend that you set up an HTTPS connection for Apache Tomcat.

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

˄˅