ローカルホストキャッシュ

最終公開日 : Nov 13, 2026
Citrix Virtual Apps and Desktopsサイトデータベースが常に利用可能であることを保証するために、CitrixはMicrosoftの高可用性ベストプラクティスに従って、フォールトトレラントなSQL Server展開から開始することを推奨します。(サポートされているSQL Serverの高可用性機能については、データベースを参照してください。)しかし、ネットワークの問題や中断により、ユーザーがアプリケーションやデスクトップに接続できなくなる可能性があります。
Local Host Cache機能により、停止が発生した場合でもサイトでの接続仲介操作を継続できます。停止は、オンプレミスのCitrix®環境でDelivery Controller™とサイトデータベース間の接続が失敗したときに発生します。サイトデータベースに90秒間アクセスできない場合、Local Host Cacheが作動します。
XenApp and XenDesktop 7.16以降、接続リース機能(以前のリリースにおける先行の高可用性機能)は製品から削除され、利用できなくなりました。

データの内容

Local Host Cacheには、メインデータベースの情報の一部である以下の情報が含まれています。
  • サイトから公開されたリソースへの権限が割り当てられているユーザーおよびグループの ID。
  • 現在使用している、または最近使用した、サイトから公開されたリソースのユーザーの ID。
  • サイトで構成されている VDA マシン(リモート PC アクセス マシンを含む)の ID。
  • 公開リソースへの接続に積極的に使用されているクライアントCitrix Receiver™マシンの識別情報(名前とIPアドレス)。
また、メインデータベースが利用できなかった間に確立された、現在アクティブな接続に関する情報も含まれています。
  • Citrix Receiverによって実行されたクライアントマシンのエンドポイント分析の結果。
  • サイトに関与するインフラストラクチャマシン(NetScaler GatewayやStoreFront™サーバーなど)の識別情報。
  • ユーザーによる最近のアクティビティの日付と時刻、および種類。

動作の仕組み

次の図は、通常の操作中のLocal Host Cacheコンポーネントと通信パスを示しています。
通常の操作中のLocal Host Cache通信パスの図

通常の操作中

  • Controller上のプリンシパルブローカー(Citrix Broker Service)は、StoreFrontからの接続要求を受け入れます。ブローカーはサイトデータベースと通信し、ユーザーをControllerに登録されているVDAに接続します。
  • Citrix Config Synchronizer Service(CSS)は、約5分ごとにブローカーに確認し、変更が加えられたかどうかを調べます。これらの変更は、管理者によって開始されたもの(デリバリーグループのプロパティの変更など)またはシステムアクション(マシンの割り当てなど)である場合があります。
  • 前回のチェック以降に構成の変更があった場合、CSS は情報をコントローラー上のセカンダリブローカーに同期 (コピー) します。(セカンダリブローカーは高可用性サービスとも呼ばれます。)
    前回のチェック以降に変更された項目だけでなく、すべての構成データがコピーされます。CSS は構成データをコントローラー上の Microsoft SQL Server Express LocalDB データベースにインポートします。このデータベースはローカルホストキャッシュデータベースと呼ばれます。CSS は、ローカルホストキャッシュデータベースの情報がサイトデータベースの情報と一致することを確認します。ローカルホストキャッシュデータベースは、同期が発生するたびに再作成されます。
    Microsoft SQL Server Express LocalDB (ローカルホストキャッシュデータベースで使用) は、コントローラーをインストールする際に自動的にインストールされます。(コマンドラインからコントローラーをインストールする際に、このインストールを禁止できます。) ローカルホストキャッシュデータベースは、複数のコントローラー間で共有することはできません。ローカルホストキャッシュデータベースをバックアップする必要はありません。構成の変更が検出されるたびに再作成されます。
  • 前回のチェック以降に変更がない場合、データはコピーされません。
次の図は、プリンシパルブローカーがサイトデータベースとの接続を失った場合 (停止が開始された場合) の通信パスの変更を示しています。
停止中のローカルホストキャッシュ通信パスの図(/en-us/citrix-virtual-apps-desktops/2607-ltsr/media/lhc-outage1.png)

停止中

停止が開始されると:
  • セカンダリブローカーは接続要求のリッスンと処理を開始します。
  • 停止が開始されると、セカンダリブローカーは最新の VDA 登録データを持っていませんが、VDA がセカンダリブローカーと通信すると、登録プロセスがトリガーされます。そのプロセス中に、セカンダリブローカーはその VDA に関する最新のセッション情報も取得します。
  • セカンダリブローカーが接続を処理している間、ブローカリングプリンシパルは接続を監視し続けます。接続が復元されると、ブローカリングプリンシパルはセカンダリブローカーに接続情報のリッスンを停止するよう指示し、ブローカリングプリンシパルはブローカリング操作を再開します。次に VDA がブローカリングプリンシパルと通信すると、登録プロセスがトリガーされます。セカンダリブローカーは、以前の停止からの残りの VDA 登録をすべて削除します。CSS は、展開で構成の変更が発生したことを認識すると、情報の同期を再開します。
同期中に停止が開始されるという万が一の事態が発生した場合、現在のインポートは破棄され、最後に認識された構成が使用されます。
イベントログ は、同期と停止に関する情報を提供します。
停止モードでの運用に時間制限はありません。
通常モードと停止モード間の移行は、既存のセッションには影響しません。新しいセッションの起動にのみ影響します。
意図的に停止をトリガーすることもできます。その理由と方法の詳細については、「停止の強制」を参照してください。

複数のControllerがあるサイト

その他のタスクの中でも、CSSはゾーン内のすべてのControllerに関する情報をセカンダリブローカーに定期的に提供します。(展開に複数のゾーンが含まれていない場合、このアクションはサイト内のすべてのControllerに影響します。)その情報を持つことで、各セカンダリブローカーは、ゾーン内の他のControllerで実行されているすべてのピアセカンダリブローカーについて認識します。
セカンダリブローカーは、別のチャネルで互いに通信します。これらのブローカーは、実行されているマシンのFQDN名のアルファベット順リストを使用して、停止が発生した場合にゾーン内でブローカー操作を行うセカンダリブローカーを決定(選出)します。停止中、すべてのVDAは選出されたセカンダリブローカーに登録します。ゾーン内の選出されていないセカンダリブローカーは、受信接続およびVDA登録要求を積極的に拒否します。
停止中に選出されたセカンダリブローカーが失敗した場合、別のセカンダリブローカーが選出されて引き継ぎ、VDAは新しく選出されたセカンダリブローカーに登録します。
停止中にControllerが再起動された場合:
  • そのControllerが選出されたブローカーでない場合、再起動による影響はありません。
  • そのControllerが選出されたブローカーである場合、別のControllerが選出され、VDAが登録されます。再起動されたControllerが起動すると、自動的にブローカー処理を引き継ぎ、VDAが再度登録されます。このシナリオでは、登録中にパフォーマンスが影響を受ける可能性があります。
通常の操作中にControllerの電源を切り、停止中に電源を入れた場合、そのControllerがブローカーとして選出されても、ローカルホストキャッシュはそのControllerで使用できません。
イベントログは、選出に関する情報を提供します。

停止中に利用できないもの、およびその他の相違点

停止モードでの運用に時間制限はありません。ただし、Citrixは可能な限り迅速に接続を復元することを推奨しています。
停止中:
  • Studioを使用できません。
  • PowerShell SDKへのアクセスが制限されます。
    • まず、次の操作を行う必要があります。
      • 値が1のレジストリキー EnableCssTestMode を追加します: New-ItemProperty -Path HKLM:\SOFTWARE\Citrix\DesktopServer\LHC -Name EnableCssTestMode -PropertyType DWORD -Value 1
      • ポート89を使用します: Get-BrokerMachine -AdminAddress localhost:89 | Select MachineName, ControllerDNSName, DesktopGroupName, RegistrationState
    • これらのコマンドを実行した後、以下にアクセスできます。
      • すべての Get-Broker* コマンドレット。
  • ハイパーバイザーの資格情報はホストサービスから取得できません。すべてのマシンは不明な電源状態になり、電源操作は発行できません。ただし、電源がオンになっているホスト上のVMは、接続要求に使用できます。
  • 割り当てられたマシンは、通常の操作中に割り当てが行われた場合にのみ使用できます。障害発生中に新しい割り当てを行うことはできません。
  • Remote PC Accessマシンの自動登録と構成はできません。ただし、通常の操作中に登録および構成されたマシンは使用可能です。
  • サーバーでホストされているアプリケーションおよびデスクトップのユーザーは、リソースが異なるゾーンにある場合、構成されているセッション制限よりも多くのセッションを使用する可能性があります。
  • ユーザーは、現在アクティブ/選出されているセカンダリブローカーを含むゾーン内の登録済みVDAからのみアプリケーションとデスクトップを起動できます。ゾーンをまたぐ起動(あるゾーンのセカンダリブローカーから別のゾーンのVDAへの起動)は、障害発生中はサポートされません。
  • デリバリーグループ内のVDAのスケジュールされた再起動が開始される前にサイトデータベースの停止が発生した場合、停止が終了したときに再起動が開始されます。これにより、意図しない結果が生じる可能性があります。詳細については、「データベースの停止により遅延するスケジュールされた再起動」を参照してください。
  • ゾーン設定 は構成できません。構成されている場合でも、セッション起動時には設定は考慮されません。
  • タグがゾーンの指定に使用される場合の タグ制限 は、セッション起動ではサポートされません。このようなタグ制限が構成され、StoreFrontストアの 高度なヘルスチェック オプションが有効になっている場合、セッションの起動が断続的に失敗する可能性があります。

アプリケーションとデスクトップのサポート

LHCは、次の種類のVDAと配信モデルをサポートしています。
VDAタイプ 配信モデル LHCイベント中のVDAの可用性
マルチセッションOS アプリケーションとデスクトップ 常に利用可能。
シングルセッションOS静的(割り当て済み) デスクトップ 常に利用可能。
電源管理されたシングルセッションOSランダム(プール) デスクトップ デフォルトでは利用できません。プールされたデリバリーグループ内の電源管理されたVDAへのすべてのセッション起動試行は、デフォルトで失敗します。
LHCイベント中に新しい接続でそれらを利用可能にできます。詳細については、Web Studio を使用して有効にする および PowerShell を使用して有効にする を参照してください。
重要: 電源管理されたシングルセッションのプールされたマシンへのアクセスを有効にすると、以前のユーザーセッションからのデータと変更が後続のセッションに存在する可能性があります。
注:
プールされたデリバリーグループ内の電源管理されたデスクトップVDAへのアクセスを有効にしても、通常の操作中に構成されたShutdownDesktopsAfterUseプロパティの動作には影響しません。LHC中にこれらのデスクトップへのアクセスが有効になっている場合、LHCイベントが完了してもVDAは自動的に再起動しません。プールされたデリバリーグループ内の電源管理されたデスクトップVDAは、VDAが再起動するまで以前のセッションのデータを保持できます。VDAの再起動は、非LHC操作中にユーザーがVDAからログオフした場合、または管理者がVDAを再起動した場合に発生する可能性があります。

Web Studio を使用して、電源管理されたシングルセッションOSのプールされたVDAでLHCを有効にする

Web Studio を使用すると、デリバリーグループごとに、LHCイベント中にそれらのマシンを新しい接続で利用可能にできます。
  • デリバリーグループの作成中にこの機能を有効にするには、デリバリーグループの作成を参照してください。
  • 既存のデリバリーグループでこの機能を有効にするには、デリバリーグループの管理 を参照してください。
注:
この設定は、電源管理されたVDAを提供するプールされたデスクトップデリバリーグループに対してのみ、Web Studio で利用できます。

PowerShellを使用して、電源管理されたシングルセッションOSのプールされたVDAに対してLHCを有効にする

特定のデリバリーグループ内のVDAに対してLHCを有効にするには、次の手順に従います。
  1. このコマンドを実行して、サイトレベルでこの機能を有効にします。
    Set-BrokerSite -ReuseMachinesWithoutShutdownInOutageAllowed $true
  2. デリバリーグループ名を指定してこのコマンドを実行し、デリバリーグループのLHCを有効にします。
    Set-BrokerDesktopGroup -Name "name" -ReuseMachinesWithoutShutdownInOutage $true
新しく作成された電源管理VDAを持つプール型デリバリーグループのデフォルトのLHC可用性を変更するには、次のコマンドを実行します。
Set-BrokerSite -DefaultReuseMachinesWithoutShutdownInOutage $true

RAM サイズに関する考慮事項

LocalDBサービスは、約1.2 GBのRAM(データベースキャッシュに最大1 GB、SQL Server Express LocalDBの実行に200 MB)を使用できます。セカンダリブローカーは、多数のログオンが発生する長時間の停止(たとえば、10Kユーザーで12時間)の場合、最大1 GBのRAMを使用できます。これらのメモリ要件は、Controllerの通常のRAM要件に加えて必要となるため、RAM容量の合計を増やす必要がある場合があります。
サイトデータベースにSQL Server Expressインストールを使用する場合、サーバーには2つのsqlserver.exeプロセスがあります。

CPU コアとソケット構成に関する考慮事項

ControllerのCPU構成、特にSQL Server Express LocalDBに利用可能なコア数は、メモリ割り当てよりもさらに、ローカルホストキャッシュのパフォーマンスに直接影響します。このCPUオーバーヘッドは、データベースにアクセスできず、セカンダリブローカーがアクティブな停止期間中にのみ観測されます。
LocalDBは複数のコア(最大4つ)を使用できますが、単一のソケットに限定されます。ソケットを追加してもパフォーマンスは向上しません(たとえば、1コアずつ4つのソケットがある場合)。代わりに、Citrixは複数のソケットと複数のコアを使用することを推奨しています。Citrixのテストでは、2x3(2ソケット、3コア)構成が4x1および6x1構成よりも優れたパフォーマンスを提供しました。

ストレージに関する考慮事項

停止中にユーザーがリソースにアクセスすると、LocalDBは増大します。たとえば、毎秒10ログオンで実行されるログオン/ログオフテスト中に、データベースは2〜3分ごとに1 MBずつ増大しました。通常の操作が再開されると、ローカルデータベースは再作成され、スペースは返却されます。ただし、停止中のデータベースの増大に対応できるように、LocalDBがインストールされているドライブには十分な空き容量が必要です。ローカルホストキャッシュは、停止中にさらに多くのI/Oを発生させます。具体的には、毎秒約3 MBの書き込みと数十万回の読み取りです。

パフォーマンスに関する考慮事項

停止中、1つのセカンダリブローカーがすべての接続を処理するため、通常の操作中に複数のController間で負荷分散を行うサイト(またはゾーン)では、選出されたセカンダリブローカーが停止中に通常よりもはるかに多くの要求を処理する必要がある場合があります。したがって、CPUの要求は高くなります。停止中に選出されるセカンダリブローカーは変更される可能性があるため、サイト(ゾーン)内のすべてのセカンダリブローカーは、ローカルホストキャッシュデータベースと影響を受けるすべてのVDAによって課される追加の負荷を処理できる必要があります。
VDIの制限:
  • シングルゾーンVDI展開では、停止中に最大10,000台のVDAを効果的に処理できます。
  • マルチゾーンVDI展開では、停止中に各ゾーンで最大10,000台のVDAを効果的に処理でき、サイト全体では最大40,000台のVDAを処理できます。たとえば、以下の各サイトは停止中に効果的に処理できます。
    • 4つのゾーンがあり、それぞれに10,000台のVDAが含まれるサイト。
    • 7つのゾーンがあり、1つに10,000台のVDA、残りの6つにそれぞれ5,000台のVDAが含まれるサイト。
停止中、サイト内の負荷管理が影響を受ける可能性があります。負荷評価機能(特にセッション数ルール)が超過する可能性があります。
すべてのVDAがセカンダリブローカーに登録されるまでの間、そのサービスは現在のセッションに関する完全な情報を持っていない可能性があります。そのため、その間に行われたユーザー接続要求は、既存のセッションへの再接続が可能であったとしても、新しいセッションが起動される結果となる可能性があります。この間隔(「新しい」セカンダリブローカーが再登録中にすべてのVDAからセッション情報を取得する間)は避けられません。停止が開始されたときに接続されているセッションは、移行期間中に影響を受けませんが、新しいセッションやセッションの再接続は影響を受ける可能性があります。
この間隔は、VDAが登録する必要がある場合に発生します。
  • 停止の開始:プリンシパルブローカーからセカンダリブローカーに移行するとき。
  • 停止中のセカンダリブローカーの障害:障害が発生したセカンダリブローカーから、新しく選出されたセカンダリブローカーに移行するとき。
  • 停止からの回復:通常の操作が再開され、プリンシパルブローカーが制御を再開するとき。
Citrix Broker ProtocolのHeartbeatPeriodMsレジストリ値を下げることで、この間隔を短縮できます(デフォルト = 600000 ms、つまり10分)。このハートビート値は、VDAがpingに使用する間隔の2倍であるため、デフォルト値では5分ごとにpingが実行されます。
たとえば、次のコマンドはハートビートを5分(300000ミリ秒)に変更し、2.5分ごとにpingが実行されるようにします。
New-ItemProperty -Path HKLM:\SOFTWARE\Citrix\DesktopServer -Name HeartbeatPeriodMs -PropertyType DWORD –Value 300000
ハートビート値を変更する際は注意してください。頻度を増やすと、通常モードと停止モードの両方でControllerへの負荷が増大します。
VDAがどれだけ迅速に登録されても、この間隔を完全に排除することはできません。
セカンダリブローカー間の同期にかかる時間は、オブジェクト(VDA、アプリケーション、グループなど)の数が増えるにつれて長くなります。たとえば、5000台のVDAを同期するには、10分以上かかる場合があります。

XenApp 6.xリリースとの違い

このローカルホストキャッシュの実装は、XenApp 6.x以前のXenAppリリースにおけるローカルホストキャッシュ機能と同じ名前を共有していますが、大幅な改善が加えられています。この実装は、より堅牢で破損しにくくなっています。定期的なdsmaintコマンドの必要性を排除するなど、メンテナンス要件が最小限に抑えられています。このローカルホストキャッシュは、技術的にはまったく異なる実装です。

ローカルホストキャッシュの管理

ローカルホストキャッシュが正しく機能するには、各ControllerのPowerShell実行ポリシーをRemoteSigned、Unrestricted、またはBypassに設定する必要があります。

SQL Server Express ローカルDB

ローカルホストキャッシュが使用するMicrosoft SQL Server Express LocalDBソフトウェアは、Controllerをインストールするか、バージョン7.9より前のControllerをアップグレードするときに自動的にインストールされます。このデータベースと通信するのはセカンダリブローカーのみです。PowerShellコマンドレットを使用して、このデータベースに関する何も変更することはできません。LocalDBはController間で共有できません。
SQL Server Express LocalDBデータベースソフトウェアは、ローカルホストキャッシュが有効になっているかどうかに関係なくインストールされます。
そのインストールを防ぐには、XenDesktopServerSetup.exeコマンドを使用してControllerをインストールまたはアップグレードし、/exclude "Local Host Cache Storage (LocalDB)"オプションを含めます。ただし、ローカルホストキャッシュ機能はデータベースなしでは機能せず、セカンダリブローカーで別のデータベースを使用することはできないことに注意してください。
このLocalDBデータベースのインストールは、サイトデータベースとして使用するためにSQL Server Expressをインストールするかどうかには影響しません。
以前のSQL Server Express LocalDBバージョンを新しいバージョンに置き換える方法については、「SQL Server Express LocalDBの置き換え」を参照してください。

製品のインストールとアップグレード後のデフォルト設定

Citrix Virtual Apps and Desktopsの新規インストール時(最小バージョン7.16)には、ローカルホストキャッシュが有効になります。
アップグレード後(バージョン7.16以降)、展開全体でVDAが10,000未満の場合、ローカルホストキャッシュが有効になります。

ローカルホストキャッシュの有効化と無効化

  • ローカルホストキャッシュを有効にするには、次のように入力します。
    Set-BrokerSite -LocalHostCacheEnabled $true
    ローカルホストキャッシュが有効になっているかどうかを確認するには、Get-BrokerSiteと入力します。LocalHostCacheEnabledプロパティがTrueであることを確認します。
  • Local Host Cache を無効にするには、次のように入力します。
    Set-BrokerSite -LocalHostCacheEnabled $false
注意: XenApp および XenDesktop 7.16 以降、接続リース (バージョン 7.6 以降の Local Host Cache の前身となる機能) は製品から削除され、利用できなくなりました。

Local Host Cache が機能していることを確認する

Local Host Cache が正しくセットアップされ、機能していることを確認するには:
  • 同期インポートが正常に完了していることを確認します。イベントログを確認してください。
  • 各 Delivery Controller に SQL Server Express LocalDB データベースが作成されていることを確認します。これにより、必要に応じてセカンダリブローカーが引き継ぐことができることが確認されます。
    • Delivery Controller サーバーで、C:\Windows\ServiceProfiles\NetworkService に移動します。
    • HaDatabaseName.mdfとHaDatabaseName_log.ldfが作成されていることを確認します。
  • Delivery Controller で障害を強制的に発生させます。Local Host Cache が機能することを確認したら、すべてのコントローラーを通常モードに戻すことを忘れないでください。これには約15分かかる場合があります。

イベントログ

イベントログは、同期と障害が発生した時期を示します。イベントビューアーログでは、障害モードは HA モード と呼ばれます。*
構成同期サービス:
通常の操作中、CSS が Local Host Cache ブローカーを使用して構成データを Local Host Cache データベースにインポートすると、次のイベントが発生する可能性があります。
  • 503: Citrix Config Sync Service が更新された構成を受信しました。このイベントは、同期プロセスの開始を示します。
  • 504: Citrix Config Sync Service が更新された構成をインポートしました。構成のインポートが正常に完了しました。
  • 505: Citrix Config Sync Service がインポートに失敗しました。構成のインポートは正常に完了しませんでした。以前に成功した構成が利用可能な場合、障害が発生したときにそれが使用されます。ただし、それは現在の構成から古くなります。以前の構成が利用できない場合、サービスは障害発生時のセッションブローカーに参加できません。この場合、トラブルシューティングセクションを参照し、Citrix サポートにお問い合わせください。
  • 507: システムが障害モードであり、Local Host Cache ブローカーがブローカー処理に使用されているため、Citrix Config Sync Service はインポートを中止しました。サービスは新しい構成を受信しましたが、障害が発生したためインポートは中止されました。これは予期される動作です。
  • 510: プライマリ構成サービスから構成サービス構成データが受信されませんでした。
  • 517: プライマリブローカーとの通信中に問題が発生しました。
  • 518: セカンダリブローカー(高可用性サービス)が実行されていないため、構成同期スクリプトが中止されました。
高可用性サービス:
このサービスは、ローカルホストキャッシュブローカーとも呼ばれます。
  • 3502: 停止が発生し、ローカルホストキャッシュブローカーがブローカー操作を実行しています。
  • 3503: 停止が解決され、通常の操作が再開されました。
  • 3504: どのローカルホストキャッシュブローカーが選出されたか、および選出に関与した他のローカルホストキャッシュブローカーを示します。
  • 3507: 2分ごとにローカルホストキャッシュのステータス更新を提供し、選出されたブローカーでローカルホストキャッシュモードがアクティブであることを示します。停止期間、VDA登録、セッション情報を含む停止の概要が含まれます。
  • 3508: 選出されたブローカーでローカルホストキャッシュがアクティブでなくなり、通常の操作が復元されたことを通知します。停止期間、ローカルホストキャッシュイベント中に登録されたマシンの数、LHCイベント中の正常な起動の数を含む停止の概要が含まれます。
  • 3509: 選出されていないブローカーでローカルホストキャッシュがアクティブであることを通知します。2分ごとの停止期間が含まれ、選出されたブローカーを示します。
  • 3510: 選出されていないブローカーでローカルホストキャッシュがアクティブでなくなったことを通知します。停止期間が含まれ、選出されたブローカーを示します。

停止を強制する

意図的に停止を強制したい場合があります。
  • ネットワークが繰り返しダウンする場合。ネットワークの問題が解決されるまで停止を強制すると、通常モードと停止モード間の継続的な移行(およびその結果として頻繁に発生するVDA登録ストーム)を防ぐことができます。
  • ディザスタリカバリ計画をテストするため。
  • ローカルホストキャッシュが正しく機能していることを確認するため。
  • サイトデータベースサーバーの交換または保守中。
停止を強制するには、Delivery Controller を含む各サーバーのレジストリを編集します。HKLM\Software\Citrix\DesktopServer\LHC で、OutageModeForced を REG_DWORD として 1 に作成して設定します。この設定により、データベースの状態に関係なく、ローカルホストキャッシュブローカーは停止モードに入ります。値を 0 に設定すると、ローカルホストキャッシュブローカーは停止モードを終了します。
イベントを確認するには、C:\ProgramData\Citrix\WorkspaceCloud\Logs\Plugins\HighAvailabilityService の Current_HighAvailabilityService ログファイルを監視します。

トラブルシューティング

ローカルホストキャッシュデータベースへの同期インポートが失敗し、505 イベントが投稿された場合、いくつかのトラブルシューティングツールが利用可能です。
CDFトレース: ConfigSyncServer および BrokerLHC モジュールのオプションが含まれています。これらのオプションは、他のブローカーモジュールとともに、問題の特定に役立つでしょう。
レポート: 同期インポートが失敗した場合、レポートを生成できます。このレポートは、エラーの原因となっているオブジェクトで停止します。このレポート機能は同期速度に影響するため、使用しないときは無効にすることをお勧めします。
CSSトレースレポートを有効にして生成するには、次のコマンドを入力します。
New-ItemProperty -Path HKLM:\SOFTWARE\Citrix\DesktopServer\LHC -Name EnableCssTraceMode -PropertyType DWORD -Value 1
HTMLレポートは C:\Windows\ServiceProfiles\NetworkService\AppData\Local\Temp\CitrixBrokerConfigSyncReport.html に投稿されます。
レポートが生成されたら、次のコマンドを入力してレポート機能を無効にします。
Set-ItemProperty -Path HKLM:\SOFTWARE\Citrix\DesktopServer\LHC -Name EnableCssTraceMode -Value 0
ブローカー構成のエクスポート: デバッグ目的で正確な構成を提供します。
Export-BrokerConfiguration | Out-File <file-pathname>
例: Export-BrokerConfiguration | Out-File C:\\BrokerConfig.xml。

ローカルホストキャッシュのPowerShellコマンド

PowerShellコマンドを使用して、Delivery Controller でローカルホストキャッシュ (LHC) を管理できます。
PowerShellモジュールは、Delivery Controller の次の場所にあります。
C:\Program Files\Citrix\Broker\Service\ControlScripts
重要:
このモジュールはDelivery Controllerでのみ実行してください。

PowerShell モジュールのインポート

モジュールをインポートするには、Delivery Controller で次を実行します。
cd C:\Program Files\Citrix\Broker\Service\ControlScripts Import-Module .\HighAvailabilityServiceControl.psm1

LHC を管理するための PowerShell コマンド

以下のコマンドは、Delivery Controller で LHC モードをアクティブ化および管理するのに役立ちます。
コマンドレット 機能
Enable-LhcForcedOutageMode ブローカーを LHC モードにします。Enable-LhcForcedOutageMode が適切に機能するには、ConfigSync Service によって LHC データベースファイルが正常に作成されている必要があります。この cmdlet は、実行された Delivery Controller 上でのみ LHC を強制します。LHC をアクティブにするには、このコマンドをゾーン内のすべての Delivery Controller で実行する必要があります。
Disable-LhcForcedOutageMode ブローカーを LHC モードから解除します。この cmdlet は、実行された Delivery Controller 上でのみ LHC モードを無効にします。Disable-LhcForcedOutageMode は、ゾーン内のすべての Delivery Controller で実行する必要があります。
Set-LhcConfigSyncIntervalOverride Citrix Config Synchronizer Service (CSS) がサイト内の構成変更をチェックする間隔を設定します。時間間隔は 60 秒 (1 分) から 3600 秒 (1 時間) の範囲で設定できます。この設定は、実行された Delivery Controller にのみ適用されます。Delivery Controller 間の一貫性を保つために、この cmdlet を各 Delivery Controller で実行することを検討してください。例: Set-LhcConfigSyncIntervalOverride -Seconds 1200
Clear-LhcConfigSyncIntervalOverride Citrix Config Synchronizer Service (CSS) がサイト内の構成変更をチェックする間隔を、デフォルト値の 300 秒 (5 分) に設定します。この設定は、実行された Delivery Controller にのみ適用されます。Delivery Controller 間の一貫性を保つために、この cmdlet を各 Delivery Controller で実行することを検討してください。
Enable-LhcHighAvailabilitySDK 実行された Delivery Controller 内のすべての Get-Broker* cmdlet へのアクセスを有効にします。
Disable-LhcHighAvailabilitySDK 実行された Delivery Controller 内の Broker cmdlet へのアクセスを無効にします。
注:
  • Delivery Controller で Get-Broker* cmdlet を実行するときは、ポート 89 を使用します。例:
    • Get-BrokerMachine -AdminAddress localhost:89
  • LHC モードでない場合、Delivery Controller 上の LHC Broker は構成情報のみを保持します。
  • LHC モード中、選出された Delivery Controller 上の LHC Broker は以下の情報を保持します。
    • リソースの状態
    • セッションの詳細
    • VDA登録
    • 構成情報