会话录制的安装、升级和卸载

本章详细介绍了如何使用 XenApp/XenDesktop 安装程序安装会话录制。它包含以下部分：

安装清单

安装会话录制管理组件

配置 Director 以使用会话录制服务器

安装会话录制代理

安装会话录制播放器

自动安装

升级会话录制

卸载会话录制

安装核对清单

从版本 7.14 开始，您可以使用 XenApp/XenDesktop 安装程序安装会话录制组件。

在开始安装之前，请完成此列表：

注意：

• Citrix 建议您根据录制策略将已发布的应用程序划分为单独的交付组，因为如果已发布的应用程序位于同一交付组中，则会话共享可能会与活动策略冲突。会话录制会将活动策略与用户打开的第一个已发布的应用程序进行匹配。
• If you are planning to use Machine Creation Services™ (MCS) or Provisioning Services, prepare a unique QMId. Failure to comply can cause recording data losses.
• SQL Server requires that TCP/IP is enabled, the SQL Server Browser service is running, and Windows Authentication is used.
• 要使用 HTTPS，请为 TLS/HTTPS 配置服务器证书。
• 确保 本地用户和组 > 组 > 用户 下的用户对 C:\windows\Temp 文件夹具有写入权限。

安装会话录制管理功能所需的组件

Citrix 建议您将会话录制管理、会话录制代理和会话录制播放器组件安装在单独的服务器上。会话录制管理组件包括会话录制数据库、会话录制服务器和会话录制策略控制台。您可以选择在服务器上安装这些组件中的哪些。

步骤 1：下载产品软件并启动向导

1. 如果您尚未下载 XenApp® 和 XenDesktop ISO，请使用您的 Citrix 帐户凭据访问 XenApp 和 XenDesktop 下载页面并下载产品 ISO 文件。解压缩 ISO 文件或将其刻录到 DVD。
2. 使用本地管理员帐户登录到要安装 Session Recording 管理组件的计算机。将 DVD 插入驱动器或装载 ISO 文件。如果安装程序未自动启动，请双击 AutoSelect 应用程序或装载的驱动器。 安装向导将启动。

步骤 2：选择要安装的产品

单击要安装的产品（XenApp 或 XenDesktop）旁边的开始。

步骤 3：选择会话录制

选择 会话录制 条目。

步骤 4：阅读并接受许可协议

在软件许可协议页面上，阅读并接受许可协议，然后单击下一步。

步骤 5：选择要安装的组件和安装位置

在核心组件页面上：

• 位置：默认情况下，组件安装在 C:\Program Files\Citrix 中。默认位置适用于大多数部署。您可以指定自定义安装位置。
• 组件：默认情况下，所有可安装组件旁边的复选框均处于选中状态。安装程序知道它是在桌面操作系统还是服务器操作系统上运行。它只允许在服务器操作系统上安装 Session Recording 管理组件，并且不允许在未预先安装 VDA 的计算机上安装 Session Recording Agent。如果您在未预先安装 VDA 的计算机上安装 Session Recording Agent，则Session Recording Agent选项将不可用。

选择 会话录制管理，然后单击 下一步。

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

在 功能 页面上：

• 默认情况下，所有可安装功能旁边的复选框均处于选中状态。在单个服务器上安装所有这些功能适用于概念验证。但是，对于大型生产环境，Citrix 建议您将会话录制策略控制台安装在单独的服务器上，并将 Session Recording Server、Session Recording Administrator Logging 和 Session Recording Database 安装在另一个单独的服务器上。请注意，会话录制管理员日志记录是会话录制服务器的一个可选子功能。必须先选择会话录制服务器，然后才能选择会话录制管理员日志记录。
• 在同一服务器上选择并安装一个或多个功能后，若要添加其他功能，只能运行 msi 软件包，而不能再次运行安装程序。

选择要安装的一个或多个功能，然后单击 下一步。

步骤 6.1：安装会话录制数据库

注意： 会话录制数据库并非实际的数据库。它是一个负责在安装过程中在 Microsoft SQL Server 实例中创建和配置所需数据库的组件。会话录制支持基于 Microsoft SQL Server 的三种数据库高可用性解决方案。有关详细信息，请参阅使用数据库高可用性安装会话录制。

会话录制数据库和 Microsoft SQL Server 通常有三种部署类型：

• 部署 1：在同一台计算机上安装会话录制服务器和会话录制数据库，并在远程计算机上安装 Microsoft SQL Server。(推荐)
• 部署 2：在同一台计算机上安装会话录制服务器、会话录制数据库和 Microsoft SQL Server。
• 部署 3：在一台计算机上安装会话录制服务器，并在另一台计算机上安装会话录制数据库和 Microsoft SQL Server。(不推荐)

1. 在 功能 页面上，选择 会话录制数据库，然后单击 下一步。

   

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

   

   在数据库和服务器配置页面上：

   • 实例名称：如果数据库实例不是您在设置实例时配置的命名实例，则只能使用 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 服务器角色权限不再需要，可以安全删除。

     • 或者，使用 SessionRecordingAdministrationx64.msi 包（解压 ISO 文件，您可以在 …\x64\Session Recording 下找到此 msi 包）。在 msi 安装过程中，对话框会提示输入具有 securityadmin 和 dbcreator 服务器角色权限的数据库管理员凭据。输入正确的凭据，然后单击确定以继续安装。

       安装会创建新的会话录制数据库，并将会话录制服务器的计算机帐户添加为 db_owner。

   • 会话录制服务器计算机帐户：
     • 部署 1 和 2：在会话录制服务器计算机帐户字段中键入 localhost。
     • 部署 3：键入托管会话录制服务器的计算机名称，格式为 domain\computer-name。会话录制服务器计算机帐户是用于访问会话录制数据库的用户帐户。

     注意： 当在会话录音服务器计算机帐户字段中设置了域名时，安装会话录音管理组件可能会失败，并显示错误代码 1603。作为一种解决方法，请在会话录音服务器计算机帐户字段中键入 localhost 或 NetBIOS 域名\计算机名称。

3. 审查必备条件，并确认继续安装。

   

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

4. 完成安装过程。

   

   完成安装页面会为所有已成功安装和初始化的必备条件和组件显示绿色复选标记。

   单击完成以完成会话录音数据库的安装。

步骤 6.2：安装会话录音服务器

1. 在功能页面上，选择会话录音服务器和会话录音管理员日志记录。单击下一步。

   

   注意：

   • 会话录音管理员日志记录是会话录音服务器的一个可选子功能。必须先选择会话录音服务器，然后才能选择会话录音管理员日志记录。
   • Citrix 建议您同时安装会话录音管理员日志记录和会话录音服务器。如果您不希望启用管理员日志记录功能，可以在稍后的页面上禁用它。但是，如果您最初选择不安装此功能但希望稍后添加它，则只能通过使用 SessionRecordingAdministrationx64.msi 软件包手动添加它。

2. 在数据库和服务器配置页面上，指定配置。

   

   在数据库和服务器配置页面上：

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

3. 在管理日志记录配置页面上，指定管理日志记录功能的配置。

   

   在管理日志记录配置页面上：

   • 管理日志记录数据库安装在 SQL Server 实例上：此文本框不可编辑。管理日志记录数据库的 SQL Server 实例名称将自动从您在数据库和服务器配置页面上键入的实例名称中获取。
   • 管理员日志记录数据库名称：如果您选择安装会话录制管理员日志记录功能，请在此文本框中为管理员日志记录数据库键入自定义数据库名称，或使用文本框中预设的默认数据库名称 CitrixSessionRecordingLogging。 注意：管理员日志记录数据库名称必须与在上一数据库和服务器配置页面上的数据库名称文本框中设置的会话录制数据库名称不同。
   • 键入管理员日志记录数据库名称后，单击测试连接以测试与管理员日志记录数据库的连接。
   • 启用管理日志记录：默认情况下，管理日志记录功能处于启用状态。您可以通过清除复选框来禁用它。
   • 启用强制阻止：默认情况下，强制阻止处于启用状态。如果日志记录失败，正常功能可能会被阻止。您可以通过清除复选框来禁用强制阻止。

   单击下一步以继续安装。

4. 检查先决条件并确认安装过程。

   

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

5. 完成安装过程。

   

   完成安装页面显示所有已成功安装和初始化的必备条件和组件的绿色复选标记。

   单击完成以完成 会话录制服务器 的安装。

   注意：会话录制服务器默认安装使用 HTTPS/TLS 来保护通信安全。如果会话录制服务器的默认 IIS 站点中未配置 TLS，请使用 HTTP。为此，请导航到会话录制代理站点，打开 SSL 设置，然后清除“要求 SSL”复选框，以便在 IIS 管理控制台中取消 SSL 的选择。

步骤 6.3：安装会话录制策略控制台

1. 在功能页面上，选择Session Recording 策略控制台并单击下一步。

   

2. 检查先决条件并确认安装过程。

   

   “摘要”页面显示您的安装选择。您可以单击“返回”以返回到之前的向导页面并进行更改。或者，单击“安装”以开始安装。

3. 完成安装过程。

   

   “完成安装”页面显示所有已成功安装和初始化的必备项和组件的绿色复选标记。

   单击“完成”以完成会话录制策略控制台的安装。

Step 7: Install Broker_PowerShellSnapIn_x64.msi

Important: To use the Session Recording Policy Console, you must have the Broker PowerShell Snap-in (Broker_PowerShellSnapIn_x64.msi) installed. The snap-in cannot be automatically installed by the installer. Locate the snap-in on the XenApp/XenDesktop ISO (\layout\image-full\x64\Citrix Desktop Delivery Controller) and follow the instructions for installing it manually. Failure to comply can cause an error.

配置 Director 以使用会话录制服务器

您可以使用 Director 控制台创建并激活会话录制策略。

1. 对于 HTTPS 连接，请在 Director 服务器的“受信任的根证书”中安装证书以信任会话录制服务器。
2. To configure the Director server to use the Session Recording Server, run the C:\inetpub\wwwroot\Director\tools\DirectorConfig.exe /configsessionrecording command.
3. 输入会话录制服务器的 IP 地址或 FQDN，以及会话录制代理用于连接 Director 服务器上的会话录制代理的端口号和连接类型 (HTTP/HTTPS)。

安装会话录制代理程序

您必须在要录制会话的 VDA 或 VDI 计算机上安装会话录制代理。

步骤 1: 下载产品软件并启动向导

使用本地管理员帐户登录到要安装 Session Recording Agent 组件的计算机。将 DVD 插入驱动器或装载 ISO 文件。如果安装程序未自动启动，请双击 AutoSelect 应用程序或装载的驱动器。

安装向导随即启动。

步骤 2: 选择要安装的产品

单击要安装的产品旁边的开始：XenApp 或 XenDesktop。

步骤 3：选择会话录制

选择 会话录制 条目。

步骤 4: 阅读并接受许可协议

在软件许可协议页面上，阅读并接受许可协议，然后单击下一步

步骤 5: 选择要安装的组件和安装位置

选择 会话录制代理，然后单击下一步。

步骤 6: 指定代理配置

在代理配置页面上：

• 如果您已提前安装会话录制服务器，请输入安装会话录制服务器的计算机名称以及连接到会话录制服务器的协议和端口信息。如果您尚未安装会话录制，您可以在以后通过会话录制代理属性修改此类信息。

注意：安装程序的测试连接功能存在限制。它不支持“HTTPS 需要 TLS 1.2”的场景。如果您在此场景中使用安装程序，测试连接会失败，但您可以忽略此失败并单击下一步继续安装。这不影响正常功能。

步骤 7: 查看必备条件并确认安装

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

步骤 8: 完成安装

完成安装页面显示所有已成功安装和初始化的必备条件和组件的绿色复选标记。

单击完成以完成会话录制代理的安装。

注意：当机器创建服务 (MCS) 或预配服务 (PVS) 使用配置的主映像和已安装的 Microsoft 消息队列 (MSMQ) 创建多个 虚拟投递代理 (VDA) 时，这些 VDA 在某些条件下可能具有相同的 QMId。这可能会导致各种问题，例如：

• 会话可能不会被录制，即使录制协议已接受。
• 会话录制服务器可能无法接收会话注销信号，因此，会话可能始终处于实时状态。

作为一种变通方法，为每个 VDA 创建一个唯一的 QMId，并且它会因部署方法而异。

如果安装了 Session Recording 代理的桌面操作系统 VDA 是使用 PVS 7.7 或更高版本以及 MCS 7.9 或更高版本在静态桌面模式下创建的（例如，配置为通过单独的个人虚拟磁盘或 VDA 的本地磁盘使所有更改持久化），则无需执行额外操作。

对于使用 MCS 或 PVS 创建的服务器操作系统 VDA，以及配置为在用户注销时丢弃所有更改的桌面操作系统 VDA，请使用 GenRandomQMID.ps1 脚本在系统启动时修改 QMId。修改电源管理策略，以确保在用户尝试登录之前有足够的 VDA 正在运行。

要使用 GenRandomQMID.ps1 脚本，请执行以下操作：

1. Make sure that the execution policy is set to RemoteSigned or Unrestricted in PowerShell.

   Set-ExecutionPolicy RemoteSigned

2. 创建一个计划任务，将触发器设置为系统启动时，并使用 SYSTEM 帐户在 PVS 或 MCS 主映像计算机上运行。

3. 将该命令添加为启动任务。

   powershell .exe -file C:\\GenRandomQMID.ps1

Summary of the GenRandomQMID.ps1 script:

1. 从注册表中删除当前的 QMId。
2. Add SysPrep = 1 to HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSMQ\Parameters.
3. Stop related services, including CitrixSmAudAgent and MSMQ.
4. 要生成随机 QMId，请启动之前停止的服务。

# 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
        }

}
}

安装会话录制播放器

在会话录制服务器或域中的一个或多个工作站上安装会话录制播放器，供查看会话录制的用户使用。

步骤 1：下载产品软件并启动向导

使用本地管理员帐户登录到要安装会话录制播放器组件的计算机。将 DVD 插入驱动器或装载 ISO 文件。如果安装程序未自动启动，请双击 AutoSelect 应用程序或装载的驱动器。

安装向导随即启动。

步骤 2：选择要安装的产品

单击要安装的产品旁边的开始：XenApp 或 XenDesktop。

步骤 3：选择会话录制

选择会话录制条目。

步骤 4：阅读并接受许可协议

在软件许可协议页面上，阅读并接受许可协议，然后单击下一步。

步骤 5：选择要安装的组件和安装位置

选择 会话录制播放器，然后单击 下一步。

步骤 6：查看必备条件并确认安装

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

步骤 7：完成安装

完成安装 页面显示所有已成功安装和初始化的必备条件和组件的绿色复选标记。

单击 完成 以完成会话录制播放器的安装。

自动化安装部署

要在多台服务器上安装会话录制代理，请编写使用静默安装的脚本。

以下命令行用于安装会话录制代理，并创建一个日志文件以捕获安装信息。

对于 64 位系统：

msiexec /i SessionRecordingAgentx64.msi /q /l*vx yourinstallationlog SESSIONRECORDINGSERVERNAME=yourservername SESSIONRECORDINGBROKERPROTOCOL=yourbrokerprotocol SESSIONRECORDINGBROKERPORT=yourbrokerport

Note: The SessionRecordingAgentx64.msi file in the XenApp/XenDesktop ISO is under \layout\image-full\x64\Session Recording.

对于 32 位系统：

msiexec /i SessionRecordingAgent.msi /q /l*vx yourinstallationlog SESSIONRECORDINGSERVERNAME=yourservername SESSIONRECORDINGBROKERPROTOCOL=yourbrokerprotocol SESSIONRECORDINGBROKERPORT=yourbrokerport

Note: The SessionRecordingAgent.msi file in the XenApp/XenDesktop ISO is under \layout\image-full\x86\Session Recording.

其中：

yourservername 是托管会话录制服务器的计算机的 NetBIOS 名称或 FQDN。如果未指定，此值默认为 localhost。

yourbrokerprotocol 是会话录制代理用于与会话录制 Broker 通信的 HTTP 或 HTTPS。如果未指定，此值默认为 HTTPS。

yourbrokerport 是会话录制代理用于与会话录制 Broker 通信的端口号。如果未指定，此值默认为零，这将指示会话录制代理使用所选协议的默认端口号：HTTP 为 80，HTTPS 为 443。

/l*v 指定详细日志记录。

yourinstallationlog 是指您的安装日志文件的位置。

/q 指定静默模式。

升级会话录制功能

您可以将某些部署升级到更高版本，而无需首先设置新计算机或站点。您可以从 Session Recording 7.6（或更高版本）升级到最新版本的 Session Recording。

注意：

• 当您将会话录制管理从 7.6 升级到 7.13 或更高版本，并在会话录制管理中选择修改以添加管理员日志记录服务时，SQL Server 实例名称不会显示在管理员日志记录配置页面上。单击下一步时，将显示以下错误消息：Database connection test failed. Please enter correct Database instance name. 作为一种解决方法，请为 localhost 用户添加对以下 SmartAuditor Server 注册表文件夹的读取权限：HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditor\Server。
• 当您仅在一台计算机上安装此组件时，升级 Session Recording Database 可能会失败。在这种情况下，请检查 HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\SmartAuditor\Database 下是否存在以下注册表项。如果不存在，请在升级前手动添加这些项。

要求、准备工作和限制条件

注意： 您无法从技术预览版进行升级。

• 您必须使用会话录制安装程序的图形界面或命令行界面来升级安装了会话录制组件的计算机上的组件。
• 在开始任何升级活动之前，请备份 SQL Server 实例中名为 CitrixSessionRecording 的数据库，以便在数据库升级后发现任何问题时可以将其还原。
• 除了是域用户之外，您还必须是正在升级会话录制组件的计算机上的本地管理员。
• 如果会话录制服务器和会话录制数据库未安装在同一台服务器上，您必须具有数据库角色权限才能升级会话录制数据库；否则，您可以
  • 请求数据库管理员分配升级所需的 securityadmin 和 dbcreator 服务器角色权限。升级完成后，securityadmin 和 dbcreator 服务器角色权限不再需要，可以安全删除。
  • 或者，使用 SessionRecordingAdministrationx64.msi 软件包进行升级。在 msi 升级期间，将弹出一个对话框，提示输入具有 securityadmin 和 dbcreator 服务器角色权限的数据库管理员凭据。输入正确的凭据，然后单击 OK 继续升级。

• 如果您不打算同时升级所有会话录制代理，则会话录制代理 7.6.0（或更高版本）可以与最新（当前）版本的会话录制服务器配合使用。但是，某些新功能和错误修复可能不会生效。
• 在会话录制服务器升级期间启动的任何会话都不会被录制。
• 在全新安装或升级后，会话录制代理属性中的 图形调整 选项默认启用，以保持与桌面合成重定向模式兼容。您可以在全新安装或升级后手动禁用此选项。
• 如果您从不包含此功能的早期版本升级会话录制，则不会安装管理员日志记录功能。要添加此新功能，请在升级后修改安装。
• 如果在升级过程开始时存在实时录制会话，那么这些录制会话能够成功完成的可能性非常小。
• 请查看下面的升级顺序，以便您可以规划并缓解潜在的服务中断。

升级顺序

1. 如果会话录制数据库和会话录制服务器安装在不同的服务器上，请在会话录制服务器上手动停止会话录制存储管理器服务，然后首先升级会话录制数据库。
2. 确保会话录制代理与 IIS 服务一起运行。升级会话录制服务器。如果会话录制数据库和会话录制服务器安装在同一服务器上，则会话录制数据库也将升级。
3. 当会话录制服务器的升级过程完成时，会话录制服务将自动恢复在线状态。
4. 升级会话录制代理（在主映像上）。
5. 与会话录制服务器同时或在其之后升级会话录制策略控制台。
6. 升级会话录制播放器。

注意： 在 Windows Server 2008 R2 上升级会话录制管理组件时，可能会出现以下错误。

在这种情况下，在 IIS 中将“SessionRecordingAppPool”的“.NET 框架版本”更改为“.NET 框架 v4”，然后再次执行升级。

卸载 Citrix 会话录制

要从服务器或工作站中删除会话录制组件，请使用 Windows 控制面板中提供的卸载或删除程序选项。 要删除会话录制数据库，您必须具有与安装时相同的 securityadmin 和 dbcreator SQL Server 角色权限。

出于安全原因，在组件卸载后，管理员日志记录数据库不会被删除。