Contents

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://www.cisco.com/c/en/us/support/security/umbrella/series.html

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.