Server installation - Linux

Installation of the ESMC Server component on Linux is performed using a command in the Terminal. You can prepare an installation script and then execute it using sudo. Make sure all prerequisites are met before you begin installation. The installation prompts you to participate in the Product improvement program. Press Y if you agree to send crash reports and telemetry data to ESET or press n to not send crash reports and telemetry data to ESET.

details_hoverNOTE

To install ESMC Server on SUSE Linux Enterprise Server (SLES), follow the instructions from our Knowledgebase article.

Example of an installation script
(New lines are split by "\" for copying the whole command to Terminal)

sudo ./server-linux-x86_64.sh \
--skip-license \
--db-driver=MySQL \
--db-hostname=127.0.0.1 \
--db-port=3306 \
--db-admin-username=root \
--db-admin-password=Admin123 \
--server-root-password=Admin123 \
--db-user-username=root \
--db-user-password=Admin123 \
--cert-hostname="10.1.179.46;Ubuntu64-bb;Ubuntu64-bb.BB.LOCAL"

The ESMC Server and the eraserver service will be installed in the following location:

/opt/eset/RemoteAdministrator/Server

You can modify the following attributes:

Attribute

Description

Required

--uninstall

Uninstalls the product.

-

--keep-database

Database will not be removed during uninstallation.

-

--locale

The locale identifier (LCID) of installed server (default value is en_US). See supported languages for possible options.

Note: You can set a language for each ESMC Web Console session.

Yes

--skip-license

Installation will not ask user for license agreement confirmation.

-

--skip-cert

Skip generation of certificates (please use together with the --server-cert-path parameter).

-

--license-key

ESET license key. This can be set later.

-

--product-guid

Global unique identifier of the product. If this is not set, it will be generated.

-

--server-port

ESET Security Management Center (ESMC) server port (default value is 2222)

-

--console-port

ESET Security Management Center console port (default value is 2223)

-

--server-root-password

Password for Web Console login of the user "Administrator", must be at least 8 characters long.

Yes

--db-type

The type of database that will be used (possible values: "MySQL Server", "MS SQL Server"). MS SQL Server on Linux is not supported. However, you can connect ESMC Server on Linux to MS SQL Server on Windows.

-

--db-driver

ODBC driver used for connecting to database (command odbcinst -q -d gives a list of available drivers, use one of these drivers for example: --db-driver=MySQL).

Yes

--db-hostname

Computer name or IP address of the database server. Named database instance is not supported.

Yes

--db-port

Port of the database server (default value is 3306).

Yes

--db-name

Name of ESMC Server database (default value is era_db).

-

--db-admin-username

Database administrator username (used by installation for creating and modifying database). You can omit this parameter if there is a previously created database user defined in --db-user-username and --db-user-password

Yes

--db-admin-password

Database administrator password. You can omit this parameter if there is a previously created database user defined by --db-user-username and --db-user-password

Yes

--db-user-username

Database ESMC Server user username (used by ESMC Server for connecting to database); should be no longer than 16 characters.

Yes

--db-user-password

Database ESMC Server user password

Yes

--cert-hostname

Contains all the possible names and/or the IP of the computer that ESMC Server will be installed on. This will need to match with the server name specified in the Agent certificate that tries to connect to the server.

Yes

--server-cert-path

Path to server peer certificate (use this option if you specified --skip-cert as well)

-

--server-cert-password

Password of server peer certificate

-

--agent-cert-password

Password of Agent peer certificate

-

--cert-auth-password

Certificate Authority password

-

--cert-auth-path

Path to the Server's Certificate Authority file

-

--cert-auth-common-name

Certification authority common name (use "")

-

--cert-organizational-unit

-

-

--cert-organization

-

-

--cert-locality

-

-

--cert-state

-

-

--cert-country

-

-

--cert-validity

Certificate validity in days or years (specify in argument --cert-validity-unit)

-

--cert-validity-unit

Unit for certificate validity, possible values are 'Years' or 'Days' (default value is Years)

-

--ad-server

Active Directory server

-

--ad-user-name

Name of the user who has rights to search the AD network

-

--ad-user-password

Active Directory user password

-

--ad-cdn-include

Active Directory tree path, which will be synchronized for; use empty brackets "" to synchronize a whole tree

-

--enable-imp-program

Turns on the Product improvement program.

 

--disable-imp-program

Turns off the Product improvement program.

 

Installer log

The installer log may be useful for troubleshooting and can be found in Log files.

After installation, verify that the ESMC Server service is running using the command shown below:

service eraserver status

component_server_status_linux