Viewing user interactions in virtualized and embedded environments

Viewing user interactions in virtualized and embedded environments

Overview

Because of the non-standard user logon process in Citrix XenApp and embedded (kiosk mode) Windows, the Collector is neither able to report user logons nor user interactions by using its default detection mechanism when running on these systems.

When installing the Collector in Citrix XenApp or in a Windows device running on kiosk mode, make sure that you set the custom shells option. This option tells the Collector to detect user logon events and interactions by means of an alternative mechanism.

To enable this special mode in the Collector, use either the CUSTOM_SHELLS MSI parameter during the installation of the Collector or the custom_shells option of the Collector Configuration Tool after it has been installed.

If you happen to install the Collector in a Citrix XenApp server, read carefully the following section.

Session termination in Citrix XenApp

Because of a known limitation of Citrix XenApp, in some cases a session may fail to close even after the user has gracefully logged off.

When a user logs in, the Collector spawns the rundll32.exe process. To avoid leaving sessions active and waste resources, ensure that Citrix is able to close this process when the user logs off and terminate the session:

  1. Log in to the Citrix XenApp server as administrator.
  2. Locate the following key in the registry editor:
    HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Citrix\wfshell\TWI
  3. Add the rundll32.exe process to the list of processes in the key value LogoffCheckSysModules:
    Citrix regkey.png