Citrix Virtual Apps and Desktops 7 2311

SCCM を使用した VDA のインストール

注:

Citrix は、顧客の運用環境に合わせて調整された Microsoft System Center Configuration Manager (SCCM) などのソフトウェア配布ツールを使用して Virtual Delivery Agent (VDA) を展開することによって発生する問題について責任を負いません。インストールに関連する Citrix の問題については、Citrix Support portal を使用して、関連するインストールログを添えてテクニカルサポートケースをオープンしてください。

概要

Microsoft System Center Configuration Manager (SCCM) または同様のソフトウェア配布ツールを使用して Virtual Delivery Agent (VDA) を正常に展開するには、Citrix® は、VDA インストーラーを段階的に使用することをお勧めします。

Citrix は、VDA のインストールまたはアップグレードの一部として VDA Cleanup Utility を使用することをお勧めしません。VDA Cleanup Utility は、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インストーラーがそのマシンにコピーされます。
    • VDAWorkstationCoreSetup_XXXX.exe以外のVDAインストーラーを使用する場合、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. コンピューターの再起動: コンピューターを再起動して準備します。 Restart Computer
  2. VDAの初回インストール: VDAのインストールを開始します。
    1. コマンドラインオプションに/quiet/noreboot、および/noresumeオプションを追加します。
    2. 選択したVDAインストーラー(ローカルイメージまたは最小インストーラーのいずれか)を実行します。 Install VDA First Attempt
    3. SCCMはリターンコードをキャプチャする必要があります。
      • リターンコードが0または8の場合、インストールは完了しており、再起動が必要です。 SCCM captures return code
      • リターンコードが3の場合、マシンを再起動し、VDAの2回目インストールに制御を渡します。 Restart machine
  3. VDAの2回目インストール: VDAのインストールを続行します。
    1. VDAの初回インストール後、ファイル%programdata%\Citrix\XenDesktopSetup\CitrixVirtualDesktopAgent.xmlが存在する場合、インストールは完了しておらず、再起動が完了した後に続行する必要があります。 Install VDA Second Attempt
    2. VDAの2回目インストールは、ファイル%programdata%\Citrix\XenDesktopSetup\CitrixVirtualDesktopAgent.xmlが存在しなくなるか、0または8以外のリターンコードが返されるまで繰り返されます。その他のリターンコードはエラーとして扱い、VDAの2回目インストールはエラーを報告して停止する必要があります。
    3. 適切なVDAインストーラー(ほとんどの場合XenDesktopVdaSetup.exe、またはVDAWorkstationCoreSetup_XXXX.exeが使用された場合はXenDesktopRemotePCSetup.exe)をファイル%programdata%\ Citrix\XenDesktopSetup\ディレクトリからコマンドラインパラメーターなしで実行して、VDAのインストールを再開します。(VDAインストーラーは、インストーラーの初回実行時に保存したパラメーターを使用します。) Upgrade Task Sequence Editor
    4. VDAインストーラーからのリターンコードを確認します。
      • 0または8: 成功、インストール完了、再起動が必要です。 Success installation complete
      • 3: インストールは完了していません。マシンを再起動し、ファイル%programdata%\ Citrix\XenDesktopSetup\CitrixVirtualDesktopAgent.xmlが存在しなくなるか、0または8が返されるまでVDAの2回目インストールを繰り返します。その他のリターンコードはエラーとして扱い、VDAの2回目インストールはエラーを報告して終了する必要があります。

リターンコードの詳細については、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 のインストール