Overview
First rule of beta club. It's a real beta. Also, there's no timeline on when the Mac Agent will leave beta at the moment. rest assured, we will announce when a date is available to keep everyone up to date.
Our Remote Machine Management (RMM) system is agent-based meaning you install a management agent (application) on every computer you manage and that is how you get the control to do your job. Our Mac agent can't have direct parity because of operating system differences but it is our goal to support as much as possible on both platforms.
The most recent Mac agent update should allow installation on Mac OS 11 Big Sur.
Feature Matrix against the Windows Agent
| Windows | Mac | |
| Native Checks - Blue Screen | X | |
| Native Checks - Antivirus Installed | X | X |
| Native Checks - Application Crashes | X | |
| Native Checks - SMART Failure | X | X |
| Native Checks - Low Disk Space | X | X |
| Native Checks - Firewall Enabled | X | X |
| Native Checks - HDD Fragmentation | X | X |
| Native Checks - Device Manager Issues | X | |
| Event Log Monitoring | X | |
| Resource Monitoring (CPU/Memory) | X | X |
| Agent Status (Online/Offline) | X | X |
| Patch Management (Operating System) | X | |
| Application Management (Third Party) | X | |
| Managed AV - Bitdefender | X | X |
| Managed AV - Emsisoft | X | |
| Syncro Live - Remote Control (native) | X | |
| Syncro Live - Task Manager | X | |
| Syncro Live - Terminal (command prompt) | X | |
| Agent Icon with Menu - Customizable icon/menu | X | X |
| Scripting Engine - Powershell | X | |
| Scripting Engine - vbscripts | X | |
| Scripting Engine - batch files | X | |
| Scripting Engine - Bash (mac) | X | |
| Scheduled Scripts (on Policy or manual schedule) | X | X |
| System Checks - External Monitoring (ping/http) | X | X |
| Remote Control - "bring your own" TeamViewer | X | * |
| Remote Control - "bring your own" ScreenConnect | X | ** |
| Agent Silent Install (CustomerID, PolicyID, ComputerName,...) | X | X |
| Agent Auto Updating | X | X |
| Service & Process Monitors | X | |
| Device System Tray Menu | x | *** |
| * Planned | ||
| ** Additional information below | ||
| *** All tray menu functions work except for the agent contact form and live chat |
Installation
To install the Mac agent, head to a customer and click "New" -> "RMM Agent Installer".
From there just click one of the Policies to install under and it will give you a download link and a token.
Download the .app package and drag it to /Applications to install it.
When you run it for the first time it will prompt for the token, that is how it gets attached to the right Customer in Syncro.
All done!
You might have to open Gatekeeper (System Preferences, Security) to allow it to run because it's not coming from the Mac App Store.
* To silently install the Beta Mac agent on a device, you can use the following script with your account's install key:
sudo spctl --add /Applications/SyncroAgent.app sudo /Applications/SyncroAgent.app/Contents/MacOS/SyncroAgent -key <YourInstallKey>.
Configure macOS Catalina to start the Mac Agent when a user logs in
Starting with Catalina, security standards have been added to macOS that make it harder for certain programs to start automatically. If you are noticing the Mac Agent isn't starting automatically, please follow these steps:
- On your Mac, choose Apple menu
> System Preferences, then click Users & Groups. - Select your user account, then click Login Items at the top of the window.
- Click the Add button
below the list of items. - Select the SyncroAgent app, then click add.
ScreenConnect
You would need to zip the .pkg file up then upload it to be made available for the RMM to download it. The pkg file will pass to the local device but won't silently install. It will need to be manually run on the local device. You can find the zipped ScreenConnect .pkg file here:
/Applications/SyncroAgent.app/Contents/MacOS/
ScreenConnect managed installation is not officially supported on our Mac at this current time. If this is not working for you, please install ScreenConnect outside of Syncro until further notice.
To show the SceenConnect button on your Mac asset in Syncro, please grab the ScreenConnect GUID from the Mac endpoint, and manually enter it in the field that shows after integration. That should populate the 'remote access > ScreenConnect' option on the mac asset's detail page.
You can get more information for obtaining the GUID from your Mac here:
https://docs.connectwise.com/ConnectWise_Control_Documentation/Developers/Integration_guide
BitDefender
In order for Bitdefender to function correctly on a mac machine, you may have to give the application full disk access. The BitDefender below will walk you through all of the necessary steps.
https://www.bitdefender.com/support/how-to-allow-full-disk-access-to-bitdefender-endpoint-security-for-mac-in-macos-mojave-(10-14)-and-later-2273.html
Troubleshooting
- Please make sure to whitelist the agent with any AV on the asset
- The MAC Agent Uninstaller has been added to this page. Follow the instructions in the .txt file. Make sure you have the SUDO Password for the uninstaller to work properly.
- Logs can be found here: /tmp/syncroMSP.zip or you can open the Mac Console, go to "Log Reports" and search for "Syncro:"
