Linux Virtual Delivery Agent

Non-GRID 3D graphics

May 6, 2022

Contributed by:

Overview

With this feature enhancement, the Linux VDA supports not only NVIDIA GRID 3D cards but also non-GRID 3D cards.

Installation

To use the non-GRID 3D graphics feature, you must install XDamage as a prerequisite. Typically, XDamage exists as an extension of XServer.

Configuration

Xorg configuration files

If your 3D card driver is NVIDIA, the configuration files are installed and set automatically.

Other types of 3D cards

If your 3D card driver is NOT NVIDIA, you must modify the four template configuration files installed under /etc/X11/:

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

Using ctx-driver_name-1.conf as an example, do the following to modify the template configuration files:

Replace driver_name with your actual driver name.

For example, if your driver name is intel, you can change the configuration file name to ctx-intel-1.conf.
Add the video driver information.

Each template configuration file contains a section named “Device,” which is commented out. This section describes the video driver information. Enable this section before adding your video driver information. To enable this section:
1. See the 3D card guide provided by the manufacturer for configuration information. A native configuration file can be generated. Verify that your 3D card can work in a local environment with the native configuration file when you are not using a Linux VDA ICA session.
2. Copy the “Device” section of the native configuration file to ctx-driver_name-1.conf.

Run the following command to set the registry key so that the Linux VDA can recognize the configuration file name set in Step 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-->

Enable the non-GRID 3D graphics feature

The non-GRID 3D graphics feature is disabled by default. You can run the following command to enable it by setting XDamageEnabled to 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-->

Troubleshooting

No or garbled graphic output

If you can run 3D applications locally and all configurations are correct, missing or garbled graphic output is the result of a bug. Use /opt/Citrix/VDA/bing/setlog and set GFX_X11 to verbose to collect the trace information for debugging.

Hardware encoding does not work

This feature supports only software encoding.

The official version of this content is in English. Some of the Citrix documentation content is machine translated for your convenience only. Citrix has no control over machine-translated content, which may contain errors, inaccuracies or unsuitable language. No warranty of any kind, either expressed or implied, is made as to the accuracy, reliability, suitability, or correctness of any translations made from the English original into any other language, or that your Citrix product or service conforms to any machine translated content, and any warranty provided under the applicable end user license agreement or terms of service, or any other agreement with Citrix, that the product or service conforms with any documentation shall not apply to the extent that such documentation has been machine translated. Citrix will not be held responsible for any damage or issues that may arise from using machine-translated content.

Non-GRID 3D graphics

May 6, 2022

Contributed by:

May 6, 2022

Contributed by:

Non-GRID 3D graphics

Overview

Installation

Configuration

Xorg configuration files

Other types of 3D cards

Enable the non-GRID 3D graphics feature

Troubleshooting

No or garbled graphic output

Hardware encoding does not work

In this article