Agent installation - macOS

These steps apply when performing a local installation of the Agent.

1.Make sure all prerequisites are met:

ESMC Server and the ESMC Web Console are installed (on a Server computer).

An Agent certificate is created and prepared on your local drive.

A Certification Authority is prepared on your local drive (only needed for unsigned certificates).

details_hoverNOTE

Should you experience problems when deploying ESET Management Agent remotely (the Server task Agent deployment ends with a failed status) please refer to Agent deployment troubleshooting.

2.Get the installation file (standalone agent installer .dmg) from the ESET download site or your system administrator.

3.Double-click the Agent-MacOSX-x86_64.dmg file and then double click the .pkg file to start the installation.

4.Proceed with the installation. When asked, enter the Server connection data:

Server hostname: hostname or IP address of the ESMC Server

Server port: port for Agent - Server communication, default is 2222.

Use Proxy: click if you want use HTTP Proxy for Agent - Server connection.

details_hoverNOTE

This proxy setting is only used only for (replication) between ESET Management Agent and ESMC Server, not for the caching of updates.

Proxy hostname: hostname or IP address of the HTTP Proxy machine.

Proxy port: default value is 3128.

Username, Password: enter the credentials used by your proxy if it uses authentication.

You can change proxy settings later in your policy. Proxy must be installed before you can configure an Agent - Server connection via Proxy.

5.Select a Peer certificate and a password for this certificate. Optionally, you can add a Certification authority.

validation-status-icon-warning IMPORTANT

The certificate passphrase must not contain the following characters: " \ These characters cause a critical error during the initialization of the Agent.

6.Review the install location and click Install. The Agent will be installed on your computer.

7.The ESET Management Agent log file can be found here:

/Library/Application Support/com.eset.remoteadministrator.agent/Logs/
/Users/%user%/Library/Logs/EraAgentInstaller.log

validation-status-icon-warning IMPORTANT

The communication protocol between Agent and ESMC Server does not support authentication. Any proxy solution used for forwarding Agent communication to ESMC Server that requires authentication will not work.

If you choose to use a non-default port for the Web Console or Agent, it may require a firewall adjustment. Otherwise, the installation may fail.