安装准备工作

部署 Citrix Virtual Apps and Desktops™ 从安装以下组件开始。此过程为向防火墙内的用户交付应用程序和桌面做准备。

• 一个或多个交付控制器
• 思杰 迪雷克特
• 思杰 斯托弗朗特™
• Citrix 许可证服务器
• 一个或多个 Citrix 虚拟交付代理 (VDA)
• 可选的组件和技术，例如通用打印服务器、联合身份验证服务和自助密码重置功能

对于防火墙外的用户，请安装并配置一个额外组件，例如 Citrix 网关。有关简介，请参阅 将 Citrix 虚拟应用和桌面与 Citrix 网关集成。

注意：

请确保在服务器操作系统和工作站操作系统上满足以下 Microsoft 先决条件：

• Microsoft 卷影复制和 Microsoft 软件卷影复制提供程序服务正在运行。有关详细信息，请参阅 卷影复制服务。
• MS-Defender 版本必须高于 4.18.2105.5。有关详细信息，请参阅 Microsoft Defender 防病毒安全智能和产品更新。

如果您的部署包含 Windows Server 工作负载，请配置 Microsoft RDS 许可证服务器。

您可以使用产品 ISO 上的完整产品安装程序部署许多组件和技术。您可以使用独立的 VDA 安装程序安装 VDA。独立的 VDA 安装程序可在 Citrix 下载站点上获取。所有安装程序都提供图形界面和命令行界面。请参阅 安装程序。

产品 ISO 包含用于在 Active Directory 中安装、升级或删除计算机 VDA 的示例脚本。您还可以使用这些脚本来管理 Machine Creation Services (MCS) 和 Citrix Provisioning（以前称为 Provisioning Services）使用的映像。有关详细信息，请参阅使用脚本安装 VDA。

安装前需要查阅的重要信息

• 技术概述：熟悉产品及其组件。
• 安全性：规划部署环境时。
• 已知问题：此版本中可能遇到的问题。
• 数据库：了解系统数据库以及如何配置它们。在 Controller 安装期间，您可以安装 SQL Server Express 作为站点数据库。在安装核心组件后，创建站点时配置大多数数据库信息。
• 远程电脑访问：如果您正在部署一个环境，使用户能够远程访问其办公室中的物理计算机。
• 连接和资源：如果您正在使用虚拟机管理程序或其他服务来托管或预配应用程序和桌面的 VM。您可以在创建站点时（安装核心组件后）配置第一个连接。在此之前设置您的虚拟化环境。
• Microsoft System Center Configuration Manager：如果您正在使用 ConfigMgr 管理对应用程序和桌面的访问，或者如果您正在将局域网唤醒功能与远程电脑访问结合使用。
• 公共云主机连接： 如果您拥有混合权利许可证，则可以创建到公共云的主机连接。有关混合权利许可证的信息，请参阅混合权利续订。有关公共云权利以及此更改原因的信息，请参阅 CTX270373。

组件的安装位置

查看系统要求，了解支持的平台、操作系统和版本。组件必备项会自动安装，但另有说明的除外。有关 Citrix StoreFront 和 Citrix License Server 的支持平台和必备项，请参阅其文档。

您可以将核心组件安装在同一服务器上或不同的服务器上。

• 将所有核心组件安装在一台服务器上适用于评估、测试或小型生产部署。
• 为了适应未来的扩展，请考虑将组件安装在不同的服务器上。例如，将 Studio 安装在与安装 Controller 的服务器不同的计算机上，可以远程管理站点。

• 对于大多数生产部署，建议在单独的服务器上安装核心组件。

  在其他服务器上安装其他组件之前，请先安装 Citrix 许可证服务器和许可证。

• 要在 Server CoreOS（例如 Delivery Controller）上安装受支持的组件，您必须(/zh-cn/citrix-virtual-apps-desktops/2411/install-configure/install-command.html)。该操作系统类型不提供图形界面，因此请在其他位置安装 Studio 和其他工具，然后将它们指向 Controller 服务器。

您可以在同一台服务器上同时安装 Delivery Controller™ 和适用于多会话操作系统的 VDA。启动安装程序并选择 Delivery Controller（以及您希望在该计算机上安装的任何其他核心组件）。然后再次启动安装程序并选择适用于多会话操作系统的 Virtual Delivery Agent。

确保每个操作系统都具有最新更新。

确保所有计算机都具有同步的系统时钟。保护计算机之间通信的 Kerberos 基础结构需要同步。

对于 XenServer，即使虚拟机显示为已注册，其电源状态也可能显示为未知。要解决此问题，请编辑注册表项 HostTime 值以禁用与主机的时钟同步：

HKEY_LOCAL_MACHINE\Software\Citrix\XenTools\HostTime="Local"

HKEY_LOCAL_MACHINE\Software\Wow6432Node\Citrix\XenTools\HostTime="Local"

提示：

默认值为 HostTime="UTC"。将此值更改为 UTC 以外的值，例如 Local。此更改可有效禁用与主机的时钟同步。

有关 Windows 10 单会话计算机的优化指南，请参阅 CTX216252。

不应安装组件的位置：

• 不要在 Active Directory 域控制器上安装任何组件。
• 不支持在 SQL Server 群集安装、SQL Server 镜像安装中的节点上或在运行 Hyper-V 的服务器上安装 Controller。

如果您尝试在当前产品版本不支持的 Windows 操作系统上安装或升级 VDA，则会出现一条消息，引导您阅读一篇描述选项的文章。

权限设置和活动目录要求

您必须是域用户，并且是安装组件的计算机上的本地管理员。

要使用独立 VDA 安装程序，您必须具有提升的管理权限或使用以管理员身份运行。

在开始安装之前，请配置您的 Active Directory 域。

• 系统要求列出了支持的 Active Directory 功能级别。已加入 Active Directory包含更多信息。
• 您必须至少有一个运行 Active Directory 域服务的域控制器。
• 请勿在域控制器上安装任何 Citrix 虚拟应用和桌面 组件。
• 在 Studio 中指定组织单位名称时，请勿使用正斜杠 (/)。

用于安装 Citrix 许可证服务器的 Windows 用户帐户会自动配置为委派管理完全管理员。

有关详细信息：

• 安全性最佳实践
• 委派管理
• 微软提供的活动目录配置相关文档

安装指南、注意事项和最佳实践

在安装任何组件期间

• 从完整产品介质安装或升级 Delivery Controller、Studio、License Server 或 Director 时，如果 Citrix 安装程序检测到计算机上存在先前 Windows 安装的待处理重启，安装程序将停止并显示退出/返回代码 9。系统会提示您重新启动计算机。

  这不是 Citrix 强制重启。这是由于计算机上之前安装的其他组件造成的。如果发生这种情况，请重新启动计算机，然后再次启动 Citrix 安装程序。

  使用命令行界面时，您可以通过在命令中包含 /no_pending_reboot_check 选项来阻止检查待处理的重新启动。

• 通常，如果某个组件具有先决条件，如果不存在，安装程序会部署它们。某些先决条件可能需要重新启动计算机。

• 在安装之前、期间和之后创建对象时，为每个对象指定唯一的名称。例如，为网络、组、目录和资源提供唯一的名称。

• 如果组件安装不成功，安装将停止并显示错误消息。已成功安装的组件将保留。您无需重新安装它们。

• 当您安装（或升级）组件时，Citrix Analytics 会自动收集。默认情况下，安装完成后，这些数据会自动上传到 Citrix。此外，当您安装组件时，您会自动加入 Citrix 客户体验改善计划 (CEIP)，该计划会上传匿名数据。

  在安装过程中，您还可以选择参与其他 Citrix 技术，这些技术会收集诊断信息以用于维护和故障排除。有关这些计划的信息，请参阅 Citrix Insight Services。

• 当您安装（或升级）Studio 时，Google Analytics 会自动收集（并稍后上传）。安装 Studio 后，您可以使用注册表项 HKLM\Software\Citrix\DesktopStudio\GAEnabled 更改此设置。值为 1 启用收集和上传，0 禁用收集和上传。

• 如果 VDA 安装失败，MSI 分析器会解析失败的 MSI 日志，显示确切的错误代码。如果是已知问题，分析器会建议一篇 CTX 文章。分析器还会收集有关失败错误代码的匿名数据。此数据包含在 CEIP 收集的其他数据中。如果您终止 CEIP 注册，则收集的 MSI 分析器数据将不再发送到 Citrix。

VDA 安装期间

• 适用于 Windows 的 Citrix Workspace™ 应用程序可用，但在安装 VDA 时默认不安装。您或您的用户可以从 Citrix 网站下载并安装（和升级）适用于 Windows 的 Citrix Workspace 应用程序以及其他 Citrix Workspace 应用程序。或者，您可以从 StoreFront 服务器提供这些 Citrix Workspace 应用程序。请参阅 StoreFront 文档。

• 必须启用 Microsoft Print Spooler 服务。如果该服务被禁用，您将无法成功安装 VDA。

• 大多数受支持的 Windows 版本都已安装 Microsoft Media Foundation。如果计算机没有 Media Foundation（例如 N 版本），某些多媒体功能将不会安装且无法工作。

  • Windows 媒体重定向
  • HTML5 视频重定向
  • HDX™ RealTime 网络摄像头重定向

  您可以确认此限制，或者在安装 Media Foundation 后，结束 VDA 安装并稍后重新启动。在图形界面中，此选择会显示在消息中。在命令行中，您可以使用 /no_mediafoundation_ack 选项来确认此限制。

• 安装 VDA 时，会自动创建一个名为 Direct Access Users 的新本地用户组。在单会话操作系统 VDA 上，此组仅适用于 RDP 连接。在多会话操作系统 VDA 上，此组适用于 ICA® 和 RDP 连接。

• VDA 必须具有有效的 Controller 地址才能进行通信。否则，无法建立会话。您可以在安装 VDA 时或之后指定 Controller 地址。请记住，此操作必须完成。有关详细信息，请参阅 VDA 注册。

在 VDA 安装之后和期间重新启动

VDA 安装结束时需要重新启动。默认情况下，该重新启动会自动发生。

将 VDA 升级到版本 7.17（或更高版本）时，升级期间会发生重新启动。这是无法避免的。

为了最大程度地减少 VDA 安装期间所需的重新启动次数，请执行以下操作：

• 确保在开始 VDA 安装之前已安装受支持的 .NET Framework 版本。
• 对于 Windows 多会话操作系统计算机，请在安装 VDA 之前安装并启用 RDS 角色服务。

如果您在安装 VDA 之前未安装这些必备项，则：

• 如果您使用图形界面或不带 /noreboot 选项的命令行界面，则在安装必备项后，计算机将自动重新启动。
• 如果您使用带 /noreboot 选项的命令行界面，则必须手动启动重新启动。

当您升级 VDA 版本时，升级期间会发生重启。这是无法避免的。

安装或升级失败时恢复

注意：

此功能适用于单会话和多会话 VDA。

如果单会话 VDA 安装或升级失败，并且启用了“失败时恢复”功能，则计算机将恢复到安装或升级开始前设置的还原点。

如果多会话 VDA 安装或升级失败，并且启用了“失败时恢复”功能，则计算机将恢复到安装或升级开始前执行的备份。

当启用此功能启动单会话 VDA 安装或升级时，安装程序会在实际安装或升级开始前创建一个系统还原点。如果 VDA 安装或升级失败，计算机将恢复到还原点状态。%temp%/Citrix 文件夹包含部署日志和有关恢复的其他信息。

当启用此功能启动多会话 VDA 安装或升级时，安装程序会在实际安装或升级开始前创建一个服务器备份。如果 VDA 安装或升级失败，计算机将恢复到备份状态。%temp%/Citrix 文件夹包含部署日志和有关恢复的其他信息。创建服务器备份所需的时间取决于所需的备份大小以及服务器可用的资源量。备份存储在 C:\WindowsImageBackup\servername 中。

默认情况下，此功能处于禁用状态。

如果您计划启用此功能，请确保未通过 GPO 设置 (Computer Configuration > Administrative Templates > System > System Restore) 禁用系统还原。

注意：

此 GPO 设置不适用于恢复多会话 VDA。

要在安装或升级单会话或多会话 VDA 时启用此功能，请执行以下操作：

• 使用 VDA 安装程序的图形界面（例如使用 Autostart 或不带任何还原或静默选项的 XenDesktopVDASetup.exe 命令）时，请在“摘要”页面上选中“如果更新失败，则启用自动还原”复选框。

  如果安装/升级成功完成，则不会使用还原点/备份，但会保留。

• 使用命令行，通过 /enablerestore 或 /enablerestorecleanup 选项运行 VDA 安装程序。

  • 如果使用 /enablerestorecleanup 选项，并且安装/升级成功完成，则还原点/服务器备份将自动删除。

  • 如果使用 /enablerestore 选项，并且安装/升级成功完成，则还原点不会被使用，但会保留。

安装程序

完整产品安装程序

使用 ISO 中提供的完整产品安装程序，您可以执行以下操作：

• 安装、升级或删除核心组件：交付控制器、Studio、Director 和许可证服务器。
• 安装或升级 StoreFront 服务。
• 安装或升级用于单会话或多会话操作系统的 Windows VDA。
• 在您的打印服务器上安装通用打印服务器 UpsServer 组件。
• 安装联合身份验证服务。
• 安装 会话录制。

• 安装 工作区环境管理。

  注意：

  工作区环境管理™ 代理安装程序未本地化。它仅提供英文版本。

要从多会话操作系统为单个用户（例如，用于 Web 开发）交付桌面，请使用完整产品安装程序的命令行界面。有关详细信息，请参阅 Server VDI。

独立 VDA 安装程序

独立 VDA 安装程序可在 Citrix 下载页面上获取。（它们无法从产品安装介质中获取。）独立 VDA 安装程序比完整产品 ISO 小得多。它们更易于适应以下部署：

• 使用已暂存或本地复制的电子软件分发 (ESD) 软件包
• 需要拥有物理机
• 拥有远程办公室

默认情况下，自解压独立 VDA 中的文件会提取到 Temp 文件夹。与使用完整产品安装程序相比，提取到 Temp 文件夹时，计算机上需要更多的磁盘空间。但是，提取到 Temp 文件夹的文件在安装完成后会自动删除。或者，您可以使用带绝对路径的 /extract 命令。

有三个独立 VDA 安装程序可供下载。

VDAServerSetup.exe:

安装适用于多会话操作系统的 VDA。它支持完整产品安装程序提供的所有适用于多会话操作系统的 VDA 选项。

VDAWorkstationSetup.exe:

安装适用于单会话操作系统的 VDA。它支持完整产品安装程序提供的所有适用于单会话操作系统的 VDA 选项。

VDAWorkstationCoreSetup.exe:

安装适用于单会话操作系统的 VDA，该 VDA 针对远程电脑访问部署或核心 VDI 安装进行了优化。远程电脑访问使用物理机。核心 VDI 安装是未用作映像的 VM。它仅安装此类部署的 VDA 连接所需的核心服务。因此，它仅支持完整产品或 VDAWorkstationSetup.exe 安装程序有效选项的子集。

此安装程序不安装或不包含用于以下目的的组件：

• App-V.
• 配置文件管理。在安装中排除 Citrix 配置文件管理会影响 Citrix Director 显示。有关详细信息，请参阅 安装 VDA。
• 计算机身份服务。
• Citrix 可支持性工具。
• 适用于 Windows 操作系统的 Citrix 文件。
• 适用于 Outlook 电子邮件客户端的 Citrix 文件。

VDAWorkstationCoreSetup.exe 安装程序不安装或不包含适用于 Windows 的 Citrix Workspace 应用程序。

使用 VDAWorkstationCoreSetup.exe 等同于使用完整产品或 VDAWorkstationSetup 安装程序安装单会话操作系统 VDA，并且满足以下任一条件：

• 在图形界面中：在环境页面上选择远程电脑访问选项。
• 在命令行界面中：指定 /remotepc 选项。
• 在命令行界面中：指定 /components vda 以及 /exclude 选项，该选项列出了所有有效的附加组件名称。

您可以通过运行完整产品安装程序稍后安装省略的组件/功能。此操作使您能够安装所有缺失的组件。

VDAWorkstationCoreSetup.exe 安装程序会自动安装浏览器内容重定向 MSI。此自动安装适用于 VDA 2003 及更高版本支持的版本。

Citrix 安装返回代码

安装日志包含组件安装的结果，作为 Citrix 返回代码，而不是 Microsoft 值。

• 0 = 成功
• 1 = 失败
• 2 = 部分成功
• 3 = 部分成功且需要重新启动
• 4 = 失败且需要重新启动
• 5 = 用户取消
• 6 = 命令行参数错误
• 7 = 发现新版本
• 8 = 成功但需要重新启动
• 9 = 文件锁定需要重新启动
• 10 = 已中止
• 11 = 介质失败
• 12 = 许可证失败
• 13 = 预检失败
• 14 = 中止，待处理重新启动检查

例如，当使用 Microsoft System Center Configuration Manager 等工具时，如果安装日志包含返回代码 3，则脚本化的 VDA 安装可能会显示失败。这可能发生在 VDA 安装程序正在等待您必须启动的重新启动时（例如，在服务器上安装 RDS 角色先决条件之后）。VDA 安装仅在所有先决条件和选定组件都已安装并且机器在安装后重新启动时才被视为成功。

或者，您可以将安装包装在 CMD 脚本中（这些脚本返回 Microsoft 退出代码），或者更改 Configuration Manager 包中的成功代码。

为 Windows 服务器工作负载配置微软远程桌面服务许可证服务器

此产品在交付 Windows Server 工作负载（例如 Windows 2016）时访问 Windows Server 远程会话功能。这通常需要远程桌面服务客户端访问许可证 (RDS CAL)。VDA 必须能够联系 RDS 许可证服务器以请求 RDS CAL。安装并激活许可证服务器。有关详细信息，请参阅 Microsoft 文档 激活远程桌面服务许可证服务器。对于概念验证环境，您可以使用 Microsoft 提供的宽限期。

通过此方法，您可以让此服务应用许可证服务器设置。您可以在映像上的 RDS 控制台中配置许可证服务器和每用户模式。您还可以使用 Microsoft 组策略设置配置许可证服务器。有关详细信息，请参阅 Microsoft 文档 使用客户端访问许可证 (CAL) 许可您的 RDS 部署。

要使用组策略设置配置 RDS 许可证服务器，请执行以下操作：

1. 在可用计算机上安装远程桌面服务许可证服务器。该计算机必须始终可用。Citrix 产品工作负载必须能够访问此许可证服务器。
2. 使用 Microsoft 组策略指定许可证服务器地址和每用户许可证模式。有关详细信息，请参阅 Microsoft 文档 为 RD 会话主机服务器指定远程桌面许可模式。

Windows 10 工作负载需要适当的 Windows 10 许可证激活。我们建议您遵循 Microsoft 文档来激活 Windows 10 工作负载。

更多信息

要为特定主机类型设置资源位置：

• AWS 云环境
• 基于 XenServer 的虚拟化环境
• 谷歌云环境
• 微软 Azure 资源管理器云环境
• 微软系统中心配置管理器环境
• 微软系统中心虚拟机管理器虚拟化环境
• 能腾虚拟化环境
• Nutanix 云和合作伙伴解决方案
• VMware 虚拟化环境
• VMware 云和合作伙伴解决方案