When utilizing an ICA receiver for UNIX/Linux or connecting to a UNIX server, it might become necessary to troubleshoot keyboard issues, which is true in non-English environments. A number of UNIX commands and utilities are available to assist with diagnosing such issues. The commands discussed here are normally provided with the original UNIX installation or might be available as part of an optional package.

Troubleshooting

When connecting from an ICA receiver to UNIX/Linux, record and use the following information to investigate the client side when troubleshooting keyboard/language issues:

• The keyboard settings are shown under, Options > Settings > Preferences panel of the ICA receiver for UNIX/Linux user interface, wfcmgr, or the ICA file equivalent.

• If the ICA connection is to a non-English session, ensure that the client keyboard also behaves as required in the local operating system.

For example, the language behavior in the ICA session must have the same functionality in the local operating system as is desired in the connected ICA session, such as if you are using a French language keyboard and output character settings, ensure that these are working correctly before you start the ICA session.

• It is not sufficient to change only the ICA Client settings. This might require the change of dip switches on the client keyboard or some proprietary UNIX commands such as xkbdlang (some versions of Linux), itemap –Li (HP UX), and so on. Refer to your operating system documentation for information about correctly setting up your keyboard language type.

When connecting to a XenApp for UNIX server and/or from an ICA receiver for UNIX, record and investigate the following information on the UNIX side:

xmodmap –pke

This command displays the current settings of the xmodmap table. The xmodmap table maps hardware keyboard codes (keycodes) to displayable characters (Keysyms). The -e option displays the table in the expression format, which is the format the xmodmap command accepts to modify the table.

xmodmap –pm

This command lists the modifier mappings such as Num Lock, Caps Lock, and mouse buttons that can alter the output behavior of certain keyboard and mouse actions.

xmodmap –e <options>

This command is used to modify the keyboard mapping or modifier codes.

Xev

This is a useful utility that provides the keycodes from the xserver and displays how they are interpreted in real time. It runs as an X application and when it has the window focus, it prints the Keycodes and Keysyms for any key being pressed.

Xdpyinfo

locale and locale –a

These commands determine the current UNIX locale settings and all available locale settings.
Connect to the server from a terminal using wfica -keylog -desc xxxx > /tmp/log and type the problem key sequences. For the wfica –keylog information about which key or key sequence was used, the expected and final results are required.

Additional Resources

Refer to the Citrix XenApp for UNIX Operating Systems Administrator’s Guide for more information about installing XenApp for UNIX operating systems.