Introduction
This article covers mass provisioning of the Umbrella roaming client or custom provisioning. For a basic Umbrella roaming client, which consists of manually downloading the Umbrella roaming client package and installing it on one machine, see our Umbrella Roaming Client Deployment guide.
The basic deployment option requires the OrgInfo.json file to be in the same folder as the Setup.msi file upon deployment. For deployment options that don't require this OrgInfo.json file, for deploying a hidden UI for the Umbrella roaming client, or deployment with RMM mass deployment tools, continue reading.
For deploying using Continuum, Kaseya, LabTech (Basic), LabTech (Advanced), N-able, or NinjaRMM. use the provided links.
The download link for bulk deployment scripts is located below in this article.
Information about mass deployment to OS X machines is at the bottom of this article.
Deploying the Umbrella Roaming Client (Windows) with Parameters
The Umbrella roaming client installer (Setup.msi) is also able to be supplied the required parameters to install without requiring the OrgInfo.json file to be in the folder during deployment. This guide will contain sample values for these parameters that need to be replaced with unique values.
Parameters (Required)
- ORG_ID—Organization specific identifier
- ORG_FINGERPRINT—Unique code generated based on User_ID and Org_ID
- USER_ID—User specific identifier.
Note: This is not your login ID, it’s a seven-digit number located in your dashboard or in the OrgInfo.JSON file—see MSP sections below.
Additional Parameters (Optional)
|
Parameter |
Description |
Values |
|
HIDE_UI |
Hide the Umbrella roaming client tray icon from showing in the system tray / menu bar to decrease awareness/visibility to an end user. |
0 - show system tray icon (default) 1 - hide system tray icon |
|
HIDE_ARP |
Omit the Umbrella roaming client from the Add/Remove Program list in Windows to prevent trivial uninstallation by an Admin. |
0 - show in list (default) 1 - omit from list |
|
NO_AUTOSUFFIX |
Don’t add domains contained in the “DNS Suffixes” settings in network adapters and networking properties. This feature exists so that the Umbrella roaming client is more aware of local resources/domains on foreign networks. |
0 - add the domains (default) 1 - don’t add the domains |
|
NO_NXDOMAIN |
If a DNS query sent to Umbrella returns an NXDOMAIN, query the local DNS servers before giving up just in case. |
0 - query local DNS servers (default) 1 - don’t query local DNS servers |
Installing from the Command Prompt
The following command deploys the Umbrella roaming client silently (Admin privileges required!). If the deployment is not successful, we recommend installing the Umbrella roaming client once without the silent flag by removing the /qn flag from the following command to allow the error message to display.
msiexec /i Setup.msi /qn ORG_ID=222222 ORG_FINGERPRINT=1234567890abcdef USER_ID=111111
Note:
For a hidden installation such as one without the GUI or Add/Remove Programs entry in Windows, scroll down to "Special Parameters"
For deployment script use only, the source of the direct download of the Umbrella roaming client.
Please note the URL is case sensitive:
https://cisco-umbrella-client-downloads.s3.amazonaws.com/win/production/Setup.msi
Special Flags: Hiding the Roaming Client
There are a few extra parameters you can include in your deployment to tweak the Umbrella roaming client. To deploy the Umbrella roaming client without the User Interface, add the HIDE_UI=1 flag.
For example:
msiexec /i Setup.msi /qn ORG_ID=222222 ORG_FINGERPRINT=1234567890abcdef USER_ID=111111 HIDE_UI=1
msiexec /i Setup.msi /qn ORG_ID=222222 ORG_FINGERPRINT=1234567890abcdef USER_ID=111111 HIDE_UI=1 HIDE_ARP=1
Additional Resources:
In-depth documentation regarding the use of special flags for hiding the UI or the removal is available here. For Windows GPO provisioning, refer to our GPO guides for Windows Server 2008R2 and 2003.
Deploying the Umbrella Roaming Client (OS X)
For OS X, the only supported install option for OS X that is hiding the UI, and this must be completed within the OrgInfo.plist file that is included in the downloaded .zip file. The .pkg installer must be run from the same folder as the OrgInfo.plist file or there will be an error during installation. Refer to the Hiding the Umbrella Roaming Client UI document for more information. The OS X .plist file contains the same parameter information as the Windows version discussed here.
When deploying the OS X client to different customer organizations, the OrgInfo.json file can be extracted from the dashboard. Starting in the customer
Extract the zip file from the download and in the extraction folder you should see two files:
- OrgInfo.plist—This is the information that identifies your roaming computers as part of your Organization
- RoamingClient_MAC_1.4.5.pkg—This is the 1.4.5 release that allows you to install with ARD. You should be installing v1.4.5 or newer; the file name will reflect the version. The file can also be downloaded here: https://cisco-umbrella-client-downloads.s3.amazonaws.com/mac/production/RoamingClient_MAC.mpkg.zip
The .plist *must* be deployed to the endpoint computer alongside the metapackage. For more guidance, read here:
https://support.umbrella.com/hc/en-us/articles/230905248-Umbrella-Roaming-Client-Mass-Deployment-Using-Apple-Remote-Desktop-in-OS-X
Comments
0 comments
Article is closed for comments.