February 19, 2025

Using Horizon Recording

The Horizon Recording feature allows administrators to record desktop and application sessions to monitor user behavior for Windows remote desktops and applications.

Administrators can observe a user's exact keystrokes, cursor and mouse activity, and other user behavior in a recorded desktop or application session. In addition to providing greater security and auditing for user behavior, recording also helps with troubleshooting and reproducing issues the user experiences during a session. Administrators can play back, store, and audit the recordings.

When a user logs on, Horizon Recording starts automatically, displaying the default message Your session is being recorded in accordance with security policies. The recording runs as long as the session is in a connected state. Recording stops when the user logs out or disconnects. If the user changes the screen resolution of the desktop or application session, Horizon Recording creates a new segment of the recording. Recording file sizes vary based on the duration of the connected session. Recordings are stored in MP4 format and can be downloaded to play in a local player or viewed in the Horizon Recording web console.

Components

Horizon Recording consists of the following components:

Horizon Recording Server: Collects information about the session as well as raw recording data for storage and playback.
Horizon Recording Agent: Records a user session, registers the session with the Horizon Recording Server, and uploads recording data.

These components are available for Horizon 8 2106 and later. The installation file is available on Customer Connect.

Note: Like certain other Horizon 8 features, this feature is not available for every subscription. For more information, see the Horizon editions listed in the page at Horizon 8.

Web Interface

After you have installed the Horizon Recording Server (see below), you can access the Horizon Recording web console, which displays the following:

Dashboard includes a list of recent recordings, the server, database, and folder where recordings are stored, as well as recording information such as start time, duration, size, and state. You can lock, unlock, and delete recordings.
Recordings includes a list of all recordings with information such as name, launched resource, location, start and end dates, start time, duration, size, and state. You can lock, unlock, and delete recordings.
Audit Trial tracks all user actions in the user interface.

Install the Horizon Recording Server

Install the Horizon Recording Server component on a machine to collect information about the session as well as raw recording data for storage and playback.

The Horizon Recording Server component consists of these items:

A database for session information storage and configuration
A Windows NTFS folder for recording storage
A web service for collecting recording data, administration, and playback

For test environments, you can deploy the Horizon Recording Server as a standalone setup where the server is installed on a machine that leverages a local SQLite database stored in the installation directory as local.db and a local NTFS folder.

For production environments, Omnissa recommends using a Microsoft SQL Server or PostgreSQL database and a shared NTFS folder for recording storage, for either a shared or standalone setup. You must configure the database in the recording server before installing the Horizon recording agent on the golden-image machine for any desktop and application pools you intend to record.

You can also deploy the Horizon Recording Server in a high availability environment using multiple servers behind a load balancer, leveraging Microsoft SQL or PostgreSQL databases, as well as a shared NTFS folder on all servers for storing recording data. Load balancers configured with L4 load distribution are supported.

Minimum Server Resource Requirements (required to support 2,000 active recordings)

Resource	Minimum Value
CPU	4 vCPU
Memory	8 GB
Free Disk Space	20 GB Note: This depends on the type of applications the user runs in the session and also the frame change rate. You must monitor usage and add extra disk space as required.

Note: The Horizon Recording Server is built in .Net Core and requires a 64-bit Windows Server operating system that is a member of the domain if you use group extraction. The server operating system must be Windows Server 2016 or later (64-bit).

To install the Horizon Recording Server, perform the following steps.

Download the HorizonRecordingServer.exe file and copy it to a local folder on the server.
Run the installer and follow the steps. Default credentials are shown below.

Username/Password: administrator/Recording123

The server is now available on https://<localservername>:9443
Manually secure the recordings folder permissions so that only the recording server's active directory accounts have access to the folder to add, modify, or delete recordings.

To uninstall the Horizon Recording Server, use Add Remove Programs (appwiz.cpl) to remove the Horizon Recording server binaries and then delete the following components manually:
- The local database file (local.db) in installation directory
- The locate logs.
- Local recordings located in installation directory\Recordings
To reset the installation:
1. Stop the Horizon Recording service.
2. Delete the Recordings folder from the installation directory.
3. Delete the servicesettings.json file and the local.db file from the installation directory.
4. Start the Horizon Recording service. The servicesettings.json and local.db files are recreated afresh.

Install the Horizon Recording Server Using the Command Line

Administrators can perform a silent installation of the Horizon recording server as follows.

HorizonRecordingServer.exe /s /v/qn

Install the Horizon Recording Agent

Install the Horizon Recording Agent component on all Windows machines where you want to record sessions.

Note: For production environments, you must configure a Microsoft SQL Server or PostgreSQL database in the recording server before installing the Horizon recording agent on the golden-image machine for any desktop and application pools you intend to record.

The Horizon Recording Agent registry settings are stored in HKEY_LOCAL_MACHINE\SOFTWARE

Minimum Resource Requirements

Resource	Minimum Value (VDI)	Minimum Value (RDSH - 80 sessions)
CPU	2 vCPU	64 vCPU
Memory	2 GB	64 GB
Free Disk Space	5 GB Note: This depends on the type of applications the user runs in the session and the frame change rate. You must monitor usage and add extra disk space as required.	50 GB Note: This depends on the type of applications the user runs in the session and the frame change rate. You must monitor usage and add extra disk space as required.

Additional System Requirements

Horizon 8 2106 or later for VDI; Horizon 8 2111 or later for RDSH
Instant Clone Agent or Full Clone Agent
Note: Do not install the instant clone agent feature on the golden image (template) if you plan to deploy full clones.
Windows 10 1909 or later 64-bit operating system for VDI; Windows Server 2016 or later 64-bit operating system for RDSH
Microsoft .Net framework 4.6.1 or later
Horizon Blast
Port 9443 allowed in the firewall inbound rules on the Horizon Recording Server

To install the Horizon Recording Agent, perform the following steps.

Download the HorizonRecordingAgent.exe file and copy it to a local folder.
Run the installer and follow the steps.
When prompted for the connection, provide the correct URL of the recording server in the format https://<FQDN or IP address of recording server>:9443 along with the User Name and Password.
1. Select the This machine is a template check box if the machine is a parent VM and a pool will be created from it.
2. Click Register.
3. If the certificate of the server is untrusted, accept the thumbprint of the server when prompted.

To uninstall the Horizon Recording Agent, use Add Remove Programs (appwiz.cpl) to remove the Horizon Recording agent binaries and then delete the following components manually:
- Locate the logs.
- Any local pending recordings located in installation directory\Recordings
To delete the agents from the registered machines:
1. In Administrator > Manage Agents.
2. Select the Name of the agent and then click Delete.
3. Read the confirmation message carefully and proceed with the deletion.

Install the Horizon Recording Agent Using the Command Line

Administrators can perform a silent installation of the Horizon recording agent as follows.

HorizonRecordingAgent.exe /s /v/qn MACHINEISTEMPLATE="True/False" SERVERADDRESSPROP="https://rec.server.fqdn:9443" USER_NAME="username" USER_PASSWORD="Password" TRUSTEDTHUMBPRINT="thumbprint"

Command Line Option	Description
MACHINEISTEMPLATE	True (or) False
SERVERADDRESSPROP	FQDN (or) IP of Recording server (or) Load balancer. Note: Starts with `https://` and ends with port number 9443.
USER_NAME	Admin username of recording server.
USER_PASSWORD	Password of the Admin username.
TRUSTEDTHUMBPRINT	Thumbprint of the recording server (no spaces or no colons).

Upgrade the Horizon Recording Server

Before upgrading the Horizon Recording Server, do the following:

Confirm that there are no active recordings.
Create a backup of the Recordings folder, the servicesettings.json file, and the local.db (if you are using SQLite for the database).

To upgrade the Horizon Recording Server, perform the following steps.

Download the HorizonRecordingServer.exe file.
Copy the HorizonRecordingServer.exe file to a local folder on the server.
Run HorizonRecordingServer.exe.

Note the following:

By default, the server is upgraded in the same folder.
- If you change the upgrade location to a new folder, the configuration is not retained, and is treated as a fresh installation. As a result, you cannot access or play back the old recordings from the web console after the upgrade.
- If you do not change the default location, then all the configurations are retained, and you can access and play back the recordings from the web console after the upgrade.
After the upgrade, the log location for the server changes to a new folder. The old logs are still available.

Upgrade the Horizon Recording Agent

Before upgrading the Horizon Recording Agent, confirm that there are no active recordings on the agent.

Note: It is recommended to upgrade the server before upgrading the agent.

To upgrade the Horizon Recording Agent, perform the following steps.

Download the HorizonRecordingAgent.exe file.
Copy the HorizonRecordingAgent.exe file to a local folder on the agent.
Run HorizonRecordingAgent.exe.