Linux Virtual Delivery Agent

Configure IPv6

The Linux VDA supports IPv6 to align with Citrix Virtual Apps and Desktops. When using this feature, consider the following:

  • For dual stack environments, IPv4 is used unless IPv6 is explicitly enabled.
  • If IPv6 is enabled in an IPv4 environment, the Linux VDA fails to function.

Important:

  • The whole network environment must be IPv6, not only for the Linux VDA.
  • Centrify does not support pure IPv6.

No special setup tasks are required for IPv6 when you install the Linux VDA.

Configure IPv6 for the Linux VDA

Before changing the configuration for the Linux VDA, ensure that your Linux virtual machine has previously worked in an IPv6 network. There are two registry keys related to IPv6 configuration:

“HKLM\Software\Policies\Citrix\VirtualDesktopAgent” -t “REG_DWORD” -v “OnlyUseIPv6ControllerRegistration”
“HKLM\Software\Policies\Citrix\VirtualDesktopAgent” -t “REG_DWORD” -v “ControllerRegistrationIPv6Netmask”
<!--NeedCopy-->

OnlyUseIPv6ControllerRegistration must be set to 1 to enable IPv6 on the Linux VDA:

sudo /opt/Citrix/VDA/bin/ctxreg create -k "HKLM\Software\Policies\Citrix\VirtualDesktopAgent" -t "REG_DWORD" -v "OnlyUseIPv6ControllerRegistration" -d "0x00000001" --force
<!--NeedCopy-->

If the Linux VDA has more than one network interfaces, ControllerRegistrationIPv6Netmask can be used to specify which one is used for the Linux VDA registration:

sudo /opt/Citrix/VDA/bin/ctxreg create -k "HKLM\Software\Policies\Citrix\VirtualDesktopAgent" -t "REG_SZ" -v "ControllerRegistrationIPv6Netmask " -d "{IPv6 netmask}" --force
<!--NeedCopy-->

Replace {IPv6 netmask} with the real netmask (for example, 2000::/64).

For more information about IPv6 deployment in Citrix Virtual Apps and Desktops, see IPv4/IPv6 support.

Troubleshooting

Check the basic IPv6 network environment and use ping6 to check whether AD and Delivery Controller are reachable.

Configure IPv6