スクリプトを使用してVDAをインストールする
注:
Citrixは、お客様の運用環境に合わせて調整されたスクリプトによって引き起こされる問題について責任を負いません。インストール関連のCitrixの問題については、Citrixサポートポータルを使用して、関連するインストールログとともにテクニカルサポートケースをオープンしてください。
この記事は、Windowsオペレーティングシステムを搭載したマシンにVDAをインストールする場合に適用されます。Linuxオペレーティングシステム用VDAの詳細については、Linux Virtual Delivery Agentのドキュメントを参照してください。
インストールメディアには、Active Directory内のマシンにVirtual Delivery Agent (VDA) をインストール、アップグレード、または削除するサンプルスクリプトが含まれています。これらのスクリプトは、Machine Creation Services™およびCitrix Provisioning (旧Provisioning Services) で使用されるマスターイメージの保守にも使用できます。
必要なアクセス権:
-
スクリプトには、VDAインストールコマンドが配置されているネットワーク共有への「Everyone読み取り」アクセス権が必要です。インストールコマンドは、製品版ISOでは
XenDesktopVdaSetup.exe、スタンドアロンインストーラーではVDAWorkstationSetup.exeまたはVDAServerSetup.exeです。 -
ログの詳細は各ローカルマシンに保存されます。レビューと分析のために結果を集中してログに記録するには、スクリプトに適切なネットワーク共有への「Everyone読み取り/書き込み」アクセス権が必要です。
スクリプト実行の結果を確認するには、中央ログ共有を調べます。キャプチャされたログには、スクリプトログ、インストーラーログ、MSIインストールログが含まれます。各インストールまたは削除の試行は、タイムスタンプ付きのフォルダーに記録されます。フォルダーのタイトルは、PASSまたはFAILのプレフィックスで操作結果を示します。標準のディレクトリ検索ツールを使用して、中央ログ共有で失敗したインストールまたは削除を見つけることができます。これらのツールは、ターゲットマシンでローカルに検索する代替手段を提供します。
インストールを開始する前に、インストールの準備のタスクを読み、完了してください。
スクリプトを使用してVDAをインストールまたはアップグレードする
-
インストールメディアの
\Support\AdDeploy\からサンプルスクリプトInstallVDA.batを入手します。Citrixは、スクリプトをカスタマイズする前に元のスクリプトのバックアップを作成することをお勧めします。 -
スクリプトを編集します:
-
インストールするVDAのバージョンを指定します:
SET DESIREDVERSION。完全な値は、インストールメディアのProductVersion.txtファイルに記載されています。ただし、完全に一致している必要はありません。 -
インストーラーが呼び出されるネットワーク共有を指定します。レイアウトのルート（ツリーの最上位）を指します。スクリプトの実行時に、適切なバージョンのインストーラー（32ビットまたは64ビット）が自動的に呼び出されます。例:
SET DEPLOYSHARE=\\fileserver1\share1。 -
オプションで、集中ログを保存するためのネットワーク共有の場所を指定します。例:
SET LOGSHARE=\\fileserver1\log1)。 -
コマンドラインを使用したインストールで説明されているように、VDA構成オプションを指定します。
/quietと/norebootオプションはスクリプトにデフォルトで含まれており、必須です:SET COMMANDLINEOPTIONS=/QUIET /NOREBOOT /NORESUME。
-
-
グループポリシーのスタートアップスクリプトを使用して、スクリプトをマシンを含むOUに割り当てます。このOUには、VDAをインストールするマシンのみを含める必要があります。そのOU内のマシンが再起動されると、スクリプトはすべてのマシンで実行されます。サポートされているオペレーティングシステムを持つ各マシンにVDAがインストールされます。
スクリプトを使用してVDAを削除する
-
インストールメディアの
\Support\AdDeploy\からサンプルスクリプトUninstallVDA.batを入手します。Citrixは、スクリプトをカスタマイズする前に元のスクリプトのバックアップを作成することをお勧めします。 -
スクリプトを編集します。
-
削除するVDAのバージョンを指定します:
SET CHECK\_VDA\_VERSION。完全な値は、インストールメディアのProductVersion.txtファイル（例: 7.0.0.3018）で確認できます。ただし、完全一致は必須ではありません。 -
オプションで、集中ログを保存するためのネットワーク共有の場所を指定します。
-
-
グループポリシーのスタートアップスクリプトを使用して、スクリプトをマシンを含むOUに割り当てます。このOUには、VDAを削除するマシンのみを含める必要があります。OU内のマシンが再起動されると、スクリプトはすべてのマシンで実行されます。各マシンからVDAが削除されます。
トラブルシューティング
-
スクリプトは、スクリプトの実行状況を記述する内部ログファイルを生成します。スクリプトは、展開開始から数秒以内に
Kickoff_VDA_Startup_Scriptログを中央ログ共有にコピーします。これにより、全体的なプロセスが機能していることを確認できます。このログが期待どおりに中央ログ共有にコピーされない場合は、ローカルマシンを検査してさらにトラブルシューティングを行ってください。スクリプトは、各マシンの%temp%フォルダーに2つのデバッグログファイルを配置します。-
Kickoff_VDA_Startup_Script_<DateTimeStamp>.log -
VDA_Install_ProcessLog_<DateTimeStamp>.log
これらのログを確認して、スクリプトが次の状態であることを確認します。-
期待どおりに実行されている。
-
ターゲットオペレーティングシステムを適切に検出している。
-
DEPLOYSHARE共有のROOTを指すように正しく構成されている（AutoSelect.exeという名前のファイルが含まれている）。 -
DEPLOYSHAREとLOGの両方の共有に対して認証できる。
-
-
コンポーネントインストールの結果をCitrixがどのように報告するかについては、Citrixインストールリターンコードを参照してください。
-
デリバリーグループのStudio表示では、「詳細」ペインの「インストール済みVDAバージョン」エントリが、マシンにインストールされているバージョンと異なる場合があります。マシンのプログラムと機能の表示には、実際のVDAバージョンが表示されます。
-
VDAがインストールされた後、Delivery Controllerに登録されるまで、ユーザーにアプリやデスクトップを配信することはできません。VDAの登録方法と登録の問題のトラブルシューティング方法については、「VDA登録」を参照してください。