Linux Virtual Delivery Agent

Integration with the Citrix Telemetry Service

With the Citrix Telemetry Service (ctxtelemetry) integrated with the Linux VDA software, you can run Citrix Scout, which then uses the /opt/Citrix/VDA/bin/xdlcollect.sh script, to collect logs about the Linux VDA.

Citrix scout

Enable and disable the Citrix Telemetry Service

  • To enable the service, run the sudo systemctl enable ctxtelemetry.socket command.
  • To disable the service, run sudo systemctl disable ctxtelemetry.socket.

Ports

The Citrix Telemetry Service (ctxtelemetry), by default, uses TCP/IP port 7503 to listen for Citrix Scout. It uses TCP/IP port 7502 on the Delivery Controller to communicate with Citrix Scout.

To change ports after you have your VDA installed, do the following:

  1. To change a port for communicating with Scout, run the following command.

    /opt/Citrix/VDA/bin/ctxreg create -k "HKLM\Software\Citrix\VirtualDesktopAgent" -t REG_DWORD -v "TelemetryServicePort" -d <port number> --force
    <!--NeedCopy-->
    
  2. To change the socket port for listening for Scout, run the following command to open and edit the ctxtelemetry.socket file.

    sudo vi /etc/systemd/system/ctxtelemetry.socket
    <!--NeedCopy-->
    

    Socket port

  3. Run the following commands to restart the socket port.

    sudo systemctl daemon-reload
    sudo systemctl stop ctxtelemetry.socket
    sudo systemctl start ctxtelemetry.socket
    <!--NeedCopy-->
    
  4. Enable the new ports in your firewall configuration.

    If you are using Ubuntu, for example, run the sudo ufw allow 7503 command to enable port 7503.

Note:

You can also run ctxsetup.sh instead to automate the preceding steps 3 and 4.

Debug mode

If the Citrix Telemetry Service does not work as expected, you can enable debug mode to determine the causes.

  1. To enable debug mode, run the following command to open the ctxtelemetry file and then change the DebugMode value to 1.

    sudo vi /opt/Citrix/VDA/sbin/ctxtelemetry
    <!--NeedCopy-->
    

    Enable debug mode

  2. Manually stop the Citrix Telemetry Service, or wait 15 minutes for the service to stop automatically.

    Stop telemetry

    In this example, you can run the following commands to stop the Citrix Telemetry Service.

    sudo netstat -ntlp
    Kill -9 1958
    <!--NeedCopy-->
    
  3. To restart the Citrix Telemetry Service, select your Linux VDA on Scout and find telemetry-debug.log in /var/log/xdl/.

Service wait time

The systemd daemon that opens the socket port starts by default and uses few resources. The Citrix Telemetry Service stops by default and starts only when there is a log collection request from the Delivery Controller. After log collection completes, the service awaits new collection requests for a duration of 15 minutes and stops again if there are not any. You can configure the wait time through the following command. The minimum value is 10 minutes. If you set a value less than 10 minutes, the minimum value, 10 minutes, takes effect. After setting the wait time, stop and restart the service.

/opt/Citrix/VDA/bin/ctxreg create -k "HKLM\Software\Citrix\VirtualDesktopAgent" -v "TelemetryServiceIdleTimeoutInMinutes" -d <number> -t REG_DWORD
<!--NeedCopy-->

Verification tests

Before a collection starts, verification tests run automatically for each selected machine. These tests ensure that the requirements are met. If a test fails for a machine, Scout displays a message with suggested corrective actions. For more information about verification tests, see the Verification tests section in the Citrix Scout documentation.

Integration with the Citrix Telemetry Service