故障排除
本文介绍了如何使用 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 | 不适用 |
| 仅运行特定测试类别，例如，时间、Kerberos 和数据库测试 | 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 命令的比较：
| Task | XDPing Command | Remarks |
|---|---|---|
| To back up the key data of a VDA | sudo /opt/Citrix/VDA/bin/xdping -b | Each time you run the backup command, a copy of the backup data is generated and saved in a directory under /var/ctxbackup. The backup data directories are named the current date and time in yyyy-mm-dd-hh_mm_ss format, for example, 2023-02-27-16_31_27. By default, the maximum number of backup data directories is 30 and the XDPing tool rotates or deletes old backup data directories when the number is exceeded. To customize the number for directory rotation, run the following command: sudo /opt/Citrix/VDA/bin/ctxreg create -k "HKLM\Software\Citrix\VirtualDesktopAgent\Backup" -t "REG_DWORD" -v "MaxDirRotationCount" -d "0x0000005" --force
|
| To compare the latest two copies of VDA backup data | sudo /opt/Citrix/VDA/bin/xdping -diff | N/A |
| To compare two specific copies of VDA backup data | **sudo /opt/Citrix/VDA/bin/xdping -diff= |
N/A |
会话指标查询实用程序
ctxsession
此实用程序提供 Windows 用户体验。 使用此实用程序，您可以按以下屏幕截图所示访问会话指标：
ctxqsession、ctxquser、ctxqfull、ctxquery
有关如何使用这些实用程序的说明，请运行帮助命令，例如：
用户只能查询自己的会话指标。 只有 root 用户和 ctxadm 组用户有权查询其他用户的会话指标。
ctxsdcutil
此实用程序有助于查询 VDA 上托管的所有会话或特定会话的以下指标。 为此，请运行 /opt/Citrix/VDA/bin/ctxsdcutil -q <all | SessionID> [-c] 命令。 [-c] 参数表示每秒查询一次指标。
-
输入会话带宽
-
输出会话带宽、
-
输出会话线速度
-
延迟 - 上次记录
-
往返行程时间
-
输出 ThinWire 带宽
-
输出音频带宽
-
输出打印机带宽
-
输入驱动器带宽
-
输出驱动器带宽