Contenido

Introducción

Windows:

OS X

Introducción

Este documento describe el propósito de cada archivo y carpeta instalados por el cliente de roaming de Umbrella para Windows y Mac OS X. Esta información se puede utilizar para aumentar sus conocimientos de trabajo sobre el cliente de roaming de Umbrella, o para ayudar cuando se trata de instalaciones interrumpidas.

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.