Product Documentation

故障排除

Feb 04, 2016

可以通过以下步骤确认安装并从用户处收集故障排除信息:

  • 确认检测到音频和视频设备。在用户设备上,从 Lync 工具菜单中,选择工具 > 音频/视频设置
  • 打开 Lync 的关于页面并确认连接属性(状态、连接类型和模式)。以下屏幕截图显示了正确的连接值。



    如果 RealTime Connector 处于回退或非优化模式,模式字段的值将为未优化。在回退模式下,将在服务器上进行视频和音频处理,并将媒体从终端发送到服务器然后再返回终端。

  • 通话期间,可以通过键入 Alt-N 查看与网络运行状况有关的信息。此时将显示“网络运行状况”窗口,如下例所示。红色值指示网络中存在的潜在问题。要将该值写入默认名称为 call_statistics_.txt 的文本文件中,请单击保存统计信息



查找日志文件

MediaEngineHost.exe 将客户端错误日志写入本地终端上的 %TEMP%\Citrix\RestrictedMediaEngine\ 中。

RealTime Connector 客户端应用程序也将日志写入 XenApp 或 XenDesktop 服务器。可以在以下位置找到日志,具体取决于客户端操作系统。
  • 对于 Windows XP 用户:C:\Documents and Settings\USERNAME\Local Settings\%Temp%\Citrix\RealTimeConnector\MediaEngine\MediaEngineDebugLogs
  • 对于 Windows 7 用户:C:\Users\USERNAME\AppData\Local\Temp\Citrix\RealTimeConnector\MediaEngine\MediaEngineDebugLogs

确定您的连接问题是否与 DNS 问题有关

如果您的终端上有 DNS 问题,则可能会导致 RealTime Connector 和 Citrix HDX RealTime Media Engine 注册失败,而 Lync 应用程序则会注册成功。此时,请从远程终端调试并修复 DNS 问题。

保存 Dell Wyse 终端的故障日志

在 Dell Wyse 终端上,当用户处于“用户”模式时,将不保存应用程序故障的日志文件。要保存故障日志,用户必须处于“管理员”模式。可在 MS-RAMDRIVE 中(默认情况下为 Wyse 终端上的驱动器 Z)找到故障日志。

更改 Citrix HDX RealTime Media Engine 错误日志的位置

通常,客户端应用程序的错误日志在客户端设备本地创建。但当终端用户注销时,此类本地错误日志有时会被删除,导致系统管理员无法进行检索。

为避免此问题,HDX RealTime Media Engine 将错误消息写入运行于客户端设备中的虚拟桌面上的 Media Engine 错误日志中。

将 Media Engine 主机错误消息的写入位置由虚拟桌面更改回本地客户端设备

  1. 在客户端设备上运行的远程桌面的注册表中,在HKEY_CURRENT_USER\Software\Citrix\HDXRTConnectorLC\MediaEngine中创建类型为 DWORD、名称为 EnableRemoteDebugLogging 的注册表值。
  2. EnableRemoteDebugLogging 值设置为 0。

要在虚拟桌面上重新启用远程错误消息日志记录功能,请将该注册表项的值设置为 1(启用)或将该注册表项整个删除。

限制 Citrix HDX RealTime Media Engine 的视频帧速率

如果因帧速率 (FPS) 高而导致视频出现问题(例如图像割裂),可通过以下注册表项的值来限制支持的 FPS:[HKEY_CURRENT_USER\Software\Citrix\HDXRTConnectorLC\MediaEngine] "MaxAllowableFrameRate"="15"

确定防火墙是否阻止了 RealTime Connector

如果个人防火墙阻止网络初始化的时间过长,RealTime Connector 可能无法初始化。下次运行程序时,如果用户已解除阻止应用程序,此情况将自行解决。

阻止防火墙时,将显示如下错误消息:

  • RealTime Connector is waiting for the connection from the Media Engine…
  • Failed to maintain RealTime Connector on this device.Communication to the Media Engine was disrupted.Please contact your system administrator.(RealTime Connector 正在等待与 Media Engine 建立连接…无法维护此设备上的 RealTime Connector。与 Media Engine 的通信中断。请与系统管理员联系。)

在这些情况下,请在 Windows 防火墙中创建一个例外。

启动第二个会话后将 Lync 恢复到正常大小

有时,当第一个会话保持打开时,如果用户在另一个终端上启动第二个会话,Microsoft Lync 不会在第二个会话中打开。它会在任务栏中保持最小化。要使其最大化,请在任务栏上单击鼠标右键并选择最大化。要将 Lync 恢复到正常大小,请重新启动 Lync。

解决 App Center 控制台中的“Application Not Running”(应用程序未运行)错误

关闭已发布的应用程序时,可能会显示Application Not Running(应用程序未运行)错误。要解决此问题,请将 LyncMonitor.exe 添加到 XenApp 服务器的注册表项中。有关信息,请参阅 http://support.citrix.com/article/CTX133328http://support.citrix.com/article/CTX891671

解决使用无线网络连接时的视频质量问题

如果使用无线网络连接时遇到视频质量问题,请尝试移近无线访问点。如果这样无法解决问题,请尝试使用有线网络连接。使用有线网络连接时,禁用无线网络适配器可避免传输问题。

在 Windows 终端上安装适用于 RealTime Media Engine 的根证书

某些 Windows 终端在其默认的受信任根证书组中不包含适用于 RealTime Media Engine 的 VeriSign 根证书。如果终端不具备所需证书,启动 Lync 之后将立即出现以下问题:

  • Lync 无法连接到 Media Engine。
  • 摄像机预览无法正常工作。
  • HDX RealTime Connector 程序信息页面中不包含与 Media Engine 对应的条目。
  • 终端错误日志中包含以下条目:Media Engine package search failure.It is impossible to launch MediaEngineHost.(Media Engine 软件包搜索失败。无法启动 MediaEngineHost。)

有关根证书问题的详细信息,请参阅以下文章:

获取根证书。

  1. 转至 https://www.verisign.com/support/roots.html
  2. VeriSign Root Package(VeriSign 根软件包)下,单击 Download a root package(下载根软件包)下载 roots.zip 存档。
  3. 将 roots.zip 存档中的文件提取到 Windows 终端。

手动安装或通过 Microsoft 管理控制台 (MMC) 安装根证书。

  • 执行手动安装:
    1. 从 Windows 终端上,导航到包含提取文件的 \roots 文件夹,然后打开文件夹 Verisign Root Certificates > Generation 5 (G5) PCA。
    2. 在此文件夹中,在 VeriSign Class 3 Public Primary Certification Authority - G5.cer 上单击鼠标右键,然后单击安装证书
    3. 在安全警告下滚动,打开“证书导入向导”,然后单击下一步
    4. 证书存储向导页面上,单击将所有的证书放入下列存储,然后单击浏览
    5. 选择证书存储对话框中,选中显示物理存储区复选框。
    6. 打开受信任的根证书颁发机构文件夹,选择本地计算机,然后单击确定
    7. 单击下一步,检查设置后,单击完成
  • 执行 MMC 安装:
    1. 从 Windows 终端上单击开始,然后单击运行。
    2. 运行字段中,键入mmc打开终端控制台。
    3. 在控制台的“文件”菜单中,选择添加/删除管理单元
    4. 添加/删除管理单元对话框中,单击添加
    5. 选择证书,然后单击添加
    6. 选择计算机帐户,然后单击下一步
    7. 选择本地计算机,然后单击完成

解决安装问题

一般来说,软件最常见的安装问题与安装所需的系统文件损坏有关。这些错误很少出现,但很难进行故障排除。

Media Engine 安装程序需要使用 Microsoft .NET 3.5.1。如果计算机中缺少此程序,通过安装此程序可解决问题。如果已安装此程序,请在 .NET 上运行修复安装。

在某些 Windows 计算机上,当运行嵌入式自定义操作 VB 脚本时,客户会在安装软件时遇到错误。向用户显示或安装日志中捕获到的常见错误为 2738 和 1720。如果防病毒程序将 vbscript.dll ClassID 置于 HKEY_CURRENT_USER 注册表配置单元之下,而非 HKEY_LOCAL_MACHINE(适当提升运行级别时需要)之下,某些客户会遇到这些错误。

运行以下注册表查询可确定当前用户或整个系统或两者是否已安装 vbscript.dll ClassID:

  • % reg query HKEY_CURRENT_USER\SOFTWARE\Classes\CLSID{B54F3741-5B07-11CF-A4B0-00AA004A55E8}
  • % reg query HKEY_LOCAL_MACHINE\SOFTWARE\Classes\CLSID{B54F3741-5B07-11CF-A4B0-00AA004A55E8}

应该仅对 HKEY_LOCAL_MACHINE 显示 ClassID。如果 ClassID 位于 HKEY_CURRENT_USER 之下,请执行以下步骤。如果 ClassID 位于 HKEY_LOCAL_MACHINE(而非 HKEY_CURRENT_USER)之下,请从步骤 2 开始。

  1. 运行防病毒清理实用程序:
    1. 如果终端已安装防病毒程序且供应商具有清理实用程序,请运行清理实用程序。
    2. 重新运行 Media Engine 安装程序 MSI。
    3. 如果问题仍然存在,请转至下一步。
  2. 注册 vbscript.dll:

    vbscript.dll 文件或对其 ClassID 的注册表引用会取消注册或损坏。请按照以下步骤进行注册或修复。

    1. 以管理员身份运行 CMD.exe:单击开始,键入cmd,右键单击 cmd,然后单击以管理员身份运行
    2. 在命令窗口中输入以下内容:
      • 对于 32 位版本的 Windows:cd %windir%\system32
      • 对于 64 位版本的 Windows:cd %windir%\syswow64
    3. 在命令窗口中输入以下内容:regsvr32 vbscript.dll
    4. 重新运行 Media Engine 安装程序 MSI。
    5. 如果问题仍然存在,请转至下一步。
  3. 删除 vbscript.dll ClassID:
    1. 在注册表编辑器中,找到并删除注册表项HKEY_Current_User\SOFTWARE\Classes\CLSID{ B54F3741-5B07-11CF-A4B0-00AA004A55E8}
    2. 单击开始 > 控制面板,导航到“用户帐户控制设置”,然后将滑块移动至不通知

      完成故障排除之后,可根据需要还原此更改。

    3. 重新运行 Media Engine 安装程序 MSI。
    4. 如果问题仍然存在,请转至下一步。
  4. 通过系统文件检查器修复损坏的系统文件:
    1. 以管理员身份运行 CMD.exe:单击开始,键入cmd,右键单击 cmd,然后单击以管理员身份运行
    2. 在命令窗口中输入以下内容:sfc /scannow
    3. 重新运行 Media Engine 安装程序 MSI。
    4. 如果问题仍然存在,请转至下一步。
  5. 将损坏的注册表项还原至初始状态:
    1. 重新启动 Windows 终端,在重新启动期间,插入操作系统安装 DVD 进行引导。

      操作系统安装 DVD 必须与此终端上安装的 Windows Service Pack 匹配。

    2. 按照安装步骤操作,选择用于修复操作系统的选项。
    3. 重新运行 Media Engine 安装程序 MSI。