Linux Virtual Delivery Agent

非 vGPU 显卡

非 vGPU 显卡是指不支持 NVIDIA 虚拟 GPU (vGPU) 解决方案的显卡。本文提供了有关使用非 vGPU 显卡的信息。

  • 先决条件

要使用非 vGPU 显卡,需要:

  • 安装 XDamage 作为先决条件。通常,XDamage 作为 XServer 的扩展存在。
  • 在安装 Linux VDA 时,将 CTX_XDL_HDX_3D_PRO 设置为 Y。有关环境变量的信息,请参阅步骤 7:设置运行时环境以完成安装

配置

  • 修改 Xorg 配置文件

  • 对于 NVIDIA 显卡

如果使用 NVIDIA 驱动程序,则配置文件将自动安装和设置。

对于其他显卡

需要修改安装在 /etc/X11/ 下的四个模板配置文件:

  • ctx-driver_name-1.conf
  • ctx-driver_name-2.conf
  • ctx-driver_name-3.conf
  • ctx-driver_name-4.conf

ctx-driver_name-1.conf 为例,执行以下操作来修改模板配置文件:

  1. driver_name 替换为实际驱动程序名称。

    例如,如果驱动程序名称为 intel,则可以将配置文件名称更改为 ctx-intel-1.conf

  2. 添加视频驱动程序信息。

    每个模板配置文件都包含一个名为“Device”的节,该节已注释掉。此节描述了视频驱动程序信息。在添加视频驱动程序信息之前,请启用此节。要启用此节:

    1. 请参阅显卡制造商提供的配置信息指南。可以生成本机配置文件。在未运行 Linux VDA 会话时,请验证显卡是否可以在本地环境中使用本机配置文件工作。

    2. 将本机配置文件的“Device”节复制到 ctx-driver_name-1.conf

  3. 运行以下命令以设置注册表项,以便 Linux VDA 可以识别在步骤 1 中设置的配置文件名称。

    /opt/Citrix/VDA/bin/ctxreg create -k "HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Citrix\XDamage" -t "REG_SZ" -v "DriverName" -d "intel" --force
    <!--NeedCopy-->
    

启用非 vGPU 图形

非 vGPU 图形功能默认处于禁用状态。可以通过运行以下命令并将 XDamageEnabled 值设置为 1 来启用此功能。

/opt/Citrix/VDA/bin/ctxreg create -k "HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Citrix\XDamage" -t "REG_DWORD" -v "XDamageEnabled" -d "0x00000001" --force
<!--NeedCopy-->

故障排除

图形输出缺失或乱码

如果可以在本地运行 3D 应用程序且所有配置均正确,则图形输出缺失或乱码是 Bug 造成的结果。使用 /opt/Citrix/VDA/bin/setlog 并将 GFX_X11 设置为 verbose 以收集跟踪信息进行调试。

硬件编码不起作用

此功能仅支持软件编码。

非 vGPU 显卡