Citrix Virtual Apps and Desktops 7 2203 LTSR

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 Task Sequencer は、必要なすべての再起動を管理します。

タスクシーケンスの定義

すべての前提条件と再起動を特定したら、SCCM Task Sequencer を使用して以下を完了します。

  • 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. SCCM TASK1: マシンを再起動して準備します。
  2. SCCM TASK2: VDAのインストールを開始します。
    1. コマンドラインオプションに/quiet/noreboot、および/noresumeオプションを追加します。
    2. 選択したVDAインストーラー(ローカルイメージまたは最小インストーラーのいずれか)を実行します。
    3. SCCMはリターンコードをキャプチャする必要があります。
      • リターンコードが0または8の場合、インストールは完了しており、再起動が必要です。
      • リターンコードが3の場合、マシンを再起動してからSCCM TASK3に制御を渡します。
  3. SCCM TASK3: VDAのインストールを続行します。
    1. SCCM TASK2が0または8を返さない場合、再起動が完了した後にインストールを続行する必要があります。
    2. VDAインストーラーが0または8(インストール成功を示す)を返すか、3(SCCM TASK3を繰り返す必要があることを示す)を返すまで、SCCM TASK3を繰り返します。その他のリターンコードはエラーとして扱い、SCCM TASK3はエラーを報告して停止する必要があります。
    3. 適切なVDAインストーラー(ほとんどの場合XenDesktopVdaSetup.exe、またはXenDesktopRemotePCSetup.exeが使用された場合はVDAWorkstationCoreSetup_XXXX.exe)を、コピーされた場所(タスクシーケンスの定義で説明されている)からコマンドラインパラメーターなしで実行して、VDAのインストールを再開します。(VDAインストーラーは、インストーラーの初回実行時に保存したパラメーターを使用します。)
    4. VDAインストーラーからのリターンコードを確認します。
      • 0または8:成功、インストール完了、再起動が必要。
      • 3:インストールが完了していません。マシンを再起動し、0または8が返されるまでSCCM TASK3を繰り返します。その他のリターンコードはエラーとして扱い、SCCM TASK3はエラーを報告して終了する必要があります。

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