Session Recording 7.13

Last Modified: Nov 7, 2020 @ 6:34 am

Navigation

This article applies to Session Recording 7.6 (including LTSR), 7.8, 7.11, 7.12, and 7.13. For 7.14 and newer, there’s a different article.

💡 = Recently Updated

Planning

George Kuruvilla – An Introduction To Session Recording (XA/XD 7.6 Feature Pack 1) – Installation, Configuration and User Experience

Citrix links:

XenApp/XenDesktop Platinum Edition licensing is required.

Remote Desktop Session Host VDAs added in Session Recording 7.6. Virtual desktops added in Session Recording 7.8.

There is no relation between Session Recording and XenApp/XenDesktop farms. You can have Agents from multiple XenApp/XenDesktop farms recording to a common Session Recording server. Or you can split a XenApp/XenDesktop farm so that different Agents point to different Session Recording servers. An Agent can only point to one Session Recording server (Load Balancing is not supported).

The Session Recording server will need a hard drive to store the recordings. Disk access is primarily writes.

Offloaded content (e.g. HDX Flash, Lync webcam, MMR) is not recorded.

Session Recording server needs a certificate. The certificate must be trusted by Agents and Players. Internal Certificate Authority recommended.

SQL:

  • Supported Versions = SQL 2008 R2 Service Pack 3 through SQL 2016.
  • The SQL database is very small.
  • The database name is CitrixSessionRecording. Can be changed in only 7.13 and newer.
  • Temporary sysadmin permissions are needed to create the database and sysadmin can be revoked after installation.
  • SQL Browser Service must be running.
  • As of Session Recording 7.13, SQL Server High Availability (AlwaysOn Availability Groups, Clustering, Mirroring) is supported. See Install Session Recording with database high availability at Citrix Docs. And see Citrix Blog Post Session Recording 7.13 – New HA and Database Options

Download Session Recording 7.13 from XenApp 7.13 / XenDesktop 7.13, Platinum Edition Components:

Session Recording Server Installs

IIS and Message Queuing

  1. If you are installing this on Windows Server 2008 R2 then see the prerequisites list at Citrix Docs.
  2. You also can use scripts to install Windows roles and features prerequisites that are required for Session Recording to work properly. See Scripts to add Windows roles and features prerequisites at Citrix Docs.
  3. In Server Manager, open the Manage menu, and click Add Roles and Features.
  4. Skip to the Server Roles page.
  5. In the Server Roles page, check the box next to Web Server (IIS), and click Next.
  6. In the Features page, expand .NET Framework 4.5 Features, expand WCF services, and select HTTP Activation.
  7. Expand Message Queuing, and expand Message Queuing Services.
  8. Select Message Queuing Server and HTTP Support. Click Next.
  9. In the Web Server Role > Select role services page, expand Security, and click Windows Authentication.
  10. Expand Application Development, and select ASP.NET 4.5/4.6.

  11. Expand IIS 6 Management Compatibility, and select all four boxes. Click Next through the rest of the wizard.
  12. Use MMC Certificates snap-in or IIS, or similar, to request a machine certificate.
  13. In IIS Manager, right-click the Default Web Site, and click Edit Bindings.
  14. On the right, click Add.
  15. Change the Type to https.
  16. Select the certificate, and click OK.

Server Components

  1. If you are installing this on Windows Server 2008 R2 then see the prerequisites list at Citrix Docs.
  2. The person installing Session Recording needs to be a sysadmin on the remote SQL server.
  3. In the SessionRecording7.13.0\Session Recording Administration folder, run Broker_PowerShellSnapIn_x64.msi.
  4. In the Please read the Citrix Broker PowerShell Snap-In License Agreement page, check the box next to I accept the terms, and click Install.
  5. In the Completed the Citrix Broker PowerShell Snap-In Setup Wizard page, click Finish.
  6. Run SessionRecordingAdministrationx64.msi.
  7. In the Welcome to the Citrix Session Recording Administration Installation Wizard page, click Next.
  8. In the License Agreement page, select I accept the license agreement, and click Next.
  9. In the Select Features page, click Next.
  10. If you are installing Session Recording 7.12 or older, in the Database and Server Configuration page, enter the name of the SQL server, and click Test.

  11. If you are installing Session Recording 7.13 or newer, enter the SQL server name, and enter a Database Name. Only 7.13 and newer lets you specify the Database Name.
  12. Enter the name of the Session Recording server in domain\machine-name format, and click Next.
  13. In the Administrator Logging Configuration page, if installing Session Recording 7.13 or newer, enter a name for the Logging Database, and then click Next.
  14. If installing Session Recording 7.12 or older, just click Next.
  15. In the Citrix Customer Experience Improvement Program page, make a choice, and click Next.

  16. In the Citrix Session Recording Administration has been successfully installed page, click Finish.
  17. In SQL Server Management Studio, notice the new CitrixSessionRecording and CitrixSessionRecordingLogging databases.

Upgrade

If you are upgrading from 7.8 or older, the logging feature won’t be installed.

  1. In Server Manager > Add Roles and Features, on the Features page, expand .NET Framework 4.5 Features, expand WCF Services and select HTTP Activation. Finish the wizard.
  2. In Programs and Features, right-click Citrix Session Recording Administration, and click Change.
  3. In the Application Maintenance page, select Modify and click Next.
  4. In the Select Features page, expand Session Recording Server.
  5. Change the selection for Session Recording Administrator Logging to installed and click Next.
  6. If you see a message about HTTP Activation, install the feature and restart the wizard.
  7. In the Administrator Logging Configuration page, if installing Session Recording 7.13 or newer, enter a name for the Logging Database, and then click Next.
  8. If installing Session Recording 7.12 or older, just click Next.
  9. In the Ready to Modify the Application page, click Next.
  10. In the Citrix Session Recording Administration has been successfully installed page, click Finish.

Session Recording Server Configuration

  1. From Start Menu, run Session Recording Server Properties.
  2. In the Storage tab, specify a path that has disk space to hold the recordings. UNC is supported, but strongly discouraged.
  3. In the Signing page, select (Browse) a certificate to sign the recordings.
  4. In the Playback tab, notice that Session Recording files are encrypted before transmit. Also, it’s possible to view live sessions but live sessions are not encrypted.
  5. In the Notifications tab, you can change the message displayed to users before recording begins.

  6. The CEIP tab lets you enable or disable the Customer Experience Improvement Program.
  7. See https://www.carlstalhood.com/delivery-controller-7-13-and-licensing/#ceip for additional places where CEIP is enabled.
  8. The Logging tab lets you configure Logging.
  9. When you click OK you’ll be prompted to restart the service.
  10. Session Recording relies on Message Queuing. In busy environments, it might be necessary to increase the Message Queuing storage limits. See CTX209252 Error: “Data lost while recording file…” on Citrix SmartAuditor.


David Ott Session Recording Cleanup Script: You may notice that the session recording entries/files don’t go away on their own. Here is how to clean them up. Just create a scheduled task to run the code below once per day (as system – elevated). See David’s blog post for details.

C:\Program Files\Citrix\SessionRecording\Server\Bin\icldb.exe remove /RETENTION:7 /DELETEFILES /F /S /L

Also see CTX134777 How to Remove Dormant Files From a SmartAuditor Database.

Authorization

  1. From the Start Menu, run Session Recording Authorization Console.
  2. In the PolicyAdministrator role, add your Citrix Admins group.
  3. If you use Director to configure Session Recording, add the Director users to the PolicyAdministrator role.
  4. In the Player role, add users that can view the recordings.
  5. By default, nobody can see the Administration Log. Add auditing users to the LoggingReader role.
  6. Session Recording 7.11 has a Session Recording Administrator Logging feature, which opens a webpage to https://SR01.corp.local/SessionRecordingLoggingWebApplication/. Only members of the LoggingReader role can see the data.

Policies

  1. From the Start Menu, run Session Recording Policy Console.
  2. Enter the hostname of the Session Recording server, and click OK.
  3. Only one policy can be enabled at a time. By default, no recording occurs. To enable recording, right-click one of the other two built-in policies and click Activate Policy.
  4. Or you can create your own policy by right-clicking Recording Policies, and clicking Add New Policy.

  5. After the policy is created, right-click it, and click Add Rule.
  6. Decide if you want notification or not, and click Next.
  7. Click OK to acknowledge this message.
  8. Choose the rule criteria. You can select more than one. Session Recording 7.12 and newer have an IP Address or IP Range rule.
  9. Then click the links on the bottom specify the groups, applications, servers, and/or IP range for the rule. Click Next.

  10. Give the rule a name, and click Finish.
  11.  Continue adding rules.
  12. When done creating rules, right-click the policy, and click Activate Policy.
  13. You can also rename the policy you created.

Session Recording Agent

Install the Agent on the VDAs. Platinum Licensing is required.

  1. Install Message Queuing Server with HTTP Support. If RDSH, in Server Manager, open the Manage window, and click Add Roles and Features.

    1. Skip to the Features page.
    2. In the Features page, expand Message Queuing. Expand Message Queuing Services.
    3. Check the box next to Message Queuing Server. Also check HTTP Support.
    4. Click Add Features. Click Next.
    5. In the Web Server Role > Select role services page, don’t change anything, and click Next.
    6. In the Confirm installation selections page, click Install.
    7. If install fails, try PowerShell instead.
      Install-WindowsFeature msmq-server,msmq-http-support -IncludeAllSubFeature

  2. If virtual desktop (Session Recording 7.8 and newer), go to Programs and Features.

    1. Click Turn Windows features on or off.
    2. Expand Microsoft Message Queue, expand Microsoft Message Queue, and select MSMQ HTTP Support. Click OK.
  3. If the VDA is Windows 7, or Windows 2008 R2, install Microsoft hotfix 2554746 MSMQ service might not send or receive messages after you restart a computer. Or install the Convenience Rollup.
  4. In the SessionRecording7.13.0\Session Recording Agent folder, run SessionRecordingAgentx64.msi.
  5. In the Welcome to the Citrix Session Recording Agent Installation Wizard page, click Next.
  6. In the License Agreement page, select I accept the license agreement and click Next.
  7. In the Session Recording Agent Configuration page, enter the FQDN of the Session Recording Server, and click Test.
  8. Click OK and then click Next.
  9. In the Destination Folder page, click Next.
  10. In the Ready to Install the Application page, click Next.
  11. In the Citrix Session Recording Agent has been successfully installed page, click Finish.
  12. Agent Installation can also be automated. See Automating installations at Citrix Docs.
  13. In the Start Menu is Session Recording Agent Properties.
  14. You can enable or disable session recording on this Agent.
  15. For MCS and PVS VDAs, see the GenRandomQMID.ps1 script at XenApp/XenDesktop 7.13 Known Issues at Citrix Docs.
  16. Session Recording Agent might cause MCS Image Prep to fail. To work around this, set the Citrix Session Recording Agent service to Automatic (Delayed Start). Source = Todd Dunwoodie at Session Recording causes Image preparation finalization Failed error at Citrix Discussions.

Session Recording Player

Install the Player on any Windows 7 through Windows 10 desktop machine. 32-bit color depth is required. Because of the graphics requirements, don’t run the Player as a published application.

  1. In the SessionRecording7.13.0\Session Recording Player folder, run SessionRecordingPlayer.msi.
  2. In the Welcome to the Citrix Session Recording Player Installation Wizard page, click Next.
  3. In the License Agreement page, select I accept the license agreement, and click Next.
  4. In the Destination Folder page, click Next.
  5. In the Ready to Install the Application page, click Next.
  6. In the Citrix Session Recording Player has been successfully installed page, click Finish.
  7. From the Start Menu, run the Session Recording Player.
  8. Open the Tools menu, and click Options.
  9. On the Connections tab, click Add.
  10. Enter the FQDN of the Session Recording server.
  11. On the Cache tab you can adjust the client-side cache size. Click OK.
  12. Use the Search box to find recordings.
  13. Or you can go to Tools > Advanced Search.

  14. Once you find a recording, double-click it to play it.
  15. If you see a message about Citrix Client version incompatibility, see CTX206145 Error: “The Session Recording Player Cannot Play Back This File” to edit the Player’s SsRecPlayer.exe.config file to accept the newer version.
  16. To skip spaces where no action occurred, open the Play menu, and click Fast Review Mode.
  17. You can add bookmarks by right-clicking in the viewer pane. Then you can skip to a bookmark by clicking the bookmark in the Events and Bookmarks
    pane.

Director Integration

  1. On the Director server, run command prompt elevated (as Administrator).
  2. Run C:\inetpub\wwwroot\Director\tools\DirectorConfig.exe /configsessionrecording
  3. Enter the Session Recording FQDN when prompted.
  4. Enter 1 for HTTPS.
  5. Enter 443 as the port.
  6. In Director, when you view users or machines, you can change the Session Recording policy. These policy changes don’t apply until a new session is launched.
  7. If the Session Recording menu says N/A then the Director user needs to be authorized in the Session Recording Authorization Console.

  8. If you use Director to enable or disable recording for a user or machine, rules are added to the active policy on the Session Recording server. They only take effect at next logon.

60 thoughts on “Session Recording 7.13”

  1. Hi, Carl
    We need your help lots, We are using SR 7.15 CU2 with PVS for XenDesktop CU2.
    Everything looks ok with the test user, but with the second user on the same desktop, the recorded is not showed it.
    We put the genrandom.ps1 logon script on the VDA, but no more than one session is recorded. At the same time we observed that the script can not edit the registry (permissions).
    So, any idea for what we can do?

  2. we would like to record Citrix desktop sessions or wish we had the feature for record keeping or evidencing facts etc.I was exploring Citrix capabilities and more info can be found here.

    https://support.citrix.com/article/CTX200869

    Actually I would like to initiate this for a particular User session. Please suggest
    Also,I am guessing there may be considerations that would need to be made, banner on login with OK and Cancel and related or these may already be covered. Please suggest if we can do disclaimer right with in Netscaler login URL ?

  3. Hi Carl. I installed Session Recording 7.8, but recording not working in Desktop VDA, in Server OS is working. Desktop OS is Windows 7 Pro with MSMQ HTTP and Fix 2554746. agent 7.8 installed.

  4. another Question:

    Does every Session Recording Server needs his own datebase? iam thinking of connecting multple Session Recording Server to the same database on a MSSQL 2016 AlwaysOn-Cluster … isnt it sick 😛

    cheers

    1. ok, wait i got it: …. In this type of deployment, each Session Recording Server has its own dedicated storage, network switches, and [b]database[/b].

          1. It may cause problem when you search the recording in the player, because if all records in the same database. By the way, is there any reason that a dedicated database does not work for you since they already had other dedicated resource, like storage?

  5. Hi folks, can you activate Citrix Director to use multiple Citrix Session Recording Server in 7.13 ?

  6. Carl I have a question regarding policies/rules. If you have 2 different options selected in 1 rule, lets say “Users”
    (Group 1) and “Published apps” (Notepad) for example, will it record any session by Group 1 no matter what app they launch as well as ANY connected user that launches Notepad? Or will it only watch for Group 1 users that specifically launch Notepad ignoring any other user not in Group 1 that launch notepad?

    1. From Citrix: The relationship between rules is “OR”. Relationship of multiple criteria of a rule is “AND”.

  7. I have a weird issue in Director where for some users when I go to turn on Session recording it says N/A with an bubble that has “Virtual resources are not available to perform Session Recording operations.” Have you seen this before? It works for most users but I can’t find a common link between accounts that it doesn’t work on.

    1. I did some testing and if I make a policy on the session recording server for that specific user to record their sessions it enables that button in Director once they connect to an app. I’m just not sure why I can turn on some users and not others manually in Director though…strange.

  8. Does Session Recording 7.12 work in an environment that is 7.6 LTSR CU1? I usually try to keep all components on the same level but I would like the logging/auditing of 7.12.

      1. That’s what I currently have setup and tested but it doesn’t have the logging built in like 7.12. Does the logging show who turned on/off session recording and who looks at what recordings?

          1. Gotcha. Thanks for the help. I just finished updating to 7.12 and it appears to work with no issues. Thanks for the guide.

            On another note…when creating your own rule for recording a Published App or specific delivery group what exactly is it asking for by “Site Address”? I’ve tried various things and nothing seems to work.

          2. Site Address = Controller name.

            For app name, put in a partial name. When you click Ok and return to the Select Applications box, select the query and it shows you the apps.

            However, it’s not showing me desktops correctly.

          3. Never mind. I do see a log entry when the recording is accessed. It’s in the Configuration Change log.

  9. Hi Carl,
    First of all thank you for your blog.

    Session Recording failed when there is an appdisk attached to the VM. I get a lot of dcom errors in eventvwr.
    I tried several appdisk with no luck
    If I remove the appdisk recording works as expected

    Any idea ?

    Regards

    1. Hi jujurackon,

      Could you please tell us the version number you used for SessionRecording and XenAPP?

      And please feedback the detailed DCOM error information you have caught. Thank you!

      Best Regards

      1. Hi Lu,

        thanks for your reply

        I’m using the 7.11 version of both Citrix XenDesktop and Session Recording

        I get these errors in system eventlog :
        id7009 : A timeout was reached (180000 milliseconds) while waiting for the Infrastructure de gestion Windows service to connect

        id10005 : DCOM got error “1053” attempting to start the service winmgmt with arguments “Unavailable” in order to run the server:
        {8BC3F05E-D86B-11D0-A075-00C04FB68820}

        and i get this error in app eventlog :
        id1009 : Exception caught while obtaining session metadata or running record policy query.
        — Exception Details —
        Type: System.Runtime.InteropServices.COMException
        Message: The service did not respond to the start or control request in a timely fashion. (Exception from HRESULT: 0x8007041D)
        Stack trace:

        1. I’ve just realised that it is not related to Session Recording only. Actually, anytime I try to connect an AppDisk (I’ve tried several ones, small, big with one or more applications) I get these errors regarding services which failed to sart.

          Regards,
          Jujurackon

  10. have you ever tried to record Windows Explorer session, i can’t find the solution for this problem, session recording doesn’t work for this app.

          1. It doesn’t matter, we tried with 7.11 version and the problem exist too. The problem is only with application windows explorer or internet explorer as file browser, when you open desktop with windows explorer, session records well, the problem is only with windows explorer as app.

  11. Thankyou Carl, Excellent guide.
    I need your advise for session recording which is needed to turn on automatically & record session videos as soon as some restricted/special users bundled together in AD group login to Xenapp 7.x. Recording for all the tasks performed by them should be recorded without giving notification. Retention period is 2-3 weeks and Recording server DB – will be in same sql db on another instance where Citrix main xenapp DB is configured.
    No of users are below 10 for which recording is needed. Please advise.

    Env is planned as Xenapp7.8 on W2012R2 but you can suggest if higher versions are stable.

  12. Carl, I am running the latest version of Session Recorder 7.11 and have integrated it with Citrix Director. I am unable to view sessions because it says Session Recording N/A. However I do have the correct Authority, because I can use the player with not problem outside of Director. My only thought would be that Citrix Director needs to be upgraded to the latest version. Your Thoughts?

  13. I am looking at implementing session recording however I have a requirement to be able to save and send the files to other viewers that will not have access to the Citrix player software can you tell me if the .icl/.icle files can be played by some other software or is there an option to export as a .mp4/.mov file.

      1. No unfortunately, we can’t do that.

        We need to automate the analysis of the recorded file in another system, the metadata at that point is not important but the video footage is.

        Anything you know that could help? exporting/converting/etc

  14. I have a warning message when I try to play record: “The recorded session file does not contain a digital signature.” But I have a certificate in Session Recording Server Properties on Signing tab. What I missed?

    1. Maybe something wrong with your certificate? Or the certificate wasn’t configured before you started recording?

          1. Did happen to me as well, I tried with NetScaler VPX 11.x to create a self-signed certificate including the RootCA however the certificate is not working, when doing a self-signed from IIS directly and it is working well, I found out that from the certificate itself the differences is SHA1 and SHA256, not really good in certificate, so not sure does it related or not.

  15. It is recommended or possible to install the Session Recording on the same server as any other software? We currently have 2 Servers for Provisioning Services, 2 Deliver Controllers / Director / Studio, 2 Store Fronts, 2 DB (Mirrored).

  16. Hello Carl.

    Is it possible to configure it to record when an AppCrash is detected, so you can see what the user was doing before an application failed? This would be so good for troubleshooting as I have seen it is better to see what was happening than asking the user what happened, they usually do not tell the story as it is.

    1. Yep. Once it’s released I’ll update these instructions accordingly. I’ve already briefly played with it and it seems to work as intended.

  17. Carl, thank you for a most excellent guide to Session Recording as well as every other technology you’ve listed here. My question is simple and it seems that Citrix’s wording depending on which article you read is misleading, but all I want to know is if you can run the Session Recording agent on a Desktop OS VDA? Most article say Server OS VDA only, but I’ve seen a few articles that mention it will work on both. Maybe that is just a slip up, but I’d like confirmation. Thank you.

    1. I’m pretty sure it’s Server OS only, which matches the prior versions that were available for XenApp 6.5. There’s supposed to be a future release for Desktop OS.

  18. Excellent guide Carl, better than Citrix edocs definitely.

    Any ideas on how big the recorded files are and what format are they saved?

    I mean are they wmv files for eg. and does an hour of session recording roughly equal 50MB data?

    1. I’m not running this in production anywhere so I couldn’t tell you actual size. However, the files essentially contain raw ICA so they’re definitely not regular WMV. They would be much bigger if they were.

    1. we would like to record Citrix desktop sessions or wish we had the feature for record keeping or evidencing facts etc.
      I was exploring Citrix capabilities and more info can be found here.

      https://support.citrix.com/article/CTX200869

      The reason, I am bringing it up, I would like to initiate this for a particular User session . Can we do it for one user session or we need to set up the whole set up for the single user as well. please help

      1. You can configure the Session Recording policy to only enable recording for a specific user. Is that what you’re asking?

Leave a Reply to Camilo Alvarez Cancel reply

Your email address will not be published. Required fields are marked *