ESET Online Help

Search English
Select the category
Select the topic

Agent installation - macOS

You can install ESET Management Agent on macOS in two ways:

Remotely - Using the Server task Agent deployment. If you experience problems deploying ESET Management Agent remotely (the Server task Agent deployment ends with a failed status), refer to Agent deployment troubleshooting.

Locally - See the instructions below.

Prerequisites

ESET PROTECT Server and the ESET PROTECT 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).

Installation

Follow the steps below to install the ESET Management Agent component locally on macOS:


important

Ensure to meet all the installation prerequisites listed above.

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

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

3.Proceed with the installation. When asked, type the Server connection data:

Server hostname: hostname or IP address of the ESET PROTECT Server

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

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


note

This proxy setting is used only for (replication) between ESET Management Agent and ESET PROTECT 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: type 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.

4.Select a Peer certificate and a password for this certificate. Optionally, you can add a Certification Authority.


warning

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

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

6.Enable Full disk access for ESET Management Agent:

Locally:

a)Open System Preferences > Security & Privacy > Privacy.

b)Unlock the settings in the lower-left corner.

c)Click Full Disk Access.

d)Click + > Application > ESET > Open and add the ESET Management Agent to the application list in the Full Disk Access folder.

e)Lock the settings in the lower-left corner.

Remotely:

a)Download the .plist configuration file.

b)Generate two UUIDs with a UUID generator of your choice and use a text editor to replace strings with the text. Insert your UUID 1 and UUID 2 in the downloaded configuration profile.

c)Deploy the .plist configuration profile file using the MDM server. Your computer needs to be enrolled in the MDM server to deploy configuration profiles to computers.

7.The computer with the installed Agent will appear in your ESET PROTECT Web Console, and you can manage it using ESET PROTECT.

Agent installation troubleshooting

Verify that the Agent is running: Click Go > Utilities and then double-click Activity Monitor. Click the Energy tab or the CPU tab and locate the process called ERAAgent.

The ESET Management Agent log file can be found here:

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


important

The communication protocol between Agent and ESET PROTECT Server does not support authentication. Any proxy solution used for forwarding Agent communication to ESET PROTECT 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.