In Citrix Workspace app, the Keyboard Dynamic synchronization mode functions differently on a Linux client from a Windows client. In general, on a Linux client, the keyboard output follows the client keyboard layout, which is different from the Windows VDA layout. Windows clients follow Windows VDA layout which is same as the Windows client keyboard layout. If a Linux client keyboard is synchronized to a Windows VDA, users may observe unpredictable keyboard output. Also, in dynamic synchronization mode, Citrix Workspace app for Linux does not support VDA users to switch the keyboard layout inside a VDA session.
In the server default mode, both Linux and Windows use the session (VDA) side keyboard layout with predictable output. In this release, ThinOS has a customized Citrix package where the keyboard layout is set to server default mode for predictable output. The keyboard layout that you select on the thin client is not automatically synchronized in the VDA session. VDA users must select or switch the keyboard layout inside the VDA session using the Windows Input Method Editor (IME) language bar.
As a VDA administrator, you must configure the VDA desktop with the required keyboard language layout options. The IME language bar must be enabled on the Windows lock screen. The VDA user can select the appropriate keyboard language layout on the Windows lock screen.
In scenarios such as opening a new application in a VDA session, locking, or unlocking the VDA session, the keyboard layout falls back to the VDA default layout. For example, EN_US. This is a known issue for a Linux client in the
server default mode.
You can customize VDA registry settings for a consistent keyboard layout in the VDA session.
- For a desktop operating system VDA, the feature is enabled by default.
- For a server operating system VDA, you can enable the feature using the system registry.
- In the system registry of VDA, go to
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Keyboard Layout.
- Create a DWORD entry
IgnoreRemoteKeyboardLayout=1.
By default, the
IgnoreRemoteKeyboardLayout entry is unavailable. The default keyboard is set to ENG, irrespective of the Control Panel setting.
For example, open an application, lock, or unlock the session, the keyboard is set to ENG. To resolve this issue, ensure that you set
IgnoreRemoteKeyboardLayout=1.
For information about the Keyboard Layout Modes and Keyboard Layout rules in Citrix Workspace app, see the
Citrix Virtual Apps and Desktops keyboard and IME configurations article at
www.citrix.com/blogs.
Table 1. Citrix Workspace app keyboard layout configuration for VDA users on ThinOS How to configure CWA keyboard for VDA users in ThinOS
VDA user scenario
|
ThinOS build
|
Wyse Management Suite settings
|
VDA settings
|
Summary
|
The client keyboard is synchronized to VDA, and the keyboard layout is not switched in the VDA desktop or application.
|
Disabled in ThinOS 9.0.4024
|
Configure the required keyboard layout for local client users and remote VDA users.
|
Set the VDA policy for Dynamic synchronization.
|
Keyboard output follows the client Linux keyboard layout and not the Windows layout. As a result, there can be unpredictable mismatch in the keyboard output. Citrix Workspace app Linux keyboard sync mode does not support switching the layout in VDA.
|
The client keyboard is synchronized to VDA, and the keyboard layout is switched in the VDA desktop using the IME language bar.
|
The client keyboard is synchronized to VDA, and the keyboard layout is switched in VDA published applications using the IME language bar.
|
The client keyboard is not synchronized to VDA, and the keyboard layout is not switched in the VDA desktop or application.
|
Supported in ThinOS 9.0.4024 with Citrix package 2006_1146
|
Configure the required keyboard layout for using the client locally. For example, sign on. There is no impact to the keyboard usage on remote VDA.
|
No specific settings are required. For recommended settings, see the
VDA settings for server default mode section.
|
Keyboard layout follows the VDA Windows layout with predictable output.
Opening a new application in a VDA session, locking or unlocking the VDA session, the keyboard layout falls back to the VDA default layout. For example, EN_US.
The following are the recommended settings for VDA administrators:
|
The client keyboard is not synchronized to VDA, and the keyboard layout is not switched in the VDA desktop using the IME language bar.
|
The client keyboard is not synchronized to VDA, and the keyboard layout is not switched in VDA published applications using the IME language bar.
|
Table 2. Language keyboard layout settings
ThinOS keyboard layout
|
Windows layout
|
Wyse Management Suite settings
|
Citrix Workspace app Linux dynamic synchronization
|
Recommended settings
|
Polish
|
Keyboard layout partially matches with the Windows layout.
|
Not supported; will be supported in future release.
|
Disabled in ThinOS 9.0.4024
|
On ThinOS 9.0.4024 with Citrix Workspace app 2006_1146, the following are the recommended settings:
- On the client side, select the keyboard layout that fully matches with the Windows layout for local usage.
- On the VDA side, select the best layout from the Windows IME language bar after the connection is established.
- For VDA administrators, see the
Citrix Workspace app keyboard layout configuration for VDA users on ThinOS table in this document.
|
Polish (Legacy)
|
Keyboard layout fully matches with the Windows layout.
|
Not supported; will be supported in future release.
|
Disabled in ThinOS 9.0.4024
|
French (France)
|
Keyboard layout partially matches with the Windows layout.
|
Supported
|
Disabled in ThinOS 9.0.4024
|
French (Microsoft)
|
Keyboard layout fully matches with the Windows layout.
|
Not supported; will be supported in future release.
|
Disabled in ThinOS 9.0.4024
|
Belgian
|
Keyboard layout does not match with the Windows layout.
|
Not supported; will be supported in future release.
|
Disabled in ThinOS 9.0.4024
|
Belgian (Comma)
|
Keyboard layout fully matches with the Windows layout.
|
Not supported; will be supported in future release.
|
Disabled in ThinOS 9.0.4024
|
Spanish
|
Keyboard layout does not match with the Windows layout.
|
Supported
|
Disabled in ThinOS 9.0.4024
|
VDA settings for Server Default mode
When set to server default mode, the keyboard layout falls back to the VDA default layout. For example, EN_US. This issue can be related to Citrix Workspace app or Windows server operating system 2016 and 2019. All workarounds may require you to modify registry keys on the server side. For more information about workarounds, see the Citrix articles
CTX269153 and
CTX223316 at
support.citrix.com. If you do not want to modify registry keys, contact the Citrix support team or the Microsoft support team.
Table 3. Citrix Workspace app Linux keyboard layout settings—Client and VDA
Mode
|
Client-side settings
|
Server or VDA-side settings
|
Additional information
|
Server default (This mode is set by default in ThinOS 9.0.4024).
|
~/.ICAClient/wfclient.ini
[WFClient]
keyboardlayout=(Server Default)
|
Setting is configured on the StoreFront server. For example,
C:\inetpub\wwwroot\Citrix\[store name]\App_Data\default.ica
[WFClient]
keyboardlayout=(Server Default)
|
Set the mode on either the client side or the server side. This mode takes the highest priority.
|
Specific keyboard (This mode is disabled in ThinOS 9.0.4024).
|
~/.ICAClient/wfclient.ini
[WFClient]
keyboardlayout=French
|
Setting is configured on the StoreFront server. For example,
C:\inetpub\wwwroot\Citrix\[store name]\App_Data\default.ica
[WFClient]
keyboardlayout=French
|
Set the mode on either the client side or the server side. You must set the value in
/opt/Citrix/ICAClient/module.ini [KeyboardLayout].
|
Dynamic sync (Available in subsequent release versions of XenApp 1912 and Citrix Workspace App 1912. However, this mode is disabled in ThinOS 9.0.4024).
|
/opt/Citrix/ICAClient/config/module.ini
[ICA 3.0]
KeyboardSync=On
~/.ICAClient/wfclient.ini
[WFClient]
keyboardlayout=(User Profile)
|
XenApp server version 2006 and higher—Enable the following policies on the server end:
- Set the
Client Keyboard Layout synchronization and IME improvement policy to
Support dynamic client keyboard layout sychronization and IME improvement.
- Set the
Enable Unicode keyboard layout mapping to
Allowed.
XenApp server version before 2006—There are no policies available to enable dynamic sync mode. You must set the registry key in the Windows VDA desktop Keyboard sync configuration. The setting is enabled by default on Windows Server 2012 and Windows 10. The setting is disabled by default on Windows Server 2016 and Windows Server 2019.
To enable the setting, add the following registry key:
HKLM\Software\Citrix\ICA\IcaIme\DisableKeyboardSync value=DWORD.
To enable Unicode Keyboard Layout Mapping for Windows VDA, add the following registry keys:
- HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\CtxKlMap\EnableKlMap value= DWORD 1
- HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\CtxKlMap\DisableWindowHook value=DWORD 1
|
Set the mode on both the client side and the server side.
|
Sync once (This mode is disabled in ThinOS 9.0.4024).
|
/opt/Citrix/ICAClient/config/module.ini
[ICA 3.0]
KeyboardSync=Off
~/.ICAClient/wfclient.ini
[WFClient]
keyboardlayout=(User Profile)
|
Not available
|
Not available
|
Limitations—Keyboard shortcut keys such as
Ctrl+Alt+Down,
Ctrl+Alt+Left, and
Ctrl+Alt+Right do not work inside the VDI session. To resolve this issue, press the
Ctrl+Alt key combination inside the session. This is a Citrix limitation.
Table 4. ThinOS dynamic synchronization supportThinOS dynamic synchronization support
Keyboard
|
Synchronization
|
Arabic (Algeria)
|
Not supported
|
Arabic (Bahrain)
|
Not supported
|
Arabic (Egypt)
|
Not supported
|
Arabic (Iraq)
|
Not supported
|
Arabic (Jordan)
|
Not supported
|
Arabic (Kuwait)
|
Not supported
|
Arabic (Lebanon)
|
Not supported
|
Arabic (Libya)
|
Not supported
|
Arabic (Morocco)
|
Not supported
|
Arabic (Oman)
|
Not supported
|
Arabic (Qatar)
|
Not supported
|
Arabic (Saudi Arabia)
|
Not supported
|
Arabic (Syria)
|
Not supported
|
Arabic (Tunisia)
|
Not supported
|
Arabic (U.A.E)
|
Not supported
|
Arabic (Yemen)
|
Not supported
|
Canadian Multilingual
|
Supported.
|
Chinese (Simplified)
|
Supported. When you switch to the language Keyboard layout in VDA, the keyboard layout is synchronized to the English layout.
|
Chinese (Traditional)
|
Supported. When you switch to the language Keyboard layout in VDA, the keyboard layout is synchronized to the English layout.
|
Croatian
|
Supported
|
Czech (Qwerty)
|
Supported
|
Czech
|
Supported
|
Danish
|
Supported
|
Dutch
|
Supported
|
English (3270 Australian)
|
Supported
|
English (Australian)
|
Supported
|
English (New Zealand)
|
Supported
|
English (United Kingdom)
|
Supported
|
English (United States)
|
Supported
|
Estonian (Estonia)
|
Supported
|
Finnish
|
Supported
|
French (Canadian Legacy)
|
Supported
|
French (Canadian)
|
Not supported
|
French (France)
|
Supported
|
French (France Microsoft)
|
Not supported
|
French (Switzerland)
|
Supported
|
German (Switzerland)
|
Supported
|
German
|
Supported
|
Greek
|
Supported
|
Hungarian
|
Supported
|
Icelandic
|
Supported
|
Italian (Switzerland)
|
Not supported
|
Italian
|
Supported
|
Japanese (OADG109A)
|
Supported
|
Japanese (KWD)
|
Supported. When you switch to the language Keyboard layout in VDA, the keyboard layout is synchronized to the English layout.
|
Korean (MS-IME2002)
|
Supported. When you switch to the language Keyboard layout in VDA, the keyboard layout is synchronized to the English layout.
|
Korean
|
Supported. When you switch to the language Keyboard layout in VDA, the keyboard layout is synchronized to the English layout.
|
Latvian (Latvia)
|
Supported
|
Lithuanian (IBM)
|
Supported
|
Lithuanian (Standard)
|
Supported
|
Norwegian
|
Supported
|
Polish
|
Supported
|
Polish (Legacy)
|
Not supported
|
Portuguese (Brazil)
|
Supported
|
Portuguese
|
Supported
|
Romanian
|
Not supported
|
Russian
|
Supported. When you switch to the language Keyboard layout in VDA, the keyboard layout is synchronized to the English layout.
|
Serbian
|
Supported
|
Slovenian
|
Supported
|
Spanish
|
Supported
|
Swedish
|
Supported
|
Turkish
|
Supported
|
U.S.International
|
Not supported
|
NOTE Keyboard layout dynamic synchronization mode is disabled in ThinOS v9.0.4024 build.