Mobile Device Connector installation - Linux

You can install Mobile Device Connector on a different server than the one on which your ESET PROTECT Server is running. For example, you can use this installation scenario to make Mobile Device Connector accessible from the internet to manage user's mobile devices at all times.

Perform the MDC component installation on Linux using a command in the Terminal. Make sure to meet all prerequisites. You can prepare an installation script and then execute it using sudo.

Required installation command parameters

There are many optional installation parameters, but some of them are required:

Peer Certificate - There are two methods to get the ESET PROTECT Peer Certificate:

Server assisted installation - You need to provide ESET PROTECT Web Console administrator credentials (the installer will automatically download required certificates).

Offline installation - You need to provide a Peer Certificate (the Proxy certificate exported from ESET PROTECT). Alternatively, you can use your custom certificate.

oFor a Server assisted installation, at least include:

--webconsole-password=

oFor an Offline installation, include:

--cert-path=
--cert-password=

 (The default Agent Certificate created during ESET PROTECT Server installation does not need a password.)

 

HTTPS (Proxy) certificate:

oIf you already have an HTTPS certificate:

--https-cert-path=
--https-cert-password=

oTo generate a new HTTPS certificate:

--https-cert-generate
--mdm-hostname=

 

Connection to ESET PROTECT Server (name or IP address):

--hostname=

 

Database connection:

oFor a MySQL database include:

--db-type="MySQL Server"
--db-driver=
--db-admin-username=
--db-admin-password=
--db-user-password=

oFor a MS SQL database include:

--db-type="Microsoft SQL Server"
--db-driver=
--db-admin-username=
--db-admin-password=
--db-user-password=

Example of an installation script

Run the installation script based on the example below (New lines are split by "\" for copying the whole command to Terminal):

sudo ./mdmcore-linux-x86_64-0.0.0.0.sh \
--https-cert-path="full_path/proxycert.pfx" \
--https-cert-password="123456789" \
--port=2222 \
--db-type="MySQL Server" \
--db-driver="MySQL ODBC 8.0 Driver" \
--db-admin-username="root" \
--db-admin-password=123456789 \
--db-user-password=123456789 \
--db-hostname="127.0.0.1" \
--webconsole-password=123456789 \
--hostname=username.LOCAL \
--mdm-hostname=username.LOCAL

For a complete list of available parameters (print help message), use:

--help

note

Note

ESET recommends that you delete commands containing sensitive data (for example, a password) from the command line history:

1.Run history to see the list of all commands in the history.

2.Run history -d line_number (specify the line number of the command). Alternatively, run history -c to delete the entire command line history.

Installer log

The installer log may be helpful for troubleshooting and you can find it in Log files.

After installation is complete, check to see if the Mobile Device Connector is running correctly by opening https://your-mdm-hostname:enrollment-port (for example, https://eramdm:9980) in your web browser. If the installation was successful, you will see the following message:

mdm_check

You can also use this URL to check the availability of the Mobile Device Connector server from the internet (if configured in such a way) by visiting it from a mobile device. If you cannot reach the page, check your firewall and the configuration of your network infrastructure.