Linux Virtual Delivery Agent

工具和实用程序

会话数据查询实用程序

  • 我们提供一个实用程序 (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 测试的示例输出:

First part of the Kerberos test sample output

Second part of the Kerberos test sample output

Third part of the Kerberos test sample output

VDA 注册状态检查范围

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

Registration status checks

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=:** 不适用
工具和实用程序