Details
Click to expand
This article describes the installation process on SUSE Linux Enterprise Server 15 SP3 as installed from the official small installation image. If you already have some software installed, the installation process might differ.
To access the ESET PROTECT Web Console on your Linux server you need a running desktop environment (for example, Gnome) and a web browser (for example, Mozilla Firefox). Otherwise, you can access the Web Console remotely from another computer.
Solution
- Prerequisites
- Install and configure the MySQL database
- Install and setup ESET PROTECT Server
- Install the ESET PROTECT Web Console
- Install the ESET Management Agent
I. Prerequisites
-
Verify your internet connection. If you have a problem with your connection, enable Network Manager and use the following command to list the available network devices:
nmcli d
-
To connect to the network, use the command
ip
. - Add openSUSE OSS software package repositories to your software management. (Click here to open the instructions)
-
Install additional ESET PROTECT Server prerequisites. Depending on your SUSE 15 installation, some of these may be already installed on your server.
sudo zypper install krb5-client
- Repeat the command for the following packages:
- apache-commons-daemon
- tomcat9
- openldap2-client
- unixODBC
- mysql-connector-odbc
- java-1_8_0-ibm
II. Install and configure the MySQL database
Open a Terminal and follow the steps below to install MySQL Server.
- Download the Repository package:
wget http://dev.mysql.com/get/mysql80-community-release-sl15-5.noarch.rpm
- Install the downloaded release package:
sudo rpm -Uvh mysql80-community-release-sl15-5.noarch.rpm
- Import the GnuPG key:
sudo rpm --import /etc/RPM-GPG-KEY-mysql-2022
- Refresh the repository information:
sudo zypper refresh
- Install the MySQL Server by the following command:
sudo zypper install mysql-community-server
- Start the MySQL Server:
systemctl start mysql
- Verify MySQL is running. After you run the following command and verify the statute is active, press Ctrl + C to quit it.
systemctl status mysql
- Use the following command to reveal the temporary MySQL password:
sudo grep 'temporary password' /var/log/mysql/mysqld.log
- Perform the
mysql_secure_installation
that will allow you to set basic settings. Use the temporary password, then you will be prompted to create a new password.
mysql_secure_installation
-
Follow the steps in the Online Help topic to configure the MySQL server.
-
Save and close the file, then type the following command to restart MySQL server and apply the configuration:
systemctl restart mysql
III. Install and setup ESET PROTECT Server
- Verify the
odbcinst.ini
file for the configuration. The output should contain the names of available drivers. For example,[MySQL ODBC 8.0 Unicode Driver]
.
cat /etc/unixODBC/odbcinst.ini
- Verify your odbcinst version.
odbcinst --version
- Update the configuration files that control ODBC access by the following command:
sudo odbcinst -i -d -f /etc/unixODBC/odbcinst.ini
- Download the ESET PROTECT Server install file (you can download it from the ESET Download page). For example:
wget https://download.eset.com/com/eset/apps/business/era/server/linux/latest/server-linux-x86_64.sh
- Make the ESET PROTECT Server install file executable:
chmod +x server-linux-x86_64.sh
- Run the installation command on your Server install file. See our Online Help topic for instructions on how to modify the installation command.
sudo ./server-linux-x86_64.sh \
--skip-license \
--db-type="MySQL Server" \
--db-driver="MySQL ODBC 8.0 Unicode Driver" \
--db-hostname=127.0.0.1 \
--db-port=3306 \
--db-admin-username=root \
--db-admin-password=password \
--server-root-password=password \
--db-user-username=root \
--db-user-password=password \
--cert-hostname="hostname, IP, FQDN"
- Start the ESET PROTECT Server:
systemctl start eraserver
- Verify that the ESET PROTECT Server is running:
systemctl status eraserver
IV. Install the ESET PROTECT Web Console
- Download the ESET PROTECT Web Console application package (you can download it from the ESET Download page). For example:
wget https://download.eset.com/com/eset/apps/business/era/webconsole/latest/era.war
- Copy the application package file to the tomcat webapps folder:
sudo cp era.war /srv/tomcat/webapps/
- Check if the ESET PROTECT Server and the tomcat service are running:
sudo systemctl status eraserver
sudo systemctl status tomcat
- If one of the services is not active, start it.
- To start Tomcat service:
sudo systemctl start tomcat
- To make Tomcat start after each boot run:
sudo systemctl enable tomcat
- Connect to the Web Console. For example, on your Linux server, open a web browser and navigate to the following URL (where
10.1.0.1
is replaced by the IP address of your machine):
http://10.1.0.1:8080/era
The connection to the Web Console is now available only via HTTP. You can set up HTTPS connection. If you are unable to connect to the Web Console from a different computer, check if network ports are open. The SUSE Linux may have a firewall blocking the 8080 port for outside connection.
V. Install the ESET Management Agent
Install the ESET Management Agent on the Linux server running the ESET PROTECT Server.
- Download the Agent installer.
wget https://download.eset.com/com/eset/apps/business/era/agent/latest/agent-linux-x86_64.sh
- Set the installer as executable.
chmod +x agent-linux-x86_64.sh
- Run the installation command on your Management Agent install file with the following parameters:
sudo ./agent-linux-x86_64.sh \
--skip-license \
--hostname=10.1.0.1 \
--port=2222 \
--webconsole-user=Administrator \
--webconsole-password=password \
--webconsole-port=2223
The hostname
is the IP or hostname of the PROTECT Server machine. The webconsole-password
is the password you use to log in to ESET PROTECT Web Console
-
When prompted, press y to accept the certificate. You can ignore any errors about SELinux returned by the installer.
-
Set the ESET Management Agent service to start and enable starting after computer boot-up.
sudo systemctl enable eraagent
sudo systemctl start eraagent
- Open the ESET PROTECT Web Console and log in as Administrator. If the Computers section contains your server machine, the Agent is installed successfully.