准备工作

Last published : Nov 13, 2026
在开始升级之前，请查看以下信息并完成必要的任务。
注意：
尽管 VDA 升级在 升级过程 中稍后进行，但最好在开始升级之前选择安装程序并查看该过程，以便您了解预期情况。
Related information
升级部署

升级前检查清单

在开始升级之前完成以下任务。每个项目都链接到其详细信息：

选择安装程序和界面

使用产品 ISO 中的完整产品安装程序升级组件。您可以使用完整产品安装程序或独立 VDA 安装程序之一升级 VDA。所有安装程序都提供图形界面和命令行界面。
有关详细信息，请参阅安装程序。
安装详情： 完成所有准备工作并准备好启动安装程序后，安装文章将向您展示您将看到的内容（如果您使用的是图形界面）或要键入的内容（如果您使用的是命令行界面）。
  • 使用图形界面安装/升级核心组件
  • 使用命令行安装/升级核心组件
  • 使用图形界面安装/升级 VDA
  • 使用命令行安装/升级 VDA
对于单会话操作系统，有四种不同的安装程序可用。Citrix 建议在 Citrix VDA 的整个生命周期（包括安装、升级和卸载）中始终使用一致的安装程序类型。有关详细信息，请参阅使用单会话 VDA 安装程序的最佳实践
将 VDA 升级到当前版本时，在升级过程中会发生计算机重新启动。（此要求始于 7.17 版本。）无法避免重新启动。重新启动后，升级会自动恢复（除非您在命令行中指定 /noresume）。

验证您的 Citrix 许可

有关管理 Citrix 许可的全面信息，请参阅激活、升级和管理 Citrix 许可证。
您可以使用完整产品安装程序升级许可证服务器。或者，您可以单独下载和升级许可证组件。请参阅升级。
升级之前，请确保您的客户成功服务/软件维护/订阅权益日期对新产品版本有效。日期必须至少为 2021.11.15。

验证许可证服务器兼容性

确保您的 Citrix 许可证服务器与新版本兼容。有两种方法可以验证兼容性：
  • 在升级任何其他 Citrix 组件之前，请在包含 Delivery Controller 的计算机上从 ISO 布局运行 XenDesktopServerSetup.exe 安装程序。如果存在任何不兼容问题，安装程序会报告并提供建议的解决步骤。
  • 在安装介质的 XenDesktop Setup 目录中，运行命令：.\LicServVerify.exe -h <license-server-fqdn> -p 27000 -v。显示屏会指示许可证服务器是否兼容。如果许可证服务器不兼容，请升级许可证服务器。

更新混合权利许可证

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

具有 SaaS 属性的混合权利许可证

当您升级到 Citrix Virtual Apps and Desktops™ LTSR 2203 及更高版本时，您将有资格获得 LTSR 1912 不具备的功能。这些功能包括在 Microsoft Azure、AWS EC2 和 Google Cloud 等公共云中预配和托管工作负载。在部署新的许可证文件之前，请将您的许可证服务器更新到最新版本。如果您跳过此先决条件，更新将阻止 Citrix Virtual Apps and Desktops 站点升级和站点创建。

不带 SaaS 属性的混合权利许可证

请按照以下步骤获取具有 SaaS 属性的新混合权利许可证：
注意：
  • 您会收到一封包含新许可证代码的电子邮件。有关详细信息，请参阅使用许可证访问代码。
  • 您现有的许可证已被撤销。撤销的许可证必须从许可证服务器中删除，然后才能安装新许可证。有关详细信息，请参阅删除许可证文件。
  1. 转到 citrix.com 管理许可证门户，下载已启用云预配权限（SaaS 属性）的新混合权利许可证文件。有关详细信息，请参阅下载许可证。下图显示了“增量”部分中具有 SaaS 属性的混合权利许可证文件。
    许可证文件中的 SaaS 属性
  2. 在许可证服务器上安装混合权利许可证文件。有关详细信息，请参阅安装许可证。
  3. 如果许可证版本或模型发生更改，请确保运行 broker 命令来设置版本和模型，然后开始就地升级。有关 Broker 命令的详细信息，请参阅Broker PowerShell SDK 部分。
有关 Citrix Virtual Apps and Desktops 当前版本和长期服务版本对公共云支持的更多信息，请参阅 CTX270373。

备份数据库

备份站点、监视和配置日志数据库。请按照 CTX135207 中的说明进行操作。如果在升级后发现任何问题，可以还原备份。
有关升级不再受支持的 SQL Server 版本的信息，请参阅检查 SQL Server 版本。（SQL Server 版本检查是指用于站点、监视和配置日志数据库的 SQL Server。）
Microsoft SQL Server Express LocalDB 会自动安装，以用于本地主机缓存。如果需要替换早期版本，新版本必须是 SQL Server Express LocalDB 2019。有关在升级组件和站点后用新版本替换 SQL Server Express LocalDB 的详细信息，请参阅替换 SQL Server Express LocalDB。

检查 SQL Server 版本

成功的 Citrix Virtual Apps and Desktops 部署需要受支持的 Microsoft SQL Server 版本用于站点、监视和配置日志数据库。使用不再受支持的 SQL Server 版本升级 Citrix 部署可能会导致功能问题，并且站点将不受支持。
要了解您要升级到的 Citrix 版本支持哪些 SQL Server 版本，请参阅该版本的系统要求文章。
升级 Controller 时，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 产品文档。

备份所有 StoreFront 修改

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

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

以下技术和主机类型在 Citrix Virtual Apps and Desktops 7 Current Release 部署中不受支持：
  • Personal vDisks (PvD)，用于在目录中用户的 VM 旁边存储数据。用户个性化层功能现在处理用户持久性。
  • AppDisks，用于管理交付组中使用的应用程序。
  • 主机类型： Azure Classic、CloudPlatform（原始 Citrix 产品）。
    • 有关此版本中支持的主机类型，请参阅系统要求。
如果您的当前部署使用 PvD 或 AppDisks，或者连接到不受支持的主机类型（例如 Microsoft Azure Classic），则只有在删除使用这些技术的项目后，才能升级到版本 2006（或更高版本）。如果您的当前部署使用公共云主机连接（例如 AWS），请确保在升级前拥有混合权利许可证。当安装程序检测到一种或多种不受支持的技术或没有混合权利许可证的主机连接时，升级将暂停或停止，并显示一条解释性消息。安装程序日志中包含详细信息。
为确保成功升级，请查看并遵循有关删除不受支持项目的适用指南。
即使您在部署中未使用 PvD 或 AppDisks，相关的 MSI 也可能已包含在较早的 VDA 安装或升级中。在将 VDA 升级到版本 2006（或更高版本）之前，您必须删除该软件，即使您从未使用过它。使用图形界面时，可以为您完成此删除操作，或者在使用 CLI 时包含删除选项。有关详细信息，请参阅从 VDA 中删除 PvD 或 AppDisks 组件。

删除 PvD

在删除所有配置为使用 PvD 的计算机之前，部署升级无法成功。此删除会影响目录和交付组。
要从组和目录中删除 PvD：
  1. 在 Studio 中，如果交付组包含使用 PvD 的目录中的计算机，请(/zh-cn/citrix-virtual-apps-desktops/2607-ltsr/install-configure/delivery-groups-manage.html#remove-a-machine-from-a-delivery-group)。
  2. 在 Studio 中，(/zh-cn/citrix-virtual-apps-desktops/2607-ltsr/install-configure/machine-catalogs-manage.html#delete-a-catalog)包含使用 PvD 的计算机的所有目录。
VDA 升级： 部署升级不会检测 VDA 是否安装了 AppDisk 或 PvD 组件。但是，VDA 安装程序会检测。有关详细信息，请参阅(#remove-pvd-or-appdisks-components-from-vdas)。
如果您计划使用 App Layering 而不是 PvD，请参阅(/zh-cn/citrix-virtual-apps-desktops/1912-ltsr/install-configure/personal-vdisk/migrate-to-app-layering.html)以了解有关移动数据的信息。

删除 AppDisk

在您从所有使用 AppDisk 的交付组中删除 AppDisk，然后删除 AppDisk 本身之前，部署升级无法继续。
  1. 在 Studio 导航窗格中选择 交付组。
  2. 选择一个组，然后在“操作”窗格中单击管理 AppDisk。
  3. 单击从组中删除 AppDisk 的操作。
  4. 对每个使用 AppDisk 的交付组重复步骤 2 和 3。
  5. 在 Studio 导航窗格中选择AppDisk。
  6. 选择一个 AppDisk，然后单击删除该 AppDisk 的操作。
  7. 对每个 AppDisk 重复步骤 5 和 6。
VDA 升级： 部署升级不会检测 VDA 是否安装了 AppDisk 或 PvD 组件。但是，VDA 安装程序会检测。有关详细信息，请参阅(#remove-pvd-or-appdisks-components-from-vdas)。

删除不受支持的主机项

如果站点连接到不受支持的主机类型（例如 Citrix CloudPlatform 或 Microsoft Azure Classic），则无法升级到版本 2006（或更高受支持版本）。在尝试升级之前，请完成以下任务。
在 Studio 中：
  • 删除所有连接 到不支持的主机。
  • 如果交付组包含使用来自不支持主机的主映像创建的目录中的计算机，请从组中删除这些计算机。
  • 删除所有目录，这些目录是使用来自不支持主机的主映像创建的。

从 VDA 中删除 PvD 或 AppDisks 组件

如果启用了 PvD 和 AppDisks 技术的组件安装在 VDA 上，则在删除这些组件之前，该 VDA 无法升级。即使您从未使用过 PvD 或 AppDisks，此限制也适用。
注意：
升级到版本 1912 时，您必须卸载当前 VDA，然后安装新的 VDA。在此版本中，系统会询问您是否希望 Citrix 删除组件，然后继续升级。
AppDisk 和 PvD 组件可能已在早期 VDA 版本中安装，即使您从未使用过这些技术：
  • 图形界面：在 VDA 安装程序中，附加组件页面包含 Citrix AppDisk / Personal vDisk 选项。7.15 LTSR 和更早的 7.x 版本默认启用此选项。因此，如果您接受了默认设置（或在提供此选项的任何版本中明确启用了此选项），则会安装该组件。
  • 命令行界面：指定 /baseimage 选项会安装该组件。

删除组件

如果 VDA 安装程序未在当前安装的 VDA 中检测到 AppDisks 或 PvD 组件，则升级照常进行。
如果安装程序在当前安装的 VDA 中检测到 AppDisks 或 PvD 组件：
  • 图形界面：升级暂停。一条消息会询问您是否要自动删除不支持的组件。如果您单击 OK，组件将自动删除，然后升级继续进行。
  • 命令行界面：为避免命令失败，请在命令中包含以下选项：
    • /remove_appdisk_ack
    • /remove_pvd_ack

继续在早期 Windows 版本上使用 PvD

如果您想在 Windows 10（1607 及更早版本，未更新）计算机上继续使用 PvD，VDA 7.15 LTSR 是最新支持的版本。
注意：
我可以在 XenApp and XenDesktop 7.15 LTSR 中将 Personal vDisk 与 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 部署提供限时支持，直至 Jan 14, 2020。PvD 组件将从 LTSR CU 中删除，并且在 Jan 14, 2020 之后将不再受支持。此外，在 Jan 14, 2020 之后将 PvD 用于 Windows 7 将导致 LTSR 站点不合规。此外，适用于 Windows 10 的 PvD 仍被排除在 7.15 LTSR 之外。因此，客户不得将其与 7.15 LTSR 站点一起使用。

关闭应用程序和控制台

在开始升级之前，请关闭所有可能导致文件锁定的程序，包括管理控制台和 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 版本。）

升级多个 Controller

当您在一个 Controller 上启动升级，然后在同一站点中启动另一个 Controller 的升级时（在第一个升级完成之前）：
  • 如果在第一个 Controller 上完成了初步站点测试，则初步站点测试页面不会显示在其他 Controller 的向导中。
  • 如果第一个 Controller 上的测试正在进行，而您在另一个 Controller 上启动升级，则站点测试页面会出现在另一个 Controller 上的向导中。但是，如果第一个 Controller 上的测试完成，则只保留第一个 Controller 的测试结果。

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

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

完成其他准备任务

  • 如有需要，备份模板并升级管理程序
  • 完成业务连续性计划规定的任何其他准备任务。