When end users connect a Japanese 106 keyboard to the machine where CWA Linux installed and select Scancode mode in Citrix Linux, the extra keys in a Japanese 106 keyboard might not work on VDA.

The Caps Lock or Eisu (英数) key is a special key that has different functions in different keyboard layout, so it may not work correctly when there not just Japanese keyboard layout in client and server.

 

To support ""Japanese 106 keyboard"" users need to make an extra configuration:

1. Navigate to the $HOME/.ICAClient/wfclient.ini configuration file.
2. Add the following entries:
   • KeyboardType = 106 Keyboard (Japanese)
3. After the configuration, Henkan（变换), Mohenkan（无变换), Hiragana/Katakana, Hankaku/Zenkaku(全角半角) will be recognized and work well.

There are 2 different scenarios we may encounter:

Use Case 1:
There is only one Japanese keyboard in the client (we can run command ""setxkbmap jp"" to clear the other keyboard and set only Japanese keyboard)

• In this case, since the key will only be recognized as Eisu key on client, the VDA will always receive it as Eisu key instead of CapsLock.
• End users need to use a combination shortcut Shift+Eisu to perform uppercase/lowercase toggle actions.
• Even when users change the server keyboard layout to a Latin keyboard such as English, users still need to tap the shortcut Shift + Eisu to perform uppercase/lowercase toggle actions.

Use Case 2:
There are more keyboard layouts on Linux client, for example: both the Japanese keyboard layout and other Latin keyboard layouts are installed on Linux client.

• In this case, the CapsLock/Eisu(英数) key will both work. When tapping CapsLock/Eisu(英数) key, CWA Linux will send both the keyboard status and keydown event to Windows VDA.
• So on Windows VDA side, the behavior is like: Microsoft Japanese IME will switch to input mode and change the caps lock status at the same time.

---

Problem Cause

• Linux OS behaviors
• The default keyboard type in CWA Linux is English 102 keyboard layout. When users connect a Japanese 106 hardware keyboard, the scan codes of these extra keys are not recognized correctly. 

This article assists with properly using the Caps Lock/Eisu key on Japanese 106 keyboard with CWA Linux, as specific configuration and actions are needed.