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インストールコマンドが配置されているネットワーク共有への「Everyone」読み取りアクセス権を必要とします。インストールコマンドは、製品版ISOでは XenDesktopVdaSetup.exe、スタンドアロンインストーラーでは VDAWorkstationSetup.exe または VDAServerSetup.exe です。
    • ログの詳細は各ローカルマシンに保存されます。レビューと分析のために結果を集中してログに記録するには、スクリプトは適切なネットワーク共有への「Everyone」読み取り/書き込みアクセス権を必要とします。

    • スクリプトの実行結果を確認するには、中央ログ共有を調べます。取得されるログには、スクリプトログ、インストーラーログ、およびMSIインストールログが含まれます。各インストールまたは削除の試行は、タイムスタンプ付きのフォルダーに記録されます。フォルダーのタイトルは、PASSまたはFAILのプレフィックスで操作結果を示します。標準のディレクトリ検索ツールを使用して、中央ログ共有で失敗したインストールまたは削除を見つけることができます。これらのツールは、ターゲットマシンでローカルに検索する代替手段を提供します。

    • インストールを開始する前に、インストールの準備のタスクを読み、完了してください。

スクリプトを使用したVDAのインストールまたはアップグレード

  1. インストールメディアの \\Support\\AdDeploy\\ からサンプルスクリプト InstallVDA.bat を入手します。Citrixは、元のスクリプトをカスタマイズする前にバックアップを作成することをお勧めします。
      1. スクリプトを編集します。
    • インストールするVDAのバージョンを指定します: SET DESIREDVERSION。完全な値は、インストールメディアの ProductVersion.txt ファイルに記載されています。ただし、完全一致は必須ではありません。
    • インストーラーが呼び出されるネットワーク共有を指定します。レイアウトのルート(ツリーの最上位)を指します。スクリプトの実行時に、インストーラーの適切なバージョン(32ビットまたは64ビット)が自動的に呼び出されます。例: SET DEPLOYSHARE=\\fileserver1\share1
    • オプションで、集中ログを保存するためのネットワーク共有の場所を指定します。例: SET LOGSHARE=\\fileserver1\log1)
    • コマンドラインを使用したインストールで説明されているVDA構成オプションを指定します。/quiet および /noreboot オプションはスクリプトにデフォルトで含まれており、必須です: SET COMMANDLINEOPTIONS=/QUIET /NOREBOOT /NORESUME
      1. グループポリシーのスタートアップスクリプトを使用して、スクリプトをマシンを含むOUに割り当てます。このOUには、VDAをインストールするマシンのみを含める必要があります。そのOU内のマシンが再起動されると、スクリプトはすべてのマシンで実行されます。サポートされているオペレーティングシステムを持つ各マシンにVDAがインストールされます。

スクリプトを使用したVDAの削除

-  1.  インストールメディアの `\\Support\\AdDeploy\\` からサンプルスクリプト `UninstallVDA.bat` を入手します。Citrixは、元のスクリプトをカスタマイズする前にバックアップを作成することをお勧めします。
-  1.  スクリプトを編集します。
-  削除するVDAのバージョンを指定します: `SET CHECK_VDA_VERSION`。完全な値は、インストールメディアの `ProductVersion.txt` ファイルに記載されています(例: 7.0.0.3018)。ただし、完全一致は必須ではありません。
-  オプションで、集中ログを保存するためのネットワーク共有の場所を指定します。
    1. グループポリシーのスタートアップスクリプトを使用して、スクリプトをマシンを含むOUに割り当てます。このOUには、VDAを削除するマシンのみを含める必要があります。OU内のマシンが再起動されると、スクリプトはすべてのマシンで実行されます。各マシンからVDAが削除されます。

トラブルシューティング

  • スクリプトは、スクリプトの実行状況を記述する内部ログファイルを生成します。スクリプトは、展開開始から数秒以内に Kickoff_VDA_Startup_Script ログを中央ログ共有にコピーします。これにより、全体的なプロセスが機能していることを確認できます。このログが期待どおりに中央ログ共有にコピーされない場合は、ローカルマシンを検査してさらにトラブルシューティングを行ってください。スクリプトは、各マシンの %temp% フォルダーに2つのデバッグログファイルを配置します。
    • Kickoff_VDA_Startup_Script_<DateTimeStamp>.log
    • VDA_Install_ProcessLog_<DateTimeStamp>.log

    これらのログを確認して、スクリプトが次のことを確認してください。

    • 期待どおりに実行されていること。
    • ターゲットオペレーティングシステムを適切に検出していること。
    • DEPLOYSHARE 共有の ROOTAutoSelect.exe という名前のファイルを含む)を指すように正しく構成されていること。
    • DEPLOYSHARE および LOG 共有の両方に対して認証できること。
  • コンポーネントインストールの結果をCitrixがどのように報告するかについては、Citrixインストールのリターンコードを参照してください。
  • デリバリーグループのStudio表示では、詳細ペインの インストール済みVDAバージョン エントリが、マシンにインストールされているバージョンと異なる場合があります。マシンのプログラムと機能の表示には、実際のVDAバージョンが表示されます。
  • VDAがインストールされた後、Delivery Controllerに登録されるまで、ユーザーにアプリやデスクトップを提供することはできません。

    VDA登録方法と登録問題のトラブルシューティングについては、VDA登録を参照してください。

スクリプトを使用したVDAのインストール