Linux VDA Custom Port Configuration

book

Article ID: CTX694984

calendar_today

Updated On:

Description

Setting the Custom Port

  1. Define the Custom Port:

    • When running the ctxsetup.sh, set the CTX_XDL_VDA_PORT to the custom port that the customer has configured on the DDC.
    export CTX_XDL_VDA_PORT='<custom-port-number>'
  2. Registry Configuration:

    • The CTX_XDL_VDA_PORT will automatically set the following two registry entries:
      • ControllerRegistrarPort: Indicates the DDC port.
      • VdaCxfServicesPort: Indicates the VDA port.

Setting Different Values

  • If customers want to set different values for these ports, they can do so using the ctxreg command instead of ctxsetup.sh. Here’s how to do it:
/opt/Citrix/VDA/bin/ctxreg create -k "HKLM\Software\Citrix\VirtualDesktopAgent" -t "REG_DWORD" -v "ControllerRegistrarPort" -d "<DDC-port-number>" --force || return 1
/opt/Citrix/VDA/bin/ctxreg create -k "HKLM\Software\Citrix\VirtualDesktopAgent" -t "REG_DWORD" -v "VdaCxfServicesPort" -d "<VDA-port-number>" --force || return 1

 

Important Notes

  • Ensure that the Linux VDA is properly configured to communicate with the DDC by setting the appropriate ports. This will facilitate seamless registration and service communication.
  • Make sure that the firewall allows the custom ports for incoming connections.

Issue/Introduction

With the latest updates, Linux VDA now supports custom VDA ports. If the Delivery Controller (DDC) has changed the default port (80), the Linux VDA must be configured to use the same custom port. This can be achieved by setting the CTX_XDL_VDA_PORT variable when running the ctxsetup.sh script. Additionally, if different values are required for the ports, they can be set using the ctxreg command.