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-->

监视 Remote PC Access VDA 的空白

对于使用非 vGPU 显卡的 Remote PC Access VDA,Linux VDA 支持物理显示器遮蔽。此增强功能可将图形显示卸载到可扩展虚拟显示接口 (Extensible Virtual Display Interface, EVDI) 虚拟显示器。

注意:

EVDI 虚拟显示器的最大数量因发行版而异。

显示器空白适用于 Ubuntu 20.04 和 Debian 11.3 VDA。要使用显示器消隐,请完成以下两个步骤:

  1. 根据您的 Linux 发行版安装 evdi-dkms 软件包:

    sudo apt install evdi-dkms
    <!--NeedCopy-->
    
  2. 启用图形显示卸载到 EVDI:

    /opt/Citrix/VDA/bin/ctxreg create -k "HKLM\System\CurrentControlSet\Control\Citrix\Thinwire" -t "REG_DWORD" -v "Evdi" -d "0x00000001" --force
    <!--NeedCopy-->
    
  3. 如果您使用的是 Intel 显卡,请禁用显示管理器。否则,Intel 卡将被显示管理器占用,无法用于 Citrix 远程会话。

    sudo systemctl disable --now gdm
    <!--NeedCopy-->
    

故障排除

无图形输出或图形输出为乱码

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

不能进行硬件编码

此功能仅支持软件编码。

非 vGPU 显卡