製品ドキュメント
Citrix DaaS
PDFを表示

監視とトラブルシューティング

September 15, 2025
寄稿者: 
C

スケジュールされたVDAアップグレードの監視

VDAとマシンカタログには、VDAアップグレードの準備状況と現在のステータスを監視するのに役立つ2つの属性があり、StudioまたはVDAやカタログの詳細ペインでフィルター処理に使用できる列として表示されます。

  • VDAのアップグレード
  • VDAアップグレードの状態

VDAのアップグレード

VDAのアップグレードでは、VDAまたはマシンカタログにVDA Upgrade Agentが構成されているかどうか、VDAが最新かどうか、またはアップグレードが利用可能かどうかに関する情報が提供されます。 使用可能なステータスは次のとおりです：

VDAのアップグレード（Studio） VDAのアップグレード（Powershell） 説明
カタログレベル    
未構成 MissingUpgradeType マシンカタログのアップグレードトラック（CR、LTSR、CR EAR、またはLTSR EAR）が選択されていません。
スケジュール設定 UpgradeScheduled マシンカタログのアップグレードが予定されています。
使用可能 UpgradeAvailable カタログ内のVDAは、アップグレードトラックの最新バージョンではありません。 アップグレードすることをお勧めします。
最新です UpToDate カタログ内のVDAは、アップグレードトラックの最新バージョンです。 操作は必要ありません。
不明 不明 最新のVDAのアップグレード状態を取得しています。
マシンレベル    
未構成 MissingUpgradeType VDAのマシンカタログにアップグレードトラック（CR、LTSR、CR EAR、またはLTSR EAR）が選択されていません。
スケジュール設定 UpgradeScheduled VDAのアップグレードが予定されています。
使用可能 UpgradeAvailable VDAは、アップグレードトラックの最新バージョンではありません。 アップグレードすることをお勧めします。
最新です UpToDate VDAは、アップグレードトラックの最新バージョンです。 操作は必要ありません。
状態を確認しています 不明 最新のVDAのアップグレード状態を取得しています。

注

LTSRトラックを使用するVDAの場合、VDAが最新の長期サービス（LTSR）バージョンの最新の累積更新プログラム（CU）である場合にのみ、カタログが「最新」として表示されます。 VDAが以前のLTSRバージョンの最新のCUである場合、VDAのアップグレードは引き続き利用可能と表示されます。

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 Installer
  • VDAインストールのアップグレードログは次の場所に保存されます：
    • C:\Windows\Temp\Citrix\XenDesktop Installer

VDA Upgrade Agentのバージョン

VUSを介してアップグレードの失敗をトラブルシューティングするためにデータを収集する場合、VDA上のUpgrade Agentのバージョンを知ることが重要です。 VDA Upgrade Agentのバージョンを確認するには、次のコマンドレットを使用します：Get-VusComponentVersion -ComponentType VUS。 すべてのVDAとそのVDA Upgrade Agentのバージョンが一覧表示されます。

VDA Upgrade Agentのバージョンをカタログレベルで確認するには、次のスクリプトを使用できます：

注

このスクリプトは例として提供されており、特定の環境に合わせた調整が必要な場合があります。 実稼働環境で使用する前に、スクリプトを徹底的にテストすることをお勧めします。

Param( [Parameter (Mandatory=$true)] [string] $CatalogName ) try { $Uuids = Get-BrokerMachine -CatalogName $CatalogName | Select-Object -Property UUID

if($Uuids -eq $null) { throw "カタログ名が見つかりません" +$CatalogName } Write-Output("渡されたカタログ名は "+$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 Upgrade Agentに関連するログ

VDA Upgrade Agent（VUA）ログは、アップグレードの失敗や、VUAとVDAアップグレードサービスとの通信に関する問題のトラブルシューティングに不可欠な情報を提供します。 収集できるログには、以下が含まれます：

  • Citrix Diagnostic Facility（CDF）トレース。 CDFモジュール名はVdaUpgradeAgentです。
  • Windowsイベントログ. ［イベント ビューアー］>［Windowsログ］>［アプリケーション］>［Citrix VDA Upgrade Agentサービス］でログを表示します。

VUAバージョン7.44以降の場合

VDA Upgrade Agentサービスエージェントバージョン7.44（2503リリースに含まれています）では、ログファイルが大きくなりすぎないようにしながらトラブルシューティングのための重要な情報を取得するローテーションログファイルを有効にするレジストリ設定が利用できます。 ログファイルの合計サイズは20MBに制限されます。 ファイルへのログ記録を有効にするには、次のレジストリキーを作成します：

  • キー： HKLM\SOFTWARE\Citrix\UpdateServices\UpdateAgent\LogToFile

  • 値の名前： LogToFile

  • 値の種類： REG_DWORD

  • 値のデータ：

    • 0 - ファイルトレースが無効

    • 1 - ファイルトレースが有効

PowerShellを使用してVDAにLogToFileレジストリキーを作成するには、次のコマンドレットを使用します：

New-ItemProperty -Path HKLM\SOFTWARE\Citrix\UpdateServices\UpdateAgent\LogToFile -Name LogToFile -Value 1 -PropertyType DWord -Force

大規模なマシングループに対してLogToFileを有効にするには、グループポリシー設定を使用して、すべてのVDA組織単位（OU）にLogToFileレジストリを作成することを検討してください。

注

LogToFile=1が設定されている場合、ログはファイルにのみ書き込まれます。 これらはCDFトレースには表示されません。

VUAバージョン7.43より前の場合

必要に応じて、ログが継続的にファイルに書き込まれるようにVDA Upgrade Agent構成ファイルを変更できます。 ファイルへのログ記録を有効にするには、次の手順を実行します：

  1. C:\Program Files\Citrix\CitrixUpgradeAgentフォルダーに移動します。
  2. ファイルCitrix.UpdateServices.UpdateAgent.exe.configを開きます。
  3. LogToFileの値を1に変更します。
  4. Citrix VDA Upgrade Agentサービスを再起動します。 これにより、C:\ProgramData\Citrix\Update Services\Logsにログファイルが作成されます。

注

  • .configファイルを使用してファイルへのログ記録を有効にすると、ログが継続的に書き込まれ、ストレージ領域が消費される可能性があります。 問題が解決したら、忘れずにログ記録を無効にしてください。 ログを無効にするには、まずLogToFileを0に設定してから、Citrix VDA Upgrade Agentサービスを再起動します。
  • LogToFile=1が設定されている場合、ログはファイルにのみ書き込まれます。 これらはCDFトレースには表示されません。

VDAアップグレードのダウンロードエラーに関するトラブルシューティング

VDAアップグレード機能に関連するダウンロードエラーのトラブルシューティングと解決を行うには、次の手順を実行します：

  1. URLフィルタリングが設定されている場合、関連するURLが許可リストに追加されていることを確認してください。 「VDAのアップグレード要件」を参照してください。

  2. 必要な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：ダウンロードの下のVDAフォルダーを削除し、VDAアップグレードをスケジュールします。

VDAアップグレードの検証エラーに関するトラブルシューティング

VDAアップグレード機能に関連するダウンロードエラーのトラブルシューティングと解決を行うには、次の手順を実行します：

  1. URLフィルタリングが設定されている場合は、関連するURL、特に失効チェックに必要な証明書失効一覧（CRL）またはOnline Certificate Status Protocol（OCSP）のURLが許可リストに追加されていることを確認してください。 「VDAのアップグレード要件」を参照してください。

  2. 必要なURLを許可リストに追加した後、VDAアップグレードのスケジュールを変更してみてください。

CDFトレースを有効にするか、LogToFileを1に設定して、分析用の詳細なログをキャプチャできます。 ログには次のエラーが含まれる場合があります：

  • RevocationStatusUnknown
  • The revocation function was unable to check the revocation status for the certificate.（失効機能は証明書の失効ステータスを確認できませんでした。）
  • The revocation function was unable to check revocation because the revocation server was offline.（失効サーバーがオフラインのため、失効機能が失効を確認できませんでした。）

VDA Upgrade Agentは、証明書の検証と失効チェックの実行をWindowsのシステムコールに依存しています。 上記のエラーは、エージェントがCRLまたはOCSPのURLへの接続を確立できないことを示しています。

Windows CryptoAPIは現在、プロキシ設定をサポートしていません。 CRLの発信呼び出しを容易にするVDAプロキシを構成するには、「プロキシ構成を使用するVDA」セクションを確認してください。

監視とトラブルシューティング
September 15, 2025
寄稿者: 
C
September 15, 2025
寄稿者: 
C

この記事の概要

サイトに関するフィードバック | Your privacy choices footer linkプライバシーに関する選択肢 | プライバシーと法令 | Cookieの設定 | 同意設定 | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.