Umbrellaローミングクライアントのファイルとフォルダ

はじめに

このドキュメントでは、WindowsとMac OS Xの両方のUmbrellaローミングクライアントによってインストールされる各ファイルとフォルダの目的について説明します。この情報を使用して、Umbrellaローミングクライアントの作業知識を増やすか、インストールの失敗を処理する際に役立てることができます。

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.