VUSの監視とトラブルシューティング
スケジュールされたVDAアップグレードの監視
VDAとマシンカタログには、VDAアップグレードの準備状況と現在のステータスを監視するのに役立つ2つの属性があります。これらは、StudioまたはVDAやカタログの詳細ペインでフィルタリングに使用できる列として表示されます。
-
VDAアップグレード
-
VDAアップグレードの状態
VDAアップグレード
VDAアップグレードは、VDAまたはマシンカタログにVDAアップグレードエージェントが構成されているかどうか、およびVDAが最新であるか、またはアップグレードが利用可能であるかに関する情報を提供します。利用可能なステータスは次のとおりです。
| VDAアップグレード (Studio) | VDAアップグレード (Powershell) | 説明 |
|---|---|---|
| カタログレベル | ||
| 未構成 | MissingUpgradeType | マシンカタログに対して、アップグレードトラック (CR、LTSR、CR EAR、またはLTSR EAR) が選択されていません。 |
| スケジュール済み | UpgradeScheduled | マシンカタログのアップグレードがスケジュールされています。 |
| 利用可能 | UpgradeAvailable | カタログ内のVDAは、アップグレードトラックの最新バージョンではありません。アップグレードが推奨されます。 |
| 最新 | UpToDate | カタログ内のVDAは、アップグレードトラックの最新バージョンです。アクションは不要です。または、VDAの現在のオペレーティングシステムをサポートする利用可能なアップグレードターゲットがありません。 |
| 不明 | 不明 | 最新のVDAアップグレード状態を取得しています。 |
| マシンレベル | ||
| 未構成 | MissingUpgradeType | VDAのマシンカタログに対して、アップグレードトラック（CR、LTSR、CR EAR、またはLTSR EAR）が選択されていません。 |
| スケジュール済み | UpgradeScheduled | VDAのアップグレードがスケジュールされています。 |
| 利用可能 | UpgradeAvailable | VDAはアップグレードトラックの最新バージョンではありません。アップグレードが推奨されます。 |
| 最新 | UpToDate | VDAはアップグレードトラックの最新バージョンです。アクションは不要です。または、VDAの現在のオペレーティングシステムをサポートする利用可能なアップグレードターゲットがありません。 |
| 状態を確認中 | 不明 | 最新のVDAアップグレード状態を取得しています。 |
注:
-
LTSRトラックを使用しているVDAの場合、カタログは、VDAが最新の長期サービス (LTSR) バージョンの最新の累積更新プログラム (CU) にある場合にのみ「最新」と表示されます。VDAが以前のLTSRバージョンの最新のCUにある場合でも、VDAアップグレードは利用可能と表示されます。
-
利用可能なアップグレードターゲットが現在のオペレーティングシステムをサポートしていない場合 (例: CVAD 2407以降のWindows Server 2016)、VDAも「最新」と表示されます。その場合、VDAアップグレードウィザードはVDAのターゲットを提供しません。アップグレードするには、マシンをサポートされているオペレーティングシステムに再イメージングしてから、アップグレードをスケジュールしてください。ターゲットバージョンのシステム要件とCTX224843を参照してください。
VDAアップグレードの状態
VDAアップグレードの状態は、スケジュールされたアップグレードのステータスに関する情報を提供します。VDAアップグレードの状態のステータスは次のとおりです。
| VDAアップグレードの状態 (Studio) | VDAアップグレードの状態 (PowerShell) | 説明 |
|---|---|---|
| カタログレベル | ||
| スケジュールされていません | NotScheduled | カタログのアップグレードはスケジュールされていません。 |
| スケジュール済み | UpgradeScheduled | カタログのアップグレードがスケジュールされています。 |
| 進行中 | UpgradeInProgress | カタログのアップグレードが進行中です。 |
| キャンセル済み | UpgradeCancelled | カタログのアップグレードがキャンセルされました。これは、手動によるキャンセル、または失敗しきい値に達したことが原因である可能性があります。 |
| 失敗 | UpgradeFailed | カタログのスケジュールされたアップグレードが失敗しました。 |
| 成功 | UpgradeSuccessful | カタログのスケジュールされたアップグレードが正常に完了しました。注: アップグレードが成功したからといって、カタログ内のすべてのVDAが正常にアップグレードされたわけではありません。 |
| - | 空 | カタログのアップグレードはスケジュールされていません。 |
| マシンレベル | ||
| スケジュール済み | UpgradeScheduled | VDAのアップグレードがスケジュールされています。 |
| アップグレード待機中 | UpgradeInUpgradeWindow | スケジュールされたアップグレードはアクティブですが、VDAはまだアップグレードを開始していません。VDAアップグレードの負荷分散方法の詳細については、「同時実行」を参照してください。 |
| 進行中 | UpgradeInProgress | VDAは現在アップグレード中です。 |
| キャンセル済み | UpgradeCancelled | アップグレードが開始される前に、VDAのスケジュールされたアップグレードがキャンセルされました。 |
| アップグレード失敗 | UpgradeFailed | VDAはアップグレードを開始しましたが、アップグレードは正常に完了しませんでした。詳細については、「トラブルシューティング」を参照してください。 |
| 成功 | UpgradeSuccess | VDAは正常にアップグレードされました。 |
| 検証に失敗しました | UpgradeValidationFailed | VDAインストーラーのメタデータをダウンロード中に、証明書の検証に失敗しました。 |
| - | 空 | VDAのアップグレードはスケジュールされていません。 |
スケジュールされたVDAアップグレードのトラブルシューティング
アップグレードの失敗が発生した場合、以下のログは問題の特定とトラブルシューティングに役立ちます。これらのログをCitrixテクニカルサポートと共有することで、サポートプロセスを迅速化することもできます。
VDAインストールログ
アップグレードの失敗をトラブルシューティングする際は、VDAの初期インストールと失敗したアップグレードの両方のログを収集して確認してください。インストールおよびアップグレードのログは、以下の場所にあります。
-
VDAインストールのインストールログは、次の場所にあります。
-
%temp%/Citrix/XenDesktop インストーラー
-
-
VDAインストールのアップグレードログは、次のいずれかの場所にあります。
-
C:\Windows\Temp\Citrix\XenDesktop Installer または
-
C:\Windows\SystemTemp\Citrix\XenDesktop インストーラー
-
VDA アップグレードエージェントのバージョン
VUS を介してアップグレードの失敗をトラブルシューティングするためにデータを収集する際、VDA 上のアップグレードエージェントのバージョンを知ることが重要です。VDA アップグレードエージェントのバージョンを確認するには、次のコマンドレットを使用します:
Get-VusComponentVersion -ComponentType VUS。これにより、すべての VDA とその VDA アップグレードエージェントのバージョンが一覧表示されます。
カタログレベルで VDA アップグレードエージェントのバージョンを確認するには、次のスクリプトを使用できます。
注:
このスクリプトは例として提供されており、特定の環境に合わせて調整する必要がある場合があります。本番環境で使用する前に、スクリプトを十分にテストすることをお勧めします。
Param( [Parameter (Mandatory=$true)] [string] $CatalogName ) try { $Uuids = Get-BrokerMachine -CatalogName $CatalogName | Select-Object -Property UUID
if($Uuids -eq $null) { throw "Cannot find CatalogName " +$CatalogName } Write-Output("Catalog Name passed is "+$CatalogName)
foreach($Uuid in $Uuids) { $compVersion = Get-VusComponentVersion -MachineId $machine.UUID -ComponentType VUS $Machine = Get-BrokerMachine -UUID $compVersion.MachineId Write-Output(“MachineName: “+$Machine.MachineName+”, Machine UUID:”+$machine.MachineId+”, VUA Version:”+$compVersion.Version) } } catch { Write-Output(“Exception Occured”) Write-Host $_ }
VDA アップグレードエージェントに関連するログ
VDA アップグレードエージェント (VUA) のログは、アップグレードの失敗や VUA と VDA アップグレードサービスとの通信に関する問題のトラブルシューティングに不可欠な情報を提供できます。収集できるログには次のものがあります。
-
Citrix Diagnostic Facility (CDF) トレース。CDF モジュール名は VdaUpgradeAgent です。
-
Windows イベントログ。イベントビューアー > Windows ログ > アプリケーション > Citrix VDA Upgrade Agent Service でログを表示します。
VUA バージョン 7.44 以降の場合
VDA アップグレードサービスエージェントバージョン 7.44 (2503 リリースに含まれる) では、管理者がトラブルシューティングのための重要な情報をキャプチャしつつ、ログファイルが大きくなりすぎるのを防ぐローテーションログファイルを有効にできるレジストリ設定が利用可能です。ログファイルの合計サイズは 20 MB に制限されています。ファイルへのログ記録を有効にするには、次のレジストリキーを作成します。
-
キー:
New-ItemProperty -Path HKLM:\SOFTWARE\Citrix\UpdateServices\UpdateAgent -Name LogToFile -Value 1 -PropertyType DWord -Force -
値の名前:
LogToFile -
値の型:
REG_DWORD -
値のデータ:
-
0- ファイルトレース無効 -
1- ファイルトレース有効
-
PowerShell を使用して VDA 上に LogToFile レジストリキーを作成するには、次のコマンドレットを使用します:
New-ItemProperty -Path HKLM:\SOFTWARE\Citrix\UpdateServices\UpdateAgent -Name LogToFile -Value 1 -PropertyType DWord -Force
大規模なマシン群に対して LogToFile を有効にするには、グループポリシー設定を使用してすべての VDA 組織単位 (OU) に LogToFile レジストリを作成することを検討してください。
注:
-
LogToFile=1が設定されている場合、ログはファイルにのみ書き込まれます。CDF トレースには表示されません。 -
レジストリの変更を有効にするには、VDA Upgrade Agent サービスの再起動が必要です
-
ログファイルは C:\ProgramData\Citrix\Update Services\Logs フォルダーに作成されます
VUA バージョン 7.43 より前の場合
必要に応じて、VDAアップグレードエージェントの構成ファイルを変更して、ログが継続的にファイルに書き込まれるようにすることができます。ファイルへのログ記録を有効にするには、次の手順に従います。
-
C:\Program Files\Citrix\CitrixUpgradeAgentフォルダーに移動します。 -
Citrix.UpdateServices.UpdateAgent.exe.configファイルを開きます。 -
LogToFileの値を1に変更します。 -
Citrix VDAアップグレードエージェントサービスを再起動します。これにより、
C:\ProgramData\Citrix\Update Services\Logsにログファイルが作成されます。
注：
-
.configファイルを通じてファイルへのログ記録を有効にすると、ログが継続的に書き込まれ、ストレージ容量を消費する可能性があります。問題が解決したら、ログ記録を無効にすることを忘れないでください。ログ記録を無効にするには、まず
LogToFileを0に設定し、その後Citrix VDAアップグレードエージェントサービスを再起動します。 -
LogToFile=1が設定されている場合、ログはファイルにのみ書き込まれます。CDFトレースには表示されません。
VDAアップグレードのダウンロード失敗のトラブルシューティング
VDAアップグレード機能に関連するダウンロードの失敗をトラブルシューティングし、解決するには、以下の手順に従ってください。
-
URLフィルタリングが実施されている場合は、関連するURLが許可リストに追加されていることを確認してください。VDAアップグレード要件を参照してください。
-
必要なURLを許可リストに追加した後、VDAアップグレードの再スケジュールを試してください。
CDFトレースを有効にするか、
LogToFileを1に設定して、分析用の詳細なログをキャプチャできます。ダウンロードの失敗の問題が解決しない場合は、エラーを確認してください。次のエラーメッセージ「Download Failed: This access control list is not in canonical form and therefore cannot be modified」が表示される場合、それはC:\ProgramData\Citrix\UpgradeServices\Downloads\VDAフォルダーのアクセス許可が正しくないことを示しています。
この問題に対処するには、次のいずれかを実行します。
-
オプション1： 次のコマンドを使用して、フォルダーのアクセス制御リスト（ACL）をリセットします。（このコマンドは、一致するすべてのファイルに対して、デフォルトで継承されたACLでACLをリセットします。）
-
icacls.exe "C:\ProgramData\Citrix\UpgradeServices\Downloads\VDA" /reset /T /C /L /Q
-
-
オプション2： Downloadsの下にあるVDAフォルダーを削除し、VDAアップグレードをスケジュールします。
VDAアップグレード検証の失敗のトラブルシューティング
VDAアップグレード機能に関連するダウンロードの失敗をトラブルシューティングし、解決するには、以下の手順に従ってください。
-
URLフィルタリングが有効な場合は、関連するURLが許可リストに追加されていることを確認してください。特に、失効チェックに必要な証明書失効リスト (CRL) またはオンライン証明書ステータスプロトコル (OCSP) のURLです。VDAアップグレード要件を参照してください。
-
必要なURLを許可リストに追加した後、VDAアップグレードの再スケジュールを試してください。
分析のために詳細なログをキャプチャするには、CDFトレースを有効にするか、LogToFileを1に設定することをお勧めします。ログには以下のエラーが含まれる場合があります。
-
RevocationStatusUnknown
-
失効機能は、証明書の失効ステータスを確認できませんでした。
-
失効サーバーがオフラインだったため、失効機能は失効を確認できませんでした。
VDAアップグレードエージェントは、Windowsシステムコールに依存して証明書を検証し、失効チェックを実行します。上記のエラーは、エージェントがCRLまたはOCSPのURLへの接続を確立できないことを示しています。
Windows CryptoAPIは現在、プロキシ設定をサポートしていません。送信CRL呼び出しを容易にするためにVDAプロキシを構成するには、「プロキシ構成を持つVDA」セクションを確認してください。