Linux Virtual Delivery Agent

System tray

Session users can click the following system tray icon to perform the actions or view the indicators:

System tray icon

Introduction to items in the system tray

Each item corresponds to a feature with a toggle. When the feature corresponding to an item is disabled, the item is hidden and not displayed.

  • Screen sharing

    For more information about this feature, see HDX screen sharing.

  • Desktop environment switch

    This item is a GUI for ctxdesktopswitch.sh. For more information, see Custom desktop environments by session users.

    Desktop environment customization by session users is enabled by default. To disable it, run the following command:

     /opt/Citrix/VDA/bin/ctxreg create -k "HKLM\System\CurrentControlSet\Control\Citrix\Thinwire" -t "REG_DWORD" -v "EnableDesktopSwitch" -d "0x00000000" --force
     <!--NeedCopy-->
    
  • Graphics quality slider

    For more information, see the Graphics quality slider section in the graphics configuration article.

  • Real-time CQI

    Currently, the ICA Round Trip Time (RTT) and latency data are displayed. For more information, see the session data query utility.

    The system tray icon displays differently according to the latency in real-time CQI:

    Real-time CQI status 1Real-time CQI status 2 Real-time CQI status 3Real-time CQI status 4

    There are thresholds that control when the icon changes display. By default, they are set as follows:

     /opt/Citrix/VDA/bin/ctxreg create -k "HKLM\System\CurrentControlSet\Control\Citrix\Thinwire" -t "REG_DWORD" -v "HighLatencyThreshold" -d "0x000000dc" --force
     <!--NeedCopy-->
    
     /opt/Citrix/VDA/bin/ctxreg create -k "HKLM\System\CurrentControlSet\Control\Citrix\Thinwire" -t "REG_DWORD" -v "LowLatencyThreshold" -d "0x00000078" --force
     <!--NeedCopy-->
    

    When the actual latency is less than or equal to LowLatencyThreshold, the icon is marked green. When the actual latency is greater than HighLatencyThreshold, the icon is marked red. In other circumstances, the icon is marked yellow. If real-time CQI is disabled, the icon does not have a color mark.

    The real-time CQI is enabled and displayed by default. To disable and hide it and make the tray icon not have a color mark, run the following command:

     /opt/Citrix/VDA/bin/ctxreg create -k "HKLM\System\CurrentControlSet\Control\Citrix\Thinwire" -t "REG_DWORD" -v "EnableCqiShow" -d "0x00000000" --force
     <!--NeedCopy-->
    
  • Graphics status

    This indicator shows the graphics settings for the current session. It is enabled by default. To disable it, run the following command:

     /opt/Citrix/VDA/bin/ctxreg create -k "HKLM\System\CurrentControlSet\Control\Citrix\Thinwire" -t "REG_DWORD" -v "EnableGfxInfo" -d "0x00000000" --force
     <!--NeedCopy-->
    

Enable the system tray

The system tray as well as the client battery status display is enabled by default. Under certain conditions, however, you must do extra configuration to enable the system tray as well as the client battery status display. Details are as follows:

  1. Enable the graphics status indicator policy in Citrix Studio.

  2. (This step is required only when you are using RHEL 8.x/9.x, Rocky Linux 8.x/9.x, Debian 11, or SUSE 15.x installed with GNOME.) Install a compatible extension for your GNOME shell to enable AppIndicator support.

    1. Run the gnome-shell --version command to check your GNOME shell version.

    2. Download a compatible extension for your GNOME shell from https://extensions.gnome.org/extension/615/appindicator-support. For example, if your shell version is 3.28, you can select 24 or 26 for the extension version.

      GNOME shell extension

    3. Unzip the downloaded package and rename the unzipped directory to appindicatorsupport@rgcjonas.gmail.com. Verify that the “uuid” value in the metadata.json file in the package is set to appindicatorsupport@rgcjonas.gmail.com.

    4. Run the mv command to move the appindicatorsupport@rgcjonas.gmail.com directory to the location under /usr/share/gnome-shell/extensions/.

    5. Run the chmod a+r metadata.json command to make the metadata.json file readable to other users.

      Tip:

      By default, the metadata.json file in the appindicatorsupport@rgcjonas.gmail.com directory is readable only to the root user. To support screen sharing, make the metadata.json file readable to other users as well.

    6. Install GNOME Tweaks.

    7. In the desktop environment, reload your GNOME shell by pressing the Alt+F2, r, and Enter keys in sequence or by running the killall -SIGQUIT gnome-shell command.

    8. In the desktop environment, run GNOME Tweaks and then enable KStatusNotifierItem/AppIndicator Support in the Tweaks or Extensions tool.

  3. (This step is required only when you are using Debian 11 installed with GNOME.) Complete the following steps to install and enable GNOME system tray icons.

    1. Run the sudo apt install gnome-shell-extension-appindicator command. You might have to log out and then back in again for GNOME to see the extension.

    2. Search for Tweaks in your Activities screen.

    3. Select Extensions in the Tweaks tool.

    4. Enable Kstatusnotifieritem/appindicator support.

      Tweaks

  4. (This step is required if you are using RHEL 7.9 installed with GNOME.) Complete the following steps to install and enable GNOME system tray icons.

    1. Search for Tweaks in your Activities screen.
    2. Select Extensions in the Tweaks tool.
    3. Enable Top icons.

      Top icons

    4. Log out of and back on to the session.
System tray