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

最終公開日 : Oct 24, 2026
この記事では、ローカルホストキャッシュ (LHC) 機能の概要を、事業継続性を維持する能力に焦点を当てて説明します。通常の運用時とLHCモードがアクティブになった場合のLHCの機能について説明します。さらに、構成チェック、トラブルシューティング、LHC管理のためのPowerShellコマンド、LHCの健全性のためのイベントログ監視に関するガイダンスも提供します。
Related information
管理
ローカルホストキャッシュ可視化ツール

概要

LHCは、ネットワーク障害またはCitrix Cloud™の問題によりCloud ConnectorがCitrix Cloud™との接続を失った場合でも、エンドユーザーがアプリとデスクトップにアクセスできるようにします。LHCモードがアクティブになってもアクティブなセッションは影響を受けず、新しいセッションはCloud Connectorで実行されているLHCブローカーを介して仲介されます。
LHCはデフォルトで有効になっていますが、環境がLHC用に適切に構成されていることを確認することが重要です。構成ミスは通常のブローカー処理を妨げない可能性がありますが、LHCのパフォーマンスを妨げ、LHCモードがアクティブなときにエンドユーザーに中断を引き起こす可能性があります。LHCの最適な機能を確保するには、Studioのゾーンノードで、Citrixが検出したゾーン関連のエラーと警告を確認してください。さらに、包括的なLHC構成チェックリストについては、回復性構成の確認ガイドとDaaSの回復性に悪影響を及ぼす可能性のある一般的な構成ミスを回避するの記事を確認してください。
重要:
LHCは、Cloud ConnectorがStoreFrontからトラフィックを受信するか、サービス継続性が有効になっている場合にのみ機能します。サービス継続性がサービス中断中にユーザーのアプリとデスクトップへのアクセスを維持するためにローカルホストキャッシュをどのように使用できるかの詳細については、サービス継続性を参照してください。

仕組み

通常の運用中、Cloud Connector上のリモートブローカープロバイダーサービスは、すべてのブローカー処理操作のためにCitrix Cloudと通信します。Citrix Config Synchronizer Service (CSS) は、Citrix Cloudでの構成変更を定期的にチェックし、このデータをCloud Connector上のLHCブローカーに同期します。Cloud ConnectorがCitrix Cloudへの接続を失うか、Citrix Cloudで問題が発生した場合、LHCモードがアクティブになり、アプリケーションとデスクトップへの継続的なアクセスが保証されます。

通常のブローカー処理操作中

通常のブローカー処理操作中
  • Cloud Connector上のCitrix Remote Broker Provider Serviceは、StoreFrontからの接続要求を受け入れます。Remote Broker Provider ServiceはCitrix Cloudと通信し、Citrix Cloudに登録されているVDAにユーザーを接続します。
  • CSSは、Citrix CloudのCloudブローカーと約5分ごとにチェックし、構成変更が行われたかどうかを確認します。これらの変更は、管理者によって開始されたもの（デリバリーグループのプロパティの変更など）またはシステムアクション（マシン割り当てなど）である可能性があります。
  • 前回のチェック以降に構成変更があった場合、CSSは情報をCloud Connector上のLHCブローカーに同期します。（LHCブローカーは、高可用性サービス、またはHAブローカーとも呼ばれます）。
    前回のチェック以降に変更された項目だけでなく、すべての構成データがコピーされます。CSSは、構成データをCloud Connector上のMicrosoft SQL Server Express LocalDBデータベースにインポートします。このデータベースは、ローカルホストキャッシュデータベースと呼ばれます。CSSは、ローカルホストキャッシュデータベースの情報がCitrix Cloudのサイトデータベースの情報と一致することを確認します。
    Microsoft SQL Server Express LocalDB（LHCデータベースで使用）は、Cloud Connectorをインストールすると自動的にインストールされます。LHCデータベースは、複数のCloud Connector間で共有できません。LHCデータベースをバックアップする必要はありません。構成変更が検出されるたびに再作成されます。
  • 前回のチェック以降に変更がない場合、構成データはコピーされません。

LHCモードがアクティブになるとき

LHCモードがアクティブになるとき
  • LHCブローカーは接続情報のリスニングを開始し、接続要求を処理します。
  • Cloud ConnectorがCitrix Cloudへの接続を最初に失ったとき、LHCブローカーは最新のVDA登録データを持っていませんが、VDAがLHCブローカーと通信すると、登録プロセスがトリガーされます。そのプロセス中に、LHCブローカーはそのVDAの現在のセッション情報も取得します。
  • LHCブローカーが接続を処理している間、Remote Broker Provider ServiceはCitrix Cloudへの接続を監視し続けます。接続が復元されると、Remote Broker Provider ServiceはLHCブローカーに接続情報のリスニングを停止するよう指示し、Citrix Cloudはブローカー操作を再開します。次にVDAがRemote Broker Provider Serviceを介してCitrix Cloudと通信するときに、登録プロセスがトリガーされます。LHCブローカーは、LHCモードがアクティブだったときに残っていたVDA登録をすべて削除します。CSSは、Citrix Cloudで構成変更が発生したことを認識すると、情報の同期を再開します。
同期中にLHCが開始されるという万が一の事態が発生した場合、現在のインポートは破棄され、最後に認識された構成が使用されます。
イベントログは、同期が発生したとき、およびLHCモードがアクティブになったときを示します。
LHCモードでの運用に時間制限はありません。
LHCモードを手動でトリガーすることもできます。その理由と方法の詳細については、「LHCモードを強制する」を参照してください。

複数のCloud Connectorがあるゾーン

CSSは、他のタスクの中でも、ゾーン内のすべてのCloud Connectorに関する情報をLHCブローカーに定期的に提供します。その情報を持つことで、各LHCブローカーは、ゾーン内の他のCloud Connectorで実行されているすべてのピアLHCブローカーについて認識しています。
LHCブローカーは、個別のチャネルで相互に通信します。これらのブローカーは、ゾーンがLHCモードに入った場合に、どのLHCブローカーがゾーン内の操作をブローカーするかを決定（選出）するために、実行されているマシンのFQDN名のアルファベット順リストを使用します。LHCモード中、すべてのVDAは選出されたLHCブローカーに再登録します。ゾーン内の選出されていないLHCブローカーは、受信接続およびVDA登録要求を積極的に拒否します。
重要:
ゾーン内のコネクタは、http://<FQDN_OF_PEER_CONNECTOR>:80/Citrix/CdsController/ISecondaryBrokerElection で相互に到達できる必要があります。コネクタがこのアドレスで通信できない場合、複数のブローカーが選出され、LHC モード時に起動エラーが発生する可能性があります。
LHC モード中に、Cloud Connector が再起動された場合、または LHC ブローカーが失敗した場合：
  • その Cloud Connector が選出された LHC ブローカーでない場合、再起動による影響はありません。
  • その Cloud Connector が選出された LHC ブローカーである場合、次の Cloud Connector 上の LHC ブローカーが選出され、VDA が登録されます。選出順序は、Cloud Connector の FQDN のアルファベット順に基づきます。LHC ブローカーが再びアクティブになると、LHC 操作はアルファベット順で最初のコネクタで続行され、VDA が再度登録される可能性があります。このシナリオでは、登録中にパフォーマンスが影響を受ける可能性があります。
LHC ブローカーの選出に関するイベントの詳細については、イベントログ を参照してください。

ローカルホストキャッシュのデータコンテンツ

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

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

LHCモードへの移行およびLHCモードからの終了のサイクル全体には、いくつかの状態があります。次の図は、LHCモードへの移行およびLHCモードからの終了の状態を示しています。
LHCの状態
  • 「Working Normally」状態では、すべてのコンポーネントが正常であり、すべてのブローカー処理トランザクションはクラウドブローカーによって処理されます。 - - CSSは、クラウドブローカーからクラウドコネクタに構成を積極的にレプリケートしています。 いずれかのヘルスチェックが失敗した場合、クラウドコネクタは「Pending HA」状態に移行します。この状態では、次のアクションを決定するために包括的なヘルスチェックが開始されます。コネクタはゾーン内の他のコネクタと連携して、それらのヘルスステータスを判断します。
  • Pending HA (HA保留中) から Initial HA (初期HA) への移行の決定は、特定のゾーン内のすべてのコネクタのヘルスステータスに基づいています。ヘルスチェックが成功した場合、コネクタ/コントローラは Working Normally (正常稼働) 状態に戻ります。あるいは、ヘルスチェックが引き続き失敗する場合、コネクタ/コントローラは Initial HA (初期HA) 状態に移行します。
  • Initial HA (初期HA) 状態では、選出されたコネクタ上のLHCブローカーがブローカー処理の責任を引き継ぎます。以前に登録されていた現在のゾーン内のすべてのVDAは、クラウドコネクタ上のLHCブローカーに登録されるようになります。すべてのVDAがHAサービスに再登録されるまで最大5分かかる場合があります。Initial HA (初期HA) の終了時に、ヘルスチェックが開始されます。すべてのヘルスチェックが成功した場合、状態は Pending Recovery (回復保留中) に移行し、そうでない場合は Extended HA (拡張HA) に移行します。
  • Extended HA (拡張HA) 期間中もヘルスチェックは継続されます。Extended HA (拡張HA) 中にヘルスチェックが成功すると、状態は Pending Recovery (回復保留中) に移行します。コネクタが Extended HA (拡張HA) 状態にとどまる最大期間はありません。
  • Pending Recovery (回復保留中) は、LHCモードから移行する前にサービスが完全に正常であることを確認するためのバッファ期間として機能します。Pending Recovery (回復保留中) 中にいずれかのヘルスチェックが失敗した場合、状態は Extended HA (拡張HA) に戻ります。
  • 10分間の Pending Recovery (回復保留中) 期間全体で、すべてのヘルスチェックが成功した場合、状態は Working Normally (正常稼働) に移行します。この移行により、LHCモードが終了し、LHCブローカーに登録されていたゾーン内のすべてのVDAは、クラウドブローカーに再登録されます。この再登録には、再び最大5分かかる場合があります。

LHCモード中の重要な考慮事項

LHCモード中は、次の影響を考慮してください。
側面 LHCモード中の影響
Studioへのアクセス 障害の性質によっては、アクセスできない場合があります。LHCモードで動作しているゾーンのVDAは、LHCブローカーに登録されているため、Studioでは Unregistered (未登録) と表示されます。
リモートPowerShell SDKアクセス アクセスが制限されます。
SDK認証を設定: Get-XDAuthentication -ProfileName WindowsCurrentUserを実行して、SDKプロキシがコマンドレット呼び出しをリダイレクトするのを防ぎます。これらの変更を行った後、すべてのGet-Brokerコマンドレットを使用できます。
注: 最初のコマンドレット呼び出しに-AdminAddress localhost:89パラメーターを含めます。
例: Get-BrokerMachine -AdminAddress localhost:89
監視データ LHCモードがアクティブな間は、監視機能はアクティビティを表示しません。監視データのサブセットは、Monitorのトレンドページのローカルホストキャッシュダッシュボードで利用できます。
ハイパーバイザーの資格情報 ホストサービスから取得できません。マシンは不明な電源状態になり、電源操作はできません。電源がオンになっているVMは接続に使用できます。
割り当てられたマシン 通常の操作中に割り当てられた場合にのみ使用可能です。LHCモードでは新しい割り当ては不可能です。
Remote PCアクセス マシン 自動登録と構成はサポートされていません。通常の操作中に登録および構成されたマシンは使用可能です。
サーバーホスト型アプリケーションおよびデスクトップのセッション制限 リソースが異なるゾーンにある場合、ユーザーは構成されたセッション制限よりも多くのセッションを使用する可能性があります。
ゾーンの動作 各ゾーンは独立して動作します。StoreFrontの高度なヘルスチェック機能が有効になっている場合、StoreFrontはLHCモード中に適切なゾーンに起動要求をルーティングし、セッション起動の失敗を回避できます。
スケジュールされたVDAの再起動 配信グループ内のVDAのスケジュールされた再起動が開始される前にLHCモードに入った場合、LHCモードが終了し、通常のブローカリング操作が再開されると再起動が開始され、ゾーンがLHCモードを終了したときに予期しない再起動が発生する可能性があります。この動作を変更できる詳細情報と構成については、「データベース障害により遅延したスケジュールされた再起動」を参照してください。
ゾーンの優先順位 ゾーンの優先順位の構成はセッション起動では考慮されません。
タグの制限 複数のゾーンにVDAを持つ配信グループの場合、タグ付けされたVDAがすべてのゾーンに存在しないと、タグの制限により起動が失敗する可能性があります。
注:
SDK認証での$XDSDKAuthの使用は、2025年6月以降非推奨となります。詳細については、「非推奨」を参照してください。

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

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

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

Studioを使用して、LHCモード中にデリバリーグループごとに新しい接続でそれらのマシンを利用可能にすることができます。
注：
この設定は、電源管理されたVDAを提供するプールされたデスクトップデリバリーグループでのみ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
注：
デフォルトを変更しても、既存のデリバリーグループの設定は変更されず、PowerShellを使用して作成されたデリバリーグループにのみ影響します。

StoreFrontの構成

オンプレミスのStoreFront展開を使用している場合は、以下を確認してください。
  • ロードバランシング仮想サーバーを使用している場合は、ブローカリング機能に基づいてコネクタを監視するように仮想サーバーを構成します（例：コネクタのロードバランシングには、NetScaler®の組み込みCITRIX-XD-DDCモニターを使用します）。
  • 単一のCloudテナント内のすべてのCloud Connectorを、StoreFrontで単一のサイトとして含めます。
  • StoreFrontでNetScaler Gatewayの構成を表示し、すべてのコネクタがSTAサーバーとしてリストされていることを確認します。NetScalerアプライアンスを確認し、StoreFrontにリストされているすべてのSTAがNetScaler Gateway仮想サーバーで同じ形式であることを確認します。STAサービスの健全性は、Gateway仮想サーバーでも監視できます。
  • すべてのコネクタをStoreFrontのリソースフィードに追加し、StoreFrontがリソースフィードで指定されたポートを介してすべてのCloud Connectorと通信できることを確認します。
注：
多数のコネクタを持つお客様の場合、管理オーバーヘッドを削減し、トラブルシューティングを簡素化するために、ゾーンごとにロードバランシング仮想サーバーを構成すると有益な場合があります。詳細については、Citrix TIPs: Citrix Virtual Apps and DesktopsサービスとStoreFrontの統合を参照してください。

ローカルホストキャッシュの動作を検証する

LHCが正しく設定され、機能していることを確認するには：
  • 同期インポートが正常に完了していることを確認します。LHC同期の監視方法の詳細については、イベントログを確認してください。
  • 各Cloud Connectorにローカルホストキャッシュデータベースが作成されていることを確認します。これにより、必要に応じて高可用性サービスが引き継ぐことができることが確認されます。
    • Cloud Connectorサーバーで、c:\Windows\ServiceProfiles\NetworkServiceを参照します。
    • HaDatabaseName.mdfとHaDatabaseName_log.ldfが作成されていることを確認します。
  • LHCモードを強制するをゾーン内のすべてのCloud Connectorに適用します。Local Host Cacheが機能することを確認したら、すべてのCloud Connectorを通常モードに戻すことを忘れないでください。LHCモードを終了するのにかかる時間については、Local Host Cacheの状態を参照してください。

Local Host Cacheを監視する

イベントログ

イベントログは、LHCの健全性とパフォーマンスに関する重要な情報を提供します。

構成同期サービス

通常の操作中、CSSがLHCブローカーを使用して構成データをLHCデータベースにインポートすると、次のイベントが発生する可能性があります。
イベントID 説明
503 CSSが更新された構成を受信したことを示します。このイベントは、Citrix Cloudから更新された構成が受信されるたびに発生します。これは同期プロセスの開始を示します。
504 CSSが更新された構成をインポートしたことを示します。構成のインポートは正常に完了しました。
505 CSSがインポートに失敗したことを示します。構成のインポートが正常に完了しませんでした。以前に成功した構成が利用可能な場合、LHCモードに入るとそれが使用されます。ただし、それは現在の構成から古くなります。以前の構成が利用できない場合、サービスはLHCモード中にセッションブローカーに参加できません。この場合、トラブルシューティングセクションを参照し、Citrixサポートに連絡してください。
507 システムがLHCモードであり、LHCブローカーがブローカー処理に使用されているため、CSSがインポートを中止したことを示します。サービスは新しい構成を受信しましたが、LHCモードに入ったためインポートは中止されました。これは予期される動作です。
510 プライマリ構成サービスからCSS構成データが受信されなかったことを示します。
517 プライマリブローカーサービスとの通信に問題があったことを示します。
518 LHCブローカー（高可用性サービス）が実行されていないため、CSSスクリプトが中止されたことを示します。

高可用性サービス

このサービスはLHCブローカーとも呼ばれます。
イベントID 説明
3502 停止が発生し、LHCブローカーがブローカー操作を実行していることを示します。
3503 停止が解決され、通常の操作が再開されたことを示します。
3504 選出されたLHCブローカーと、その選出に関与した他のLHCブローカーを示します。
3507 選出されたLHCブローカーでLHCモードがアクティブであることを示します。停止期間、VDA登録、セッション情報を含む停止の概要が含まれます。
3508 選出されたLHCブローカーでLHCがアクティブではなくなり、通常の操作が復元されたことを示します。停止期間、LHCイベント中に登録されたマシンの数、LHCモード中の起動成功数を含む停止の概要が含まれます。
3509 非選出LHCブローカーでLHCがアクティブであることを示します。2分ごとの停止期間と、選出されたLHCブローカーを示します。
3510 非選出LHCブローカーでLHCがアクティブではなくなったことを示します。停止期間と、選出されたLHCブローカーを示します。

リモートブローカープロバイダー

このサービスは、Citrix CloudとVDAおよびCloud Connector間のプロキシとして機能します。
イベントID 説明
3001 Cloud ConnectorがPending HA状態になる原因となる障害が最初に検出されました。ヘルスチェックは、障害が一時的なものか永続的なものかを評価し始めます。Pending HA状態での割り当てられた時間が経過した後、最新のヘルスチェック結果は、LHCモードへの移行が必要か、または通常の操作を再開できるかを示します。
3002 Cloud ConnectorがLHCモードに入れないことを示します。理由はイベント情報に含まれています。
3003
Cloud ConnectorがLHCモードの状態を遷移していることを示します。このイベントは、以下の詳細を提供します
  • Cloud Connectorが遷移している元の状態
  • 遷移先の状態
  • 前の状態の期間
注:
Cloud Connectorで1日を通して定期的に発生する3001イベントは、通常、懸念の原因ではありません。ただし、1時間に複数回発生する場合は、ネットワークの問題を示しており、さらなる調査が必要になる可能性があります。

Citrix モニター

Citrix Monitorには、環境内のさまざまなゾーンにおけるLHCモードのエントリとパフォーマンスに関する集中情報が含まれています。
DaaS モニター LHC(/en-us/citrix-daas/media/monitor-lhc.png)
詳細については、「サイト全体の履歴トレンドを監視する」(/ja-jp/citrix-daas/monitor/site-analytics/trends.html)を参照してください。

ローカルホストキャッシュモードの強制

以下のシナリオでは、意図的にローカルホストキャッシュモードを強制することが望ましい場合があります。
  • ネットワークが繰り返し停止したり回復したりする場合: ネットワークの問題が解決するまでLHCを強制することで、通常モードとLHCモード間の継続的な移行（およびそれに伴う頻繁なVDA登録ストーム）を防ぎます。
  • ディザスタリカバリ計画をテストするため。
  • ローカルホストキャッシュが正しく機能していることを確認するため。
LHCモードを強制するには:
  1. HKLM\Software\Citrix\DesktopServer\LHCにある各Cloud Connectorサーバーのレジストリを編集します: OutageModeForcedをREG_DWORDとして作成し、1に設定します。
    • 値を1に設定すると、Citrix Cloudへの接続状態に関わらず、LHCブローカーはLHCモードに入るよう指示されます。
    • 値を0に設定すると、LHCブローカーはLHCモードを終了し、通常の操作を再開するよう指示されます。
イベントを確認するには:
  1. C:\ProgramData\Citrix\workspaceCloud\Logs\Plugins\HighAvailabilityServiceにあるCurrent_HighAvailabilityServiceログファイルを監視します。

同期インポートの失敗のトラブルシューティング

LHCデータベースへの同期インポートが失敗し、505イベントがログに記録された場合、以下のトラブルシューティングツールを使用できます。
  • CDFトレース:
    • ConfigSyncServerおよびBrokerLHCモジュールのトレースを有効にします。
    • 他のブローカーモジュールと組み合わせて使用し、問題を特定します。
  • CSSトレースレポート:
    • 同期失敗の原因となっているオブジェクトを特定する詳細レポートを生成します。
      注:
      このレポートを有効にすると、同期速度に影響を与える可能性があります。積極的にトラブルシューティングを行っていない場合は、無効にしてください。
    CSSトレースレポートを有効にして生成するには:
    1. レポートを有効にする: 次のコマンドを実行します:
      New-ItemProperty -Path HKLM:\SOFTWARE\Citrix\DesktopServer\LHC -Name EnableCssTraceMode -PropertyType DWORD -Value 1
    2. レポートの場所: HTMLレポートはC:\Windows\ServiceProfiles\NetworkService\AppData\Local\Temp\CitrixBrokerConfigSyncReport.htmlに生成されます。
    3. レポートを無効にする: レポートが生成された後、次のコマンドを実行してレポート機能を無効にします:
      Set-ItemProperty -Path HKLM:\SOFTWARE\Citrix\DesktopServer\LHC -Name EnableCssTraceMode -Value 0

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

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

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

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

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

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

詳細情報

  • 「Local Host Cache のスケーリングとサイズに関する考慮事項」で、以下の情報について確認してください。
    • テスト方法論と結果
    • RAM サイズに関する考慮事項
    • CPU コアとソケット構成に関する考慮事項
    • ストレージに関する考慮事項
  • 技術概要: ローカルホストキャッシュ
  • Local Host Cache (LHC) リアルタイム可視化ツールは、Citrix Local Host Cache 環境での可視性を提供する包括的な PowerShell ベースのソリューションです。Cloud Connector からアクセスできるコマンドラインインターフェイスとシンプルな GUI インターフェイスの両方を提供し、以下のことを可能にします。
    • ゾーンまたはリソースの場所にある Cloud Connector を検出する
    • LHC モード中に選出されたリーダーを特定する
    • ゾーンまたはリソースの場所にあるすべての Cloud Connector で強制停止モードを有効または無効にする
    • 特定のプロバイダーとイベント ID からイベントログを照会する
    • 選出されたリーダーで Broker PowerShell コマンドを実行する
    詳細については、Local Host Cache Visibility Toolを参照してください。