工具和实用程序
会话数据查询实用程序
-
我们提供一个实用程序 (ctxsdcutil),可用于查询每个 Linux VDA 上的会话数据。要查询 VDA 上托管的所有会话或特定会话的以下数据,请运行
/opt/Citrix/VDA/bin/ctxsdcutil -q <all | SessionID> [-c]命令。[-c]参数表示每秒查询一次数据。 -
输入会话带宽
-
输出会话带宽
-
输出会话线路速度
-
延迟 - 上次记录
-
往返时间
-
输出 ThinWire 带宽
-
输出音频带宽
-
输出打印机带宽
-
输入驱动器带宽
-
输出驱动器带宽
xdlcollect Bash 脚本
用于收集日志的 xdlcollect Bash 脚本已集成到 Linux VDA 软件中,位于 /opt/Citrix/VDA/bin 下。安装 Linux VDA 后,您可以运行 bash /opt/Citrix/VDA/bin/xdlcollect.sh 命令来收集日志。日志收集完成后,将在与脚本相同的文件夹中生成一个压缩日志文件。xdlcollect Bash 脚本可以询问您是否将压缩日志文件上传到 Citrix Insight Services (CIS)。如果您同意,xdlcollect 将在上传完成后返回一个 upload_ID。上传不会从您的本地计算机中删除压缩日志文件。其他用户可以使用 upload_ID 访问 CIS 中的日志文件。
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 附带一个名为 xdping 的可执行文件,可从命令 shell 运行。
-
下表介绍了可使用相应 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 注册状态检查范围。 -
备份 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 不适用 -
探测特定的 Delivery Controller **sudo /opt/Citrix/VDA/bin/xdping -d ** 不适用
单独测试
- Linux **XDPing** 工具对系统执行 150 多项单独测试,这些测试大致分为以下几类:
-
注意:
-
-
Linux XDPing 工具不执行 SQLite 测试。
- 检查是否满足 Linux VDA 系统要求
- 识别并显示计算机信息,包括 Linux 发行版
-
- 检查 Linux 内核兼容性
- 检查是否存在可能影响 Linux VDA 运行的已知 Linux 发行版问题
- 检查 Security-Enhanced Linux (SELinux) 模式和兼容性
- 识别网络接口并检查网络设置
- 检查存储分区和可用磁盘空间
- 检查计算机主机和域名配置
- 检查 DNS 配置并执行查找测试
- 识别底层虚拟机管理程序并检查虚拟机配置。支持:
- Citrix Hypervisor™
- Microsoft HyperV
- VMware vSphere
- 检查时间设置并检查网络时间同步是否正常运行
- 检查 PostgreSQL 服务是否已正确配置并正常运行
- 检查防火墙是否已启用以及所需端口是否已打开
- 检查 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 数据备份和比较以及相应的 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= |
不适用 |