Citrix Virtual Apps and Desktops

安装 VDA

重要提示:

  • 如果您正在升级,并且当前版本已安装 Personal vDisk 或 AppDisks 软件,请参阅删除 PvD、AppDisks 和不受支持的主机
  • Citrix® 分发的二进制文件现已签名。已签名的二进制文件表示它们已通过 Citrix 生成的证书或真实的第三方证书进行验证。

Windows 计算机有两种类型的 VDA:多会话操作系统 VDA 和单会话操作系统 VDA。(有关 Linux 计算机 VDA 的信息,请参阅 Linux Virtual Delivery Agent 文档。)

开始安装之前,请查看准备安装并完成所有准备任务。

安装 VDA 之前,请先安装核心组件。您也可以在安装 VDA 之前创建站点。

本文介绍了安装 VDA 时的安装向导顺序。提供了命令行等效项。有关详细信息,请参阅使用命令行安装

步骤 1. 下载产品软件并启动向导

如果您使用的是完整产品安装程序:

  1. 如果您尚未下载产品 ISO:
    • 使用您的 Citrix 帐户凭据访问 Citrix Virtual Apps and Desktops™ 下载页面。下载产品 ISO 文件。
    • 解压缩文件。或者,刻录 ISO 文件的 DVD。
  2. 在要安装 VDA 的映像或计算机上使用本地管理员帐户。将 DVD 插入驱动器或装载 ISO 文件。如果安装程序未自动启动,请双击装载驱动器上的 AutoSelect 应用程序。

    安装向导启动。

步骤 2. 选择要安装的产品

组件安装程序中的“要安装的产品”页面

单击要安装的产品旁边的开始:Citrix Virtual Apps 或 Citrix Virtual Desktops。(如果计算机已安装 Citrix Virtual Apps 或 Citrix Virtual Desktops 组件,则此页面不会出现。)

命令行选项:/xenapp 用于安装 Citrix Virtual Apps。如果省略此选项,则安装 Citrix Virtual Desktops。

步骤 3. 选择 VDA

组件安装程序中的“组件选择”页面

选择虚拟投递代理条目。安装程序知道它是在单会话操作系统还是多会话操作系统上运行,因此它只提供适当的 VDA 类型。

例如,当您在 Windows Server 2019 计算机上运行安装程序时,多会话操作系统 VDA 选项可用。单会话操作系统 VDA 选项不提供。

如果您尝试在不受此 Citrix Virtual Apps™ and Desktops 版本支持的操作系统上安装(或升级到)Windows VDA,则会显示一条消息,引导您了解有关选项的信息。

如果您使用的是独立软件包:

  1. 使用您的 Citrix 帐户凭据访问 Citrix Virtual Apps™ and Desktops 下载页面。下载相应的软件包:
    • VDAServerSetup_2511.exe:多会话操作系统 VDA 版本
    • VDAWorkstationSetup_2511.exe:单会话操作系统 VDA 版本
    • VDAWorkstationCoreSetup_2511.exe:单会话操作系统核心服务 VDA 版本
    • VDASingleSessionCoreSetup_2511.exe:新单会话操作系统核心服务 VDA 版本
  2. 右键单击软件包并选择以管理员身份运行

    安装向导启动。

步骤 4. 指定 VDA 的使用方式

VDA 安装程序中的“环境”页面

环境页面上,指定您计划如何使用 VDA,指示您是否将此计算机用作预配更多计算机的映像。

您选择的选项会影响自动安装哪些 Citrix Provisioning™ 工具(如果有),以及 VDA 安装程序“附加组件”页面上的默认值。

安装 VDA 时会自动安装多个 MSI(预配和其他)。防止其安装的唯一方法是在命令行安装中使用 /exclude 选项。

选择以下选项之一:

  • 创建主 MCS 映像: 如果您计划使用 Machine Creation Services™ 预配 VM,请选择此选项以在 VM 映像上安装 VDA。此选项将安装计算机身份服务。这是默认选项。

    命令行选项:/mastermcsimage/masterimage

重要提示:

安装介质或 ISO 映像必须在本地装载。不支持从网络驱动器装载 ISO 映像以安装软件。

  • 使用 Citrix Provisioning 或第三方预配工具创建主映像: 如果您计划使用 Citrix Provisioning 或第三方预配工具(例如 Microsoft System Center Configuration Manager)预配 VM,请选择此选项以在 VM 映像上安装 VDA。

    命令行选项:/masterpvsimage

  • (仅在多会话操作系统计算机上显示)启用与服务器的代理连接: 选择此选项可在物理或虚拟机上安装 VDA,该虚拟机不会用作预配其他计算机的映像。

    命令行选项:/remotepc

  • (仅在单会话操作系统计算机上显示)启用 Remote PC Access: 选择此选项可在物理计算机上安装 VDA,以用于 Remote PC Access。

    命令行选项:/remotepc

单击下一步

此页面不会出现:

  • 如果您正在升级 VDA
  • 如果您使用的是 VDAWorkstationCoreSetup_2507.exeVDAServerSetup_2507.exeVDAWorkstationSetup_2507.exe 安装程序

步骤 5. 选择安装 VDA 的位置

VDA 安装程序中的“组件”页面

注意:

CWA 和 CSA 已从“组件”页面移至新的“可选软件”页面。

组件页面上:

  • 位置: 默认情况下,VDA 安装在 C:\Program Files\Citrix 中。此默认设置适用于大多数部署。如果您指定不同的位置,则该位置必须具有网络服务的 execute 权限。

单击下一步

步骤 6. 安装附加组件

VDA 安装程序中的“附加组件”页面

附加组件页面包含用于启用或禁用 VDA 其他功能和技术安装的复选框。在命令行安装中,您可以使用 /exclude/includeadditional 选项明确排除或包含一个或多个可用组件:

  • /includeadditionalcomponent”[,”component”] …
  • /excludecomponent”[,”component”] …

下表指示此页面上项目的默认设置。默认设置取决于您在环境页面上选择的选项。

附加组件页面 “环境”页面:“使用 MCS 的主映像”或“使用 Citrix Provisioning 的主映像”已选择 “环境”页面:“启用与服务器的代理连接”(适用于多会话操作系统)或“Remote PC Access”(适用于单会话操作系统)已选择
应用程序包交付组件 未选择 未选择
Citrix VDA 升级代理 未选择 未选择
Citrix 备份和还原 未选择 未选择
Citrix MCS IODriver 未选择 未选择
Citrix Rendezvous V2 未选择 未选择

此页面不显示,如果:

  • 您正在使用 VDAWorkstationCoreSetup.exe 安装程序。此外,附加组件的命令行选项对该安装程序无效。
  • 您正在升级 VDA 并且所有附加组件都已安装。如果某些附加组件已安装,则页面仅列出未安装的组件。

选择或清除以下复选框。(组件在安装程序中的显示顺序可能不同。)

  • App Packages Delivery Component(应用程序包交付组件):如果您使用 Microsoft App-V 包中的应用程序,请安装此组件。有关详细信息,请参阅部署和交付 App-V 应用程序

    命令行选项:/includeadditional "App Packages Delivery Component" 以启用组件安装,/exclude "App Packages Delivery Component" 以阻止组件安装。

  • Citrix Profile Management(Citrix 配置文件管理):此组件管理用户配置文件中的用户个性化设置。有关详细信息,请参阅 Profile Management

    从安装中排除 Citrix Profile Management 会影响使用 Citrix Director 对 VDA 进行的监视和故障排除。在用户详细信息端点页面上,个性化面板和登录持续时间面板将失败。在控制板趋势页面上,平均登录持续时间面板仅显示已安装 Profile Management 的计算机的数据。

    即使您正在使用第三方用户配置文件管理解决方案,Citrix 仍建议您安装并运行 Citrix Profile Management Service。不需要启用 Citrix Profile Management Service。

    命令行选项:/includeadditional "Citrix Profile Management" 以启用组件安装,/exclude "Citrix Profile Management" 以阻止组件安装。

  • Citrix Profile Management WMI Plug-in(Citrix Profile Management WMI 插件):此插件在 WMI (Windows Management Instrumentation) 对象中提供 Profile Management 运行时信息(例如,配置文件提供程序、配置文件类型、大小和磁盘使用情况)。WMI 对象向 Director 提供会话信息。

    命令行选项:/includeadditional "Citrix Profile Management WMI Plug-in" 以启用组件安装,/exclude "Citrix Profile Management WMI Plug-in" 以阻止组件安装。

注意:

从本版本开始,Citrix Profile ManagementCitrix Profile Management WMI Plug-in 现已成为 VDA 的一部分,并针对 Master Image/MCS/PVS 用例自动安装。对于 Remote PC 用例,这些组件默认不安装。在所有情况下,已安装的组件都会自动升级。命令行行为与以前的版本保持不变。

  • VDA Upgrade Agent(VDA 升级代理):仅适用于 Citrix DaaS(以前称为 Citrix Virtual Apps and Desktops service)部署。使 VDA 能够参与 VDA 升级功能。您可以使用该功能立即或在预定时间从管理控制台升级目录的 VDA。如果未安装此代理,您可以通过在计算机上运行 VDA 安装程序来升级 VDA。

    命令行选项:/includeadditional "Citrix VDA Upgrade Agent" 以启用组件安装,/exclude "Citrix VDA Upgrade Agent" 以阻止组件安装。

  • MCSIO write cache for storage optimization(用于存储优化的 MCSIO 写入缓存):安装 Citrix MCS I/O 驱动程序。有关详细信息,请参阅管理程序共享的存储配置临时数据缓存

    命令行选项:/includeadditional "Citrix MCS IODriver" 以启用组件安装,/exclude "Citrix MCS IODriver" 以阻止组件安装。

  • Proxy Configuration(代理配置):如果您计划在您的环境中使用 Rendezvous 协议与 Gateway Service、VDA Upgrade Service 等,并且您的网络中存在用于出站连接的非透明代理,请在此处指定代理。仅支持 HTTP 代理。

    如果您安装此组件,请在Rendezvous Proxy Configuration(Rendezvous 代理配置)页面上指定代理地址或 PAC 文件路径。有关功能详细信息,请参阅 Rendezvous 协议

    命令行选项:/includeadditional "Citrix Rendezvous V2" 以启用组件安装,/exclude "Citrix Rendezvous V2" 以阻止组件安装。

  • Citrix Backup and Restore(Citrix 备份和还原):如果 VDA 安装或升级失败,此组件可以将计算机恢复到安装或升级之前完成的备份。

    请确保满足 Prepare to install 中提到的 Microsoft 先决条件。

    命令行选项:/includeadditional "Citrix Backup and Restore" 以启用组件安装,/exclude "Citrix Backup and Restore" 以阻止组件安装。

    注意:

    如果启用了 MCS 存储优化,则 Windows 服务器或桌面操作系统备份或还原可能会失败。要解决此问题,请在元安装程序中禁用 MCS 存储优化选项。

步骤 7. 安装可选软件

VDA 安装程序中的可选软件页面 1

注意:

“可选软件”页面是 Citrix Virtual Apps and Desktops 2503 开始新增的功能,为客户提供了更大的灵活性,可以在 VDA 上安装额外的 Citrix 软件。

Citrix Workspace™ App 和 Citrix Secure Access™ Client 已从“组件”页面移至“可选软件”页面。

用户个性化层也已从“附加组件”页面移至“可选软件”页面。其选择逻辑与在“附加组件”页面时相同。也就是说,如果用户个性化层已安装,则将其选择为必需,并且组件将升级。

可选软件页面上:

  • 位置:默认情况下,组件安装在 C:\Program Files\Citrix 中。此默认设置适用于大多数部署。如果您指定不同的位置,则该位置必须具有网络服务的 execute 权限。
  • 组件:默认情况下,Citrix Workspace app for Windows 不随 VDA 一起安装。如果您正在使用 VDAWorkstationCoreSetup.exe 安装程序,则 Citrix Workspace app for Windows 永远不会安装,因此不显示此复选框。

单击下一步

命令行选项:'/installdir "C:\Program Files\VDA" /components "VDA","CSA","PLUGINS".to 安装 Virtual Delivery Agent、Citrix Secure Access Client、Citrix deviceTRUST、Citrix uberAgent 和 Citrix Workspace app 到指定目录。

注意:

在以下情况下,您可以在 VDA 安装、升级或卸载期间选择安装、升级或卸载 Citrix Workspace app 和其他组件:

  • 在 VDA 安装和升级到 2511 期间,您可以选择包含或排除组件和 CWA 插件。

    • 默认情况下,Citrix Workspace app (CWA)Citrix Secure Access Client (CSA)Citrix User Personalization Layer (UPL)(仅适用于 WS VDA)以及 Citrix Elastic App Layering (CEAL)(仅适用于 TS VDA)不安装。如果需要,您可以在安装期间选择它们。Session Recording Agent​ (SRAGENT) 和 ​​Citrix Assistant App (ASSISTANTAPP)(仅适用于 WS VDA)默认安装。如果需要,您可以在安装期间取消选择它们。

    • Citrix Device TrustCitrix uberAgentCitrix Workspace Environment Management™ agent 现已与 VDA 集成并始终安装。使用 GUI 安装时无法取消选择这些组件。

    • 默认情况下,Citrix Workspace Environment Management™ agent基本部署中运行,这是一种功能有限的单机模式,不连接到 WEM 基础结构。要通过将代理连接到 Citrix Cloud 中的 WEM 服务或本地部署来启用完整的 WEM 功能,请通过组策略配置设置。有关详细信息,请参阅这篇 WEM 文章

    • 命令行更改

      /components VDA CSA:此命令安装 VDACSA(已选择),以及 Citrix Device TrustCitrix uberAgentCitrix Workspace Environment Management agent(默认集成)。

      /components VDA:此命令安装 VDA,以及 Citrix Device TrustCitrix uberAgentCitrix Workspace Environment Management agent,因为这些组件现已集成到 VDA 本身。如果您将 Citrix Device Trust、Citrix uberAgent 和 Citrix Workspace Environment Management agent 指定为与 “/components” 选项一起的参数,则 VDA 元安装程序会记录一条通知,指示从 “/components” 选项中删除这些参数。随后,VDA 元安装程序将继续安装或升级 VDA。

      /components:此命令是无效命令,并且必须始终包含 VDA。可以根据需要添加其他组件进行安装。

      /exclude 命令用于默认集成组件:在 Citrix Virtual Apps and Desktops 2507 LTSR 中,/exclude 选项始终优先。它可用于阻止安装默认集成组件。示例:/exclude “Citrix Device Trust”,”Citrix Universal Print Client”。此命令安装带有 Citrix Workspace Environment Management agent 的 VDA,但不安装 Citrix Device Trust 和 Citrix Universal Print Client。

  • 在 VDA 升级期间,如果 Citrix Workspace app、Citrix Secure Access Client 和 Citrix User Personalization Layer、Session Recording Agent​、​​Citrix Assistant App 和 Elastic App Layering 尚未安装在 VDA 中,您可以选择安装它们。
  • 在 VDA 升级期间,如果 Citrix Workspace app 的版本以及其他已安装的插件可以升级,则会显示升级它们的选项。
  • 在安装或升级期间,如果 Citrix Workspace app (CWA) 插件或任何组件未能安装或升级,您可以通过选中复选框“如果选定组件失败,则继续 VDA 升级或安装。”来覆盖失败并继续安装核心 VDA。
  • 在 VDA 卸载期间,您可以选择是否卸载 Citrix Workspace app (CWA) 和任何其他已安装的组件。默认情况下,除 CWA 外的所有组件都会自动卸载。CWA 的处理方式不同,除非明确选择,否则不会将其删除。
  • Citrix User Personalization Layer(Citrix 用户个性化层):安装用户个性化层的 MSI。有关详细信息,请参阅 User personalization layer

    此组件仅在单会话 Windows 10 计算机上安装 VDA 时显示。

    命令行选项:/includeadditional "User Personalization Layer" 以启用组件安装,/exclude "User Personalization Layer" 以阻止组件安装。

步骤 8. Delivery Controller™ 地址

VDA 安装程序中的 Delivery Controller 页面

Delivery Controller页面上,选择您希望如何输入已安装 Controller 的地址。Citrix 建议您在安装 VDA 时指定地址(手动执行)。VDA 必须先获取此信息才能向 Controller 注册。如果 VDA 无法注册,用户将无法访问该 VDA 上的应用程序和桌面。

  • 手动执行:(默认)输入已安装 Controller 的 FQDN,然后单击添加。如果您安装了更多 Controller,请添加它们的地址。
  • 稍后执行(高级):如果您选择此选项,向导会要求您在继续之前确认是否要执行此操作。要稍后指定地址,您可以重新运行安装程序或使用 Citrix 组策略。向导还会提醒您在摘要页面上。
  • 从 Active Directory 中选择位置:仅当计算机已加入域且用户是域用户时才有效。
  • 使用 WebSocket 令牌:创建 WebSocket VDA。WebSocketToken 用于所需的令牌。
  • 让 Machine Creation Services 自动执行:仅在使用 MCS 预配计算机时有效。

单击下一步。如果您选择了稍后执行(高级),系统会提示您确认稍后将指定 Controller 地址。

其他注意事项:

  • 地址不能包含非字母数字字符。
  • 如果您在 VDA 安装期间和组策略中指定地址,则策略设置将覆盖安装期间提供的设置。
  • 成功的 VDA 注册要求用于与 Controller 通信的防火墙端口处于打开状态。此操作在向导的防火墙页面上默认启用。
  • 在指定 Controller 位置(在 VDA 安装期间或之后)后,您可以使用自动更新功能在添加或删除 Controller 时更新 VDA。有关 VDA 如何发现和注册 Controller 的详细信息,请参阅 VDA 注册

命令行选项:/controllers

步骤 9. 代理配置

VDA 安装程序中的 Rendezvous 代理配置页面

代理配置页面仅在您在附加组件页面上启用了代理配置复选框时显示。

  1. 选择您将通过代理地址还是 PAC 文件路径指定代理源。
  2. 指定代理地址或 PAC 文件路径。

    • 代理地址格式:http://<url-or-ip>:<port>
    • PAC 文件格式:http://<url-or-ip>:<port>/<path>/<filename>.pac

代理端口的防火墙必须打开,连接测试才能成功。如果无法连接到代理,您可以选择是否继续 VDA 安装。

命令行选项:/proxyconfig

步骤 10. 启用或禁用功能

VDA 安装程序中的功能页面

在“功能”页面上,使用复选框启用或禁用您要使用的功能。

  • 使用 Windows 远程协助: 启用此功能后,Windows 远程协助将与 Director 的用户影子功能结合使用。Windows 远程协助会在防火墙中打开动态端口。(默认 = 禁用)

    命令行选项:/enable_remote_assistance

  • 使用实时音频传输: 如果您的网络中广泛使用 IP 语音,请启用此功能。此功能可降低延迟并提高音频在有损网络中的弹性。它允许使用 RTP 通过 UDP 传输音频数据。(默认 = 禁用)

    命令行选项:/enable_real_time_transport

  • 使用屏幕共享: 启用后,屏幕共享使用的端口将在 Windows 防火墙中打开。(默认 = 禁用)

    命令行选项:/enable_ss_ports

  • 此 VDA 是否安装在云中的 VM 上: 此设置有助于 Citrix 正确识别本地和服务 (Citrix Cloud™) VDA 部署的资源位置,以用于遥测目的。此功能对客户侧利用率没有影响。如果您的部署使用 Citrix DaaS,请启用此设置 (默认 = 禁用)。

    命令行选项:/xendesktopcloud

  • 安全默认设置: 此选项将各种功能的默认设置从启用更改为禁用,以实现更安全的开箱即用配置。相关功能包括:客户端驱动器重定向、特殊文件夹重定向、拖放、客户端 TWAIN 设备重定向、客户端 USB 即插即用设备重定向、客户端打印机重定向、客户端剪贴板重定向和客户端麦克风重定向。

命令行选项:/ENABLE_SECURE_DEFAULTS

单击“下一步”。

步骤 11. 防火墙端口

VDA 安装程序中的防火墙页面

在“防火墙”页面上,默认情况下,如果 Windows 防火墙服务正在运行,即使防火墙未启用,端口也会自动打开。此默认设置适用于大多数部署。有关端口信息,请参阅网络端口

单击“下一步”。

命令行选项:/enable_hdx_ports

步骤 12. 查看必备条件并确认安装

VDA 安装程序中的摘要页面

摘要”页面列出了将要安装的内容。使用“返回”按钮返回到之前的向导页面并更改选择。

准备就绪后,单击“安装”。

如果尚未安装或启用必备条件,计算机可能会重启一次或多次。请参阅准备安装

注意:

此时,您还可以单击“摘要”页面上的“生成自定义脚本”按钮,根据您当前的安装选择创建命令行脚本。此脚本可以重复用于以无人参与模式安装或升级 VDA。

步骤 13. 诊断

VDA 安装程序中的诊断页面

在“诊断”页面上,选择是否参与 Citrix Call Home。如果您选择参与(默认),请单击“连接”。出现提示时,输入您的 Citrix 帐户凭据。

凭据验证后(或者如果您选择不参与),单击“下一步”。

使用完整产品安装程序时,如果您在“诊断”页面上单击“连接”而未首先选择“收集诊断信息”,则在关闭“连接到 Citrix Insight Services”对话框后,“下一步”按钮将被禁用。您无法移动到下一页。要重新启用“下一步”按钮,请选择并立即取消选择“收集诊断信息”。

有关详细信息,请参阅 Call Home

步骤 14. 完成此安装

VDA 安装程序中的完成安装页面

完成”页面包含所有已成功安装和初始化的必备条件和组件的绿色复选标记。

单击“完成”。默认情况下,计算机将自动重启。尽管您可以禁用此自动重启,但在计算机重启之前无法使用 VDA。

后续步骤

如有需要,请重复上述过程以在其他计算机或映像上安装 VDA。

安装所有 VDA 后,启动 Studio。如果您尚未创建站点,Studio 会自动引导您完成该任务。完成后,Studio 会引导您创建计算机目录,然后创建交付组。请参阅:

Citrix Optimizer

Citrix Optimizer 是一款适用于 Windows 操作系统的工具,可帮助 Citrix 管理员通过删除和优化各种组件来优化 VDA。

安装 VDA 并完成最终重启后,下载并安装 Citrix Optimizer。请参阅 CTX224676。该 CTX 文章包含下载包以及有关安装和使用 Citrix Optimizer 的说明。

自定义 VDA

要自定义已安装的 VDA:

  1. 在 Windows 的“删除或更改程序”功能中,选择“Citrix Virtual Delivery Agent”或“Citrix Remote PC Access/VDI Core Services VDA”。然后右键单击并选择“更改”。
  2. 选择“自定义 Virtual Delivery Agent 设置”。安装程序启动后,您可以更改:

    • 控制器地址
    • 用于向控制器注册的 TCP/IP 端口(默认 = 80)
    • 是否自动打开 Windows 防火墙端口

故障排除

  • 有关 Citrix 如何报告组件安装结果的信息,请参阅 Citrix 安装返回代码

  • 在交付组的 Studio 显示中,“详细信息”窗格中的“已安装的 VDA 版本”条目可能不是计算机上安装的版本。计算机的 Windows“程序和功能”显示实际的 VDA 版本。

  • 安装 VDA 后,在向 Delivery Controller 注册之前,它无法向用户交付应用程序或桌面。

    要了解 VDA 注册方法以及如何排查注册问题,请参阅 VDA 注册

已知限制

当您使用 Citrix Workspace app for Windows 1912 或更早版本时,会话会在一段时间后断开。此问题已在 Citrix Workspace app 的较新 LTSR 和 CR 版本中修复。 有关支持的版本信息,请参阅 Citrix Workspace app for Windows / Citrix Receiver for Windows 长期服务版本