Deploy Umbrella Roaming Client on macOS Using Apple Remote Desktop

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.

  1. Navigate toIdentities > Roaming Computersin the Umbrella dashboard.
  2. Click theAddicon.
  3. 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.

Note: You can make the installation package silent so the icon does not appear in the menu bar. For details, see: https://docs.umbrella.com/deployment-umbrella/docs/appendix-g-command-line-and-customization-for-installation

Stage 1 – Copy OrgInfo.plist to the Target Workstation

1. In ARD, select the computer(s) you want to target. Start with a single workstation to test the deployment.
2. Set up a newCopytask for the selected machines.
3. Select theOrgInfo.plistfile from your extracted folder.
4. Set the destination path on the remote machine to:
   /Library/Application Support/OpenDNS Roaming Client
5. Execute the copy task. The file will copy within a few seconds.

Stage 2 – Deploy the Package File to the Target Workstation

1. In ARD, select theRoamingClient_MAC_1.4.5.pkgfile from your extracted folder.
2. Set up a newInstalltask for the selected machines. Use the default install options unless you have a specific reason to change them.
3. ClickInstall. If you have sufficient permissions, a progress bar will appear and the installation will run.
4. 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.