Introduction
This document describes the purpose of each file and folder installed by the Umbrella roaming client for both Windows and Mac OS X. This information can be used to increase your working knowledge of the Umbrella roaming client, or assist when dealing with broken installations.
Windows
Service Name: "Umbrella_RC"
C:\ProgramData\OpenDNS\ERC\
beacon-logs\
Folder containing log files kept by the Umbrella roaming client for troubleshooting and diagnostic purposes.
Upgrades\
Folder containing temp files when automatically updating to the latest version.
Config.json
Contains the unique "Device" and "Origin" ID's specific to this Umbrella roaming client. This file must stay in place for proper, registered operation of the Umbrella roaming client.
OpenDNS_ERC_Service.log
Live log of the Umbrella roaming client's running process. Used for Umbrella troubleshooting.
OpenDNS_ERC_UI.log
Live log of the Umbrella roaming client's tray icon process. Used for Umbrella troubleshooting.
OrgInfo.json
Contains information about the install-time parameters specified during installations, and also contains organization-specific information used for registering with the Umbrella API.
PersistedNicDefaults.json
A file for storing the DNS settings assigned to a computer before the Umbrella roaming client initiates and utilizes the network-defined DNS servers only for resolution of internal domains.
We keep the information in this file in order to gracefully restore the network-defined DNS servers in certain situations.
proxy_whitelist.txt
The "Internal Domains" list downloaded from the dashboard, as well as DNS Suffixes imported from the local Network configuration. Used by the Umbrella roaming client to identify if DNS queries should be sent
to the local DNS servers. Read more at Roaming Client: Internal Domains.
*Network Connection Name*-resolv.conf
Each active Network Interface on the computer will have its own .conf file, (ie: Local Area Connection-resolv.conf, Wireless Connection-resolv.conf). We use this list to keep an interface-by-interface list of
what DNS servers belonged to which networking interface. These files contain the local DNS servers normally found on the NIC settings which are hidden by the Umbrella roaming client operation which sets DNS to 127.0.0.1.
RoamingProfile.json
A file to be used as part of a future feature.
sync-latest.json
The latest copy of the profile information specific to each Umbrella roaming client. Used for Umbrella troubleshooting.
whitelist.txt
The "Internal Domains" list downloaded from the Umbrella dashboard which is used by the Umbrella roaming client to identify if DNS queries should be sent to the local DNS servers. This file is separate
from the "proxy_whitelist.txt" file, which is used as a temporary file. Read more at Roaming Client: Internal Domains.
C:\Program Files (x86)\OpenDNS\Umbrella Roaming Client\
dnscryptproxy.exe
In Umbrella Roaming client 3.0 and above, this is the executable used for encrypting, authenticating, and sending DNS queries. This executable is responsible for binding to 127.0.0.1:53
dnscrypt-proxy.exe (depreciated in 2.3)
Used in Umbrella Roaming client versions before 2.3. It has been superseded by dnscryptproxy.exe.
ERCInterface.exe
The executable used for running the tray icon.
UmbrellaDiagnostic.exe
The built-in diagnostic tool which customers or Support can run for troubleshooting purposes.
*.dll
Dynamic Load Libraries associated with running different facets of the Umbrella roaming client.
ERCInterface.exe.config
.NET framework configuration file for the ERCInterface.exe executable.
ERCService.exe.config
.NET framework configuration file for the ERCService.exe executable.
Logging.config
Configuration file used for instructing the Umbrella roaming client what to log or not log. Controls verbosity of logs.
UmbrellaDiagnostic.exe.config
.NET framework configuration file for the UmbrellaDiagnostic.exe executable.
GetNetStats.bat
A facilitating script to assist with getting information as part of the Umbrella Diagnostic tool.
OS X
/Library/Application Support/OpenDNS Roaming Client
beacon-logs/
Folder containing log files kept by the Umbrella roaming client for troubleshooting and diagnostic purposes.
Updater.plist
Local configuration data unique to the local installation of the Umbrella roaming client.
com.opendns.osx.DNSCryptProxy.plist
The configuration file used to set runtime parameters for the dns-updater executable.
dns-updater
The executable used for encrypting, authenticating, and sending DNS queries. This executable is responsible for binding to 127.0.0.1:53
localdomains
The list of domain names that the Umbrella roaming client treats a local resources and queries the local DNS servers. Read more about Internal Domains.
p12.hash
Hash file to verify integrity of clientCert.p12 file.
sync-latest.plist
The latest copy of the profile information specific to each Umbrella roaming client. Used for Umbrella troubleshooting.
erc_state.plist
Data that is synced with our API to populate the Umbrella dashboard with information about the Umbrella roaming client.
resolv_orig.conf
We use this list to keep an ordered list of DNS servers used for Internal DNS resolution. The list will contain DNS servers associated with all network interfaces, attempting to prioritize
VPN DNS servers first. These are the DNS servers normally found on the NIC settings which are hidden by the Umbrella roaming client operation which sets DNS to 127.0.0.1.
/Library/LaunchDaemons/
com.opendns.osx.RoamingClientConfigUpdater.plist
The configuration file for running the Umbrella roaming client.
/Library/LaunchAgents/
com.opendns.osx.RoamingClientMenubar.plist
The configuration file for running the menu bar icon of the Umbrella roaming client.
Feedback