升级 StoreFront™
升级可保留您的 StoreFront 配置并保持用户的收藏夹不变。相比之下，卸载 StoreFront 会删除 StoreFront 及相关服务、站点、收藏夹（在独立服务器上）和相关配置。
支持的升级路径
您可以从以下版本升级到 StoreFront 2402：
- StoreFront 2311
- StoreFront 2308
- StoreFront 2203 LTSR（任何 CU）
- StoreFront 1912 LTSR（任何 CU）
- StoreFront 3.12 LTSR CU9
要从 3.12 CU9 之前的版本进行升级，您必须首先升级到 StoreFront 3.12 CU9。
警告：
当您从 1912 之前的版本进行升级时，部署中的任何 Desktop Appliance 站点都将自动删除。作为替代方案，Citrix 建议将 Citrix Workspace app Desktop Lock 用于所有非域加入用例。
须知
- StoreFront 不支持包含不同产品版本的多个服务器部署，因此服务器组中的所有服务器都必须升级到相同版本，然后才能授予对部署的访问权限。
- 多个服务器部署不支持并发升级，服务器必须按顺序升级。
- StoreFront 升级运行之前会执行一些预升级检查。如果任何预升级检查失败，升级将不会启动，并且您会收到失败通知。您的 StoreFront 安装保持不变。修复失败原因后，重新运行升级。
- 如果 StoreFront 升级本身失败，您现有的 StoreFront 安装可能会丢失其初始配置。将您的 StoreFront 安装恢复到功能状态，然后重新运行升级。要将 StoreFront 恢复到功能状态，请考虑以下方法：
- 恢复您在升级前创建的 VM snapshot，
- 导入您在升级前导出的 StoreFront 配置，请参阅导出和导入 StoreFront 配置，
- 执行解决 StoreFront 升级问题中的故障排除建议。
- Citrix Virtual Apps and Desktops 元安装程序导致的任何 StoreFront 升级失败都将在对话框中报告，并提供相关失败日志的链接。
-
通过 StoreFront 1912 到 2203 版本进行混合启动
StoreFront 1912 到 2203 版本支持通过自定义启用具有 App Protection 策略的虚拟应用程序和桌面的混合启动，如下所示：
Citrix® 建议在升级到 StoreFront 2308 或更高版本时删除此自定义。
有关详细信息，请参阅通过 StoreFront 1912 到 2203 版本进行混合启动
准备升级
在开始升级之前，我们建议您执行以下步骤，这可以防止升级失败：
- 在升级前规划您的备份策略。
- 验证您是否正在从支持的版本进行升级。
- 从 Citrix 网站下载 StoreFront 安装程序。
升级单个 StoreFront 服务器
- 通过创建 VM snapshot 备份服务器。
- 导出现有 StoreFront 配置。如果服务器组中有多个服务器，则仅从一台服务器导出服务器组配置。如果已在它们之间传播所有更改，则服务器组中的所有服务器都维护相同的配置副本。此备份允许您轻松构建新的服务器组，以便在出现问题时轻松恢复配置。请注意，您只能将此备份恢复到运行导出时相同版本的服务器中。
- 如果您已修改
C:\inetpub\wwwroot\Citrix\<StoreName>\App_Data或C:\inetpub\wwwroot\Citrix\<StoreName>Auth\App_Data中的文件（例如 default.ica 和 usernamepassword.tfrm），请为每个应用商店备份它们。升级后，您可以恢复它们以恢复您的修改。 - 通过从任何负载平衡器中删除服务器或以其他方式阻止连接来阻止用户连接。
- 重新启动服务器。
- 确保没有正在运行的应用程序，包括 StoreFront 管理控制台、命令行和 PowerShell 窗口或任何其他可能锁定 StoreFront 文件的应用程序。这可确保安装程序在升级期间可以访问所有 StoreFront 文件。如果安装程序无法访问任何文件，则不会替换它们，并且升级将失败，从而导致删除现有 StoreFront 配置。
- 确保您没有打开任何包含 StoreFront 文件的目录上的 Windows 资源管理器或命令提示符。
- 禁用任何防病毒应用程序。
- 运行所需 StoreFront 版本的安装文件。
在计划的维护停机期间升级 StoreFront 服务器组
要在计划的停机期间升级包含多个服务器的 StoreFront 服务器组，请完成以下步骤：
- 通过禁用负载平衡 URL 来禁用用户对服务器组的访问。这可以防止用户在升级过程中连接到部署。
- 按照升级单个 StoreFront 服务器中的说明升级每台服务器。
- 检查所有服务器是否正常运行。
- 通过启用负载平衡 URL 来启用用户对升级后的服务器组的访问。
在不停机的情况下升级 StoreFront 服务器组
不支持同时升级实时 StoreFront 服务器组中的服务器。但是，您可以通过创建具有相同配置的新服务器组、升级它，然后将用户连接迁移到新服务器组来实现实时升级。当用户在服务器组之间传输时，需要重新向 StoreFront 进行身份验证。
例如，要升级由三台服务器 A、B 和 C 组成的 StoreFront 服务器组：
- 使用 Export-STFConfiguration 导出 StoreFront 配置。此备份是必需的，因为服务器稍后在过程中会恢复出厂设置，这将删除配置数据。
- 使用 Export-STFStoreSubscriptions 从服务器 A 导出订阅数据。此备份是必需的，因为服务器稍后在过程中会恢复出厂设置，这将删除订阅数据。请参阅管理应用商店的订阅数据。
- 通过从负载平衡器中删除服务器 C 来禁用用户对服务器 C 的访问。这可以防止用户在升级过程中连接到服务器 C。负载平衡器继续向服务器 A 和 B 发送请求。
- 使用服务器 A 从组中删除服务器 C。 服务器 A 和 B 继续为您的用户提供对其资源的访问。服务器 C 现在已从服务器组中分离，并已恢复出厂设置。
- 使用 Clear-STFDeployment 将分离的服务器 C 恢复为出厂默认设置。
- 使用 Import-STFConfiguration 将您之前导出的 StoreFront 配置导入到服务器 C。服务器 C 现在具有与旧服务器组相同的配置。稍后无需再次重复此步骤。只有一台服务器需要配置数据的副本，才能将其传播到加入组的任何其他服务器。
- 按照升级单个 StoreFront 服务器中的说明升级服务器 C。服务器 C 现在具有与旧服务器组相同的配置，并已升级到新版本的 StoreFront。
- 将您之前导出的订阅数据导入到服务器 C。稍后无需再次重复此步骤。只有一台服务器需要订阅数据的副本，才能将其传播到加入组的任何其他服务器。
- 使用服务器 B 重复步骤 3、4、5 和 7（不要重复步骤 6）。在此期间，只有服务器 A 为用户提供对其资源的访问。因此，建议在工作量较小的安静工作期间执行此步骤，此时 StoreFront 服务器组上的负载预计最小。
- 使用加入现有服务器组过程将服务器 B 加入服务器 C。这会在当前版本的 StoreFront（服务器 A）上提供单个服务器部署，并在新版本的 StoreFront（服务器 B 和 C）上提供新的双节点服务器组。
- 将服务器 B 和 C 添加到负载平衡服务，以便它们可以接管服务器 A。
- 从负载平衡器中删除服务器 A，以便用户被定向到新升级的服务器 B 和 C。
- 使用服务器 A 重复步骤 5、7、10 和 11（不要重复步骤 6）。服务器组升级过程现已完成。服务器 A、B 和 C 具有与原始组相同的配置和订阅数据。
注意：
在服务器 A 是唯一可访问服务器的短暂期间，收藏夹可能会丢失（步骤 9）。这可能导致新服务器组在升级后拥有稍微过时的订阅数据库副本，并且任何新的收藏夹都会丢失。
这没有功能影响，因为收藏夹数据对于用户登录和启动资源不是必需的。但是，用户需要在服务器 A 恢复出厂设置并加入新升级的组后再次收藏资源。尽管不太可能丢失超过少数收藏记录，但这是在不停机的情况下升级实时 StoreFront 生产环境的可能后果。
解决升级问题
-
在 C:\Windows\Temp\StoreFront 中，打开最新的 CitrixMsi*.log 并搜索任何异常错误。
Thumbs.db Access 异常：由 C:\inetpub\wwwroot\citrix 或其子目录中的 thumbs.db 文件引起。删除找到的任何 thumbs.db 文件。
Cannot get exclusive file access \in use 异常：如果可用，恢复 snapshot/备份，或重新启动服务器，并手动停止任何 StoreFront 服务。
Service cannot be started 异常：如果可用，恢复 snapshot/备份，或安装完整版本的 .NET framework 4.5（而不是客户端配置文件）。
- 如果 CitrixMsi*.log 中没有异常错误，请检查服务器的 Event Viewer > Delivery Services 中是否有包含上述异常错误消息的任何错误。遵循相应的建议。
- 如果 Event Viewer 中没有异常错误，请检查 C:\Program Files\Citrix\Receiver StoreFront\logs 中的 Admin 日志，查找任何包含上述异常错误消息的错误。遵循相应的建议。
有关日志文件的更多详细信息，请参阅安装日志。