Citrix DaaS™

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

この記事では、ビジネス継続性を維持する機能に焦点を当て、ローカルホストキャッシュ (LHC) 機能の完全な概要を説明します。通常の運用時とLHCモードがアクティブになった場合のLHCの機能について説明します。さらに、構成チェック、トラブルシューティング、LHC管理用のPowerShellコマンド、およびLHCの健全性のためのイベントログ監視に関するガイダンスも提供します。

概要

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上のRemote Broker Provider Serviceは、すべてのブローカー処理操作のために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は、約5分ごとにCitrix CloudのCloudブローカーをチェックし、構成変更が行われたかどうかを確認します。これらの変更は、管理者によって開始されたもの (デリバリーグループプロパティの変更など) またはシステムアクション (マシン割り当てなど) の場合があります。
  • 前回のチェック以降に構成変更が発生した場合、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ブローカーは、別のチャネルで互いに通信します。これらのブローカーは、実行されているマシンのFQDN名のアルファベット順リストを使用して、ゾーンがLHCモードに入った場合にゾーンで操作を仲介するLHCブローカーを決定 (選出) します。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の状態

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

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

LHCモード中には、以下の影響を考慮してください。

側面 LHCモード中の影響
Studioアクセス 中断の性質によってはアクセスできない場合があります。LHCモードで動作しているゾーンのVDAは、LHCブローカーに登録されているため、Studioでは未登録と表示されます。
リモートPowerShell SDKアクセス


アクセスが制限されます。
SDK認証の設定: Get-XDAuthentication -ProfileName WindowsCurrentUser を実行して、SDKプロキシがコマンドレット呼び出しをリダイレクトするのを防ぎます。これらの変更を行った後、すべての Get-Broker コマンドレットを使用できます。
: 最初のコマンドレット呼び出しに -AdminAddress localhost:89 パラメーターを含めます。
例: Get-BrokerMachine -AdminAddress localhost:89
監視データ LHCモードがアクティブな間は、監視機能はアクティビティを表示しません。監視データの一部は、Monitorのトレンドページのローカルホストキャッシュダッシュボードで利用できます。
ハイパーバイザー資格情報 ホストサービスから取得できません。不明な電源状態のマシンでは、電源操作はできません。電源がオンになっているVMは接続に使用できます。
割り当て済みマシン 通常操作中に割り当てられた場合にのみ使用可能です。LHCモードでは新しい割り当ては不可能です。
リモート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モード中に新しい接続でこれらのマシンを利用できるようにすることができます。

-  デリバリーグループの作成中にこの機能を有効にするには、「[デリバリーグループの作成](/ja-jp/citrix-daas/install-configure/delivery-groups-create#local-host-cache-mode-page)」を参照してください。

注:

この設定は、電源管理されたVDAを提供するプールされたデスクトップデリバリーグループに対してのみ、Studioで利用可能です。

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

特定のデリバリーグループ内のVDAに対してLHCを有効にするには、次の手順に従います。

  1. このコマンドを実行して、サイトレベルでこの機能を有効にします。

    Set-BrokerSite -ReuseMachinesWithoutShutdownInOutageAllowed $true
    <!--NeedCopy-->
    
  2. デリバリーグループ名を指定してこのコマンドを実行することで、デリバリーグループのLHCを有効にします。

    Set-BrokerDesktopGroup -Name "name" -ReuseMachinesWithoutShutdownInOutage $true
    <!--NeedCopy-->
    

電源管理されたVDAを持つ新しく作成されたプールされたデリバリーグループのデフォルトのLHC可用性を変更するには、次のコマンドを実行します。

Set-BrokerSite -DefaultReuseMachinesWithoutShutdownInOutage $true
<!--NeedCopy-->

注:

デフォルトを変更しても既存のデリバリーグループの設定は変更されず、PowerShellを使用して作成されたデリバリーグループにのみ影響します。

StoreFrontの構成

  • オンプレミスのStoreFront展開を使用している場合は、以下を確認してください。

  • 負荷分散仮想サーバーを使用している場合は、ブローカー機能に基づいてコネクターを監視するように仮想サーバーを構成します (例: コネクターの負荷分散には、NetScaler®の組み込みCITRIX-XD-DDCモニターを使用します)。
  • 単一のクラウドテナント内のすべてのCloud Connectorを、StoreFrontで単一のリソースフィードとして含めます。
  • StoreFrontでNetScaler Gatewayの構成を表示し、すべてのコネクターがSTAサーバーとしてリストされていることを確認します。NetScalerアプライアンスを確認し、StoreFrontにリストされているすべてのSTAがNetScaler Gateway仮想サーバーで同じ形式であることを確認します。STAサービスの状態は、Gateway仮想サーバーでも監視できます。
  • StoreFrontのリソースフィードにすべてのコネクターを追加し、StoreFrontがリソースフィードで指定されたポートを介してすべてのCloud Connectorと通信できることを確認します。

注:

多数のコネクターを持つお客様の場合、管理オーバーヘッドを削減し、トラブルシューティングを簡素化するために、各ゾーンに負荷分散仮想サーバーを構成すると有益な場合があります。詳細については、Citrix TIPs: Integrating Citrix Virtual Apps and Desktops service and StoreFrontを参照してください。

ローカルホストキャッシュの動作確認

  • LHCが正しくセットアップされ、動作していることを確認するには、次の手順を実行します。

  • 同期インポートが正常に完了していることを確認します。LHCの同期を監視する方法の詳細については、イベントログを確認してください。

    • 各Cloud Connectorにローカルホストキャッシュデータベースが作成されていることを確認します。これにより、必要に応じて高可用性サービスが引き継ぐことができることが確認されます。
    • Cloud Connectorサーバーで、c:\Windows\ServiceProfiles\NetworkServiceに移動します。
    • HaDatabaseName.mdfHaDatabaseName_log.ldfが作成されていることを確認します。

    • ゾーン内のすべてのCloud ConnectorでLHCモードを強制します。ローカルホストキャッシュが動作することを確認したら、すべてのCloud Connectorを通常モードに戻すことを忘れないでください。LHCモードを終了するのにかかる時間に関する詳細については、ローカルホストキャッシュの状態を参照してください。

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

イベントログ

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

Config Synchronizer Service

通常の操作中、CSSがLHCブローカーを使用して構成データをLHCデータベースにインポートするときに、次のイベントが発生する可能性があります。

イベントID 説明
503 CSSが更新された構成を受信したことを示します。このイベントは、Citrix Cloudから更新された構成が受信されるたびに発生します。これは同期プロセスの開始を示します。
504 CSSが更新された構成をインポートしたことを示します。構成のインポートは正常に完了しました。
505 CSSがインポートに失敗したことを示します。構成のインポートは正常に完了しませんでした。以前に成功した構成が利用可能な場合、LHCモードに入るとそれが使用されます。ただし、それは現在の構成から古くなります。以前の構成が利用できない場合、サービスはLHCモード中にセッションブローカーに参加できません。この場合、トラブルシューティングセクションを参照し、Citrixサポートに連絡してください。
507 システムがLHCモードであり、LHCブローカーがブローカー処理に使用されているため、CSSがインポートを中止したことを示します。サービスは新しい構成を受信しましたが、LHCモードに入ったためインポートは中止されました。これは予期される動作です。
510 プライマリConfiguration ServiceからCSS構成データが受信されなかったことを示します。
517 プライマリBroker Serviceとの通信に問題があったことを示します。
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がLHCモードに入る必要があるかを確認します。Cloud Connectorのヘルスチェックが1回失敗した後に発生します。90秒後に別のチェックが失敗した場合、Cloud ConnectorはLHCモードに移行します。
    • 3002 Cloud ConnectorがLHCモードに入れないことを示します。理由はイベント情報に含まれています。
    • 3003 Cloud ConnectorがLHCモードの状態を移行中であることを示します。このイベントは以下の詳細を提供します
    • ^^ ^^ - Cloud Connectorが移行している元の状態
  • ^^ ^^ - 移行先の状態
    • ^^ ^^ - 以前の状態の期間

注:

Cloud Connectorで1日を通して定期的に発生する3001イベントは、通常、懸念事項ではありません。ただし、1時間に複数回発生する場合は、ネットワークの問題を示しており、さらなる調査が必要になる可能性があります。

Citrix Monitor

Citrix Monitorには、環境内のさまざまなゾーンにおけるLHCモードのエントリとパフォーマンスに関する集中情報が含まれています。

DaaS Monitor LHC

詳細については、「サイト全体の履歴トレンドを監視する」を参照してください。

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

以下のシナリオでは、意図的にローカルホストキャッシュモードを強制することが望ましい場合があります。

  • ネットワークが繰り返し停止および再開する場合: ネットワークの問題が解決されるまでLHCを強制することで、通常モードとLHCモード間の継続的な移行(およびそれに伴う頻繁なVDA登録ストーム)を防ぎます。
  • ディザスターリカバリー計画をテストするため。
  • ローカルホストキャッシュが正しく機能していることを確認するため。

LHCモードを強制するには:

  1. 各Cloud Connectorサーバーのレジストリ (HKLM\Software\Citrix\DesktopServer\LHC) を編集します: 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
      <!--NeedCopy-->
      
    2. レポートの場所: HTMLレポートはC:\Windows\ServiceProfiles\NetworkService\AppData\Local\Temp\CitrixBrokerConfigSyncReport.htmlに生成されます。

    3. レポートの無効化: レポートが生成されたら、次のコマンドを実行してレポート機能を無効にします。

      Set-ItemProperty -Path HKLM:\SOFTWARE\Citrix\DesktopServer\LHC -Name EnableCssTraceMode -Value 0
      <!--NeedCopy-->
      

ローカルホストキャッシュの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
<!--NeedCopy-->

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

次のコマンドレットは、Cloud ConnectorでLHCモードをアクティブ化および管理するのに役立ちます。

コマンドレット 機能
Enable-LhcForcedOutageMode BrokerをLHCモードにします。Enable-LhcForcedOutageModeが適切に機能するには、CSSによってローカルホストキャッシュデータベースファイルが正常に作成されている必要があります。このコマンドレットは、実行されたCloud ConnectorでのみLHCを強制します。LHCをアクティブにするには、ゾーン内のすべてのCloud Connectorでこのコマンドレットを実行する必要があります。
Disable-LhcForcedOutageMode Brokerを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登録
    • 構成情報

詳細情報