How to enable dynamic keyboard layout synchronization for Linux VDA sessions

How to enable dynamic keyboard layout synchronization for Linux VDA sessions

book

Article ID: CTX232459

calendar_today

Updated On:

Description

This article introduces the method to enable dynamic keyboard layout synchronization for Linux VDA sessions and general troubleshooting tips.
 

Instructions

In the previous 7.16 release, Linux VDA allowed Citrix customers to change the keyboard layout during an application session, but the keyboard layout on the client device had to be the same with that on the Linux VDA as described in CTX230070.
With this release, the keyboard layout on the client device can be automatically synchronized to the Linux VDA, whenever the keyboard layout on the client device changes.
Note: This feature is compatible with Citrix Receiver for Windows and can be effective in both application and desktop sessions.
Configuration
This feature is disabled by default, perform the following steps to enable:
  • On Linux VDA:
You can enable it use the ctxreg utility. The feature configuration on a given Linux VDA applies to all sessions on that VDA.
The registry key is “HKEY_LOCAL_MACHINE\SYSTEM \CurrentControlSet\Control\Citrix\SyncKeyboardLayout” and the type is DWORD.
To enable this feature, run the command:
/opt/Citrix/VDA/bin/ctxreg update -k "HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Citrix\SyncKeyboardLayout" -v "Enabled" -d "0x00000001"
  • On On the Citrix Receiver:
Right-click the Receiver icon, choose Advanced Preferences -> Local Keyboard Layout Setting, choose “Yes, I prefer to use the local keyboard layout, rather than the keyboard layout provided by the remote server”.

 
Usage
With this feature enabled, when the keyboard layout changes on the client device during a session, the keyboard layout of the session changes accordingly.
For example, if you change the keyboard layout on a client device to French (FR):

Then the keyboard layout of the Linux VDA session also changes to “fr”.
  • In an application session, you can see this automatic change if you have enabled the language bar:
  • In a desktop session, you can see this automatic change in the task bar:

Troubleshooting
For a general troubleshooting purpose, you can:
  1. Check the ctxism process status through ps command, for example, ps –aux|grep ctxism.
  2. Get more detailed logging:
  • Enable ctxism verbose log through setlog:  /opt/Citrix/VDA/bin/setlog level ISM VERBOSE
  • Look for “citrix-ctxism” lines in /var/log/xdl/hdx.log.

 

Issue/Introduction

This article introduces the method to enable dynamic keyboard layout synchronization for Linux VDA sessions and general troubleshooting tips.
Powered by Wolken Software