Introduction
This document describes how to deploy the Umbrella roaming client to macOS computers using Apple Remote Desktop (ARD).
Prerequisites
-
You must have Apple Remote Desktop (ARD) set up to manage your target workstations.
-
Download the latest Umbrella roaming client for macOS from your Umbrella dashboard. Do not use an outdated version.
- Navigate toIdentities > Roaming Computersin the Umbrella dashboard.
- Click theAddicon.
- UnderMac OS X Client, clickDownload.
-
Extract the downloaded zip file. You should see:
- OrgInfo.plist— Identifies your roaming computers as part of your organization.
- RoamingClient_MAC_1.4.5.pkg(or newer) — The installation package for deployment via ARD.
Stage 1 – Copy OrgInfo.plist to the Target Workstation
- In ARD, select the computer(s) you want to target. Start with a single workstation to test the deployment.
- Set up a newCopytask for the selected machines.
- Select theOrgInfo.plistfile from your extracted folder.
- Set the destination path on the remote machine to:
/Library/Application Support/OpenDNS Roaming Client
- Execute the copy task. The file will copy within a few seconds.
Stage 2 – Deploy the Package File to the Target Workstation
- In ARD, select theRoamingClient_MAC_1.4.5.pkgfile from your extracted folder.
- Set up a newInstalltask for the selected machines. Use the default install options unless you have a specific reason to change them.
- ClickInstall. If you have sufficient permissions, a progress bar will appear and the installation will run.
- The install duration depends on the speed and location of the target workstation.
Troubleshooting
- If you encounter installation errors, check thatOrgInfo.plistwas copied to the correct folder in Stage 1.
- If you see the error message “Validating packages,”OrgInfo.plistwas not copied successfully to the correct location.