StoreFront™ 2507 LTSR

升级 StoreFront™

升级可保留您的 StoreFront 配置,并使用户的收藏夹保持不变。相比之下,卸载 StoreFront 会删除 StoreFront 及相关服务、站点、收藏夹(在独立服务器上)和相关配置。

支持的升级路径

您可以从以下版本升级到 StoreFront 2507:

  • StoreFront 2503.1
  • StoreFront 2503
  • StoreFront 2407
  • StoreFront 2402 LTSR(任何 CU)
  • StoreFront 2203 LTSR(任何 CU)
  • StoreFront 1912 LTSR CU10

无法从 2402 CU2 或更高版本 CU 升级到 2407 或 2411。

须知

  • StoreFront 不支持包含不同产品版本的多个服务器部署,因此服务器组中的所有服务器都必须升级到同一版本,然后才能授予对部署的访问权限。
  • 多个服务器部署不支持并发升级,服务器必须按顺序升级。
  • StoreFront 升级运行前会执行一些预升级检查。如果任何预升级检查失败,升级将不会启动,并且您会收到失败通知。您的 StoreFront 安装将保持不变。修复失败原因后,重新运行升级。
  • 如果 StoreFront 升级本身失败,您现有的 StoreFront 安装可能会丢失其初始配置。将您的 StoreFront 安装恢复到正常运行状态,然后重新运行升级。要将 StoreFront 恢复到正常运行状态,请考虑以下方法:
  • Citrix Virtual Apps and Desktops 元安装程序导致的任何 StoreFront 升级失败都会在对话框中报告,并附有相关失败日志的链接。

准备升级

在开始升级之前,我们建议您执行以下步骤,以防止升级失败:

  • 在升级前规划您的备份策略。
  • 验证您是否正在从支持的版本进行升级。
  • 从 Citrix 网站下载 StoreFront 安装程序。

升级单个 StoreFront 服务器

  1. 通过创建 VM 快照来备份服务器。
  2. 导出现有 StoreFront 配置。如果服务器组中有多个服务器,则仅从一个服务器导出服务器组配置。只要您已在它们之间传播所有更改,服务器组中的所有服务器都会维护相同的配置副本。此备份允许您轻松构建新的服务器组,以便在出现问题时轻松恢复配置。请注意,您只能将此备份恢复到运行与导出版本相同的服务器中。
  3. 如果您修改了 C:\inetpub\wwwroot\Citrix\<StoreName>\App_DataC:\inetpub\wwwroot\Citrix\<StoreName>Auth\App_Data 中的文件(例如 default.ica 和 usernamepassword.tfrm),请为每个应用商店备份它们。升级后,您可以恢复它们以恢复您的修改。
  4. 通过从任何负载平衡器中删除服务器或以其他方式阻止连接来阻止用户连接。
  5. 重新启动服务器。
  6. 确保没有正在运行的应用程序,包括 StoreFront 管理控制台、命令行和 PowerShell 窗口或任何其他可能锁定 StoreFront 文件的应用程序。这可确保安装程序在升级期间可以访问所有 StoreFront 文件。如果安装程序无法访问任何文件,则不会替换这些文件,并且升级会失败,从而导致删除现有 StoreFront 配置。
  7. 确保您没有打开包含 StoreFront 文件的目录中的任何 Windows 资源管理器或命令提示符。
  8. 禁用任何防病毒应用程序。
  9. 运行所需版本的 StoreFront 安装文件。

在计划的维护停机期间升级 StoreFront 服务器组

要在计划停机期间升级包含多个服务器的 StoreFront 服务器组,请完成以下步骤:

  1. 通过禁用负载平衡 URL 来禁用用户对服务器组的访问。这可以防止用户在升级过程中连接到部署。
  2. 按照升级单个 StoreFront 服务器中的说明升级每个服务器。
  3. 检查所有服务器是否正常运行。
  4. 通过启用负载平衡 URL 来启用用户对已升级服务器组的访问。

在不停机的情况下升级 StoreFront 服务器组

不支持同时升级实时 StoreFront 服务器组中的服务器。但是,您可以通过创建具有相同配置的新服务器组、升级该服务器组,然后将用户连接迁移到新服务器组来实现实时升级。用户在服务器组之间传输时需要重新向 StoreFront 进行身份验证。

例如,要升级由三台服务器 A、B 和 C 组成的 StoreFront 服务器组:

  1. 使用 Export-STFConfiguration 导出 StoreFront 配置。此备份是必需的,因为服务器稍后在过程中会恢复出厂设置,这将删除配置数据。
  2. 使用 Export-STFStoreSubscriptions 从服务器 A 导出订阅数据。此备份是必需的,因为服务器稍后在过程中会恢复出厂设置,这将删除订阅数据。请参阅管理应用商店的订阅数据
  3. 通过从负载平衡器中删除服务器 C 来禁用用户对服务器 C 的访问。这可以防止用户在升级过程中连接到服务器 C。负载平衡器继续向服务器 A 和 B 发送请求。
  4. 使用服务器 A 从组中删除服务器 C。 服务器 A 和 B 继续为您的用户提供对其资源的访问。服务器 C 现在已从服务器组中脱离,并已恢复出厂设置。
  5. 使用 Clear-STFDeployment 将脱离的服务器 C 恢复为出厂默认设置
  6. 使用 Import-STFConfiguration 将您之前导出的 StoreFront 配置导入到服务器 C。服务器 C 现在具有与旧服务器组相同的配置。稍后无需再次重复此步骤。只有一个服务器需要配置数据的副本,才能将其传播到加入组的任何其他服务器。
  7. 按照升级单个 StoreFront 服务器中的说明升级服务器 C。服务器 C 现在具有与旧服务器组相同的配置,并已升级到新版本的 StoreFront。
  8. 将您之前导出的订阅数据导入到服务器 C。稍后无需再次重复此步骤。只有一个服务器需要订阅数据的副本,才能将其传播到加入组的任何其他服务器。
  9. 使用服务器 B 重复步骤 3、4、5 和 7(不要重复步骤 6)。在此期间,只有服务器 A 为用户提供对资源的访问。因此,建议在工作量较小的安静工作期间执行此步骤,此时 StoreFront 服务器组上的负载预计最小。
  10. 使用加入现有服务器组过程将服务器 B 加入服务器 C。这会在当前版本的 StoreFront(服务器 A)上提供单个服务器部署,并在新版本的 StoreFront(服务器 B 和 C)上提供新的双节点服务器组。
  11. 将服务器 B 和 C 添加到负载平衡服务,以便它们可以接管服务器 A。
  12. 从负载平衡器中删除服务器 A,以便用户被定向到新升级的服务器 B 和 C。
  13. 使用服务器 A 重复步骤 5、7、10 和 11(不要重复步骤 6)。服务器组升级过程现已完成。服务器 A、B 和 C 具有与原始组相同的配置和订阅数据。

注意:

在服务器 A 是唯一可访问服务器的短暂期间,收藏夹可能会丢失(步骤 9)。这可能导致新服务器组在升级后拥有稍微过时的订阅数据库副本,并且任何新的收藏夹都会丢失。

这没有功能影响,因为收藏夹数据对于用户登录和启动资源并非必不可少。但是,在服务器 A 恢复出厂设置并加入新升级的组后,用户需要再次收藏资源。尽管不太可能丢失超过少数几个收藏记录,但这是在不停机的情况下升级实时 StoreFront 生产环境可能导致的结果。

解决升级问题

  1. C:\Windows\Temp\StoreFront 中,打开最新的 CitrixMsi*.log 并搜索任何异常错误。

    Thumbs.db 访问异常:由 C:\inetpub\wwwroot\citrix 或其子目录中的 thumbs.db 文件引起。删除找到的任何 thumbs.db 文件。

    无法获取独占文件访问权限 \in use 异常:如果可用,请恢复快照/备份,或重新启动服务器,并手动停止任何 StoreFront 服务。

    服务无法启动异常:如果可用,请恢复快照/备份,或安装完整版 .NET framework 4.5(而非客户端配置文件)。

  2. 如果 CitrixMsi*.log 中没有异常错误,请检查服务器的 Event Viewer > Delivery Services 中是否存在包含上述异常错误消息的任何错误。遵循相应的建议。
  3. 如果 Event Viewer 中没有异常错误,请检查 C:\Program Files\Citrix\Receiver StoreFront\logs 中的管理员日志,查找包含上述异常错误消息的任何错误。遵循相应的建议。

有关日志文件的更多详细信息,请参阅安装日志

升级 StoreFront™