注意：

传统上用于激活各种本地组件的基于文件的许可系统将于 2026 年 4 月 15 日终止生命周期 (EOL)。许可证激活服务 (LAS) 是用于激活 Citrix 产品套件中产品的下一代技术。2026 年 4 月 15 日之后，LAS 将是激活和许可 Citrix 本地组件的唯一方式。为了获得支持，您的 Citrix Virtual Apps and Desktops 部署必须是与 LAS 兼容的版本。与 LAS 兼容的最低所需 CVAD 版本为：

• CVAD 2203 长期服务版本 累积更新 7
• CVAD 2402 长期服务版本 累积更新 3
• CVAD 2507 长期服务版本
• CVAD 2411

如果您有任何疑问或疑虑，请联系客户服务。如果未能遵守这些要求，Citrix 可能会限制或暂停您的 Citrix Maintenance，且不承担任何责任，此外，Citrix 还可能依法或衡平法采取其他补救措施。在法律或法规禁止的情况下，这些要求不适用。

本节介绍

注意：

本文介绍涉及 Web Studio 的部署升级。有关涉及 Citrix Studio 的升级信息，请参阅 Citrix Virtual Apps and Desktops™ 7 2212 或更早版本中的相应文章。

您可以将某些部署升级到更新版本，而无需首先设置新计算机或站点。这称为就地升级。

要了解可以升级哪些 Citrix Virtual Apps and Desktops 版本，请参阅可升级的版本。

在升级到任何 Citrix Virtual Apps and Desktops 版本之前，请确保您当前的客户成功服务日期有效且未过期。有关详细信息，请参阅客户成功服务续订许可证文章。

要开始升级，请运行新版本中的安装程序以升级以前安装的核心组件、VDA 和某些其他组件。然后升级数据库和站点。

您可以升级任何可以使用完整产品安装程序（以及独立 VDA 安装程序）安装的组件，前提是提供了更新版本。对于不使用完整产品安装程序安装的其他组件（例如 Citrix Provisioning™ 和 Profile Management），请参阅该组件的文档以获取指导。有关主机升级，请参阅相应的文档。

在开始升级之前，请查看本文中的所有信息。

升级顺序

下图显示了升级顺序的步骤。升级过程 包含图中每个步骤的详细信息。

注意：

为避免故障，您必须在执行任何与预配和交付组相关的任务（例如创建新计算机目录、删除计算机目录、更新交付组中的计算机等）之前，升级所有 Delivery Controller 和数据库。

混合权利许可证

混合权利许可证是基于期限的订阅许可证，当客户从永久许可证过渡或升级到云服务订阅时，除了云服务订阅之外，还会提供此类许可证。您还可以随 DaaS 订阅购买混合权利附加组件。

如果您拥有具有 SaaS 属性的混合权利许可证，则在升级到 Citrix Virtual Apps and Desktops LTSR 2203 及更高版本时，您将有资格访问 Citrix Virtual Apps and Desktops LTSR 1912 不具备的功能。这些功能包括在公共云（例如 Microsoft Azure、AWS EC2 和 Google Cloud）中预配和托管工作负载。在部署新的许可证文件之前，请将您的许可证服务器更新到最新版本。

如果您拥有不带 SaaS 属性的混合权利许可证，请按照以下步骤获取带 SaaS 属性的新混合权利许可证：

注意：

• 您将收到一封包含新许可证代码的电子邮件。有关详细信息，请参阅使用许可证访问代码。
• 您现有的许可证将被撤销。撤销的许可证必须从许可证服务器中删除，然后才能安装新许可证。有关详细信息，请参阅删除许可证文件。

1. 转到 citrix.com 管理许可证门户，下载已启用云预配权限（SaaS 属性）的新混合权利许可证文件。有关详细信息，请参阅下载许可证。下图显示了“增量”部分中具有 SaaS 属性的混合权利许可证文件。

   

2. 在许可证服务器上安装混合权利许可证文件。有关详细信息，请参阅安装许可证。
3. 如果许可证版本或模型发生更改，请确保运行代理命令来设置版本和模型，然后开始就地升级。有关代理命令的详细信息，请参阅Broker PowerShell SDK部分。

有关 Citrix Virtual Apps and Desktops 当前版本和长期服务版本对公共云支持的详细信息，请参阅 CTX270373。

升级操作步骤

大多数主要产品组件都可以通过在包含该组件的计算机上运行产品安装程序进行升级。

如果一台计算机包含多个组件（例如 Studio 和许可证服务器），并且产品介质包含其软件的较新版本，则该计算机上的所有组件都将升级。

要使用安装程序：

• 要运行完整产品安装程序的图形界面，请登录到计算机，然后插入介质或装载新版本的 ISO 驱动器。双击 AutoSelect。
• 要使用命令行界面，请发出相应的命令。请参阅使用命令行安装。

步骤 1：准备

在开始升级之前，请确保您已做好准备。阅读并完成所有必要的任务：

• 删除 PVD、AppDisks™ 和不受支持的主机
• 具有个人虚拟磁盘或应用程序磁盘组件的 VDA
• 限制
• 混合环境注意事项
• 早期操作系统
• 准备工作
• 初步站点测试
• SQL Server 数据库版本检查

步骤 2：升级许可证服务器

如果安装包含新版本的 Citrix 许可证服务器软件，请先升级此组件，然后再升级任何其他组件。

如果您尚未确定您的许可证服务器是否与新版本兼容，则必须在升级任何其他核心组件之前，在许可证服务器上运行安装程序。

步骤 3: 升级店面™

如果安装介质包含新版本的 StoreFront 软件，请在包含 StoreFront 服务器的计算机上运行安装程序。

• 在图形界面中，从“扩展部署”部分选择“Citrix StoreFront”。
• 从命令行运行 CitrixStoreFront-x64.exe，该文件位于 Citrix Virtual Apps and Desktops 安装介质的 x64 文件夹中。

步骤 4: 升级导向器

如果安装介质包含新版本的 Director 软件，请在包含 Director 的计算机上运行安装程序。

步骤 5: 升级 思杰预配

思杰预配安装介质与思杰虚拟应用和桌面安装介质是分开提供的。要了解如何安装和升级思杰预配服务器和目标设备软件，请参阅思杰预配产品文档。

步骤 6：升级一半的交付控制器

例如，如果您的站点有四个 Controller，请在其中两个上运行安装程序。

保持一半的 Controller 处于活动状态可让用户访问站点。VDA 可以向其余 Controller 注册。有时，由于可用的 Controller 较少，站点的容量可能会降低。升级仅在最终数据库升级步骤中导致建立新客户端连接的短暂中断。在整个站点升级完成之前，已升级的 Controller 无法处理请求。

如果您的站点只有一个 Controller，则在升级期间它将无法运行。

实际升级开始之前，将在第一个 Controller 上运行初步站点测试。有关详细信息，请参阅 初步站点测试。

步骤 7：升级 Studio

如果您尚未升级 Web Studio（因为它与另一个组件位于同一台计算机上），请在包含 Studio 的计算机上运行安装程序。

注意：

升级 Web Studio 后，版本信息可能不会立即更新。即使 Web Studio 已是最新版本，系统也可能会提示您升级。要解决此问题，请转到 Web Studio 服务器，打开 Internet 信息服务 (IIS) 管理器，导航到 起始页 > 站点 > 默认网站，然后在 管理网站 窗格中选择 重新启动。

步骤 8：重新启动 Studio

重新启动已升级的 Web Studio。升级过程将自动恢复。

步骤 9：升级数据库和站点

注意：

为避免故障，您必须在执行任何与预配和交付组相关的任务（例如创建新计算机目录、删除计算机目录、更新交付组中的计算机等）之前升级所有 Delivery Controller 和数据库。

检查 准备工作 以了解更新 SQL Server 数据库架构所需的权限。

• 如果您有足够的权限更新 SQL Server 数据库架构，则可以启动自动数据库升级。继续执行 自动升级数据库和站点。
• 如果您没有足够的数据库权限，则可以启动使用脚本的手动升级，并在数据库管理员（拥有所需权限的人员）的帮助下进行。对于手动升级，Studio 用户生成脚本，然后运行启用和禁用服务的脚本。数据库管理员使用 SQLCMD 实用程序或 SQL Server Management Studio 的 SQLCMD 模式运行其他更新数据库架构的脚本。继续执行 手动升级数据库和站点。
• 如果您有多区域部署并希望自动升级数据库和站点，Citrix 建议 dbschema 升级必须在托管站点 SQL Server 数据库的同一区域中执行。否则，自动升级数据库和站点可能会失败。

Citrix 强烈建议您在升级前备份数据库。请参阅 CTX135207。在数据库升级期间，产品服务将被禁用。在此期间，控制器无法为站点代理新连接，因此请仔细规划。

自动执行数据库和站点升级

1. 启动新升级的 Studio。
2. 指定您希望自动启动站点升级，并确认您已准备就绪。

数据库和站点升级正在进行中。

手动升级数据库和站点

1. 启动新升级的 Studio。
2. 请指明您希望手动升级站点。向导将检查许可证服务器的兼容性，并请求您进行确认。

3. 确认您已完成数据库备份。

   向导会生成并显示脚本以及升级步骤清单。如果数据库的架构自升级的产品版本以来没有更改，则不会生成该脚本。例如，如果日志记录数据库架构没有更改，则不会生成 UpgradeLoggingDatabase.sql 脚本。

4. 按所示顺序运行以下脚本。

   • DisableServices.ps1：Studio 用户在控制器上运行此 PowerShell 脚本以禁用产品服务。
   • UpgradeSiteDatabase.sql：数据库管理员在包含站点数据库的服务器上运行此 SQL 脚本。
   • UpgradeMonitorDatabase.sql：数据库管理员在包含监视数据库的服务器上运行此 SQL 脚本。
   • UpgradeLoggingDatabase.sql：数据库管理员在包含配置日志记录数据库的服务器上运行此 SQL 脚本。仅当此数据库发生更改时（例如，应用修补程序后）才运行此脚本。
   • EnableServices.ps1：Studio 用户在控制器上运行此 PowerShell 脚本以启用产品服务。

   数据库升级完成且产品服务启用后，Studio 会自动测试环境和配置，然后生成 HTML 报告。如果发现问题，可以还原数据库备份。解决问题后，可以再次升级数据库。

5. 完成清单任务后，单击“完成升级”。

步骤 10：升级剩余的交付控制器

在新升级的 Studio 中，在导航窗格中选择 Citrix Studio site-name。在“常见任务”选项卡上，选择“升级剩余的 Delivery Controller”。

注意：

要使“升级剩余的 Delivery Controller”可用，请为该站点创建至少一个计算机目录和一个交付组。

完成升级并确认完成后，关闭并重新打开 Studio。Studio 可能会提示进行额外的站点升级，以将 Controller 的服务注册到站点，或者在不存在区域 ID 的情况下创建区域 ID。

步骤 11：升级 VDA

重要：

如果要将 VDA 升级到版本 1912 或更高版本，请参阅将 VDA 升级到 1912 或更高版本。

在包含 VDA 的计算机上运行产品安装程序。

如果您使用 Machine Creation Services™ 和主映像创建了计算机，请转到您的主机并升级主映像上的 VDA。您可以使用任何可用的 VDA 安装程序。

• 有关图形界面指导，请参阅安装 VDA。
• 有关命令行指导，请参阅使用命令行安装。

如果您使用 Citrix Provisioning 创建了计算机，请参阅Citrix Provisioning 产品文档 以获取有关升级的指导。

步骤 12：更新计算机目录和交付组

• 更新使用已升级 VDA 的计算机的目录。
• 升级使用已升级 VDA 的计算机的目录。
• 升级使用已升级 VDA 的计算机的交付组。

步骤 13：升级后

升级部署中的其他组件。有关指导，请参阅以下产品文档：

• 应用商店前端
• 应用程序DNA
• Citrix 应用程序分层
• HDX 实时优化包
• 配置文件管理
• 思杰预配
• 会话录制
• 工作区环境管理

如果您需要将 微软 SQL Server Express 本地数据库 软件替换为更高版本，请参阅替换 微软 SQL Server Express 本地数据库。

数据库架构升级

当您更新部署时，可能会有多个数据库架构需要升级。以下表格详细列出了在此升级过程中会涉及到的数据库架构：

术语定义：

• 站点：站点数据存储。数据库架构更新应用于站点数据存储。
• 监视器：监视器数据存储。数据库架构更新应用于监视器数据存储。
• 配置：配置表。Desktop Studio 版本、许可信息或两者都在配置表中更新。
• 日志记录：日志记录数据存储。数据库架构更新应用于日志记录数据存储。

将 VDA 升级到 2203 或更高版本

如果 VDA 上曾安装过 Personal vDisk (PvD) 组件，则该 VDA 无法升级到 2203 或更高版本。要使用新的 VDA，您必须卸载当前 VDA，然后安装新的 VDA。

此说明适用，即使您从未使用过 PvD。

以下是 PvD 组件在早期版本中可能已安装的方式：

• 在 VDA 安装程序的图形界面中，PvD 是“附加组件”页面上的一个选项。
• 在命令行中，/baseimage 选项安装了 PvD。如果您指定了此选项，或使用了包含此选项的脚本，则 PvD 已安装。

如果您不确定您的 VDA 是否安装了 PvD，请在该机器或映像上运行新 VDA（2203 或更高版本）的安装程序。

• 如果安装了 PvD，则会出现一条消息，指示存在不兼容的组件。
  • 在图形界面中，单击包含该消息的页面上的“取消”，然后确认要关闭安装程序。
  • 在 CLI 中，命令会直接失败并显示该消息。
• 如果未安装 PvD，则升级将继续。

操作方法

如果 VDA 未安装 PvD，请按照常规升级过程进行操作。

如果 VDA 已安装 PvD：

1. 卸载当前 VDA。
2. 安装新的 VDA。

如果您希望在 Windows 10（1607 及更早版本，未更新）计算机上继续使用 PvD，则 VDA 7.15 LTSR 是受支持的最新版本。

注意：

我能否在 XenApp 和 XenDesktop 7.15 LTSR 版本中，将个人虚拟磁盘与 Windows 7 桌面操作系统配合使用？

Citrix 于 2016 年 1 月宣布将 Personal vDisk (PvD) 从 XenApp and XenDesktop 7.6 LTSR 中排除。此外，Citrix 已宣布弃用 PvD 技术，并建议客户今后开始使用 Citrix App Layering。Citrix App Layering（版本 4.4 及更高版本）是 XenApp and XenDesktop 7.15 LTSR 的兼容组件。但是，为了帮助现有 Windows 7 上的 PvD 部署客户迁移到 Citrix App Layering 技术，Citrix 已决定通过 XenApp and XenDesktop 7.15 LTSR 累积更新 (CU) 为 Windows 7 桌面的 PvD 部署提供限时支持，直至 2020 年 1 月 14 日。PvD 组件将从 LTSR CU 中删除，并且在 2020 年 1 月 14 日之后将不再受支持。此外，在 2020 年 1 月 14 日之后将 PvD 用于 Windows 7 将导致 LTSR 站点不合规。此外，适用于 Windows 10 的 PvD 仍被排除在 7.15 LTSR 之外。因此，客户不得将其与 7.15 LTSR 站点一起使用。

删除 PvD、AppDisks 和不受支持的主机

在思杰虚拟应用和桌面 7 当前版本部署中，以下技术和主机类型不受支持：

• Personal vDisks (PvD)，用于在目录中存储用户虚拟机旁的数据。用户个性化层功能现在处理用户持久性。
• AppDisks，用于管理交付组中使用的应用程序。
• 主机类型： Azure 经典版、云平台（原始思杰产品）。
  • 有关此版本中支持的主机类型，请参阅 系统要求。
  • 有关继续使用 ARM 和 AWS 的替代方法的信息，请参阅 CTX270373。

如果您当前的部署使用 PvD 或 AppDisks，或者连接到不受支持的主机类型（例如 Microsoft Azure Classic），则只有在删除使用这些技术的项目后，才能升级到版本 2006（或更高版本支持的版本）。如果您当前的部署使用公共云主机连接（例如 AWS），请确保在升级前拥有混合权利许可证。当安装程序检测到一个或多个不受支持的技术或没有混合权利许可证的主机连接时，升级将暂停或停止，并显示一条解释性消息。安装程序日志中包含详细信息。

为确保成功升级，请查看并遵循适用的指导以删除不受支持的项目。

• 删除个人虚拟磁盘
• 删除应用程序磁盘
• 删除不受支持的主机项目

即使您在部署中没有使用 PvD 或 AppDisks，相关的 MSI 也可能已包含在较早的 VDA 安装或升级中。在将 VDA 升级到版本 2006（或更高支持版本）之前，您必须删除该软件，即使您从未使用过它。使用图形界面时，可以为您完成删除操作，或者在使用 CLI 时可以包含删除选项。有关详细信息，请参阅 升级具有 PvD 或 AppDisks 组件的 VDA。

删除 PvD

在您删除所有配置为使用 PvD 的计算机之前，部署升级无法成功。这会影响目录和交付组。

从组和目录中删除 PvD：

1. 在 Studio 中，如果交付组包含使用 PvD 的目录中的计算机，请 从组中删除这些计算机。
2. 在 Studio 中，删除所有包含使用 PvD 的计算机的目录。

VDA 升级： 部署升级不会检测 VDA 是否安装了 AppDisk 或 PvD 组件。但是，VDA 安装程序会检测。有关详细信息，请参阅 具有 PvD 或 AppDisks 组件的 VDA。

如果您计划使用 App Layering 而不是 PvD，请参阅 将 PvD 迁移到 App Layering 以获取有关数据迁移的信息。

移除应用磁盘

在您从所有使用 AppDisks 的交付组中删除 AppDisks，然后删除 AppDisks 本身之前，部署升级无法进行。

1. 在 Studio 导航窗格中选择 交付组。
2. 选择一个组，然后在“操作”窗格中单击 管理 AppDisks。
3. 单击从组中删除 AppDisk 的操作。
4. 对每个使用 AppDisks 的交付组重复步骤 2 和 3。
5. 在 Studio 导航窗格中选择 应用磁盘。
6. 选择一个 AppDisk，然后单击删除该 AppDisk 的操作。
7. 对每个 AppDisk 重复步骤 5 和 6。

VDA 升级： 部署升级不会检测 VDA 是否安装了 AppDisk 或 PvD 组件。但是，VDA 安装程序会检测。有关详细信息，请参阅 具有 PvD 或 AppDisks 组件的 VDA。

删除不受支持的主机项

如果站点连接到不受支持的主机类型（例如 Citrix CloudPlatform 或 Microsoft Azure Classic），则无法将部署升级到版本 2006（或更高受支持版本）。请在尝试升级之前完成以下任务。

在 Studio 中执行以下操作：

• 删除所有连接 到不受支持的主机。
• 如果交付组包含使用不受支持的主机中的主映像创建的目录中的计算机，请将这些计算机从组中删除。
• 删除所有目录，这些目录是使用不受支持的主机中的主映像创建的。

具有个人虚拟磁盘或应用程序磁盘组件的 VDA

如果 VDA 上安装了启用 PvD 和 AppDisks 技术所需的组件，则在删除这些组件之前无法升级该 VDA。

注意：

升级到版本 1912 时，您必须卸载当前 VDA，然后安装新的 VDA。在此版本中，系统会询问您是否希望 Citrix 删除该组件，然后继续升级。

AppDisk 和 PvD 组件可能已在早期 VDA 版本中安装，即使您从未使用过这些技术：

• 图形界面：在 VDA 安装程序中，“附加组件”页面包含“Citrix AppDisk / Personal vDisk”选项。7.15 LTSR 和更早的 7.x 版本默认启用此选项。因此，如果您接受了默认设置（或在任何提供此选项的版本中明确启用了此选项），则会安装该组件。
• CLI：指定 /baseimage 选项安装了该组件。

操作方法

如果 VDA 安装程序未在当前安装的 VDA 中检测到 AppDisks 或 PvD 组件，则升级照常进行。

如果安装程序在当前安装的 VDA 中检测到 AppDisks 或 PvD 组件：

• 图形界面：升级暂停。系统会显示一条消息，询问您是否要自动删除不受支持的组件。如果您单击 确定，则组件将自动删除，升级将继续进行。

• CLI：为避免命令失败，请在命令中包含以下选项：

  • /remove_appdisk_ack
  • /remove_pvd_ack

限制条件

以下列出了适用于升级的限制条件：

• 选择性组件安装： 如果您将任何组件安装或升级到新版本，但选择不升级需要升级的其他组件（在不同的计算机上），Studio 会提醒您。例如，假设升级包括新版本的 Controller 和 Studio。您升级了 Controller，但未在安装 Studio 的计算机上运行安装程序。Studio 将不允许您继续管理站点，直到您升级 Studio。

  您不必升级 VDA，但 Citrix 建议升级所有 VDA，以便您可以使用所有可用功能。

• 早期版本或技术预览版： 您无法从早期版本、技术预览版或预览版进行升级。

• 早期操作系统上的组件： 您无法在 Microsoft 或 Citrix 不再支持的操作系统上安装当前 VDA。有关详细信息，请参阅早期操作系统。

• 混合环境/站点： 如果您必须继续运行早期版本站点和当前版本站点，请参阅混合环境注意事项。

• 产品选择： 从早期版本升级时，您无需选择或指定在安装期间设置的产品 (Citrix Virtual Apps 或 Citrix Virtual Apps and Desktops)。

混合环境注意事项

升级时，Citrix 建议您升级所有组件和 VDA，以便您可以使用版本中的所有新增和增强功能。

例如，尽管您可以在包含早期 Controller 版本的部署中使用当前 VDA，但当前版本中的新功能可能不可用。使用非当前版本时，还可能出现 VDA 注册问题。

在某些环境中，您可能无法将所有 VDA 升级到最新版本。在这种情况下，创建计算机目录时，您可以指定计算机上安装的 VDA 版本。(这称为功能级别。) 默认情况下，此设置指定建议的最低 VDA 版本。默认值足以满足大多数部署的需求。仅当目录包含早于默认版本的 VDA 时，才考虑将设置更改为早期版本。不建议在计算机目录中混合使用 VDA 版本。

如果目录是使用默认的最低 VDA 版本设置创建的，并且一台或多台计算机的 VDA 版本早于默认版本，则这些计算机无法向 Controller 注册，并且将无法工作。

有关详细信息，请参阅 VDA 版本和功能级别。

具有不同版本的多个站点

当您的环境包含具有不同产品版本的站点时（例如，XenDesktop 7.18 站点和 Citrix Virtual Apps and Desktops 1909 站点），Citrix 建议使用 StoreFront 聚合来自不同产品版本的应用程序和桌面。有关详细信息，请参阅 StoreFront 文档。

在混合环境中，请继续使用每个版本的 Studio 和 Director，但请确保将不同版本安装在单独的计算机上。

较早的操作系统

假设您在运行受支持的操作系统 (OS) 版本的计算机上安装了某个组件的早期版本。现在，您想使用较新的组件版本，但该操作系统不再受当前组件版本的支持。

例如，假设您在 Windows Server 2016 计算机上安装了服务器 VDA。现在您想将该 VDA 升级到当前版本，但您要升级到的当前版本不支持 Windows Server 2016。

如果您尝试在不再允许的操作系统上安装或升级组件，则会显示错误消息，例如“无法安装在此操作系统上”。

这些注意事项适用于升级当前版本和长期服务版本。(这不影响将 CU 应用于 LTSR 版本。)

请点击以下链接了解支持的操作系统：

• Citrix 虚拟应用和桌面（当前版本）：
  • 交付控制器、Studio、Director、VDA、通用打印服务器
  • 联合身份验证服务
  • 有关 StoreFront、自助密码重置 和 会话录制，请参阅当前版本的系统要求文章。
• 对于 LTSR，请参阅您的 LTSR 版本和 CU 的组件列表。（从主要的 Citrix Virtual Apps and Desktops 产品文档页面中选择您的 LTSR 版本。）

无效的操作系统

下表列出了当前版本中不适用于安装/升级组件的早期操作系统。它指出了每个列出的操作系统支持的最新有效组件版本，以及安装和升级变得无效时的组件版本。

表中的操作系统包括 Service Pack 和更新。

操作系统	组件/功能	最新有效版本	从该版本起无法安装/升级
微软视窗 7 和 微软视窗 8	VDA	7.15 长期服务版本	7.16
微软视窗 7 和 微软视窗 8	其他安装程序组件	7.17	7.18
早于 1607 版本的 Windows 10	VDA	7.15 长期服务版本	7.16
Windows 10 x86 架构的操作系统版本	VDA	1906.2.0	1909
Windows 服务器 2008 R2 服务器操作系统	VDA	7.15 长期服务版本	7.16
微软视窗服务器 2008 R2	其他安装程序组件	7.17	7.18
Windows Server 2012	VDA	7.15 长期服务版本	7.16
视窗服务器 2012	其他安装程序组件	7.17	7.18
视窗服务器 2012 R2	其他安装程序组件 *	1912 长期服务版本	2003
视窗服务器 2012 R2 版本	服务器 VDI	7.15 长期服务版本	7.16
视窗服务器 2016	服务器 VDI	7.15 长期服务版本	7.16

Windows XP 和 Windows Vista 不适用于任何 7.x 版本的组件或相关技术。

* 适用于交付控制器、站点管理、监控器和虚拟投递代理。

您可以执行的操作

您有以下选择：

• 继续使用当前操作系统
• 重新映像或升级计算机
• 添加新计算机，然后移除旧计算机

继续使用当前操作系统

这些方法适用于 VDA。如果您想继续使用较早操作系统的计算机，可以选择以下任一方法：

• 继续使用已安装的组件版本。
• 下载最新的有效组件版本，然后将组件升级到该版本。（这假设尚未安装最新的有效组件版本。）

例如，您的 Windows 7 SP1 计算机上有一个 7.14 VDA。Windows 7 操作系统计算机上最新的有效 VDA 版本是 XenApp and XenDesktop 7.15 LTSR。您可以继续使用 7.14，也可以下载 7.15 LTSR VDA，然后将您的 VDA 升级到该版本。这些较早的 VDA 版本可在包含较新版本交付控制器的部署中运行。例如，7.15 LTSR VDA 可以连接到 Citrix Virtual Apps and Desktops 7 1808 Controller。

重新映像或升级计算机

这些方法适用于 VDA 和未安装核心组件（例如 Delivery Controller）的其他计算机。请选择以下任一方法：

• 将计算机停止服务（开启维护模式并允许所有会话关闭）后，您可以将其重新映像到受支持的 Windows 操作系统版本，然后安装最新版本的组件。
• 要在不重新映像的情况下升级 VDA 计算机中的操作系统，您必须首先安装您要升级到的操作系统所支持的 VDA 版本，或者在升级操作系统后升级 VDA。否则，Citrix 软件将不受支持。在不卸载 VDA 的情况下执行就地升级时，您可以升级到以下最低操作系统版本：
  • 安装了 2023 年 7 月适用于 Windows 11 的累积更新 (KB5028185) 或更高版本的 Windows 11（内部版本 22621.1992 或更高版本）。
  • 安装了 2023 年 7 月适用于 Windows 10 的动态更新 (KB5028311) 的 Windows 10。
• 如果您计划升级到的 Windows 版本与上述指南不符，则必须在升级操作系统之前卸载 VDA，然后在操作系统升级完成后安装受支持的 VDA 版本。

添加新计算机，然后移除旧计算机

如果必须在包含 Delivery Controller™ 或其他核心组件的计算机上升级操作系统，此方法是可行的。

Citrix 建议站点中的所有控制器都使用相同的操作系统。以下升级顺序可最大程度地缩短不同控制器使用不同操作系统的时间间隔。

1. 对站点中的所有 Delivery Controller 进行快照，然后备份站点数据库。
2. 在安装了受支持操作系统的全新服务器上安装新的 Delivery Controller。
3. 将新控制器添加到站点。
4. 移除在当前版本不支持的操作系统上运行的控制器。请遵循 Delivery Controllers 中有关移除控制器的建议。

准备工作

在开始升级之前，请查看以下信息并完成必要的任务。

注意：

尽管 VDA 升级在 升级顺序 中发生得较晚，但最好在开始升级之前选择安装程序并查看过程，以便您了解预期结果。

选择安装程序和界面

使用产品 ISO 中的完整产品安装程序升级组件。您可以使用完整产品安装程序或其中一个独立 VDA 安装程序升级 VDA。所有安装程序都提供图形界面和命令行界面。

有关详细信息，请参阅 安装程序。

安装详情： 完成所有准备工作并准备好启动安装程序后，安装文章将向您展示您将看到的内容（如果您使用的是图形界面）或要键入的内容（如果您使用的是命令行界面）。

• 使用图形界面安装/升级核心组件
• 使用命令行安装/升级核心组件
• 使用图形界面安装/升级 VDA
• 使用命令行安装/升级 VDA

如果您最初使用 VDAWorkstationCoreSetup.exe 安装程序安装了单会话 VDA，Citrix 建议使用该安装程序进行升级。如果您使用完整产品 VDA 安装程序或 VDAWorkstationSetup.exe 安装程序升级 VDA，则除非您明确从升级中省略/排除它们，否则最初排除的组件可能会被安装。

将 VDA 升级到当前版本时，升级过程中会发生计算机重新启动。（此要求始于 7.17 版本。）这是无法避免的。重新启动后，升级会自动恢复（除非您在命令行中指定 /noresume）。

数据库操作

备份站点、监视和配置日志记录数据库。请遵循 CTX135207 中的说明。如果在升级后发现任何问题，可以还原备份。

有关升级不再受支持的 SQL Server 版本的信息，请参阅 SQL Server 版本检查。（这指的是用于站点、监视和配置日志记录数据库的 SQL Server。）

Microsoft SQL Server Express LocalDB 会自动安装，用于本地主机缓存。如果您需要替换早期版本，新版本必须是 SQL Server Express LocalDB 2019。有关在升级组件和站点后用新版本替换此数据库的详细信息，请参阅 替换 SQL Server Express LocalDB。

确保您的 Citrix 许可为最新版本

有关管理 Citrix 许可的全面信息，请参阅 激活、升级和管理 Citrix 许可证。

您可以使用完整产品安装程序升级许可证服务器。或者，您可以单独下载和升级许可证组件。请参阅 升级。

在升级之前，请确保您的客户成功服务/软件维护/订阅权益日期对新产品版本有效。该日期必须至少为 2021.11.15。

确保您的 Citrix 许可证服务器兼容

确保您的 Citrix 许可证服务器与新版本兼容。有两种方法可以实现此目的：

• 在升级任何其他 Citrix 组件之前，请在包含 Delivery Controller 的计算机上从 ISO 布局运行 XenDesktopServerSetup.exe 安装程序。如果存在任何不兼容问题，安装程序将报告并提供建议的解决步骤。

• 从安装介质上的 XenDesktop Setup 目录运行命令：.\LicServVerify.exe -h <license-server-fqdn> -p 27000 -v。显示屏将指示许可证服务器是否兼容。如果许可证服务器不兼容，请升级许可证服务器。

备份所有 StoreFront 的修改

在开始升级之前，如果您修改了 C:\inetpub\wwwroot\Citrix\<StoreName>\App_Data 中的文件（例如 default.ica 和 usernamepassword.tfrm），请为每个存储备份这些文件。升级后，您可以恢复它们以重新应用您的修改。

关闭应用程序和控制台

在开始升级之前，请关闭所有可能导致文件锁定的程序，包括管理控制台和 PowerShell 会话。

重新启动计算机可确保清除所有文件锁定，并且没有待处理的 Windows 更新。

在开始升级之前，请停止并禁用所有第三方监控代理服务。

确保您拥有适当的权限

除了作为域用户，您还必须是正在升级产品组件的计算机上的本地管理员。

站点数据库和站点可以自动或手动升级。对于自动数据库升级，Studio 用户的权限必须包括更新 SQL Server 数据库架构的能力（例如，db_securityadmin 或 db_owner 数据库角色）。有关详细信息，请参阅数据库。

如果 Studio 用户没有这些权限，则启动手动数据库升级会生成脚本。Studio 用户从 Studio 运行部分脚本。数据库管理员使用 SQL Server Management Studio 等工具运行其他脚本。

其他准备任务

• 备份模板并升级虚拟机管理程序（如果需要）。
• 完成业务连续性计划中规定的任何其他准备任务。

站点初步测试

升级 Delivery Controller 和站点时，在实际升级开始之前会运行站点初步测试。这些测试会验证：

• 站点数据库可以访问并且已经完成备份
• 与基本 Citrix 服务的连接正常工作
• Citrix 许可证服务器地址可用
• 配置日志数据库可以正常访问
• 如果要添加公共云主机连接（例如 AWS），请确保您拥有混合权利许可证。否则，站点初步测试将暂停或停止，并显示一条解释性消息。

测试运行后，您可以查看结果报告。然后，您可以修复检测到的任何问题，并再次运行测试。未能运行站点初步测试并解决任何问题可能会影响站点的运行方式。

包含测试结果的报告是一个 HTML 文件 (PreliminarySiteTestResult.html)，位于与安装日志相同的目录中。如果该文件不存在，则会创建该文件。如果该文件存在，则其内容将被覆盖。

运行测试

• 当您使用安装程序的图形界面进行升级时，向导会包含一个页面，您可以在其中启动测试并显示报告。测试运行后，查看报告并解决发现的任何问题后，您可以重新运行测试。测试成功完成后，单击“下一步”继续向导。
• 当您使用命令行界面进行升级时，测试会自动运行。默认情况下，如果测试失败，则不执行升级。查看报告并解决问题后，重新运行命令。

Citrix 建议始终运行站点初步测试，并在继续 Controller 和站点升级之前解决任何问题。运行测试所花费的短暂时间带来的潜在好处是值得的。但是，您可以覆盖此建议操作。

• 当您使用图形界面进行升级时，可以选择跳过这些测试并继续执行升级操作。
• 从命令行升级时，您无法跳过测试。默认情况下，站点测试失败会导致安装程序失败，而不执行升级。通常，如果您包含 /ignore_site_test_failure 选项，则会忽略任何测试失败并继续升级。（有关例外情况，请参阅 SQL Server 版本检查。）

当您升级多个控制器时

当您在一个控制器上启动升级，然后在同一站点中启动另一个控制器的升级时（在第一个升级完成之前）：

• 如果初步站点测试已在第一个控制器上完成，则初步站点测试页面不会出现在其他控制器上的向导中。
• 如果在您启动其他控制器上的升级时，第一个控制器上的测试正在进行，则站点测试页面会出现在其他控制器上的向导中。但是，如果第一个控制器上的测试完成，则仅保留第一个控制器上的测试结果。

与站点运行状况无关的测试失败

• 如果初步站点测试因内存不足而失败，请提供更多内存，然后重新运行测试。
• 如果您有权升级但无权运行站点测试，则初步站点测试将失败。要解决此问题，请使用具有运行测试权限的用户帐户重新运行安装程序。

SQL 服务器版本检查

成功的 Citrix Virtual Apps and Desktops 部署需要受支持的 Microsoft SQL Server 版本，用于站点、监视和配置日志记录数据库。使用不再受支持的 SQL Server 版本升级 Citrix 部署可能会导致功能问题，并且站点将不受支持。

要了解您正在升级到的 Citrix 版本支持哪些 SQL Server 版本，请参阅该版本的 系统要求 文章。

升级控制器时，Citrix 安装程序会检查用于站点、监视和配置日志记录数据库的当前安装的 SQL Server 版本。

• 如果检查确定当前安装的 SQL Server 版本不是您正在升级到的 Citrix 版本中支持的版本：

  • 图形界面：升级将停止并显示一条消息。单击 我理解，然后单击 取消 以关闭 Citrix 安装程序。（您无法继续升级。）
  • 命令行界面：命令失败（即使您在命令中包含了 /ignore_db_check_failure 选项）。

  升级 SQL Server 版本，然后再次启动 Citrix 升级。

• 如果检查无法确定当前安装的 SQL Server 版本，请查看您当前安装的版本是否在您要升级到的版本中受支持（系统要求）。

  • 图形界面：升级停止并显示一条消息。

    • 如果当前安装的 SQL Server 版本受支持，请单击 我理解 关闭消息，然后单击 下一步 继续 Citrix 升级。
    • 如果当前安装的 SQL Server 版本不受支持，请单击 我理解 关闭消息，然后单击 取消 结束 Citrix 升级。将您的 SQL Server 升级到受支持的版本，然后再次启动 Citrix 升级。

  • 命令行界面：命令失败并显示一条消息。关闭消息后：

    • 如果当前安装的 SQL Server 版本受支持，请使用 /ignore_db_check_failure 选项再次运行该命令。
    • 如果当前安装的 SQL Server 版本不受支持，请将您的 SQL Server 升级到受支持的版本。再次运行该命令以启动 Citrix 升级。

执行 SQL Server 升级操作

如果您启动新的 SQL Server 服务器并迁移站点数据库，则必须更新连接字符串。

如果站点当前将 SQL Server Express 用于站点数据库（Citrix 在站点创建期间自动安装的）：

1. 安装最新版本的 SQL Server Express 数据库管理系统。
2. 分离数据库。
3. 将数据库附加到新的 SQL Server Express 数据库。
4. 迁移连接字符串。

更多信息，请参阅配置连接字符串和 Microsoft SQL Server 产品文档。

Replace SQL Server Express LocalDB

微软 SQL Server Express 本地数据库是 SQL Server Express 的一项功能，本地主机缓存独立使用此功能。本地主机缓存除了 SQL Server Express 本地数据库之外，不需要 SQL Server Express 的任何其他组件。

Citrix 不会自动更新 SQL Server Express 本地数据库。要更新 SQL Server Express 本地数据库 版本，请按照本节中的指导进行操作。

• 将交付控制器升级到 Citrix 虚拟应用和桌面 2203 LTSR 版或更高版本时，支持的版本是 SQL Server Express 本地数据库 2019 或 SQL Server Express 本地数据库 2022。

所需条件：

• Citrix 虚拟应用和桌面 安装介质。
• 来自 Windows 系统内部工具集 的 PsExec 工具。

过程：

1. 完成 Citrix Virtual Apps and Desktops 组件、数据库和站点的升级。（这些数据库升级会影响站点、监视和配置日志记录数据库。它们不影响使用 SQL Server Express LocalDB 的本地主机缓存数据库。）
2. 登录到交付控制器，您希望在此处更新 SQL Server Express LocalDB。
3. 从 Microsoft 下载 PsExec，并将其放置在该交付控制器上易于访问的位置，例如 C:\Temp。
4. 从 Windows 系统服务中停止交付控制器上的 Citrix 高可用性服务。

5. 在 Delivery Controller 上打开命令提示符，导航到 PsExec 所在的位置（例如，C:\Temp），然后运行以下命令以使用网络服务帐户提升命令提示符：

   psexec -i -u "NT AUTHORITY\NETWORKSERVICE" cmd
   <!--NeedCopy-->
   

6. 运行 whoami 以确认命令提示符以网络服务帐户身份运行。您必须获得以下输出：nt authority\networkservice。

7. 使用命令提示符导航到 SQL LocalDB 实例：

   • 如果需要从 SQL LocalDB 2014 版本进行升级：

      cd "C:\Program Files\Microsoft SQL Server\120\Tools\Binn"
      <!--NeedCopy-->
     

   • 如果从 SQL LocalDB 2017 进行升级：

      cd "C:\Program Files\Microsoft SQL Server\140\Tools\Binn"
      <!--NeedCopy-->
     

   • 如果从 SQL LocalDB 2019 进行升级：

      cd "C:\Program Files\Microsoft SQL Server\150\Tools\Binn"
      <!--NeedCopy-->
     

8. 停止并删除 SQL LocalDB 数据库实例：CitrixHA。

   SqlLocalDB stop CitrixHA
   
   SqlLocalDB delete CitrixHA
   <!--NeedCopy-->
   

9. 从交付控制器中删除以下文件：

   C:\Windows\ServiceProfiles\NetworkService\HADatabaseName.*
   C:\Windows\ServiceProfiles\NetworkService\HADatabaseName_log.*
   C:\Windows\ServiceProfiles\NetworkService\HAImportDatabaseName.* (if exists)
   C:\Windows\ServiceProfiles\NetworkService\HAImportDatabaseName_log.* (if exists)
   <!--NeedCopy-->
   

10. 使用 Windows 的原生程序卸载功能，从交付控制器卸载现有的 SQL LocalDB SQL Server Express。
11. 待卸载操作完成后，请重新启动交付控制器。
12. 从 Windows 系统服务中停止交付控制器上的 Citrix 高可用性服务。
13. 将 Citrix 虚拟应用和桌面 安装介质挂载到您的 交付控制器。

14. 在 交付控制器 上以管理员身份安装 SQL 服务器 Express 本地数据库 2022。

    1. 使用 Citrix Virtual Apps and Desktops 安装介质的 Support > SQLLocalDB 文件夹中的 sqllocaldb.msi 文件。例如，如果安装介质装载到 E drive 盘符，则该文件位于 E:\Support\SQLLocalDB\sqllocaldb.msi。需要重新启动才能完成安装。
    2. The new SQL LocalDB must be in C:\Program Files\Microsoft SQL Server\160\Tools\Binn.
15. 从 Windows 系统服务中启动交付控制器上的 Citrix 高可用性服务。

16. 在 Delivery Controller 的命令提示符下，导航到 C:\Program Files\Microsoft SQL Server\160\Tools\Binn 并运行 SqlLocalDB i，以确认 CitrixHA 实例已创建。返回的实例列表中必须包含 CitrixHA。

    注意：

    启动 Citrix 高可用性服务后，最多可能需要 15 分钟才能创建 CitrixHA 数据库。

17. 确保已创建本地主机缓存数据库文件，以确认高可用性服务（辅助代理）可在需要时接管。

    1. 在交付控制器上，浏览到 C:\Windows\ServiceProfiles\NetworkService。
    2. 验证 HaDatabaseName.mdf 和 HaDatabaseName_log.ldf 已创建。
18. 在其余交付控制器上重复这些步骤。