安装、升级和卸载
注意:
要通过负载平衡配置服务器高可用性,请参阅 在现有部署中配置负载平衡 和 在 Azure 中部署和负载平衡会话录制。
要详细了解如何快速设置和配置 Citrix 会话录制和 Citrix 会话录制服务,请参阅 Citrix 技术专区文章 POC 指南:Citrix 会话录制。
本文中将包含以下几个部分:
安装核对清单
您可以使用 Citrix 虚拟应用和桌面™ 安装程序安装会话录制组件。
在开始安装之前,请完成此列表:
| ✔ | 步骤 |
|---|---|
| 选择您希望安装各个会话录制组件的计算机。确保每台计算机都符合将要安装在其上的一个或多个组件的硬件和软件要求。 | |
| 使用您的 Citrix 帐户凭据访问 Citrix Virtual Apps™ and Desktops 下载页面并下载产品 ISO 文件。解压缩 ISO 文件或将其刻录到 DVD。 | |
| 要使用 TLS 协议在会话录制组件之间进行通信,请在您的环境中安装正确的证书。 | |
| 安装会话录制组件所需的任何修补程序。修补程序可从 Citrix 支持 获取。 | |
| 配置 Director 以创建和激活会话录制策略。有关详细信息,请参阅 配置 Director 以使用会话录制服务器。 |
注意:
- 我们建议您根据录制策略将已发布的应用程序划分为单独的交付组。如果应用程序位于同一交付组中,则已发布应用程序的会话共享可能会与活动策略冲突。会话录制会将活动策略与用户打开的第一个已发布应用程序进行匹配。从 7.18 版本开始,您可以使用动态会话录制功能在会话期间随时开始或停止录制会话。此功能有助于缓解与活动策略的冲突问题。有关详细信息,请参阅 动态会话录制。
- 如果您计划使用 Machine Creation Services™ (MCS) 或 Provisioning Services,请准备一个唯一的 QMId。未能遵守此要求可能会导致录制数据丢失。
- SQL 服务器 需要 TCP/IP、运行 SQL Server 浏览器 服务并启用 Windows 身份验证。
- 要使用 HTTPS,请为 TLS/HTTPS 配置服务器证书。
- 确保 本地用户和组 > 组 > 用户 下的用户对
C:\windows\Temp文件夹具有写入权限。
使用 Citrix 虚拟应用和桌面 安装程序安装会话录制
注意:
我们建议您将会话录制管理、会话录制代理和会话录制播放器组件安装在单独的服务器上。
会话录音管理组件包括会话录音数据库、会话录音服务器和会话录音策略控制台。将所有这些组件安装在单个服务器上用于概念验证是可以的。但是,我们建议您将会话录音策略控制台安装在单独的服务器上,并将会话录音服务器、管理员日志记录和会话录音数据库组件安装在另一个单独的服务器上。
安装会话录音服务器可让您自动安装会话录音 Web 播放器。
安装会话录制管理功能的相关组件
注意:
从 2110 版本开始,在 TLS 1.0 已禁用的 Windows Server 2016 上安装会话录音管理组件之前,请完成以下步骤:
- 安装适用于 SQL Server 数据库的微软 OLE DB 驱动程序。
在
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\v4.0.30319注册表项下,添加SchUseStrongCryptoDWORD(32 位)值并将值数据设置为 1。- 重新启动 Windows 服务器 2016。
会话录音管理组件包括会话录音数据库、会话录音服务器和会话录音策略控制台。您可以选择要在服务器上安装的组件。
步骤 1:下载产品软件并启动向导
- 使用您的 Citrix 帐户凭据访问 Citrix Virtual Apps and Desktops 下载页面并下载产品 ISO 文件。解压缩 ISO 文件或将其刻录到 DVD。
- 使用本地管理员帐户登录到要安装会话录音管理组件的计算机。将 DVD 插入驱动器或装载 ISO 文件。如果安装程序未自动启动,请双击 AutoSelect 应用程序或装载的驱动器。 安装向导将启动。
步骤 2:选择要安装的产品
选择要安装的产品(/zh-cn/session-recording/2303/media/1-choose-which-product-to-install.png)
单击产品旁边的开始以安装 Citrix 虚拟应用 或 Citrix 虚拟桌面™。
步骤 3:选择会话录制
选择会话录制(/zh-cn/session-recording/2303/media/select-session-recording.png)
选择会话录制条目。
步骤 4:阅读并接受许可协议
安装协议(/zh-cn/session-recording/2303/media/read-and-accept-the-license-agreement.png)
在软件许可协议页面上,阅读并接受许可协议,然后单击下一步。
步骤 5:选择要安装的组件和安装位置
选择组件和安装路径(/zh-cn/session-recording/2303/media/4-select-the-components-to-install-and-the-installation-location.png)
在核心组件页面上:
- 位置:默认情况下,组件安装在 C:\Program Files\Citrix 中。默认位置适用于大多数部署。您可以指定自定义安装位置。
- 组件:默认情况下,所有可安装组件旁边的复选框均处于选中状态。安装程序知道它是在单会话操作系统还是多会话操作系统上运行。它只允许在多会话操作系统上安装会话录制管理组件。它只允许在安装了 VDA 的计算机上安装会话录制代理。如果将会话录制代理安装在未预先安装 VDA 的计算机上,则会话录制代理选项将不可用。
选择会话录制管理,然后单击下一步。

步骤 6:选择要安装的功能

在“功能”页面上:
- 默认情况下,将选中可安装功能旁边的所有复选框。在单个服务器上安装所有这些功能适用于概念验证。对于大型生产环境,请将会话录制策略控制台安装在单独的服务器上。将会话录制服务器、管理员日志记录和数据库安装在另一个单独的服务器上。
- 会话录制管理员日志记录是会话录制服务器的一个可选子功能。必须先选择会话录制服务器,然后才能选择会话录制管理员日志记录。
- 如果选择会话录制服务器,则也会安装会话录制 Web 播放器。
- 在同一服务器上选择并安装功能后,若要添加功能,只能使用 msi 软件包。不能再次运行安装程序。
选择要安装的一个或多个功能,然后单击“下一步”。
步骤 6.1:安装会话录制数据库
注意:
会话录制数据库不是实际的数据库。它是一个组件,用于在安装过程中在 Microsoft SQL Server 实例中创建和配置所需的数据库。会话录制支持基于 Microsoft SQL Server 的三种数据库高可用性解决方案。有关详细信息,请参阅数据库高可用性。
您可以在 Azure SQL 托管实例、Azure 虚拟机 (VM) 上的 SQL Server 以及 AWS RDS 上部署会话录制数据库。在 Azure SQL 托管实例和 AWS RDS 上,您只能使用 SessionRecordingAdministrationx64.msi 软件包部署会话录制数据库。有关详细信息,请参阅在 Azure SQL 托管实例或 AWS RDS 上部署会话录制数据库。在 Azure VM 上的 SQL Server 上,您可以使用 msi 软件包和 Citrix Virtual Apps and Desktops 安装程序部署会话录制数据库。有关详细信息,请参阅在 Azure VM 上的 SQL Server 上部署会话录制数据库。
会话录制数据库和 Microsoft SQL Server 通常有三种部署类型:
- 部署 1:将会话录制服务器和会话录制数据库安装在同一台计算机上,将 Microsoft SQL Server 安装在远程计算机上。(推荐)
- 部署 2:在同一台计算机上安装会话录制服务器、会话录制数据库和 Microsoft SQL Server。
- 部署 3:在一台计算机上安装会话录制服务器,并在另一台计算机上安装会话录制数据库和 Microsoft SQL Server。(不建议)
-
在“功能”页面上,选择“会话录制数据库”,然后单击“下一步”。

-
在“数据库和服务器配置”页面上,指定会话录制数据库的实例名称和数据库名称以及会话录制服务器的计算机帐户。单击“下一步”。

在“数据库和服务器配置”页面上:
- 实例名称:如果数据库实例不是命名实例,则只能使用 SQL Server 的计算机名称。如果在实例设置期间已命名实例,请使用 computer-name\instance-name 作为数据库实例名称。要确定您正在使用的服务器实例名称,请在 SQL Server 上运行 select @@servername。返回值是确切的数据库实例名称。如果您的 SQL Server 配置为侦听除默认端口 1433 之外的自定义端口,请通过在实例名称后附加逗号来设置自定义侦听器端口。例如,在“实例名称”文本框中键入 DXSBC-SRD-1,2433,其中逗号后的 2433 表示自定义侦听器端口。
-
数据库名称:在“数据库名称”文本框中键入自定义数据库名称,或使用文本框中预设的默认数据库名称。单击“测试连接”以测试与 SQL Server 实例的连接以及数据库名称的有效性。
重要提示:
自定义数据库名称只能包含 A-Z、a-z、0–9 和下划线,且不能超过 123 个字符。
您必须拥有数据库的 securityadmin 和 dbcreator 服务器角色权限。如果您没有这些权限,可以执行以下操作:
- 请求数据库管理员分配安装所需的权限。安装完成后,securityadmin 和 dbcreator 服务器角色权限不再是必需的,可以安全删除。
-
或者,使用 Citrix 虚拟应用和桌面 ISO 中 \x64\Session Recording 下的 SessionRecordingAdministrationx64.msi 软件包。在 msi 安装过程中,将弹出一个对话框,提示输入具有 securityadmin 和 dbcreator 服务器角色权限的数据库管理员的凭据。键入正确的凭据,然后单击“确定”以继续安装。
安装将创建会话录制数据库,并将会话录制服务器的计算机帐户添加为 db_owner。
-
会话录制服务器计算机帐户:
- 部署 1 和 2:在 Session Recording 服务器计算机帐户 文本框中键入 localhost。
- 部署 3:键入托管会话录制服务器的计算机名称,格式为 domain\computer-name。会话录制服务器计算机帐户是用于访问会话录制数据库的用户帐户。
注意:
当在 Session Recording 服务器计算机帐户 文本框中设置域名时,尝试安装 Session Recording Administration 组件可能会失败,并显示错误代码 1603。作为一种解决方法,请在 Session Recording 服务器计算机帐户 文本框中键入 localhost 或 NetBIOS 域名\计算机名称。要获取 NetBIOS 域名,请转到 Session Recording 服务器并在 PowerShell 中运行
$env:userdomain或在命令提示符中运行echo %UserDomain%。
-
审阅必备条件并确认安装过程。

摘要页面显示您的安装选择。您可以单击返回以返回到之前的向导页面并进行更改,或者单击安装以开始安装。
-
完成安装过程。

完成安装页面会显示所有已成功安装和初始化的必备条件和组件的绿色复选标记。
单击完成以完成 Session Recording 数据库的安装。
步骤 6.2:安装会话录制服务器
Session Recording 服务器是一个托管以下内容的服务器:
- Broker。一个 IIS 6.0+ 托管的 Web 应用程序,用于实现以下目的:
- 处理来自会话录制播放器和 Web 播放器的搜索查询和文件下载请求。
- 处理来自会话录制策略控制台的策略管理请求。
- 评估针对每个 Citrix 虚拟应用和桌面 或 Citrix DaaS™(以前称为 Citrix 虚拟应用和桌面服务)会话的录制策略。
- 存储管理器。一个 Windows 服务,用于管理从每个启用了会话录制的 VDA 接收的录制会话文件。
- 管理员日志记录。与会话录制服务器一起安装的可选子组件,用于记录管理活动。默认情况下,所有日志记录数据都存储在名为 CitrixSessionRecordingLogging 的单独 SQL Server 数据库中。您可以自定义数据库名称。
安装会话录制服务器可让您自动安装会话录制 Web 播放器。
要安装会话录制服务器,请完成以下步骤:
-
在功能页面上,选择会话录制服务器和会话录制管理员日志记录。单击下一步。

注意:
- 会话录制管理员日志记录是会话录制服务器的一个可选子功能。在选择会话录制管理员日志记录之前,请先选择会话录制服务器。
- 建议您同时安装会话录制管理员日志记录和会话录制服务器。如果您不希望启用管理员日志记录功能,可以在后续页面上将其禁用。但是,如果您最初选择不安装此功能但希望稍后添加,则只能通过使用 SessionRecordingAdministrationx64.msi 手动添加。
-
在数据库和服务器配置页面上,指定配置。

在数据库和服务器配置页面上:
- 实例名称:在“实例名称”文本框中键入 SQL Server 的名称。如果您使用的是命名实例,请键入 computer-name\instance-name;否则,仅键入 computer-name。如果您的 SQL Server 配置为侦听除默认端口 1433 之外的自定义端口,请通过在实例名称后附加逗号来设置自定义侦听器端口。例如,在“实例名称”文本框中键入 DXSBC-SRD-1,2433,其中逗号后的 2433 表示自定义侦听器端口。 数据库名称:在“数据库名称”文本框中键入自定义数据库名称,或者使用文本框中预设的默认数据库名称 CitrixSessionRecording。
- 您必须拥有数据库的 securityadmin 和 dbcreator 服务器角色权限。如果您没有这些权限,可以:
- 请求数据库管理员为安装分配权限。安装完成后,securityadmin 和 dbcreator 服务器角色权限不再是必需的,可以安全删除。
- 或者,使用 SessionRecordingAdministrationx64.msi 包安装 Session Recording 服务器。在 msi 安装过程中,将弹出一个对话框,提示您输入具有 securityadmin 和 dbcreator 服务器角色权限的数据库管理员凭据。键入正确的凭据,然后单击“确定”以继续安装。
- 键入正确的实例名称和数据库名称后,单击“测试连接”以测试与 Session Recording 数据库的连接。
- 键入 Session Recording 服务器计算机帐户,然后单击“下一步”。
-
在“管理日志记录配置”页面上,指定管理日志记录功能的配置。

在“管理日志记录配置”页面上:
- 管理日志记录数据库安装在 SQL Server 实例上:此文本框不可编辑。管理日志记录数据库的 SQL Server 实例名称将自动从您在“数据库和服务器配置”页面上键入的实例名称中获取。
-
管理员日志记录数据库名称:要安装 Session Recording 管理员日志记录功能,请在此文本框中键入管理员日志记录数据库的自定义数据库名称,或者使用文本框中预设的默认数据库名称 CitrixSessionRecordingLogging。
注意:
管理员日志记录数据库名称必须与在上一“数据库和服务器配置”页面上的“数据库名称”文本框中设置的 Session Recording 数据库名称不同。
- 键入管理员日志记录数据库名称后,单击“测试连接”以测试与管理员日志记录数据库的连接。
- 启用管理日志记录:默认情况下,管理日志记录功能处于启用状态。您可以通过清除此复选框来禁用它。
- 启用强制阻止:默认情况下,强制阻止处于启用状态。如果日志记录失败,正常功能可能会被阻止。您可以取消选中该复选框以禁用强制阻止。
单击下一步以继续安装。
-
请检查所有必备条件,然后确认安装。

摘要页面显示您的安装选择。您可以单击返回以返回到之前的向导页面并进行更改,或者单击安装以开始安装。
-
完成安装过程。

完成安装页面显示绿色复选标记,表示所有已成功安装和初始化的必备条件和组件。
单击完成以完成会话录制服务器的安装。
注意:
会话录制服务器默认安装使用 HTTPS/TLS 来保护通信安全。如果会话录制服务器的默认 Internet Information Services (IIS) 站点中未配置 TLS,请使用 HTTP。为此,请导航到会话录制代理站点,打开 SSL 设置,然后取消选中 Require SSL(要求 SSL)复选框,以在 IIS 管理控制台中取消选择 SSL。
步骤 6.3:安装会话录制策略控制台
您可以使用会话录制策略控制台配置策略。
要安装会话录制策略控制台,请完成以下步骤:
-
在功能页面上,选择会话录制策略控制台,然后单击下一步。
选择要安装的策略控制台(/zh-cn/session-recording/2303/media/install-policy-console-1.png)
-
请审阅所有先决条件,并确认安装。
策略控制台安装摘要(/zh-cn/session-recording/2303/media/install-policy-console-2.png)
“摘要”页面显示您的安装选择。您可以单击“返回”以返回到之前的向导页面并进行更改,或者单击“安装”以开始安装。
-
请完成安装过程。
完成策略控制台安装(/zh-cn/session-recording/2303/media/install-policy-console-3.png)
“完成安装”页面显示所有已成功安装和初始化的必备条件和组件的绿色复选标记。
单击“完成”以完成会话录制策略控制台的安装。
Step 7: Install Broker_PowerShellSnapIn_x64.msi
重要提示:
要使用会话录制策略控制台,请手动安装 Broker PowerShell 管理单元 (
Broker_PowerShellSnapIn_x64.msi)。在 Citrix Virtual Apps and Desktops ISO (\x64\Citrix Desktop Delivery Controller) 上找到该管理单元,并按照说明进行安装。不遵守此操作可能会导致错误。
安装会话录制代理程序
会话录制代理是安装在每个多会话操作系统或单会话操作系统 VDA 上的组件,用于启用录制。它负责录制会话数据。
步骤 1:下载产品软件并启动向导
使用本地管理员帐户登录到要安装会话录制代理的计算机。将 DVD 插入驱动器或装载 ISO 文件。如果安装程序未自动启动,请双击 AutoSelect 应用程序或装载的驱动器。
安装向导随即启动。
步骤 2:选择要安装的产品

Click Start next to the product to install Citrix Virtual Apps or Citrix Virtual Desktops.
步骤 3:选择会话录制

选择 会话录制 条目。
步骤 4:阅读并接受许可协议

在“软件许可协议”页面上,阅读并接受许可协议,然后单击“下一步”。
步骤 5:选择要安装的组件和安装位置

选择 会话录制代理,然后单击“下一步”。
步骤 6:指定代理配置

在 代理配置 页面上:键入安装了会话录制服务器的计算机的计算机名称,以及用于连接会话录制服务器的协议和端口信息。如果尚未安装会话录制,则可以在以后通过 会话录制代理属性 更改此类信息。
注意:
安装程序的测试连接功能存在限制。它不支持“HTTPS 需要 TLS 1.2”的场景。如果在此场景中使用安装程序,测试连接将失败,但您可以忽略此失败并单击 下一步 继续安装。这不影响正常功能。
步骤 7:查看必备条件并确认安装

摘要 页面显示您的安装选择。您可以单击 返回 返回到之前的向导页面进行更改,或者单击 安装 开始安装。
步骤 8:完成安装

完成安装 页面显示所有已成功安装和初始化的必备条件和组件的绿色复选标记。
单击 完成 以完成会话录制代理的安装。
注意:
当机器创建服务 (MCS) 或 Citrix Provisioning™ 使用主映像和已安装的 Microsoft 消息队列 (MSMQ) 创建多个 VDA 时,这些 VDA 可能具有相同的 QMId。相同的 QMId 可能会导致各种问题,例如:
- 即使接受了录制协议,会话也可能不会被录制。
- 会话录制服务器可能无法接收会话注销信号,因此会话可能始终处于“实时”状态。
作为一种解决方法,为每个 VDA 创建一个唯一的 QMId,并且它因部署方法而异。
如果使用 PVS 7.7 或更高版本以及 MCS 7.9 或更高版本在静态桌面模式下创建了安装有会话录制代理的单会话操作系统 VDA(例如,配置为通过单独的 Personal vDisk 或 VDA 的本地磁盘使所有更改持久化),则无需执行额外操作。
对于使用 MCS 或 PVS 创建的多会话操作系统 VDA,以及配置为在用户注销时丢弃所有更改的单会话操作系统 VDA,请使用 GenRandomQMID.ps1 脚本在系统启动时更改 QMId。更改电源管理策略,以确保在用户尝试登录之前有足够的 VDA 正在运行。
要使用 GenRandomQMID.ps1 脚本,请执行以下操作:
Ensure that the execution policy is set to RemoteSigned or Unrestricted in PowerShell.
Set-ExecutionPolicy RemoteSigned
创建计划任务,将触发器设置为系统启动时,并使用 SYSTEM 帐户在 PVS 或 MCS 主映像计算机上运行。
将命令添加为启动任务。
powershell .exe -file C:\\GenRandomQMID.ps1Summary of the GenRandomQMID.ps1 script:
- 从注册表中删除当前的 QMId。
- 将
SysPrep = 1添加到HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSMQ\Parameters。- Stop related services, including CitrixSmAudAgent and MSMQ.
- 要生成随机 QMId,请启动之前停止的服务。
Example GENRANDOMQMID.PS1:
# Remove old QMId from registry and set SysPrep flag for MSMQ Remove-Itemproperty -Path HKLM:Software\Microsoft\MSMQ\Parameters\MachineCache -Name QMId -Force Set-ItemProperty -Path HKLM:Software\Microsoft\MSMQ\Parameters -Name "SysPrep" -Type DWord -Value 1 # Get dependent services $depServices = Get-Service -name MSMQ -dependentservices | Select -Property Name # Restart MSMQ to get a new QMId Restart-Service -force MSMQ # Start dependent services if ($depServices -ne $null) { foreach ($depService in $depServices) { $startMode = Get-WmiObject win32_service -filter "NAME = '$($depService.Name)'" | Select -Property StartMode if ($startMode.StartMode -eq "Auto") { Start-Service $depService.Name } } } <!--NeedCopy-->
安装会话录制播放器
提示:
安装会话录制服务器可让您自动安装会话录制 Web 播放器。本节介绍如何安装会话录制播放器。
Session Recording 播放器是一个用户界面,您可以从工作站访问它以播放录制的会话文件。在 Session Recording 服务器或域中的工作站上安装 Session Recording 播放器。
步骤 1:下载产品软件并启动向导
使用本地管理员帐户登录到要安装 Session Recording 播放器组件的计算机。将 DVD 插入驱动器或装载 ISO 文件。如果安装程序未自动启动,请双击 AutoSelect 应用程序或装载的驱动器。
安装向导随即启动。
步骤 2:选择要安装的产品

单击要安装的产品旁边的“开始”以安装 Citrix 虚拟应用 或 Citrix 虚拟桌面。
步骤 3:选择会话录制

选择会话录制条目。
步骤 4:阅读并接受许可协议

在“软件许可协议”页面上,阅读许可协议,接受它,然后单击“下一步”。
步骤 5:选择要安装的组件和安装位置
选择要安装的播放器(/zh-cn/session-recording/2303/media/install-player-3-select.png)
选择会话录制播放器,然后单击下一步。
步骤 6:查看必备条件并确认安装
播放器安装摘要(/zh-cn/session-recording/2303/media/install-player-4-confirm-installation.png)
“Summary”(摘要)页面显示您的安装选择。您可以单击“Back”(返回)返回到之前的向导页面进行更改,也可以单击“Install”(安装)开始安装。
步骤 7:完成安装
播放器安装完成(/zh-cn/session-recording/2303/media/install-player-7-install-complete.png)
“Finish Installation”(完成安装)页面显示所有已成功安装和初始化的必备条件和组件的绿色复选标记。
单击 Finish 以完成会话录制播放器的安装。
自动化安装过程
Session Recording 支持带选项的静默安装。编写使用静默安装的脚本并运行相关命令。
使会话录制管理组件的安装工作实现自动化
使用单个命令安装全套 Session Recording 管理组件
例如,以下任一命令都将安装全套 Session Recording 管理组件并创建日志文件以捕获安装信息。
msiexec /i "c:\SessionRecordingAdministrationx64.msi" ADDLOCAL="SsRecServer,PolicyConsole,SsRecLogging,StorageDatabase" DATABASEINSTANCE="WNBIO-SRD-1" DATABASENAME="CitrixSessionRecording" LOGGINGDATABASENAME="CitrixSessionRecordingLogging" DATABASEUSER="localhost" /q /l*vx "yourinstallationlog"
<!--NeedCopy-->
msiexec /i "SessionRecordingAdministrationx64.msi" ADDLOCAL="SsRecServer,PolicyConsole,SsRecLogging,StorageDatabase" DATABASEINSTANCE="CloudSQL" DATABASENAME="CitrixSessionRecording" LOGGINGDATABASENAME="CitrixSessionRecordingLogging" AZURESQLSERVICESUPPORT="1" AZUREUSERNAME="CloudSQLAdminName" AZUREPASSWORD="CloudSQLAdminPassword" /q /l*vx "c:\WithLogging.log"
<!--NeedCopy-->
注意:
您可以在 Citrix 虚拟应用和桌面 ISO 的
\x64\Session Recording下找到SessionRecordingAdministrationx64.msi文件。
其中:
- ADDLOCAL 提供供您选择的功能。您可以选择多个选项。SsRecServer 是会话录制服务器。PolicyConsole 是会话录制策略控制台。SsRecLogging 是管理员日志记录功能。StorageDatabase 是会话录制数据库。会话录制管理员日志记录是会话录制服务器的一个可选子功能。在选择会话录制管理员日志记录之前,请先选择会话录制服务器。
-
DATABASEINSTANCE 是会话录制数据库的实例名称。例如,如果您使用的是 Azure SQL 托管实例,则为
.\SQLEXPRESS,computer-name\SQLEXPRESS,computer-name或tcp:srt-sql-support.public.ca7b16b60789.database.windows.net,3342。 - DATABASENAME 是会话录制数据库的数据库名称。
- LOGGINGDATABASENAME 是管理员日志记录数据库的名称。
-
AZURESQLSERVICESUPPORT 用于确定是否支持云 SQL。如果您希望使用云 SQL,则需要将其设置为
1。 - DATABASEUSER 是会话录制服务器的计算机帐户。
- AZUREUSERNAME is the cloud SQL admin name.
- AZUREPASSWORD is the cloud SQL admin password.
- /q 指定静默模式。
- /l*v 指定详细日志记录。
- yourinstallationlog is the location of your installation log file.
创建用于部署会话录制服务器的主映像
您可能已从现有部署中设置了会话录音数据库和管理日志数据库。对于此类情况,现在您可以使用 SessionRecordingAdministrationx64.msi 安装会话录音管理组件时,跳过数据库检查。您可以创建主映像,以便在许多其他计算机上轻松部署会话录音服务器。在使用主映像在目标计算机上部署会话录音服务器后,在每台计算机上运行命令以连接到现有会话录音数据库和管理日志数据库。此主映像支持可简化部署并最大程度地减少人为错误可能造成的影响。它仅适用于全新安装,并包含以下步骤:
-
启动命令提示符并运行类似于以下内容的命令:
msiexec /i "SessionRecordingAdministrationx64.msi" ADDLOCAL="SsRecServer,PolicyConsole,SsRecLogging,StorageDatabase" DATABASEINSTANCE="sqlnotexists" DATABASENAME="CitrixSessionRecording2" LOGGINGDATABASENAME="CitrixSessionRecordingLogging2" DATABASEUSER="localhost" /q /l*vx "c:\WithLogging.log" IGNOREDBCHECK="True" <!--NeedCopy-->此命令将安装会话录音管理组件,但不会配置和测试其与会话录音数据库以及管理日志数据库之间的连接情况。
Set the IGNOREDBCHECK parameter to True and use random values for DATABASEINSTANCE, DATABASENAME, and LOGGINGDATABASENAME.
-
在您正在操作的计算机上创建主映像。
-
将主映像部署到其他计算机以部署会话录音服务器。
-
在每台计算机上,运行类似于以下内容的命令:
.\SsRecUtils.exe -modifydbconnectionpara DATABASEINSTANCE DATABASENAME LOGGINGDATABASENAME iisreset /noforce <!--NeedCopy-->这些命令将之前安装的会话录音服务器连接到现有会话录音数据库和管理日志数据库。
You can find the
SsRecUtils.exefile at\Citrix\SessionRecording\Server\bin\. Set the DATABASEINSTANCE, DATABASENAME, and LOGGINGDATABASENAME parameters as needed.
在卸载会话录音管理组件时,确保数据库得到保留
将 KEEPDB 设置为 True 后,以下命令将在卸载会话录音管理组件时保留会话录音数据库和管理日志数据库:
msiexec /x "SessionRecordingAdministrationx64.msi" KEEPDB="True"
<!--NeedCopy-->
自动化安装会话录音播放器和 Web 播放器
例如,以下命令分别安装会话录音播放器和 Web 播放器。
msiexec /i "c:\SessionRecordingPlayer.msi" /q /l*\vx "yourinstallationlog"
<!--NeedCopy-->
msiexec /i "c:\SessionRecordingWebPlayer.msi" /q /l*vx "yourinstallationlog"
<!--NeedCopy-->
注意:
您可以在 Citrix 虚拟应用和桌面 ISO 的
\x86\Session Recording目录下找到SessionRecordingPlayer.msi。您可以在 Citrix 虚拟应用和桌面 ISO 的
\x64\Session Recording目录下找到SessionRecordingWebPlayer.msi。
其中:
- /q 指定静默模式。
- /l*v 指定详细日志记录。
- yourinstallationlog 表示您的安装日志文件的位置。
实现会话录制代理的自动化安装
例如,以下命令将安装会话录制代理,并创建一个日志文件,用于捕获安装过程中的相关信息。
对于 64 位系统:
msiexec /i SessionRecordingAgentx64.msi /q /l*vx yourinstallationlog SESSIONRECORDINGSERVERNAME=yourservername
SESSIONRECORDINGBROKERPROTOCOL=yourbrokerprotocol SESSIONRECORDINGBROKERPORT=yourbrokerport
<!--NeedCopy-->
注意:
您可以在 Citrix 虚拟应用和桌面 ISO 的
\x64\Session Recording下找到SessionRecordingAgentx64.msi。
对于 32 位系统:
msiexec /i SessionRecordingAgent.msi /q /l*vx yourinstallationlog SESSIONRECORDINGSERVERNAME=yourservername
SESSIONRECORDINGBROKERPROTOCOL=yourbrokerprotocol SESSIONRECORDINGBROKERPORT=yourbrokerport
<!--NeedCopy-->
注意:
您可以在 Citrix 虚拟应用和桌面 ISO 文件 的
\x86\Session Recording下找到SessionRecordingAgent.msi。
其中:
- yourservername 是托管会话录制服务器的计算机的 NetBIOS 名称或 FQDN。如果未指定,此值默认为 localhost。
- yourbrokerprotocol 是会话录制代理用于与会话录制代理通信的 HTTP 或 HTTPS。如果未指定,此值默认为 HTTPS。
- yourbrokerport 是会话录制代理用于与会话录制代理通信的端口号。如果未指定,此值默认为零,这将指示会话录制代理使用所选协议的默认端口号:HTTP 为 80,HTTPS 为 443。
- /q 指定静默模式。
- /l*v 指定详细日志记录。
- yourinstallationlog 指的是您的安装日志文件的位置。
升级会话录制功能
您可以将某些部署升级到更高版本,而无需首先设置新计算机或站点。您可以将会话录制从 XenApp 和 XenDesktop 7.6 LTSR 最新 CU 中包含的版本以及任何更高版本升级到会话录制的最新版本。
注意:
当您将会话录制管理从 7.6 升级到 7.13 或更高版本,并在会话录制管理中选择修改以添加管理员日志记录服务时,SQL Server 实例名称不会显示在管理员日志记录配置页面上。当您单击下一步时,会出现以下错误消息:数据库连接测试失败。请输入正确的数据库实例名称。 作为一种解决方法,请为 localhost 用户添加对以下 SmartAuditor Server 注册表文件夹的读取权限:
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditor\Server。您无法从技术预览版本升级。
要求、准备事项和限制条件
- 请使用会话录制安装程序的图形用户界面或命令行界面,来升级在您已安装这些组件的计算机上的会话录制组件。
- 在进行任何升级活动之前,请备份 SQL Server 实例中名为 CitrixSessionRecording 的数据库。这样,如果在数据库升级后发现任何问题,您可以将其还原。
- 除了是域用户之外,您还必须是正在升级会话录制组件的计算机上的本地管理员。
- 如果会话录制服务器和会话录制数据库未安装在同一服务器上,则您必须具有数据库角色权限才能升级会话录制数据库。否则,您可以:
- 请数据库管理员分配用于升级的 securityadmin 和 dbcreator 服务器角色权限。升级完成后,不再需要 securityadmin 和 dbcreator 服务器角色权限,可以安全移除。
- 或者,使用 SessionRecordingAdministrationx64.msi 软件包进行升级。在 msi 升级期间,将弹出一个对话框,提示您输入具有 securityadmin 和 dbcreator 服务器角色权限的数据库管理员的凭据。键入正确的凭据,然后单击 OK(确定)以继续升级。
- 您可以选择不同时升级所有 Session Recording 代理。Session Recording 代理 7.6.0(及更高版本)与最新(当前)版本的 Session Recording 服务器兼容。但是,某些新功能和错误修复可能不会生效。
- 在 Session Recording 服务器升级期间启动的任何会话都不会被录制。
- 在全新安装或升级后,Session Recording 代理属性中的图形调整选项默认启用,以保持与桌面组合重定向模式兼容。您可以在全新安装或升级后手动禁用此选项。
- 如果您从不提供管理员日志记录功能的早期版本升级 Session Recording,则该功能不会安装。要添加此功能,请在升级后修改安装。
- 如果在升级过程开始时存在实时录制会话,则录制完成的可能性微乎其微。
- 查看以下升级顺序,以便您可以规划和缓解潜在的中断。
升级顺序
要升级现有安装,请前往安装了会话录制组件的每台计算机,然后运行 Citrix 虚拟应用和桌面 ISO。
提示:
请访问 Citrix 虚拟应用和桌面下载页面,以下载相应版本的 Citrix 虚拟应用和桌面。
对现有安装进行升级,通常需要遵循以下步骤:
-
升级会话录制服务器组件。
如果存在多个 Session Recording 服务器,请首先升级安装了 Session Recording 数据库组件的服务器。之后,升级其余的 Session Recording 服务器。
为此,请完成以下步骤:
- 在会话录制服务器上手动停止会话录制存储管理器服务。
- 通过 Internet 信息服务 (IIS) 管理器,确保会话录制代理正在运行。
- 运行 Citrix Virtual Apps and Desktops 安装镜像,然后选择会话录制条目进行升级。
- 在会话录制服务器的升级过程全部完成后,会话录制服务将无需手动干预,自动恢复联机状态。
- 升级会话录制代理(在主映像上)。
- 在会话录制服务器升级时或之后升级会话录制策略控制台。
- 升级会话录制播放器。
在云 SQL 数据库服务上部署会话录制数据库
本节介绍如何在 Azure SQL 托管实例、AWS RDS 以及 Azure VM 上的 SQL Server 上部署会话录制数据库。
在 Azure SQL 托管实例或 AWS RDS 上部署会话录制数据库
提示:
您还可以运行类似于以下内容的单个命令,以在 Azure SQL 托管实例或 AWS RDS 上部署会话录制数据库。有关详细信息,请参阅本文中前面的 自动化安装 部分。
msiexec /i "SessionRecordingAdministrationx64.msi" ADDLOCAL="SsRecServer,PolicyConsole,SsRecLogging,StorageDatabase" DATABASEINSTANCE="CloudSQL" DATABASENAME="CitrixSessionRecording" LOGGINGDATABASENAME="CitrixSessionRecordingLogging" AZURESQLSERVICESUPPORT="1" AZUREUSERNAME="CloudSQLAdminName" AZUREPASSWORD="CloudSQLAdminPassword" /q /l*vx "c:\WithLogging.log" <!--NeedCopy-->
-
创建 Azure SQL 托管实例,或者通过 Amazon RDS 控制台来创建 SQL Server 实例。
-
(仅适用于 Azure SQL)记录属性面板中显示的 Server 字符串。这些字符串是会话录制数据库的实例名称。有关示例,请参阅以下屏幕截图。

-
(仅适用于 AWS RDS) 记录 Endpoint 和 Port 信息。我们将其用作数据库的实例名称,格式为 <Endpoint, Port>。
AWS RDS 实例的组成(/zh-cn/session-recording/2303/media/aws-rds-instance-composition.png)
-
请运行 SessionRecordingAdministrationx64.msi 安装程序,以便完成会话录制数据库的整个安装部署过程。
选中“启用云 SQL”复选框,并填写云 SQL 管理员名称和密码。进行其他必需的配置。

注意:
如果您更改云 SQL 管理员密码,则必须在会话录制服务器属性中更新密码。当您打开会话录制服务器属性时,将显示一条错误消息。单击确定继续,选择云数据库选项卡,然后键入新的云 SQL 管理员密码。重新启动 Citrix 会话录制分析服务、Citrix 会话录制存储管理器服务和 IIS 服务。
不支持 Azure AD 身份验证。

将本地数据库迁移到云 SQL 托管实例
-
根据 https://docs.microsoft.com/zh-cn/data-migration/ 或 https://docs.aws.amazon.com/prescriptive-guidance/latest/patterns/migrate-an-on-premises-microsoft-sql-server-database-to-amazon-rds-for-sql-server.html 迁移您的本地数据库。
-
为使会话录制在迁移后正常工作,请在会话录制服务器上运行 SsRecUtils.exe。
C:\Program Files\Citrix\SessionRecording\Server\bin\SsRecUtils.exe -modifyazuredbconnectionpara {Database Instance} {Session Recording Database Name} {Session Recording Logging Database Name} {AzureAdminName}{AzureAdminPassword} iisreset /noforce -
在会话录制服务器上,重新启动 Citrix 会话录制分析服务、Citrix 会话录制存储管理器服务和 IIS 服务。
将生产数据库从 Azure SQL 托管实例迁移到本地数据库
-
为使会话录制在迁移后正常工作,请在会话录制服务器上运行 SsRecUtils.exe。
C:\Program Files\Citrix\SessionRecording\Server\bin\SsRecUtils.exe -modifydbconnectionpara {Database Instance} {Session Recording Database Name} {Session Recording Logging Database Name} iisreset /noforce -
在会话录制服务器上,重新启动 Citrix 会话录制分析服务、Citrix 会话录制存储管理器服务和 IIS 服务。
在 Azure VM 上的 SQL Server 上部署会话录制数据库
在 Azure 虚拟机上的 SQL Server 上,您既可以使用 msi 软件包,也可以使用 Citrix Virtual Apps and Desktops 安装程序来部署会话录制数据库。
- 准备一个 Azure SQL 虚拟机。
- 配置 VM 并将其添加到安装会话录制组件的域中。
- 在安装会话录制数据库期间,使用 VM 的 FQDN 作为实例名称。 注意: 如果您使用 SessionRecordingAdministrationx64.msi 进行安装,请清除 启用云 SQL 复选框。
- 请按照安装用户界面上的指示操作,以完成会话录制数据库的安装过程。
如何卸载会话录制
要从服务器或工作站中删除会话录制组件,请使用 Windows 控制面板中提供的卸载或删除程序选项。 要删除会话录制数据库,您必须拥有与安装时相同的 securityadmin 和 dbcreator SQL Server 角色权限。
出于安全原因,管理员日志记录数据库在组件卸载后不会被删除。
与 思杰安全分析™ 集成
您可以将会话录制服务器配置为将用户事件发送到 Citrix Analytics for Security,Citrix Analytics for Security 会处理这些用户事件,以提供有关用户行为的可操作洞察。
先决条件
在您开始之前,请确保满足以下条件:
-
会话录制服务器必须能够与以下地址进行连接:
-
会话录制部署必须打开端口 443 以用于出站 Internet 连接。网络上的任何代理服务器都必须允许此通信与 Citrix Analytics for Security 进行。
-
如果您使用的是 Citrix Virtual Apps and Desktops 7 1912 LTSR,则支持的会话录制版本为 2103 或更高版本。
将您的会话录制服务器与 Citrix Analytics for Security 解决方案进行连接操作
-
登录到 Citrix 云。
-
找到 Citrix 安全分析,然后单击 管理。
-
在顶部栏中,单击 设置 > 数据源。
-
在 Virtual Apps and Desktops - 会话录制 站点卡上,单击 连接会话录制服务器。

-
在“连接会话录制服务器”页面上,查看清单并选择所有强制性要求。如果您未选择强制性要求,“下载文件”选项将被禁用。

-
如果您的网络中有代理服务器,请在会话录制服务器上的 SsRecStorageManager.exe.config 文件中输入代理地址。
您可以在以下位置找到配置文件
<Session Recording server installation path>\bin\SsRecStorageManager.exe.config例如:
C:\Program Files\Citrix\SessionRecording\Server\Bin\SsRecStorageManager.exe.config
-
请点击 下载文件 按钮,以便将 SessionRecordingConfigurationFile.json 配置文件下载到您的本地计算机上。
注意:
该文件包含敏感信息。请将文件保存在安全可靠的位置。
-
将文件复制到您要连接到 Citrix Analytics for Security 的会话录制服务器。
-
如果您的部署中有多个会话录制服务器,则必须将文件复制到要连接的每个服务器中,并按照步骤配置每个服务器。
-
在会话录制服务器上,运行以下命令以导入设置:
<Session Recording server installation path>\bin\SsRecUtils.exe -Import_SRCasConfigurations <configuration file path> <!--NeedCopy-->例如:
C:\Program Files\Citrix\SessionRecording\Server\bin\SsRecUtils.exe -Import_SRCasConfigurations C:\Users\administrator\Downloads\SessionRecordingConfigurationFile.json <!--NeedCopy--> -
重新启动以下服务:
-
Citrix 会话录制分析服务
-
Citrix 会话录制存储管理器
-
-
配置成功后,转到 Citrix Analytics for Security 以查看已连接的会话录制服务器。单击 打开数据处理 以允许 Citrix Analytics for Security 处理数据。
注意:
如果您使用的是会话录制服务器版本 2103 或 2104,则必须首先启动 Virtual Apps and Desktops 会话,才能在 Citrix Analytics for Security 上查看已连接的会话录制服务器。否则,已连接的会话录制服务器将无法显示。此要求不适用于会话录制服务器版本 2106 及更高版本。
查看已连接的部署
仅当配置成功时,服务器部署才会显示在 Session Recording 站点卡上。站点卡显示已与 Citrix Analytics for Security 建立连接的已配置服务器数量。
如果即使配置成功后仍未看到您的 Session Recording 服务器,请参阅 已配置的 Session Recording 服务器无法连接 中的故障排除部分。

在站点卡上,单击部署数量以查看与 Citrix Analytics for Security 连接的服务器组。例如,单击 1 个 Session Recording 部署 以查看连接的服务器或服务器组。每个 Session Recording 服务器都由一个基本 URL 和一个 ServerGroupID 表示。

查看收到的事件
站点卡显示已连接的 Session Recording 部署以及在过去一小时内从这些部署收到的事件,这是一小时的默认时间选择。您还可以选择 1 周 (1 W) 并查看数据。单击收到的事件数量以在自助服务搜索页面上查看事件。
启用数据处理后,站点卡可能会显示 未收到数据 状态。此状态出现的原因有两个:
-
如果您是首次打开数据处理,事件需要一些时间才能到达 Citrix Analytics 中的事件中心。当 Citrix Analytics 收到事件时,状态将更改为 数据处理已开启。如果一段时间后状态未更改,请刷新“数据源”页面。
-
在过去一小时内,Citrix Analytics 未从数据源收到任何事件。
添加会话录制服务器
要添加会话录制服务器,请执行以下操作之一:
-
在已连接的会话录制部署页面上,单击连接到会话录制服务器。

-
在Virtual Apps and Desktops - 会话录制站点卡片上,单击垂直省略号 (⋮),然后选择连接会话录制服务器。

执行以下步骤,以下载配置文件并配置会话录制服务器。
删除会话录制服务器
要删除会话录制服务器:
-
在 Citrix Analytics for Security 上,转到已连接的会话录制部署页面并选择要删除的服务器部署。
-
单击垂直省略号 (⋮) 并选择从 Analytics 中删除会话录制服务器。

-
在已从 Citrix Analytics 中删除的会话录制服务器上,运行以下命令:
<Session Recording server installation path>\bin\SsRecUtils.exe -Remove_SRCasConfigurations <!--NeedCopy-->例如:
C:\Program Files\Citrix\SessionRecording\Server\bin\SsRecUtils.exe -Remove_SRCasConfigurations <!--NeedCopy-->
启用或禁用数据源上的数据处理
您可以随时停止特定数据源(Director 和 Workspace 应用程序)的数据处理。在数据源站点卡片上,单击垂直省略号 (⋮),然后选择 Turn off data processing(关闭数据处理)。Citrix Analytics 将停止处理该数据源的数据。您还可以从 Virtual Apps and Desktops 站点卡片停止数据处理。此选项适用于两个数据源:Director 和 Workspace 应用程序。 要再次启用数据处理,请单击 Turn On Data Processing(开启数据处理)。
配置的会话录制服务器无法连接
您的会话录制服务器在配置后无法连接到 Citrix Analytics。因此,您在 Session Recording(会话录制)站点卡片上看不到已配置的服务器。
要解决此问题,请执行以下操作:
-
在您配置的会话录制服务器上,运行以下 PowerShell 命令以检查客户端计算机标识 (CMID):
Get-WmiObject -class SoftwareLicensingService | select Clientmachineid <!--NeedCopy--> -
如果 CMID 为空,请在指定路径中添加以下注册表文件:
注册表名称 注册表路径 密钥类型 值 AuditorUniqueIDComputer\HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditor\Server\字符串 输入您的 UUID。 EnableCASUseAuditorUniqueIDComputer/HKEY_LOCAL_MACHINE/SOFTWARE/Citrix/SmartAuditor/Server/注册表双字 1 -
重新启动以下服务:
-
Citrix 会话录制分析服务
-
Citrix 会话录制存储管理器
-