Linux Virtual Delivery Agent

故障排除

本文介绍了如何使用 XDPing 进行故障排除以及如何使用 ctxsdcutil 实用程序查询会话数据。

XDPing

Linux XDPing 工具是一个命令行应用程序。它可以自动执行检查 Linux VDA 环境中的常见配置问题的过程。

安装 Linux XDPing 工具

运行 ctxsetup.sh 不会安装 XDPing。要安装 XDPing,请运行 sudo /opt/Citrix/VDA/bin/xdping。 此命令还会创建一个 XDPing 所需的 Python3 虚拟环境。如果此命令无法创建 Python3 虚拟环境,请按照创建 Python3 虚拟环境中的说明手动创建该环境。

要解决在使用 pip 工具时可能会遇到的 SSL 连接错误,请考虑将以下可信主机添加到 /etc/pip.conf 文件中:

[global]
trusted-host =
pypi.org
files.pythonhosted.org

可以使用 XDPing 完成的任务

XDPing 附带从命令 shell 运行的名为 XDPing 的单个可执行文件。

下表介绍了可以使用相应的 XDPing 命令完成的各种任务:

任务 XDPing 命令 备注
显示命令行选项 sudo /opt/Citrix/VDA/bin/xdping -h 不适用
运行全套测试 sudo /opt/Citrix/VDA/bin/xdping(在没有任何命令行选项的情况下运行 XDPing Linux XDPing 工具在系统中执行了 150 多项单项测试。有关详细信息,请参阅本文后面的单项测试
运行 VDA 注册状态检查 sudo /opt/Citrix/VDA/bin/xdping -a 有关详细信息,请参阅本文后面的注册状态检查的范围
备份 VDA 的关键数据 sudo /opt/Citrix/VDA/bin/xdping -b 有关详细信息,请参阅本文后面的 VDA 数据的备份和比较
比较 VDA 备份数据的两个最新副本 sudo /opt/Citrix/VDA/bin/xdping -diff 有关详细信息,请参阅本文后面的 VDA 数据的备份和比较
比较 VDA 备份数据的两个特定副本 **sudo /opt/Citrix/VDA/bin/xdping -diff=<一个备份数据目录>:<另一个备份数据目录>\*\*另一个备份数据目录>一个备份数据目录>另一个备份数据目录>一个备份数据目录> 有关详细信息,请参阅本文后面的 VDA 数据的备份和比较
在安装 Linux VDA 软件包之前检查环境 sudo /opt/Citrix/VDA/bin/xdping –preflight 不适用
仅运行特定的测试类别(例如,time、Kerberos 和 database 测试) sudo /opt/Citrix/VDA/bin/xdping -T time,kerberos,database 不适用
探测特定的 Delivery Controller **sudo /opt/Citrix/VDA/bin/xdping -d ** 不适用

单项测试

Linux XDPing 工具在系统中执行 150 多个单项测试,这些测试大致分类如下:

  • 检查是否满足 Linux VDA 系统要求。
  • 识别和显示计算机信息,包括 Linux 发行版。
  • 检查 Linux 内核的兼容性。
  • 检查是否存在任何可能影响 Linux VDA 操作的已知 Linux 发行版问题。
  • 检查安全增强型 Linux (SELinux) 模式和兼容性。
  • 识别网络接口并检查网络设置。
  • 检查存储分区和可用的磁盘空间。
  • 检查计算机主机和域名配置。
  • 检查 DNS 配置并执行查找测试。
  • 识别基本虚拟机管理程序并检查虚拟机配置。支持:
    • XenServer(以前称为 Citrix Hypervisor)
    • Microsoft HyperV
    • VMware vSphere
  • 检查时间设置并检查网络时间同步是否可以运行。
  • 检查 PostgreSQL 服务是否正确配置和运行。
  • 检查 SQLite 的配置和运行是否正确。
  • 检查防火墙是否已启用且所需端口是否已打开。
  • 检查 Kerberos 配置并执行身份验证测试。
  • 检查 LDAP 搜索环境中的组策略服务引擎。
  • 检查 Active Directory 集成是否已正确设置,以及当前计算机是否已加入域。支持:
    • Samba Winbind
    • Dell Quest Authentication Services
    • Centrify DirectControl
    • SSSD
  • 检查 Active Directory 中 Linux 计算机对象的完整性。
  • 检查可插拔身份验证模块 (PAM) 配置。
  • 检查核心转储模式。
  • 检查是否安装了 Linux VDA 所需的软件包。
  • 识别 Linux VDA 软件包并检查安装的完整性。
  • 检查 PostgreSQL 注册表数据库的完整性。
  • 检查 Linux VDA 服务是否已正确配置和运行。
  • 检查 VDA 和 HDX 配置的完整性。
  • 探测配置的每个 Delivery Controller,以测试 Broker Service 是否可访问、运行且响应迅速。
  • 检查计算机是否已在 Delivery Controller 场中注册。
  • 检查每个活动或断开连接的 HDX 会话的状态。
  • 扫描日志文件中是否存在与 Linux VDA 相关的错误和警告。
  • 检查 Xorg 的版本是否适合。
  • 检查是否安装了所需的依赖项。

示例输出

下面是运行 Kerberos 测试的示例输出:

Kerberos 测试示例输出的第一部分

Kerberos 测试示例输出的第二部分

Kerberos 测试示例输出的第三部分

VDA 注册状态检查的范围

Linux XDPing 工具还提供了一个分析模块,可帮助您检查和分析 VDA 注册状态。有关注册状态检查的范围,请参见以下屏幕截图:

注册状态检查

VDA 数据的备份和比较

自 Linux VDA 2305 起,XDPing 工具引入了 VDA 备份模块。此模块允许您随时备份 VDA 的关键数据,例如配置、数据库和二进制权限数据。当 VDA 正常运行时,您可以备份 VDA 的关键数据。如果 VDA 以后出现故障,请备份另一个数据副本并比较两个数据副本以方便故障排除。下表介绍了 VDA 数据备份以及与相应的 XDPing 命令的比较:

任务 XDPing 命令 备注
备份 VDA 的关键数据 sudo /opt/Citrix/VDA/bin/xdping -b 每次运行备份命令时,都会生成备份数据的副本并将其保存在 /var/ctxbackup 下的目录中。备份数据目录以 yyyy-mm-dd-hh_mm_ss 格式的当前日期和时间命名,例如 2023-02-27-16_31_27。默认情况下,备份数据目录的最大数量为 30,超过该数量时 XDPing 工具会轮换或删除旧的备份数据目录。要自定义目录轮换的次数,请运行以下命令:sudo /opt/Citrix/VDA/bin/ctxreg create -k "HKLM\Software\Citrix\VirtualDesktopAgent\Backup" -t "REG_DWORD" -v "MaxDirRotationCount" -d "0x0000005" --force
比较 VDA 备份数据的两个最新副本 sudo /opt/Citrix/VDA/bin/xdping -diff 不适用
比较 VDA 备份数据的两个特定副本 **sudo /opt/Citrix/VDA/bin/xdping -diff=<一个备份数据目录>:<另一个备份数据目录>\*\*另一个备份数据目录>一个备份数据目录>另一个备份数据目录>一个备份数据目录> 不适用

会话数据查询实用程序

我们提供的实用程序 (ctxsdcutil) 可用于查询每个 Linux VDA 上的会话数据。要查询 VDA 上托管的所有会话或特定会话的以下数据,请运行 /opt/Citrix/VDA/bin/ctxsdcutil -q <all | SessionID> [-c] 命令。[-c] 参数表示每秒钟查询一次数据。

  • 输入会话带宽

  • 输出会话带宽、

  • 输出会话线速度

  • 延迟 - 上次记录

  • 往返行程时间

  • 输出 ThinWire 带宽

  • 输出音频带宽

  • 输出打印机带宽

  • 输入驱动器带宽

  • 输出驱动器带宽

故障排除