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/2503/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
Citrix バックアップおよび復元の事前チェック(/ja-jp/citrix-virtual-apps-desktops/2503/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:で始まる行に記載されています。
ログ出力(/ja-jp/citrix-virtual-apps-desktops/2503/media/log-output.png)
ログ出力
XenDesktop Installation.logの事前チェック結果は、コマンドラインに表示されるものと同じです。それらを見つけるには、ログファイルでPrecheck -を検索してください。
全体の結果がFAILの場合、修正の提案はPrecheck - Fix Suggestion:を含む行に記載されています。
ログ出力の修正提案(/ja-jp/citrix-virtual-apps-desktops/2503/media/log-output-fix-suggestion.png)
JSONアウトプット
/quiet /precheckonlyを含むコマンドが実行されるたびに、.jsonファイルが生成されます。ファイル名はPrecheckResult_{yyyyMMddHHmmss}.jsonで、タイムスタンプのサフィックスが付いています。
.jsonファイルには以下が含まれます。
- 事前チェックのローカル終了時刻
- 全体的な結果
- 事前チェックの詳細
- 基準
- 実際値
- 状態
- 修正推奨事項
FAILのステータスを持つ各事前チェック項目に対する修正案は、.jsonファイル内の事前チェックの詳細セクションにあります。
