Citrix Virtual Apps and Desktops

スクリプトを使用した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インストールコマンドがあるネットワーク共有に対するすべてのユーザーの読み取りアクセスが必要です。インストールコマンドは、完全な製品ISOではXenDesktopVdaSetup.exe、スタンドアロンインストーラーではVDAWorkstationSetup.exeまたはVDAServerSetup.exeです。
  • ログの詳細は各ローカルマシンに保存されます。また、レビューおよび分析のために結果ログをネットワーク上に保存する場合は、そのネットワーク共有に対するすべてのユーザーの読み取りおよび書き込みアクセスが必要です。

スクリプトの実行結果をチェックするには、ネットワーク共有のログを調べます。このログには、スクリプトログ、インストーラーログ、およびMSIインストールログが含まれます。各インストールまたは削除に関するログは、日時を示すフォルダー内に保存されます。フォルダー名には、操作の結果としてPASSまたはFAILのプレフィックスが付きます。失敗したインストールまたは削除処理を検索できるように、ネットワーク共有を使用します。これにより、ターゲットマシンのローカルドライブに代わるツールが提供されます。

インストールを始める前に、「インストールの準備」を読んで、必要なタスクを完了しておいてください。

スクリプトを使ってVDAをインストールまたはアップグレードする

  1. インストールメディアの\Support\AdDeploy\にあるInstallVDA.batサンプルスクリプトを開きます。スクリプトをカスタマイズする前に、元のスクリプトをバックアップしておくことをお勧めします。
  2. スクリプトを編集します:
    • インストールするVDAのバージョンを指定します:SET DESIREDVERSION。Version 7の場合はバージョンを「7.0」と指定できます。完全な値は、インストールメディアのProductVersion.txtファイルに記載されています。ただし、完全に一致させる必要はありません。
    • 実行するインストーラーのネットワーク共有を指定します。レイアウトのルート(ツリーの最上位)を指定します。スクリプトにより、適切なバージョンのインストーラー(32ビットまたは64ビット)が自動的に実行されます。例:SET DEPLOYSHARE=\\fileserver1\share1
    • オプションとして、ログを保存するためのネットワーク共有を指定します。例:SET LOGSHARE=\\fileserver1\log1)
    • コマンドラインを使ったインストール」の説明に従って、VDAの構成オプションを指定します。/quietおよび/norebootオプションはスクリプトにデフォルトで含まれており、必須です:SET COMMANDLINEOPTIONS=/QUIET /NOREBOOT
  3. グループポリシースタートアップスクリプトを使って、マシンが存在する組織単位にスクリプトを割り当てます。VDAをインストールするマシン以外のものがこの組織単位に属していないことを確認してください。組織単位内のマシンの再起動時にスクリプトが実行され、サポートされるオペレーティングシステムの各マシン上にVDAがインストールされます。

スクリプトを使ってVDAを削除する

  1. インストールメディアの\Support\AdDeploy\からサンプルスクリプトのUninstallVDA.batを開きます。スクリプトをカスタマイズする前に、元のスクリプトをバックアップしておくことをお勧めします。
  2. スクリプトを編集します。
    • 削除するVDAのバージョンを指定します:SET CHECK\_VDA\_VERSION。Version 7の場合はバージョンを「7.0」と指定できます。完全な値はインストールメディアのProductVersion.txtファイルに記述されています(7.0.0.3018など)。ただし、完全に一致させる必要はありません。
    • オプションとして、ログを保存するためのネットワーク共有を指定します。
  3. グループポリシースタートアップスクリプトを使って、マシンが存在する組織単位にスクリプトを割り当てます。VDAを削除するマシン以外のものがこの組織単位に属していないことを確認してください。組織単位内のマシンの再起動時にスクリプトが実行され、各マシンからVDAが削除されます。

トラブルシューティング

スクリプトにより、スクリプトの進捗を示す内部ログファイルが生成されます。スクリプトは、展開の開始後すぐにKickoff_VDA_Startup_Scriptログをネットワーク共有にコピーします。これにより、処理全体が実行中であることを確認できます。このログがネットワーク共有にコピーされない場合は、ローカルマシンを調べることでトラブルシューティングを実行します。スクリプトにより、各マシンの%temp%フォルダーに以下の2つのデバッグログファイルが生成されます。

  • Kickoff_VDA_Startup_Script_<DateTimeStamp>.log
  • VDA_Install_ProcessLog_<DateTimeStamp>.log

これらのログから、次の点を確認します。

  • スクリプトが正しく実行されたかどうか。
  • ターゲットのオペレーティングシステムが正しく検出されているかどうか。
  • DEPLOYSHARE共有でROOT(AutoSelect.exeファイルを含んでいるフォルダー)が正しく構成されているかどうか。
  • DEPLOYSHAREおよびLOGで指定した両方のネットワーク共有にアクセスできるかどうか。
スクリプトを使用したVDAのインストール