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)を正常に展開するには、VDAインストーラーを一連の手順で使用することをCitrixではお勧めします。

VDAのインストールまたはアップグレードの一部としてVDA Cleanup Utilityを使用することはお勧めしません。VDA Cleanup Utilityは、以前にVDAインストーラーで失敗した場合にのみ使用してください。

再起動

VDAのインストール中に必要な再起動回数は、環境によって異なります。例:

  • 以前のソフトウェアインストールからの更新や再起動が保留になっている場合は、再起動が必要になることがあります。
  • 以前に別のプロセスによってロックされていたファイルは、更新が必要になり追加で再起動が必要になる場合があります。
  • VDAインストーラーの一部のオプションコンポーネント(Citrix Profile Management、Citrix Filesなど)は、再起動が必要な場合があります。

SCCMのタスクシーケンサーにより、必要なすべての再起動が管理されます。

タスクシーケンスの定義

すべての前提条件と再起動を確認したら、SCCMのタスクシーケンサーを使用して次の作業を完了します:

  • VDAは、インストールメディアのアクセス可能なコピーから、またはVDAスタンドアロンインストーラーの1つからインストールできます:

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

リターンコードについて詳しくは、「Citrixインストールリターンコード」を参照してください。

VDAインストールコマンドの例

使用可能なインストールオプションは、使用するインストーラーによって異なります。コマンドラインオプションの詳細については、次の記事を参照してください。

リモートPCアクセス用のインストールコマンド

  • 次のコマンドでは、シングルセッションのコア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のインストール