Home ยป Citrix Session Recording Server Pt.1 Install

Citrix Session Recording Server Pt.1 Install

By:

Two people sitting at their desks working on computers.

Session Recording is a feature of Citrix Virtual Apps and Desktops that allows administrators to record user sessions. This can be useful for such activities like end user training, helpdesk troubleshooting, monitoring user activity or more. This blog series walks through the steps for installing, configuring and using a Session Recording server. This post covers the steps for installing an on-prem Session Recording Server. For simplicity, I will be installing most key components on a single server, which is not recommended for a production installation, but what you would likely do for a Proof of Concept (POC) testing.

Components

Before starting I recommend having the following ready:

  • Windows Server 2022 or 2019 VM for the Session Recording server. For this POC installation I used the following specs: 4 vCPU, 8 GB Ram, 45 GB drive.
  • Windows 11 or 10 VDA VM as the Session Recording agent. I chose Windows 10 only because it has less resource requirements than Windows 11, otherwise either OS is fine.
  • The name and credentials to a SQL Server that will manage the database.
  • Citrix Virtual Apps and Desktop ISO. I am using version 2308.
  • Optional: TLS/HTTPS certificate for HTTPS communication.

Install server application

  1. Launch the Citrix Virtual Apps and Desktops ISO on the Windows server VM. Click the Start button next to Virtual Apps or Virtual Apps and Desktops. (Note: You won’t see this if using CVAD version 2311.)
  2. From the Extend Deployment section select Session Recording.
Session Recording Extend Deployment screenshot.
  1. Accept the software license agreement.
Session Recording license agreement screenshot.
  1. Keep the default selections of Session Recording Administration and Session Recording Player.
Session Recording Core Components screenshot.
  1. On the Features selection page, leave the default selection of all features.
Session Recording Features selection screenshot.
  1. On the Database and Server Configuration page enter the SQL server instance name, or the name of the SQL server.
    • Leave the default name for the Session Recording server database.
    • Click the Test Connection button to confirm connection with the SQL server instance.
    • Lastly enter the computer account name of the Session Recording server. Note: Citrix recommends entering either localhost or domain name\machine name.
Session Recording Database and Server configuration screenshot.
  1. On the Administration Logging Configuration page, you can leave all the default settings selected. Click the Test Connection button to again validate the connection to the SQL server instance.
Session Recording Administrator Logging Configuration screenshot.
  1. Review the Summary page and make sure everything looks correct then click the Install button.
Session Recording Summary page screenshot.
  1. Monitor the installation progress.
Session Recording install progress screenshot.
  1. Once installation is complete click the Finish button.
Session Recording install finish screenshot.

Install the Broker PowerShell Snap-In

The Citrix Broker PowerShell snap-in extends Citrix Broker cmdlets to PowerShell and is needed to use the Session Recording Policy Console.

  1. Locate and install the Broker PowerShell snap-in located on the CVAD ISO, in the \x64\Citrix Desktop Delivery Controller folder.
Session Recording Broker PowerShell snap-in screenshot.
  1. Accept the License Agreement.
Broker PowerShell Snap-In License Agreement screenshot.
  1. Click the Finish button once the install is complete.
Broker PowerShell snap-in install complete screenshot.

Install the Session Recording Agent

The Session Recording agent is software installed on the Citrix Virtual Delivery Agent (VDA) whose session you want to record. We’re going to move over now to the Windows 10 desktop VM that will be running the Session Recording agent. Ideally you will have the VDA software already installed on this VM.

  1. Insert the CVAD ISO in the Windows 10 VM and launch the installer.
  2. Select Session Recording from the Extend Deployment section.
CVAD Extend Deploy screenshot.
  1. Accept the Software License Agreement.
CVAD software License Agreement screenshot.
  1. Deselect Session Recording Administration and Session Recording Player if they are selected by default. Only select Session Recording Agent, then click Next.
Session Recording core components selection screenshot.
  1. On the Agent Configuration page, enter the name of the Session Recording server. Leave the protocol set to HTTPS and default port of 443. Skip the Test Connection for now because we haven’t installed a certificate on the Session Recording server yet. However, if you plan to use HTTP, then change the protocol to HTTP and click Test Connection to make sure it’s working.
Session Recording agent configuration screenshot.
  1. Review the Summary then click Install.
Session Recording agent install summary screenshot.
  1. Click Finish once installation is complete.
Session Recording agent installation complete screenshot.

That’s it. The installation phase is complete. The next phase is configuration which I will cover in part 2 of this blog series.

Please let me know what you think in the Comments section below.

The views expressed by the author do not represent those of Citrix or Cloud Software Group.

Comments

Leave a Reply

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