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

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

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

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

VDAアップグレード

VDAアップグレードは、VDAまたはマシンカタログにVDAアップグレードエージェントが構成されているか、VDAが最新であるか、またはアップグレードが利用可能であるかに関する情報を提供します。利用可能なステータスは次のとおりです。

注:

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

VDAアップグレードの状態

VDAアップグレード状態は、スケジュールされたアップグレードのステータスに関する情報を提供します。VDAアップグレード状態のステータスは次のとおりです。

スケジュールされたVDAアップグレードのトラブルシューティング

アップグレードの失敗が発生した場合、以下のログは問題の特定とトラブルシューティングに役立ちます。これらのログをCitrixテクニカルサポートと共有して、サポートプロセスを迅速化することもできます。

VDAインストールログ

アップグレードの失敗をトラブルシューティングする際は、VDAの初期インストールと失敗したアップグレードの両方のログを収集して確認してください。インストールおよびアップグレードのログは、次の場所にあります。

• VDAインストールのインストールログは次の場所にあります。
  • %temp%/Citrix/XenDesktop Installer
• VDAインストールのアップグレードログは次のいずれかの場所にあります。
  • C:\Windows\Temp\Citrix\XenDesktop Installer or
  • C:\Windows\SystemTemp\Citrix\XenDesktop Installer

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 診断機能 (CDF) のトレース。CDF モジュール名は VdaUpgradeAgent です。
• Windowsイベントログ。ログは、イベントビューアー > Windowsログ > アプリケーション > Citrix VDA Upgrade Agent Serviceで表示します。

管理者が、トラブルシューティングに不可欠な情報をキャプチャしつつ、ログファイルが肥大化するのを防ぐローテーションログファイルを有効にできるレジストリ設定が利用可能です。ログファイルの合計サイズは20 MBに制限されています。ファイルへのログ記録を有効にするには、次のレジストリキーを作成します。

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

• 値の名前: LogToFile

• 値の型: REG_DWORD

• 値のデータ:

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

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

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

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

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

注:

• LogToFile=1が設定されている場合、ログはファイルにのみ書き込まれます。CDFトレースには表示されません。
• レジストリの変更を有効にするには、VDAアップグレードエージェントサービスの再起動が必要です。
• ログファイルは、C:\ProgramData\Citrix\Update Services\Logs という場所にあるフォルダーの中に作成されます。

VDAアップグレードのダウンロード失敗のトラブルシューティング

VDAアップグレード機能に関連するダウンロードの失敗をトラブルシューティングして解決するには、以下の手順に従ってください。

1. URLフィルタリングが設定されている場合は、関連するURLが許可リストに追加されていることを確認してください。接続性を参照してください。

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）またはオンライン証明書ステータスプロトコル（OCSP）のURLが重要です。VDAアップグレードの要件を参照してください。

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

分析のために詳細なログをキャプチャするには、CDFトレースを有効にするか、LogToFileを1に設定することをお勧めします。ログには以下のエラーが含まれる場合があります。

• 失効ステータス不明
• 失効機能は、証明書の失効ステータスを確認できませんでした。
• 失効サーバーがオフラインだったため、失効機能は失効を確認できませんでした。

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

Windows CryptoAPIは現在、プロキシ設定をサポートしていません。アウトバウンドCRL呼び出しを容易にするためのVDAプロキシの構成については、プロキシ構成のVDAセクションを参照してください。