The Umbrella roaming client has a Diagnostic Tool built into it. The tool provides invaluable information to Support that is essential when troubleshooting complex issues.
This article outlines multiple ways to access this tool: from the graphic interface, from the command line, and running on remote machines as an unattended process.
- If possible, always provide this output when opening a support ticket that relates to the Umbrella roaming client. xf
- Once the test completes it will generate either a URL or a .txt file. Please copy and paste that URL or attach the .txt file to the ticket.
- If you are having trouble accessing a particular domain, please add it in the "Domain to Test" field.
Note: Do not copy the text output of the diagnostic into the support ticket. The results lose formatting and cannot be read. You will be asked to re-submit the results.
Running Diagnostic via Tray Icon
With the Umbrella roaming client installations on Windows or Mac OSX, you can access and use the Diagnostic Tool from the tray icon.
The Umbrella roaming client tray icon can be intentionally hidden in order to prevent the user from being aware of the Umbrella roaming client. In this case, you won't be able to summon the diagnostic tool this way, and you'll have to utilize other methods described in the next section of this article.
|Accessing Diagnostic Tool via User Interface|
Running Diagnostic via File Browser / Finder
From the File Browser (Explorer)
*Note: if the operating system is 32-bit, the folder will just be called "Program Files"
From the Finder
Running Diagnostic via Command Line / Terminal
From the Command Prompt
"C:\Program Files (x86)\OpenDNS\Umbrella Roaming Client\ UmbrellaDiagnostic.exe"
*Note: If the operating system is 32-bit, remove (x86) from the Program Files pathname.
From the Terminal
Run Diagnostics on a remote computer or unattended from command line:
The Diagnostic Tool contains functionality to allow silent execution (without user intervention). This can be especially helpful on when you'd like to run the diagnostic utility on a user's machine, but do not want to disturb the user.
These switches can be appended to both the Windows or OSX version from the command prompt or terminal, respectively.
When run without switches, the Umbrella Diagnostic will launch a user interface and, waits for the user to submit information. When running remotely, you almost always want the --silent option.
The following switches can be appended to the command in order to automate the silent execution of the Diagnostic and direct the output:
|A specific domain to target with tests (e.g. ProblematicDomain.com)|
|-s, --silent||Automatically run tests in silent mode (will not show the UI or new windows; defaults to -i output)|
|-i, --internet||Output all results to diagnostic.opendns.com; destination URL will print to console as 'appspot=URL'|
|-o, --output=VALUE||Output to a file, which will print to console as 'outputFile=FILE'; can be a full path, make sure to use "quotes" if needed|
|-c, --console||Output all results to console as text|
|--erc||Force the Roaming Client tests to be performed even if it's not installed.|
|--noerc||Skip the Roaming Client tests even if it's installed|
|-h, -?, --help||Display this usage statement|
If run without -o or -c arguments, -i is the default output; meaning there will be a URL shown on the screen. You're expected to copy that URL and send it to Support.
If the utility is run with -o or -c, then -i must be explicitly set if desired as additional output. We would recommend specifying -i in addition to -o or -c when running with those parameters.
You may specify multiple output formats if desired.
- This command will automatically run the diagnostic, displaying nothing to the user, and includes specific checks for "ProblematicDomain.com". Then, the diagnostic submits results to opendns.appspot.com, and Prints 'appspot=URL' to the command prompt/console with the resulting appspot URL to submit to Support.
UmbrellaDiagnostic.exe --domain=ProblematicDomain.com --silent
- This command automatically runs the diagnostic, displaying nothing to the user. The diagnostic then creates an output file at C:\windows\temp\diag.txt on the machine local to the diagnostic tool.
UmbrellaDiagnostic.exe --silent --output=C:\windows\temp\diag.txt
Example usage using PsExec
PsExec from Microsoft's Sysinternals site is a tool that may be used to remotely execute the UmbrellaDiagnostic.exe in a typical Windows domain environment.
The usage outlined here work best in a domain environment. In a workgroup environment, there must be a user with the same exact username and password on the remote machine and local machine.
To execute the tool remotely, substitute your variables for those in bold below. This syntax will test against "example.com", and post a URL at the end that you can submit to support:
psexec \\REMOTEMACHINE-NAME -u Administrator -p Password "C:\Program Files (x86)\OpenDNS\Umbrella Roaming Client\UmbrellaDiagnostic.exe" -d=example.com -s -i
PsExec v2.0 - Execute processes remotely
Copyright (C) 2001-2013 Mark Russinovich
Sysinternals - www.sysinternals.com
Running all tests... please wait...
C:\Program Files (x86)\OpenDNS\Umbrella Roaming Client\UmbrellaDiagnostic.exe exited on remotemachine-name with error code 0.