Mac Agent

Mac Agent


Role Required: Administrator

Refer here for a list of the supported Mac OS versions.
  

Install Mac Agent Manually

Follow the steps mentioned below to install the Mac agent manually,
  1. Install the Endpoint Central agent on the computer intended for imaging.
  2. Log in to the Mac computer as an administrator and navigate to the location where the agent is downloaded.
  3. Unzip the file then double-click DesktopCentral_MacAgent.pkg to install the agent
  4. Enter the administrator's password when prompted to complete installation.
 

Install Mac Agents using Mac Agent Installation Script   

This method deploys agents on multiple computers 
Follow the steps below to install Mac agents:
  1. In AssetExplorer, navigate to Admin > Discovery > Agent Configuration > Download Mac Agent.
  2. Make sure sshpass is installed in the Mac computer from which the script will be executed
  3. Ensure that Remote Login has been enabled on all the Mac computers and that the systems are accessible by their machine name.
  4. Execute this script and specify the username and password through which the installation will be carried out.  
The credentials provided must have sudo permission.
  1. Prepare a TXT file containing a list of computers where the agent should be installed. Each computer name or IP address should be on a separate line.
 

Image a Mac Computer with an Endpoint Central Agent   

To image a Mac computer with an Endpoint Central agent,
  1. Download the pre-installation script in the machine that is to be imaged and save it as a .sh file.
  2.  Execution of this script will block agent-server communication on a temporary basis. 
  3. Open the terminal and navigate to the folder where the pre-installation script is stored.
  4. Execute the following command to prepare the machine for imaging: sudo ./dcagentpreimage_Mac.sh  
The Endpoint Central Mac agent will only communicate with the server if it is renamed. Each agent has a unique resource ID that represents the machine name and other information. If two agents have the same ID, both their details will be overwritten, resulting in only one machine being listed during the scan. To prevent this, it is necessary to rename the agent on the computer with the deployed OS image. 
  1. To restore agent-server communication on the imaged computer,
    1. Download the post-installation script on the imaged computer and save it as a .sh file.
    2. Open the terminal and navigate to the folder where the post-installation script is stored.
    3. Execute the following command: sudo ./dcagentpostimage_Mac.sh 
 

Stopping Endpoint Central Agent Service on Client Machines

Endpoint Central agent service can be stopped on client machines.
To stop an Endpoint Central agent:
  1. Navigate to Tools on the Endpoint Central server.
  2. Choose System Manager.
  3. Select the computer on which you want to stop the service and click Manage.
  4. Under the Services tab, select ManageEngine Endpoint Central > Agent.
  5. Go to Actions and click Stop to halt the Endpoint Central agent service. 

Uninstall Endpoint Central Agents from Mac Computers

To uninstall the agent from the Mac computer, follow the steps mentioned below.
  1. Log in to the computer as an administrator and open the terminal.
  2. Navigate to the directory /Library/DesktopCentral_Agent/uninstall
  3. Execute the command sudo chmod 744 uninstall.sh
  4. Execute the command sudo./uninstall.sh. This command removes all the files except logs.

    • Related Articles

    • Linux Agent

      Role Required: Administrator Refer here for a list of supported Linux OS versions. Install Linux Agent Manually The SSH port (port 22) should be open on the computers where the agent needs to be installed. To install an agent on a Linux Computer ...
    • Agent Configuration

      Agent-based scanning is supported for Windows, Linux, and Mac machines. Before proceeding with an agent-based scan, Endpoint Central has to be installed. Click here to learn more. Configure Endpoint Central agent settings in AssetExplorer under Admin ...
    • Windows Agent

      Role Required: Administrator Refer here for a list of the supported Windows OS versions. Manually Install an Endpoint Central Agent on Windows The following steps guide you on how to deploy an agent on a single Windows computer manually. Download the ...
    • Agent-Based Scan

      How does an agent-based scan work? Refer to the following link: UEM Agent What are the OS supported in the agent-based scan? The following Windows OS versions are supported: Windows 10 Windows 8.1 Windows 8 Windows 7 Windows Vista Windows XP* ...
    • FAQs on Agent-Based Scan

      How does an agent-based scan work? Please refer to this link for more details. What is the OS supported in the agent-based scan? Windows OS Windows Server OS MAC Linux Windows 11 Windows 10 Windows 8.1 Windows 8 Windows 7 Windows Vista Windows XP ...