故障排除
本文介绍了如何使用 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 |
不适用 |
| 显示 VDA 上安装了的依赖项 | sudo /opt/Citrix/VDA/bin/xdping –query-pkgs 或 sudo /opt/Citrix/VDA/bin/xdping -q | 不适用 |
| 显示 VDA 上安装的依赖项并将查询结果保存在特定路径中 | **sudo /opt/Citrix/VDA/bin/xdping -f <用于保存查询结果的特定路径>\*\* 或 \*\*sudo /opt/Citrix/VDA/bin/xdping --query-pkgs-to <用于保存查询结果的特定路径>\*\*用于保存查询结果的特定路径>用于保存查询结果的特定路径>用于保存查询结果的特定路径>用于保存查询结果的特定路径> | 不适用 |
单项测试
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 测试的示例输出：
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=<一个备份数据目录>:<另一个备份数据目录>\*\*另一个备份数据目录>一个备份数据目录>另一个备份数据目录>一个备份数据目录> | 不适用 |
会话指标查询实用程序
ctxsession
此实用程序提供 Windows 用户体验。使用此实用程序，您可以按以下屏幕截图所示访问会话指标：
ctxqsession、ctxquser、ctxqfull、ctxquery
有关如何使用这些实用程序的说明，请运行帮助命令，例如：
用户只能查询自己的会话指标。只有 root 用户和 ctxadm 组用户有权查询其他用户的会话指标。
ctxsdcutil
此实用程序有助于查询 VDA 上托管的所有会话或特定会话的以下指标。为此，请运行 /opt/Citrix/VDA/bin/ctxsdcutil -q <all | SessionID> [-c] 命令。[-c] 参数意味着每秒查询一次指标。
-
输入会话带宽
-
输出会话带宽、
-
输出会话线速度
-
延迟 - 上次记录
-
往返行程时间
-
输出 ThinWire 带宽
-
输出音频带宽
-
输出打印机带宽
-
输入驱动器带宽
-
输出驱动器带宽