安装、设置、升级和卸载

注意:

单击新增功能了解与产品名变更有关的信息。

安装和配置之前

要安装和配置 StoreFront,请按顺序完成以下步骤:

  1. 如果要使用 StoreFront 来向用户交付 Citrix Virtual Apps and Desktops 资源,请确保 StoreFront 服务器已加入包含相应用户帐户的 Microsoft Active Directory 域或与用户帐户域之间存在信任关系的域。

    重要:

    • 对于单服务器部署,可以在未加入域的服务器上安装 StoreFront。
    • StoreFront 可以安装在域控制器上。
  2. StoreFront 要求安装 Microsoft .NET Framework,如果尚未安装,可以从 Microsoft 下载。必须先安装 Microsoft .NET,才能安装 StoreFront。

  3. (可选)如果要配置多服务器 StoreFront 部署,请为 StoreFront 服务器设置一个负载平衡环境。

    要使用 Citrix ADC 进行负载平衡,应定义一个虚拟服务器作为 StoreFront 服务器的代理。有关通过配置 Citrix ADC 实现负载平衡的详细信息,请参阅使用 Citrix ADC 进行负载平衡

    1. 确保在 Citrix ADC 设备上启用负载平衡。

    2. 对于每个 StoreFront 服务器,根据需要使用 StoreFront 监视器类型创建各 HTTP 或 SSL 负载平衡服务。

    3. 通过配置服务将客户端 IP 地址插入转发给 StoreFront 的请求的 X-Forwarded-For HTTP 标头中,覆盖任何全局策略。

      StoreFront 需要使用用户的 IP 地址来与其资源建立连接。

    4. 创建虚拟服务器并将服务绑定到虚拟服务器。

    5. 在虚拟服务器上,使用客户端 IPCookie 插入方法配置持久性。确保生存时间 (TTL) 足够长,以使用户能够根据需要在尽可能长的时间内保持登录到服务器。

      持久性可确保仅对初始用户连接进行负载平衡,此后来自该用户的后续请求将定向到同一台 StoreFront 服务器。

  4. (可选)启用以下功能。

    • .NET Framework 功能 > .NET Framework、ASP.NET

    (可选)在 StoreFront 服务器上启用以下角色及其依赖项。

    • Web 服务器 (IIS) > Web 服务器 > 常见 HTTP 功能 > 默认文档、HTTP 错误、静态内容、HTTP 重定向

    • Web 服务器 (IIS) > Web 服务器 > 运行状况和诊断 > HTTP 日志记录

    • Web 服务器 (IIS) > Web 服务器 > 安全性 > 请求筛选、Windows 身份验证

      StoreFront 安装程序将检查是否已启用上述所有功能和服务器角色。

  5. 安装 StoreFront

    如果计划将服务器作为服务器组的一部分,则这些服务器之间的 StoreFront 安装位置和 IIS Web 站点设置、物理路径和站点 ID 必须一致。

  6. (可选)如果计划使用 HTTPS 来确保 StoreFront 与用户设备之间的连接安全,请将 Microsoft Internet Information Services (IIS) 配置为支持 HTTPS。

    智能卡身份验证必须使用 HTTPS。默认情况下,Citrix Workspace 应用程序需要使用 HTTPS 来连接应用商店。要配置 IIS,以便您可以在 StoreFront 中使用 HTTPS hostbaseURL,请创建与默认 Web 站点的 HTTPS 绑定,并将其链接到 StoreFront 服务器证书。有关将 HTTPS 绑定添加到 IIS 站点的详细信息,请参阅 https://docs.microsoft.com/en-us/previous-versions/orphan-topics/ws.11/hh831632(v=ws.11)

  7. 确保防火墙和其他网络设备允许从企业网络内部和外部访问 TCP 端口 80 或 443(如果适用)。此外,确保内部网络的任何防火墙或其他设备均不阻止通信流向任何未分配的 TCP 端口。

    安装 StoreFront 时,配置一个 Windows 防火墙规则,允许通过从所有非保留端口中随机选择的 TCP 端口访问 StoreFront 可执行文件。此端口用于在服务器组的各 StoreFront 服务器之间实现通信。

  8. 如果要使用多个 Internet Information Services (IIS) Web 站点,请在 IIS 中创建 Web 站点后,使用 PowerShell SDK 在其中每个 IIS Web 站点中创建一个 StoreFront 部署。有关详细信息,请参阅多个 Internet Information Services (IIS) Web 站点

    注意:

    StoreFront 会在检测到多个站点时禁用管理控制台并针对该影响显示一条消息。

  9. 使用 Citrix StoreFront 管理控制台配置服务器

安装 StoreFront

重要

为避免安装 StoreFront 过程中可能会出现的错误和数据丢失情况,请务必关闭所有应用程序,并且不要在目标系统中运行任何其他任务或操作。

  1. 从下载页面下载安装程序。

  2. 使用具有本地管理员权限的帐户登录 StoreFront 服务器。

  3. 请务必在服务器上安装所需的 Microsoft .NET Framework。

  4. 找到 CitrixStoreFront-x64.exe,然后以管理员身份运行此文件。

  5. 阅读并接受许可协议,然后单击下一步

  6. 如果显示检查必备项页面,请单击下一步

  7. 在已做好安装准备页面上,检查所列的安装必备项和 StoreFront 组件,然后单击安装

    在安装组件之前,如果服务器尚未配置以下角色,则会启用这些角色。

    • Web 服务器 (IIS) > Web 服务器 > 常见 HTTP 功能 > 默认文档、HTTP 错误、静态内容、HTTP 重定向

    • Web 服务器 (IIS) > Web 服务器 > 运行状况和诊断 > HTTP 日志记录

    • Web 服务器 (IIS) > Web 服务器 > 安全性 > 请求筛选、Windows 身份验证

    • Web 服务器 (IIS) > 管理工具 > IIS 管理控制台、IIS 管理脚本和工具

    如果尚未配置以下功能,则同时会启用这些功能。

    • .NET Framework 功能 > .NET Framework、ASP.NET
  8. 安装完成后,单击完成。Citrix StoreFront 管理控制台自动启动。您还可以从“开始”屏幕打开 StoreFront。

    “确认”对话框

  9. 在 Citrix StoreFront 管理控制台中,单击创建新部署

    1. 基本 URL 框中指定 StoreFront 服务器的 URL。
    2. 应用商店名称页面上,指定应用商店的名称,然后单击下一步

Delivery Controller 页面上,输入提供您希望在应用商店中提供的资源的 Citrix Virtual Apps and Desktops 部署。

  1. 设置传输类型端口。,例如 HTTP 和端口 80,或 HTTPS 和端口 443,然后单击确定

  2. 远程访问页面上,选择“无”。如果要使用 Citrix Gateway,请选择无 VPN 通道,然后输入网关详细信息。

  3. 远程访问页面上,选择“创建”。创建完应用商店之后,单击完成

现在,用户已可以通过 Citrix Receiver for Web 站点访问您的应用商店,这使用户能够通过 Web 页面访问其桌面和应用程序。

此时将显示一个 URL,用户可使用该 URL 访问新应用商店的 Citrix Receiver for Web 站点。例如:example.net/Citrix/StoreWeb/。登录后,您将在 Citrix Workspace 应用程序中访问新的用户界面。

Citrix Receiver for Web 站点

CEIP

如果您参与 Citrix 客户体验改善计划 (CEIP) 时,系统会向 Citrix 发送匿名统计数据和使用情况信息以提高 Citrix 产品的质量和性能。

默认情况下,安装 StoreFront 时会自动为您注册 CEIP。大约在您安装 StoreFront 七天后第一次上载数据。可以在注册表设置中更改此默认设置。如果在安装 StoreFront 之前更改注册表设置,则将使用该值。如果在升级 StoreFront 之前更改注册表设置,则将使用该值。

警告:

注册表编辑不当会导致严重问题,可能需要重新安装操作系统。Citrix 无法保证因注册表编辑器使用不当导致出现的问题能够得以解决。使用注册表编辑器需自担风险。在编辑注册表之前,请务必进行备份。

控制自动上载分析数据的注册表设置(默认值为 1):

位置:HKLM:\Software\Citrix\Telemetry\CEIP
名称:Enabled
类型:REG_DWORD
值:0 = 禁用,1 = 启用

默认情况下,Enabled 属性在注册表中处于隐藏状态。当它保持未指定时,启用自动上载功能。

使用 PowerShell 时,以下 cmdlet 禁用在 CEIP 中注册:

New-ItemProperty -Path HKLM:\SOFTWARE\Citrix\Telemetry\CEIP -Name Enabled -PropertyType DWORD -Value 0

注意:

注册表设置控制同一台服务器上所有组件的匿名统计数据和使用情况信息的自动上载。例如,如果您已将 StoreFront 和 Delivery Controller 安装在同一台服务器上,并决定使用注册表设置退出 CEIP ,则退出将应用到这两个组件。

从 StoreFront 收集的 CEIP 数据

下表提供了收集的匿名信息的类型示例。数据中不包含任何识别出您是客户的详细信息。

数据 说明
StoreFront 版本 指示安装的 StoreFront 版本的字符串。例如,“3.8.0.0”
应用商店计数 表示部署中的应用商店数量的计数器。
服务器组中的服务器计数 表示服务器组中的服务器数量的计数器。
每个应用商店的 Delivery Controller 计数 指示可供部署中每个应用商店使用的 Delivery Controller 数量的数值列表。
启用 HTTPS 指示是否为部署启用 https 的字符串。“True”或“False”。
Citrix Workspace 应用程序的 HTML5 设置 字符串列表,指示每个 Web Receiver 的 HTML5 Receiver 设置。对于每个 Web Receiver 为“始终”、“回退”或“关”。
为 Citrix Workspace 应用程序启用的工作区控制 布尔值列表,指示是否为每个 Web Receiver 启用“工作区控制”。对于每个 Web Receiver 为 TRUE 或 FALSE。
为应用商店启用远程访问 字符串列表,指示是否为部署中的每个应用商店启用“远程访问”。对于每个应用商店为“已启用”或“已禁用”。
网关计数 表示部署中配置的 Citrix Gateway 数量的计数器。

从命令提示窗口安装 StoreFront

  1. 使用具有本地管理员权限的帐户登录 StoreFront 服务器。

  2. 安装 StoreFront 之前,请务必满足 StoreFront 安装的所有要求。有关详细信息,请参阅安装和配置之前

  3. 浏览您的安装介质或下载软件包,找到 CitrixStoreFront-x64.exe,然后将该文件复制到服务器上的一个临时位置。

  4. 从命令提示窗口中,导航到包含安装文件的文件夹并键入以下命令。

    CitrixStoreFront-x64.exe [-silent] [-INSTALLDIR installationlocation] [-WINDOWS_CLIENT filelocation\filename.exe] [-MAC_CLIENT filelocation\filename.dmg]
    

    使用 -silent 参数可执行 StoreFront 以及所有必备项的无提示安装。默认情况下,StoreFront 安装在 C:\Program Files\Citrix\Receiver StoreFront 下。但是,可以使用 -INSTALLDIR 参数指定其他安装位置,其中 installationlocation 为 StoreFront 的安装目录。请注意,如果计划将服务器作为服务器组的一部分,则这些服务器之间的 StoreFront 安装位置和 IIS Web 站点设置、物理路径和站点 ID 必须一致。

    默认情况下,如果 Citrix Receiver for Web 站点检测不到 Windows 或 Mac OS X 设备上的 Citrix Workspace 应用程序,系统将提示用户从 Citrix Web 站点下载和安装适合其平台的 Citrix Workspace 应用程序。您可以修改此行为,以使用户从 StoreFront 服务器下载 Citrix Workspace 应用程序安装文件。有关详细信息,请参阅配置资源对用户的显示方式

    如果要更改此配置,请指定 -WINDOWS_CLIENT-MAC_CLIENT 参数,以将 Citrix Receiver for Windows 或适用于 Windows 的 Citrix Workspace 应用程序以及 Citrix Receiver for Mac 或适用于 Mac 的 Citrix Workspace 应用程序安装文件分别复制到 StoreFront 部署中的适当位置。将 filelocation 替换为包含要复制的安装文件的目录,并将 filename 替换为安装文件的名称。Citrix Receiver for Windows 或适用于 Windows 的 Citrix Workspace 应用程序以及 Citrix Receiver for Mac 或适用于 Mac 的 Citrix Workspace 应用程序安装文件都包含在 Citrix Virtual Apps and Desktops 安装介质中。

升级 StoreFront

注意:

升级到此版本的 StoreFront 时,使用经典用户体验的所有应用商店都会更新为使用统一体验。我们建议您告知用户升级引入的新体验,如统一用户体验中所述。如果您自定义了统一体验,则在升级到此版本的 StoreFront 时会保留您的自定义设置。检查自定义外观是否仍适用于新的统一体验。

要将现有 StoreFront 3.x 部署升级到此版本的 StoreFront,请运行此版本的 StoreFront 的安装文件。

不支持从现在已结束使用的旧版当前版本升级到最新的当前版本。有关详细信息,请参阅 CTX200356

一旦启动升级过程后,则无法将其回滚。如果升级过程中断或无法完成,则现有配置会被删除,但不会安装 StoreFront。在开始升级之前,您必须断开用户与 StoreFront 部署的连接,并且在升级过程中,还必须阻止用户访问服务器。这样才能确保在升级期间,安装程序可以访问所有 StoreFront 文件。如果存在安装程序无法访问的文件,那么将无法替换这些文件,因此升级会失败,从而导致现有 StoreFront 配置被删除。StoreFront 不支持包含不同产品版本的多服务器部署,因此,授予对部署的访问权限之前,必须将组中的所有服务器更新到已升级的版本。多服务器部署不支持同时升级,必须按顺序升级服务器。Citrix 建议您在升级之前对数据进行备份。

卸载 StoreFront 将删除身份验证服务、应用商店、用户的应用程序订阅、Citrix Receiver for Web 站点、桌面设备站点和 XenApp Services URL。这意味着如果您决定卸载 StoreFront,那么在重新安装 StoreFront 时,您必须重新创建服务、应用商店和站点。升级还使您能够保留 StoreFront 的配置,并将用户的应用程序订阅数据保留原样,以便用户不需要订阅其所有应用程序。

不支持在运行 StoreFront 的服务器上升级操作系统版本。Citrix 建议您在新安装的操作系统中安装 StoreFront。

重要:

开始升级之前:

  • 关闭 StoreFront 服务器上的所有其他应用程序。
  • 关闭所有命令行和 PowerShell 窗口。

将现有 StoreFront 3.x 升级到此版本的 StoreFront

  1. 禁用通过负载平衡环境对部署的访问。禁用负载平衡的 URL 将阻止用户在升级过程中连接到部署。
  2. 备份服务器组中的所有服务器,例如,通过在升级之前创建 VM 快照。
  3. 从现有服务器组中删除其中一台服务器,以用作新服务器组的主服务器。
  4. 重新启动删除的服务器。 请注意,可以使用局部负载平衡器在构建新服务器组的过程中对其进行检查。将可用性最大化并进一步将风险降至最低的变体涉及仅删除并升级原始服务器组中的一台服务器。然后可以基于新计算机(而非从原始服务器组中删除的计算机)构建新组。
  5. 使用管理员帐户升级删除的服务器,在此过程中,请不要运行任何其他安装并且运行最少量的其他应用程序。
  6. 检查是否已成功升级删除的服务器。
  7. 从负载平衡器中删除现有服务器组中的另外一台服务器。
  8. 重新启动删除的服务器,原因与步骤 1 中指出的原因相同。
  9. 卸载当前安装的 StoreFront 版本并安装新版本的 StoreFront。
  10. 将新安装的服务器添加到由所有升级后的服务器和全新安装的服务器组成的新服务器组,并检查其是否能够正常运行。
  11. 重复步骤 3-10,直至新服务器组有足够的容量,能够接管旧服务器组的角色,将负载平衡器指向新服务器组,然后检查其是否能够正常运行。
  12. 对剩余的服务器重复步骤 3-10,在每次成功升级后将每台服务器都添加到负载平衡器中。

注意:

  • 如果要将可用性最大化,可以在升级过程中保持对原始服务器组的访问权限,直至新服务器组可用。为此,请执行以下操作:
    1. 跳过步骤 1。
    2. 修改步骤 11,使其包括禁用使用负载平衡器访问原始服务器组的功能。从原始服务器组中导出订阅数据并将其导入到新服务器组中。启用使用负载平衡器访问新服务器组的功能。

    这样可确保用户在完成步骤 3 之后执行步骤 11 之前对订阅所做的所有更改都在新服务器组中可用。

  • 可以通过以下方式进一步将可用性最大化:仅从原始服务器组中删除一台服务器并进行升级,然后使用新服务器(而非从原始服务器组中删除的服务器)构建新服务器组。新服务器组投入生产时,可以停用旧服务器。
  • 在与应用商店的默认 IIS 目录不同的位置保存 web.config 文件的备份。例如,请勿将备份保存到 C:\inetpub\wwwroot\citrix\<storename> 中。在与应用商店的默认 IIS 目录相同的位置保存备份会干扰 StoreFront 的升级。

配置 StoreFront

Citrix StoreFront 管理控制台首次启动时,会提供两个选项。

  • 创建新部署。在新 StoreFront 部署中配置第一台服务器。单服务器部署适用于评估 StoreFront 或小型生产部署。配置第一台 StoreFront 服务器后,可以随时向组中添加更多服务器,以提高部署的容量。
  • 加入现有服务器组。将其他服务器添加到现有 StoreFront 部署中。选择此选项可快速提高 StoreFront 部署的容量。多服务器部署需要实现外部负载平衡。要添加新服务器,需要访问部署中的现有服务器。Citrix 建议您向服务器组中添加的服务器不要超过 6 个。

卸载 StoreFront

除产品本身外,卸载 StoreFront 将删除身份验证服务、应用商店、Citrix Receiver for Web 站点、桌面设备站点和 XenApp Services URL 以及关联的配置。此外,还将删除包含用户的应用程序订阅数据的订阅应用商店服务。在单服务器部署中,这意味着用户应用程序订阅的详细信息将丢失。但是,在多服务器部署中,这些数据将保留在组中的其他服务器上。卸载 StoreFront 时,不会从服务器中删除 StoreFront 安装程序要求的必备项,例如,.NET Framework 功能和 Web 服务器 (IIS) 角色服务。

  1. 使用具有本地管理员权限的帐户登录 StoreFront 服务器。
  2. 如果打开了 StoreFront 管理控制台,请关闭。
  3. 关闭任何可能已通过其 Powershell SDK 管理 StoreFront 的 Powershell 会话。
  4. 在 Windows 开始屏幕或“应用程序”屏幕中,找到 Citrix StoreFront 磁贴。在该磁贴上单击鼠标右键,然后单击卸载
  5. 程序和功能对话框中,选择 Citrix StoreFront,然后单击卸载,以删除服务器中的所有 StoreFront 组件。
  6. 卸载 Citrix StoreFront 对话框中,单击。卸载完成后,单击确定
上一步

安装、设置、升级和卸载