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,
- Install the Endpoint Central agent on the computer intended for imaging.
- Log in to the Mac computer as an administrator and navigate to the location where the agent is downloaded.
- Unzip the file then double-click DesktopCentral_MacAgent.pkg to install the agent
- 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:
- In AssetExplorer, navigate to Admin > Discovery > Agent Configuration > Download Mac Agent.
- Make sure sshpass is installed in the Mac computer from which the script will be executed
- Ensure that Remote Login has been enabled on all the Mac computers and that the systems are accessible by their machine name.
- Execute this script and specify the username and password through which the installation will be carried out.
The credentials provided must have sudo permission.
- 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,
- Download the pre-installation script in the machine that is to be imaged and save it as a .sh file.
- Execution of this script will block agent-server communication on a temporary basis.
- Open the terminal and navigate to the folder where the pre-installation script is stored.
- 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.
- To restore agent-server communication on the imaged computer,
- Download the post-installation script on the imaged computer and save it as a .sh file.
- Open the terminal and navigate to the folder where the post-installation script is stored.
- 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:
- Navigate to Tools on the Endpoint Central server.
- Choose System Manager.
- Select the computer on which you want to stop the service and click Manage.
- Under the Services tab, select ManageEngine Endpoint Central > Agent.
- 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.
- Log in to the computer as an administrator and open the terminal.
- Navigate to the directory /Library/DesktopCentral_Agent/uninstall
- Execute the command sudo chmod 744 uninstall.sh
- Execute the command sudo./uninstall.sh. This command removes all the files except logs.