Installing or uninstalling the macOS Agent - Legacy UI

SECURITY  Administrator permissions on the device

NAVIGATION  Legacy UI > Sites > open a Managed site > New Device > OS X

Refer to Installing or uninstalling the macOS Agent.

IMPORTANT  For information about supported macOS versions, refer to Supported operating systems and Agent requirements. For information about which services get installed, refer to Services, dependencies, and folders (Windows, macOS, Linux).

IMPORTANT  In order for the Agent to function properly on macOS devices running Sonoma or later, the following applications must be listed and selected for the following options in the System Settings > Privacy & Security > Privacy section:
• Accessibility: AEM Agent
• Full Disk Access: AEM Agent
• Screen & System Audio Recording: AEM Agent

IMPORTANT  Installation will require entry of a local user password.

1. Refer to the steps outlined in Downloading or emailing the Agent installer.

NOTE  macOS devices can only be added to Managed sites.

NOTE  For information about manually enrolling other types of devices, refer to Adding a device manually - Legacy UI.

2. Open the downloaded or emailed file and unpack the .zip file.
3. Open the AgentSetup folder and double-click the file called CAG.pkg.
4. Complete the wizard to install the Agent. Once the Agent has been installed, the Datto RMM icon will be displayed in the menu bar of your computer.

IMPORTANT  When changing the hostname of a macOS device through the command line (scutil --set HostName), make sure that you add .local to the hostname to prevent the Agent from crashing.

1. Open Terminal.
2. Run the following commands:

						curl -o Agent.zip "https://platform.centrastage.net/csm/profile/downloadMacAgent/siteID"
							unzip Agent.zip
					sudo installer -pkg "AgentSetup/CAG.pkg" -target /

IMPORTANT  Make sure to replace platform and siteID with the appropriate values. The platform is included in the URL when you are logged in to Datto RMM (for example, https://concord.centrastage.net). You can find the site ID in Site Settings.

3. Complete the wizard to install the Agent. Once the Agent has been installed, the Datto RMM icon will be displayed in the menu bar of your computer.

1. Open Terminal.
2. Run the following command:

					sudo bash /Applications/AEM\ Agent.app/Contents/Resources/uninstall.sh

3. The Agent will now be uninstalled from the device.

If you have problems reinstalling the Agent on a macOS device, it may be necessary to completely remove the Agent from the device. After uninstalling the Agent using a local script, use one of the following methods:

Terminal

1. Open Terminal.
2. Enter the following commands, entering your password where prompted:

					sudo rm -rf /usr/local/share/Centrastage

and

					sudo rm -rf /var/root/.mono/registry/CurrentUser/software/centrastage

Finder

1. If your preference is to use Finder, ensure you have enabled root. You can do so by following the instructions in this article.

Using the instructions for Lion will also work for later versions.

2. Once the root user is enabled, type the following into Terminal to show all files in Finder:

					defaults write com.apple.finder AppleShowAllFiles

and then

					killall Finder

3. If you are using Mavericks 10.9 or later, add -boolean true to the end of the first command so it looks like this:

					defaults write com.apple.finder AppleShowAllFiles -boolean true

4. Delete the following directory:
   • /usr/local/share/Centrastage
   • /var/root/.mono/registry/CurrentUser/software/centrastage