Feature Description
This feature was first introduced in Session Recording 7.17 and provides a build-in ability in to monitor high-level session events and associate them with the recording files as meaningful event tags. With this feature, customers can easily search for events of interest from mass amount of recordings and locate graphical evidence.
In the 7.17 release, USB mass storage device attach events on Windows Receiver and Mac Receiver through CDM mapping or Generic redirection are supported.
 
Feature Requirements
To make this feature work properly, make sure both Session Recording Agent and VDA should be upgraded at least to 7.17 release. Currently supported versions of Receiver for Windows and Receiver for Mac are also required.
 
Configuration: Enable or disable USB mass storage device event logging
Three registry keys on Session Recording Agent were added as the feature toggle switch.

1. After installation, log on as an administrator to the Session Recording Agent machine.
2. Open the Registry Editor.
3. Browse to HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditor\SessionEvents
4. Set the value of EnableSessionEvents to:

5. Set the value of EnableCDMUSBDriveEvents to:

6. Set the value of EnableGenericUSBDriveEvents to:

7. Reboot the SR Agent to make the feature toggle switch change take effect.
8. Configure the CDM mapping and USB redirection policies on Citrix Studio according to your actual needs.

Important Note:
On Citrix Studio, CDM mapping policy is Enabled by default, USB redirection policy is Disabled by default.

You can refer to the table below to set the registry keys values for the required scenario:

Scenarios	Registry keys values
Enable logging both CDM mapped and generic redirected USB mass storage USB device attach events	EnableSessionEvents = 1 EnableCDMUSBDriveEvents = 1 EnableGenericUSBDriveEvents = 1
Only enable logging CDM mapped USB mass storage USB device attach events	EnableSessionEvents = 1 EnableCDMUSBDriveEvents = 1 EnableGenericUSBDriveEvents = 0
Only enable logging generic redirected USB mass storage USB device attach events	EnableSessionEvents = 1 EnableCDMUSBDriveEvents = 0 EnableGenericUSBDriveEvents = 1
Disable logging both CDM mapped and generic redirected USB mass storage USB device attach events	EnableSessionEvents = 0 EnableCDMUSBDriveEvents = 0 EnableGenericUSBDriveEvents = 0

   
Playback the recordings with logged events
When playing back the recordings with logged USB mass storage device attach events on Player, you can see the events were displayed in the “Events and Bookmarks” panel and also appear as yellow dots in the lower part of the Player window.
You can use these events to help you navigate through recorded sessions, you can skip to the point in the recorded session where the event is inserted.


Search for recordings with event tags
Session Recording Player allows you to perform advanced searches to search for recordings with event tags.

1. In the Session Recording Player window, click Advanced Search on the tool bar or choose Tools  >  Advanced Search.
2. Define your search criteria on the tabs of the Advanced Search dialog box, Events tab allows you to search logged events that had been inserted to the sessions by Event type. You can use “Event type” and other filter conditions in Common and Data/Time in combination to search for the recordings which met the criteria. For example, you can search all recordings with CDM mapped mass storage USB device attach events within 24 hours.

 

Caution! Using Registry Editor incorrectly can cause serious problems that might require you to reinstall your operating system. Citrix cannot guarantee that problems resulting from the incorrect use of Registry Editor can be solved. Use Registry Editor at your own risk. Be sure to back up the registry before you edit it.