VDAのインストールとアップグレードの事前チェック

VDAのインストールとアップグレードのための分離された事前フライトチェックを導入し、お客様が続行する前に潜在的な問題を事前に特定できるようにします。このチェックは、すべての依存関係と前提条件を検証し、各条件に対して明確な合否ステータスを提供します。失敗が発生した場合は、具体的な推奨事項を含む詳細な修復ガイダンスが提供されます。実際のインストールまたはアップグレードプロセスは分離されており、事前チェックが完了した後に手動で開始する必要があります。

この記事では、VDAのインストールとアップグレードの事前チェックを実行する手順について説明します。

ステップ1. コマンドラインを実行する

注：

• 事前チェックはコマンドラインモードでのみサポートされています。
• このコマンドを実行しても、インストールまたはアップグレードは開始されません。

事前チェックを実行するには、インストールまたはアップグレードによく使用するコマンドに/precheckonlyオプションを追加します。VDAのインストールまたはアップグレードに関するすべての事前チェック条件が確認されます。

デフォルトのインストールとアップグレードの事前チェックを実行する

事前チェックを実行し、マシンの状態が許容できる状態であることを確認するには、次のコマンドを実行します。 \x64\XenDesktop Setup\XenDesktopVdaSetup.exe /quiet /precheckonly

指定されたコンポーネントのインストールとアップグレードの事前チェックを実行する

インストールまたはアップグレードの前に特定のコンポーネントの前提条件を確認するには、コマンドに/precheckonlyを追加します。 \x64\XenDesktop Setup\XenDesktopVdaSetup.exe /quiet /precheckonly /components vda,plugins

追加コンポーネント（Citrix Backup and Restore）のインストールとアップグレードの事前チェックを実行する

コマンド \x64\XenDesktop Setup\XenDesktopVdaSetup.exe /quiet /precheckonly は、オプションのチェックとして Citrix Backup and Restore コンポーネントの前提条件を確認します。オプションのチェックを除いてすべての事前チェックが合格した場合、全体の結果は PASS になります。

追加コンポーネントの事前チェック(/ja-jp/citrix-virtual-apps-desktops/2511/media/precheck-for-additional-components.png)

次のコマンドは、必須チェックの一部として Citrix Backup and Restore コンポーネントの前提条件を確認します。

• \x64\XenDesktop Setup\XenDesktopVdaSetup.exe /quiet /precheckonly /includeadditional "Citrix Backup and Restore"
• \x64\XenDesktop Setup\XenDesktopVdaSetup.exe /quiet /precheckonly /enablerestore
• \x64\XenDesktop Setup\XenDesktopVdaSetup.exe /quiet /precheckonly /enablerestorecleanup

シトリックス バックアップおよびリストアの事前チェック(/ja-jp/citrix-virtual-apps-desktops/2511/media/precheck-for-citrix-backup-and-restore.png)

ステップ 2. 事前チェック結果の表示

事前チェックの結果は、コマンドラインに表示され、%temp%/Citrix/XenDesktop Installer/XenDesktop Installation.log にログ記録され、%temp%/Citrix/XenDesktop Installer/PrecheckResult_{yyyyMMddHHmmss}.json に保存されます。事前チェックが失敗した場合、全体の結果は FAIL となり、各問題に対する修正案が示されます。

コマンドライン出力

コマンドラインの事前チェック結果には、次のものが含まれます。

• 事前チェック基準
• 事前チェックステータス
• 失敗に対する修正案
• 全体結果
• 終了時刻。

結果が FAIL の場合、修正の提案は、Precheck - Fix Suggestion: で始まる行にあります。

ログ出力

XenDesktop Installation.log のプレチェック結果は、コマンドラインに表示されるものと同じです。それらを見つけるには、ログファイルで Precheck - を検索してください。 全体的な結果が FAIL の場合、修正の提案は Precheck - Fix Suggestion: を含む行にあります。

JSON形式出力

/quiet /precheckonly を含むコマンドが実行されるたびに、.json ファイルが生成されます。ファイル名は PrecheckResult_{yyyyMMddHHmmss}.json で、タイムスタンプのサフィックスが付いています。

.json ファイルには以下が含まれます:

• プレチェックのローカル終了時刻
• 全体的な結果
• プレチェックの詳細
  • 基準
  • 実際の値
  • 状態
  • 修正推奨事項

FAILのステータスを持つ各事前チェック項目に対する修正案は、.jsonファイル内の事前チェックの詳細セクションで確認できます。