简介
本文档介绍如何通过Umbrella漫游客户端的诊断工具向支持人员提供诊断信息。
概述
Umbrella漫游客户端内置有诊断工具。该工具为支持部门提供了宝贵的信息,这些信息在排除复杂问题时必不可少。
本文概述了访问此工具的多种方式:从图形界面和命令行运行,并作为无人值守的进程在远程计算机上运行。
关键步骤
- 如果可能,请在打开与Umbrella漫游客户端相关的支持票证时始终提供此输出。
- 测试完成后,会生成一个.txt文件。请将.txt文件附加到票证。
- 如果访问特定域时遇到问题,请在“要测试的域”字段中添加该域。
注意:不要将诊断程序的文本输出复制到支持票证中。结果将丢失格式设置且无法读取。系统会要求您重新提交结果。
通过托盘图标运行诊断
在Windows或Mac OSX上安装Umbrella漫游客户端后,您可以从托盘图标访问和使用诊断工具。
可以有意隐藏Umbrella漫游客户端托盘图标,以防止用户感知Umbrella漫游客户端。在这种情况下,您无法通过这种方式调用诊断工具,您必须使用本文下一部分中介绍的其他方法。
|
MAC |
Windows 窗口版本 |
通过用户界面访问诊断工具 |
|
|
通过文件浏览器/查找器运行诊断
|
|
从文件浏览器(资源管理器)
- 导航至C:\Program Files(x86)\OpenDNS\Umbrella Roaming Client\
- 双击UmbrellaDiagnostic
*注:如果操作系统是32位,则文件夹仅称为“程序文件”
|
|
|
|
从Finder
- 导航到应用> OpenDNS漫游客户端
- 双击Umbrella Diagnostic。
|
|
通过命令行/终端运行诊断
在命令提示符下
- 打开命令提示符应用程序
- 键入以下内容并按Enter:
"C:\Program Files(x86)\OpenDNS\Umbrella Roaming Client\ UmbrellaDiagnostic.exe"
*注:如果操作系统是32位,请从Program Files路径名中删除(x86)。
|
|
从终端
- 打开终端应用程序
- 键入以下内容(带引号):
"/Applications/OpenDNS Roaming Client/Umbrella Diagnostic.app/Contents/MacOS/OpenDNSDiagnostic"
|
|
在远程计算机上运行诊断程序,或者从命令行无人值守:
诊断工具包含允许静默执行的功能(无需用户干预)。 当您要在用户计算机上运行诊断实用程序,但不想干扰用户时,这尤其有用。
这些开关可以分别从命令提示符或terminal添加到Windows或OSX版本中。
当运行不带交换机时,Umbrella Diagnostic将启动用户界面,并等待用户提交信息。远程运行时,几乎总是需要 — silent选项。
这些交换机可以附加到命令中,以自动执行无提示诊断并指导输出:
-d, —domain=VALUE
|
要通过测试确定目标的特定域(例如,ProblematicDomain.com) |
-s, —silent |
在静默模式下自动运行测试(不显示UI或新窗口;默认为 — i输出) |
-i、—internet |
将所有结果输出到diagnostic.opendns.com;目标URL以“appspot=URL”的形式打印到控制台 |
-o, —output=VALUE |
输出到文件,该文件以“outputFile=FILE”形式打印到控制台;可以是完整路径,确保在需要时使用“引号” |
-c、—console |
将所有结果以文本形式输出到控制台 |
-erc |
即使未安装,也强制执行漫游客户端测试。 |
-noerc |
即使安装了漫游客户端测试,也跳过该测试 |
-h、-?、 — 帮助 |
显示此用法语句 |
如果运行时不带 — o或 — c参数,-i是缺省输出;意味着屏幕上显示了一个URL。 您需要复制该URL并将其发送到支持部门。
如果实用程序与 — o或 — c一起运行,则在需要时,必须将 — i显式设置为其他输出。 建议在使用这些参数运行时,除了 — o或 — c外还指定 — i。
如果需要,可以指定多种输出格式。
使用示例
- 此命令将自动运行诊断,不会向用户显示任何内容,并且包括对“ProblemDomain.com”的特定检查。然后,诊断将结果提交到opendns.appspot.com,并向命令提示符/控制台打印“appspot=URL”,并将生成的appspot URL提交到支持部门。
UmbrellaDiagnostic.exe —domain=ProblematicDomain.com —silent
- 此命令自动运行诊断程序,不向用户显示任何内容。然后,诊断程序在诊断工具本地的计算机上在C:\windows\temp\diag.txt处创建一个输出文件。
UmbrellaDiagnostic.exe —silent —output=C:\windows\temp\diag.txt
使用PsExec的示例
Microsoft Sysinternals站点的PsExec是一个工具,可用于在典型的Windows域环境中远程执行UmbrellaDiagnostic.exe。
此处介绍的使用在域环境中效果最佳。 在工作组环境中,远程计算机和本地计算机上必须有具有完全相同用户名和密码的用户。
要远程执行工具,请将以下粗体显示的变量替换为变量。 此语法针对“example.com”进行测试,并在您可以提交支持的最后URL发布:
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...
appspot=http://opendnsupdate.appspot.com/d/34172100
Test complete!
C:\Program Files (x86)\OpenDNS\Umbrella Roaming Client\UmbrellaDiagnostic.exe exited on remotemachine-name with error code 0.
只需复制appspot=URL,即可获得诊断信息URL的副本以提供给支持部门!