Citrix Virtual Apps and Desktops

使用 SCCM 安装 VDA

注意:

Citrix 对使用适用于客户生产环境的 Microsoft System Center Configuration Manager (SCCM) 等软件分发工具部署 Virtual Delivery Agent (VDA) 导致出现的问题不承担任何责任。对于任何与安装相关的 Citrix 问题,请使用 Citrix 支持门户开立包含相关安装日志的技术支持案例。

概述

要使用 Microsoft System Center Configuration Manager (SCCM) 或类似的软件分发工具成功部署 Virtual Delivery Agent (VDA),Citrix 建议在一系列步骤中使用 VDA 安装程序。

Citrix 不建议在 VDA 安装或升级过程中使用 VDA 清理实用程序。请仅在 VDA 安装程序之前失败时的有限情况下使用 VDA 清理实用程序。

重新启动

安装 VDA 过程中所需的重新启动次数取决于环境。例如:

  • 早期软件安装中挂起的更新或重新启动可能需要重新启动。
  • 以前被其他进程锁定的文件可能需要更新,从而强制额外重新启动。
  • VDA 安装程序中的某些可选组件(例如 Citrix Profile Management 和 Citrix Files)可能需要重新启动。

SCCM 任务排序器管理所有必需的重新启动操作。

定义任务序列

确定所有必备项并重新启动后,使用 SCCM 任务排序器完成以下操作:

  • 可以从安装介质的可访问副本或其中一个 VDA 独立安装程序安装 VDA:

    • VDAWorkstationSetup_XXXX.exe
    • VDAServerSetup_XXXX.exe
    • VDAWorkstationCoreSetup_XXXX.exe

    有关 VDA 安装程序的详细信息,请参阅安装程序

  • 升级 VDA 时,安装了 VDA 的计算机必须处于维护模式,没有任何会话。
  • 首次在计算机上运行 VDA 安装时,正在使用的 VDA 安装程序将复制到该计算机上。
    • 使用 VDA 安装程序而非 VDAWorkstationCoreSetup_XXXX.exe 时,VDA 安装程序将复制到 %ProgramData%\Citrix\XenDesktopSetup\XenDesktopVdaSetup.exe
    • 使用 VDAWorkstationCoreSetup_XXXX.exe 时,VDA 安装程序将复制到 %ProgramData%\Citrix\XenDesktopSetup\XenDesktopRemotePCSetup.exe。 `
  • VDA 安装程序的目录位置也存储在注册表 “HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\MetaInstall” “MetaInstallerInstallLocation” 中。
  • 将命令行选项 /NOREBOOT/NORESUME/QUIET 添加到您的命令行选项中。
    • /QUIET:在安装过程中不显示用户界面,以便 SCCM 可以控制安装过程。
    • /NOREBOOT:禁止 VDA 安装程序自动重新启动。SCCM 触发器在需要时重新启动。
    • /NORESUME:通常情况下,在安装过程中需要重新启动时,VDA 安装程序会设置一个 runonce 注册表项 (\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\RunOnce)。计算机重新启动时,Windows 使用该注册表项启动 VDA 安装程序。这对 SCCM 来说是个问题,因为 SCCM 无法监视安装并捕获退出代码。

使用 SCCM 的安装顺序示例

以下示例显示了安装顺序。

  1. 重新启动计算机: 通过重新启动计算机来准备计算机。 重新启动计算机
  2. 首次尝试安装 VDA: 启动 VDA 安装。
    1. /quiet/noreboot/noresume 选项添加到您的命令行选项中。
    2. 运行您选择的 VDA 安装程序(本地映像或其中一个最小的安装程序)。 首次尝试安装 VDA
    3. SCCM 必须捕获返回代码。
      • 如果返回代码为 0 或 8,则表示安装完成,需要重新启动。 SCCM 捕获返回代码
      • 如果返回代码为 3,请重新启动计算机,然后传递控制权以再次尝试安装 VDA重新启动计算机
  3. 再次尝试安装 VDA: 继续安装 VDA。
    1. 首次尝试安装 VDA 后如果文件 %programdata%\Citrix\XenDesktopSetup\CitrixVirtualDesktopAgent.xml 存在,则安装未完成,必须在重新启动完成后继续安装。 再次尝试安装 VDA
    2. 再次尝试安装 VDA 重复进行,直到文件 %programdata%\Citrix\XenDesktopSetup\CitrixVirtualDesktopAgent.xml 不存在或者返回 0 或 8 以外的返回代码。将任何其他返回代码视为错误,“再次尝试安装 VDA”应报告错误并停止。
    3. 通过运行文件 %programdata%\ Citrix\XenDesktopSetup\ 目录中相应的 VDA 应用程序(在大多数情况下为 XenDesktopVdaSetup.exe,如果使用 VDAWorkstationCoreSetup_XXXX.exe,则为 XenDesktopRemotePCSetup.exe)但不使用命令行参数来恢复 VDA 安装。(VDA 安装程序使用其在首次运行安装程序时保存的参数。) 升级任务序列编辑器
    4. 注意 VDA 安装程序的返回代码。
      • 0 或 8:成功、安装完成、需要重新启动。 成功安装完成
      • 3:安装未完成。重新启动计算机并重复执行“再次尝试安装 VDA”操作,直至文件 %programdata%\ Citrix\XenDesktopSetup\CitrixVirtualDesktopAgent.xml 不存在或者返回 0 或 8。将任何其他返回代码视为错误,“再次尝试安装 VDA”应报告错误并结束。

有关返回代码的详细信息,请参阅 Citrix 安装返回代码

VDA 安装命令示例

可用的安装选项有所不同,具体取决于使用的安装程序。有关命令行选项详细信息,请参阅以下文章。

Remote PC Access 的安装命令

  • 以下命令使用单会话核心 VDA 安装程序 (VDAWorkstationCoreSetup.exe):

    VDAWorkstationCoreSetup.exe /quiet /controllers “control.domain.com” /enable_hdx_ports /noresume /noreboot

  • 以下命令使用单会话完整 VDA 安装程序 (VDAWorkstationSetup.exe):

    VDAWorkstationSetup.exe /quiet /remotepc /physicalmachine /controllers “control.domain.com” /enable_hdx_ports /noresume /noreboot

专用 VDI 的安装命令

  • 以下命令使用单会话完整 VDA 安装程序 (VDAWorkstationSetup.exe):

    VDAWorkstationSetup.exe /quiet /components vda /controllers “control.domain.com” /enable_hdx_ports /enable_remote_assistance /noresume /noreboot

使用 SCCM 安装 VDA