Installing the Mac Agent

The Mac data agent inventories hardware and software information and sends it to CloudRadial's infrastructure reporting. 

A CloudRadial Mac install script is available under Partner > Clients > Agents and is customized for each company with the correct partner and company information.

Run the downloaded script file using the command:

sudo bash {{nameofinstallscript}}

The installer installs and launches a daemon on the Mac that checks in on startup and every 24 hours. Please allow up to an hour for the data to first populate in the CloudRadial portal. You can check the status of the running daemon using this command:

sudo launchctl list cloudradial.mac.agent

The agent creates a log file which is available on the Mac at this path:

/Library/Logs/cloudradial.mac.agent.log

Troubleshooting

If you don't see the Mac checking in after an hour or more after installation, please check the following:

• Open the log file mentioned above and check that the last entry shows a successful check-in. If not, please send the log file by submitting a ticket so we can investigate.
• If you don't see a log file, then the agent probably didn't install correctly. When installing, be sure that the install script is run with "sudo" elevated privileges and the most recent package file was able to download.
• If you don't see a "/Library/Logs" folder, then your Mac is too old to be supported.
• There are reported issues with macOS 10.12, though there are agents running on older Macs, we can only support operation on macOS 10.13 or higher.
• Mac devices must be named for check-in to process.
• We don't have any specific knowledge of porting the install script to any RMM installer. Please refer to your RMM vendor for specific examples. We have partners who have successfully installed with Intune and various RMMs and encourage everyone to share their efforts at https://community.cloudradial.com.
• There have been reported issues with Apple Silicon based Macs needing Rosetta for the Data Agent installation to complete successfully. You can install Rosetta 2 via the Mac Terminal using the following command (you may be prompted for a password): 

  softwareupdate --install-rosetta --agree-to-license

Uninstall

Install also creates an uninstall script that stops and daemon and removes the agent files. The uninstall script is located here:

/Library/LaunchDaemons/cloudradial.mac.agent/uninstall.sh

Installing with an RMM

If you have a Mac-capable RMM that provides for the remote execution of scripts, copy the entire contents of any downloaded company script and change the "Company ID" value to an RMM variable that is substituted at runtime with the correct CloudRadial company ID. This ID is available in the agents' list.

Frequently Asked Questions

• Does the CloudRadial agent show in the Applications list on MACs.
  • No, the MAC agent runs as a service and can be restarted from the Activity monitor, but is not shown on the application list.