Citrix Director の障害理由とトラブルシューティング

以下の表は、さまざまな障害カテゴリ、その理由、および問題を解決するために必要なアクションについて説明しています。詳細については、「列挙型、エラーコード、および説明」を参照してください。

接続障害エラー

カテゴリ 理由 問題 アクション
該当なし [0] 不明。このエラーコードはマッピングされていません。 監視サービスは、ブローカリングサービスから共有された情報から、報告された起動または接続障害の理由を判断できません。 コントローラでCDFログを収集し、Citrixサポートに連絡してください。
[0] なし [1] なし なし 該当なし
[2] マシンフェイルアー [2] セッションプレパレーション デリバリーコントローラーからVDAへのセッション準備要求が失敗しました。考えられる原因:コントローラーとVDA間の通信の問題、準備要求の作成中にブローカーサービスで発生した問題、またはVDAが要求を受け入れない原因となるネットワークの問題。 コントローラーとVDA間の通信問題を引き起こす一般的な問題については、ナレッジセンターの記事「Citrix Virtual Apps and DesktopsにおけるデリバリーコントローラーへのVirtual Delivery Agent登録のトラブルシューティング」に記載されているトラブルシューティング手順を参照してください。
[2] マシンフェイルアー [3] レジストレーションタイムアウト VDAは電源が入っていましたが、デリバリーコントローラーへの登録を試行中にタイムアウトが発生しました。 Citrix Broker Serviceがデリバリーコントローラーで実行されており、DesktopサービスがVDAで実行されていることを確認してください。停止している場合はそれぞれを開始してください。
[1] クライアントコネクションフェイルアー [4] コネクションタイムアウト セッション起動のためにVDAが準備された後、クライアントがVDAに接続しませんでした。セッションは正常に仲介されましたが、クライアントがVDAに接続するのを待っている間にタイムアウトが発生しました。考えられる原因:ファイアウォール設定、ネットワークの中断、またはリモート接続を妨げる設定。 Directorコンソールで、クライアントが現在アクティブな接続を持っているかどうかを確認してください。これは、ユーザーに影響がないことを意味します。セッションが存在しない場合は、クライアントとVDAのイベントログでエラーがないか確認してください。クライアントとVDA間のネットワーク接続に関する問題を解決してください。
[4] ノーライセンスアベイラブル [5] ライセンシング ライセンス要求が失敗しました。考えられる原因:ライセンス数が不足しているか、ライセンスサーバーが30日以上ダウンしている。 ライセンスサーバーがオンラインで到達可能であることを確認します。ライセンスサーバーへのネットワーク接続の問題を解決するか、機能していないように見える場合はライセンスサーバーを再起動します。環境内に十分なライセンスがあることを確認し、必要に応じて追加で割り当てます。
[1] クライアント接続失敗 [6] チケッティング チケッティング中にエラーが発生しました。これは、VDAへのクライアント接続が仲介された要求と一致しないことを示しています。起動要求チケットはBrokerによって準備され、ICA®ファイルで配信されます。ユーザーがセッションを起動しようとすると、VDAはICAファイル内の起動チケットをBrokerで検証します。考えられる原因:ICAファイルが破損しているか、ユーザーが不正な接続を試みている。 デリバリーグループで定義されたユーザーグループに基づいて、ユーザーがアプリケーションまたはデスクトップにアクセスできることを確認します。これが一時的な問題であるかどうかを判断するために、ユーザーにアプリケーションまたはデスクトップを再起動するよう指示します。問題が再度発生する場合は、クライアントデバイスのイベントログでエラーを確認します。ユーザーが接続しようとしているVDAが登録されていることを確認します。未登録の場合は、VDAのイベントログを確認し、登録に関する問題を解決します。
[1] クライアント接続失敗 [7] その他 クライアントが最初にVDAに接続した後、接続シーケンスが完了する前に、セッションがVDAから終了したと報告されました。 起動前にユーザーによってセッションが終了されていないことを確認します。セッションを再起動してみてください。問題が解決しない場合は、CDFログを収集してCitrixサポートに連絡してください。
[1] クライアント接続失敗 [8] 一般的な失敗 セッションの起動に失敗しました。考えられる原因:Brokerがまだ起動中または初期化中に仲介された起動が要求されたか、起動の仲介フェーズ中に内部エラーが発生した。 Citrix Broker Serviceが実行中であることを確認し、セッションの起動を再試行します。
[5] 構成 [9] メンテナンスモード VDA、またはVDAが属するデリバリーグループがメンテナンスモードに設定されています。 メンテナンスモードが必要かどうかを判断します。不要な場合は、該当するデリバリーグループまたはマシンでメンテナンスモードを無効にし、ユーザーに再接続を試みるよう指示します。
[5] 構成 [10] アプリケーション無効 アプリケーションは管理者によって無効にされているため、エンドユーザーはアクセスできません。 アプリケーションが本番環境で使用されることを意図している場合は、アプリケーションを有効にし、ユーザーに再接続するよう指示します。
[4] 利用可能なライセンスなし [11] ライセンス機能拒否 使用されている機能は、既存のライセンスではカバーされていません。 既存のCitrix Virtual Apps and Desktops™ライセンスのエディションとタイプでカバーされている機能を確認するには、Citrixの営業担当者にお問い合わせください。
[3] 利用可能な容量なし [13] セッション制限に到達 すべてのVDAが使用中であり、これ以上セッションをホストする容量がありません。考えられる原因:すべてのVDAが使用中である(シングルセッションOS VDAの場合)、またはすべてのVDAが設定された最大同時セッション数に達している(マルチセッションOS VDAの場合)。 メンテナンスモードのVDAがないか確認します。より多くの容量を解放するために不要な場合は、メンテナンスモードを無効にします。サーバーVDAあたりのセッション数を増やすには、Citrixポリシー設定の最大セッション数の値を増やすことを検討してください。マルチセッションOS VDAを追加することを検討してください。シングルセッションOS VDAを追加することを検討してください。
[5] 構成 [14] 許可されていないプロトコル ICAおよびRDPプロトコルは許可されていません。 デリバリーコントローラーで Get-BrokerAccessPolicyRule PowerShellコマンドを実行し、AllowedProtocols の値に目的のプロトコルがすべてリストされていることを確認します。この問題は、構成が誤っている場合にのみ発生します。
[5] 構成 [15] リソースが利用できません ユーザーが接続しようとしているアプリケーションまたはデスクトップは利用できません。このアプリケーションまたはデスクトップが存在しないか、実行できるVDAがありません。考えられる原因:アプリケーションまたはデスクトップが非公開になっている、アプリケーションまたはデスクトップをホストしているVDAが最大負荷に達している、またはアプリケーションまたはデスクトップがメンテナンスモードに設定されている。 アプリケーションまたはデスクトップがまだ公開されており、VDAがメンテナンスモードではないことを確認します。マルチセッションOS VDAが最大負荷に達しているかどうかを判断します。もしそうであれば、さらにマルチセッションOS VDAをプロビジョニングします。接続に利用できるシングルセッションOS VDAがあることを確認します。必要に応じて、さらにシングルセッションOS VDAをプロビジョニングします。
[5] 構成 [16] アクティブセッションの再接続が無効です ICAセッションはアクティブで、別のエンドポイントに接続されています。ただし、Active Session Reconnection が無効になっているため、クライアントはアクティブなセッションに接続できません。 デリバリーコントローラーで、アクティブセッション再接続 が有効になっていることを確認します。レジストリの HKEY_LOCAL_MACHINE\Software\Citrix\Desktop\Server の下にある DisableActiveSessionReconnect の値が0に設定されていることを確認します。
[2] マシンの障害 [17] 再接続するセッションがありません クライアントは特定のセッションに再接続しようとしましたが、セッションは終了しました。 ワークスペースコントロールの再接続を再試行してください。
[2] マシンの障害 [18] スピンアップに失敗しました VDA はセッション起動のために電源をオンにできません。これはハイパーバイザーが報告した問題です。 マシンの電源がまだオフになっている場合は、Citrix Studio からマシンの起動を試みてください。これが失敗した場合は、ハイパーバイザーの接続と権限を確認してください。VDA が PVS プロビジョニングされたマシンである場合は、PVS コンソールでマシンが実行中であることを確認してください。実行中でない場合は、マシンに Personal vDisk が割り当てられていることを確認し、ハイパーバイザーにログインして VM をリセットしてください。
[2] マシンの障害 [19] 拒否されました デリバリーコントローラーは、エンドユーザーからの接続に備えるよう VDA に要求を送信しますが、VDA はこの要求を積極的に拒否します。 ping を介して、デリバリーコントローラーと VDA が正常に通信できることを確認してください。通信できない場合は、ファイアウォールまたはネットワークルーティングの問題を解決してください。
[2] マシンの障害 [20] 構成セットの障害 デリバリーコントローラーは、セッション起動中にポリシー設定やセッション情報などの必要な構成データを VDA に送信しませんでした。考えられる原因:コントローラーと VDA 間の通信の問題、構成セット要求の作成中に Broker Service で発生した問題、または VDA が要求を受け入れない原因となるネットワークの問題。 -
[3] 利用可能な容量がありません [21] 最大インスタンス総数を超過しました アプリケーションの最大インスタンス数に達しました。VDA でアプリケーションの追加インスタンスを開くことはできません。この問題は、アプリケーション制限機能に関連しています。 ライセンスで許可されている場合は、アプリケーション設定の「同時に実行するインスタンスの数を制限する」をより高い値に増やすことを検討してください。
[3] 利用可能な容量がありません [22] ユーザーごとの最大インスタンス数を超過しました ユーザーはアプリケーションの複数のインスタンスを開こうとしていますが、アプリケーションはユーザーごとに1つのインスタンスのみを許可するように構成されています。この問題は、アプリケーション制限機能に関連しています。 デフォルトでは、ユーザーごとに1つのアプリケーションインスタンスのみが許可されます。ユーザーごとに複数のインスタンスが必要な場合は、アプリケーション設定の「ユーザーごとに1つのインスタンスに制限する」設定をクリアすることを検討してください。
[1] クライアント接続エラー [23] 通信エラー デリバリーコントローラーは、接続の準備要求などの情報をVDAに送信しようとしましたが、通信中にエラーが発生しました。これはネットワークの中断が原因である可能性があります。 既に開始されている場合は、VDA上のデスクトップサービスを再起動して登録プロセスを再開し、VDAが正常に登録されていることを確認します。アプリケーションイベントログの詳細を通じて、VDA用に構成されたデリバリーコントローラーが正確であることを確認します。
[3] 利用可能な容量がありません [100] 利用可能なマシンがありません 監視サービスは [12] 利用可能なデスクトップがありません をこのエラーコードに変換します。 セッションを起動するために割り当てられたVDAが無効な状態であるか、利用できません。考えられる原因:VDAの電源状態が不明または利用できない、VDAが前回のユーザーセッション以降に再起動されていない、現在のセッションで有効にする必要があるにもかかわらずセッション共有が無効になっている、またはVDAがデリバリーグループまたはサイトから削除された。 VDAがデリバリーグループ内にあることを確認します。そうでない場合は、適切なデリバリーグループに追加します。ユーザーが要求した公開共有デスクトップまたはアプリケーションを起動できるように、十分なVDAが登録され、準備状態にあることを確認します。VDAをホストしているハイパーバイザーがメンテナンスモードではないことを確認します。
[2] マシン障害 [101] マシン機能不全。監視サービスは、[12] デスクトップ利用不可 をこのエラーコードに変換します。 VDAが動作していません。考えられる原因:VDAがデリバリーグループから削除された、VDAが登録解除されている、VDAの電源状態が利用できない、またはVDAが内部的な問題を抱えている。 VDAがデリバリーグループに属していることを確認します。属していない場合は、適切なデリバリーグループに追加します。Citrix StudioでVDAが電源オンとして表示されていることを確認します。複数のマシンの電源状態が不明な場合は、ハイパーバイザーへの接続に関する問題やホストの障害を解決します。VDAをホストしているハイパーバイザーがメンテナンスモードではないことを確認します。これらの問題が解決されたら、VDAを再起動します。

マシンの障害タイプ

エラーコード エラーコードID 問題 アクション
不明 - - -
未登録 3 - -
最大容量(Directorでは「最大負荷」として表示されます) 4 マシンが最大容量に達していると報告しています(つまり、最大負荷インデックス) すべてのハイパーバイザーの電源がオンになっていることを確認します。影響を受けるデリバリーグループに、ハイパーバイザーの容量を増やすか、ハイパーバイザーを追加することで、マシンを追加します。
起動中に停止 2 仮想マシンが起動シーケンスを完了せず、ハイパーバイザーと通信していません。 仮想マシンがハイパーバイザー上で正常に起動したことを確認します。OSの問題など、仮想マシン上の他のメッセージを確認します。ハイパーバイザーツールが仮想マシンにインストールされていることを確認します。VDAが仮想マシンにインストールされていることを確認します。
起動失敗 1 仮想マシンがハイパーバイザー上で起動しようとしたときに問題が発生しました。 ハイパーバイザーのログを確認します。
なし 0 - -

マシンの登録解除理由 (障害タイプが「未登録」または「不明」の場合に適用)

エラーコード エラーコード ID 問題 アクション
エージェントシャットダウン 0 VDA は正常にシャットダウンされました。 既存の電源管理ポリシーに基づいてオフになっていると想定されない場合は、VDA の電源をオンにします。イベントログでエラーを確認します。
エージェント一時停止 1 VDA は休止状態またはスリープモードです。 VDA を休止状態から復帰させます。電源設定を介して Citrix Virtual Apps and Desktops VDA の休止状態を無効にすることを検討してください。
互換性のないバージョン 100 VDA は、Citrix プロトコルバージョンの不一致により、デリバリーコントローラーと通信できません。 VDA とデリバリーコントローラーのバージョンを合わせます。
エージェントアドレス解決失敗 101 デリバリーコントローラーは、VDA の IP アドレスを解決できませんでした。 VDA マシンアカウントが AD に存在することを確認します。存在しない場合は、作成します。DNS 内の VDA の名前と IP アドレスが正確であることを確認します。正確でない場合は、修正します。広範囲にわたる場合は、デリバリーコントローラーの DNS 設定を検証します。nslookup コマンドを実行して、コントローラーからの DNS 解決を確認します。
101 デリバリーコントローラーは、VDA の IP アドレスを解決できませんでした。 VDA マシンアカウントが AD に存在することを確認します。存在しない場合は、作成します。DNS 内の VDA の名前と IP アドレスが正確であることを確認します。正確でない場合は、修正します。
エージェント連絡不能 102 デリバリーコントローラーと VDA の間で通信の問題が発生しました。 ping を使用して、デリバリーコントローラーと VDA が正常に通信できることを確認します。通信できない場合は、ファイアウォールまたはネットワークの問題を解決します。コントローラーと VDA 間の通信問題を引き起こす一般的な問題については、Knowledge Center の記事「Troubleshooting Virtual Delivery Agent Registration with delivery controllers in Citrix Virtual Apps and Desktops (CTX136668)」に記載されているトラブルシューティング手順を参照してください。
102 デリバリーコントローラーとVDA間で通信の問題が発生しました。 コントローラーとVDA間の通信問題を引き起こす一般的な問題については、Knowledge Centerの記事「Citrix Virtual Apps and DesktopsにおけるデリバリーコントローラーへのVirtual Delivery Agent登録のトラブルシューティング (CTX136668)」に記載されているトラブルシューティング手順を参照してください。Citrixサポートにお問い合わせください。
エージェントのActive Directory OUが間違っています 103 Active Directoryの検出設定に誤りがありました。VDAレジストリで構成されているサイト固有のOU(サイトコントローラー情報がADに保存されている場所)が、別のサイト用です。 Active Directoryの設定が正しいことを確認するか、レジストリ設定を確認してください。
登録要求が空です 104 VDAからデリバリーコントローラーに送信された登録要求が空でした。これは、VDAソフトウェアのインストールが破損していることが原因である可能性があります。 VDA上のDesktopサービスを再起動して登録プロセスを再開し、アプリケーションイベントログを介してVDAが正しく登録されていることを確認してください。
登録に必要な機能の欠落 105 VDAのバージョンがデリバリーコントローラーと互換性がありません。 VDAをアップグレードするか、VDAを削除してから再インストールします。
エージェントバージョン不足 106 VDAのバージョンがデリバリーコントローラーと互換性がありません。 問題がすべてのマシンに影響している場合は、VDAソフトウェアを再インストールしてください。
登録機能に一貫性がない 107 VDAは、その機能をBrokerに通信できません。これは、VDAとデリバリーコントローラーのバージョン間の非互換性が原因である可能性があります。バージョンごとに変更される登録機能は、登録要求と一致しない形式で表現されています。 VDAとデリバリーコントローラーのバージョンを合わせます。
機能のライセンスなし 108 使用しようとしている機能はライセンスされていません。 Citrixライセンスエディションを確認するか、VDAを削除してから再インストールしてください。
108 使用しようとしている機能はライセンスされていません。 Citrixサポートにお問い合わせください。
サポートされていないCredentialSecurityバージョン 109 VDAとデリバリーコントローラーが同じ暗号化メカニズムを使用していません。 VDAとデリバリーコントローラーのバージョンを合わせてください。
登録要求が無効です 110 VDAがBrokerに登録要求を行いましたが、要求の内容が破損しているか無効です。 コントローラーとVDA間の通信問題を引き起こす一般的な問題については、Knowledge Centerの記事「Citrix Virtual Apps and DesktopsにおけるデリバリーコントローラーとのVirtual Delivery Agent登録のトラブルシューティング (CTX136668)」に記載されているトラブルシューティング手順を参照してください。
シングル/マルチセッションの不一致 111 VDAのオペレーティングシステムタイプは、マシンカタログまたはデリバリーグループと互換性がありません。 VDAを、同じオペレーティングシステムを持つマシンを含む正しいマシンカタログタイプまたはデリバリーグループに追加してください。
カタログの機能レベルが低すぎます 112 マシンカタログが、インストールされているVDAバージョンよりも高いVDA機能レベルに設定されています。 VDAのマシンカタログ機能レベルがVDAの機能レベルと一致していることを確認します。マシンカタログをVDAの機能レベルに合わせてアップグレードまたはダウングレードします。
デスクトップグループの機能レベルが低すぎます 113 デリバリーグループが、インストールされているVDAバージョンよりも高いVDA機能レベルに設定されています。 VDAのデリバリーグループ機能レベルがVDAの機能レベルと一致していることを確認します。マシンカタログをVDAの機能レベルに合わせてアップグレードまたはダウングレードします。
電源オフ 200 VDAが正常にシャットダウンされませんでした。 VDAが電源オンの状態であるべき場合、Citrix StudioからVDAを起動してみて、VDAが正常に起動して登録されることを確認します。起動または登録に関する問題があればトラブルシューティングします。VDAが再び稼働したら、イベントログを確認してシャットダウンの根本原因を特定するのに役立ててください。
エージェントが設定の更新を拒否しました 203 Citrixポリシーなどの設定が変更または更新されましたが、VDAへの更新の送信中にエラーが発生しました。これは、更新がインストールされているVDAバージョンと互換性がない場合に発生する可能性があります。 必要に応じてVDAをアップグレードします。適用された更新がVDAバージョンでサポートされているかどうかを確認します。
セッション準備失敗 206 ブローカーは、VDAで実行されているセッションの監査を完了しませんでした。 広範囲にわたる場合は、デリバリーコントローラーでCitrix Broker Serviceを再起動してください。
206 ブローカーは、VDAで実行されているセッションの監査を完了しませんでした。 Citrixサポートに連絡してください。
接続喪失 207 デリバリーコントローラーはVDAとの接続を失いました。これはネットワーク障害によって引き起こされる可能性があります。 デリバリーコントローラーでCitrix Broker Serviceが実行されており、VDAでDesktop Serviceが実行されていることを確認してください。停止している場合は、それぞれを開始してください。すでに開始されている場合は、VDAでDesktop Serviceを再起動して登録プロセスを再開し、VDAが正常に登録されることを確認してください。アプリケーションイベントログの詳細を通じて、VDA用に構成されているデリバリーコントローラーが正確であることを確認してください。pingを使用して、デリバリーコントローラーとVDAが正常に通信できることを確認してください。そうでない場合は、ファイアウォールまたはネットワークの問題を解決してください。
207 デリバリーコントローラーはVDAとの接続を失いました。これはネットワーク障害によって引き起こされる可能性があります。 VDAでDesktopサービスが実行されていることを確認します。停止している場合は開始します。
ブローカー登録制限到達 301 デリバリーコントローラーは、同時に登録できるVDAの構成済み最大数に達しました。デフォルトでは、デリバリーコントローラーは10,000の同時VDA登録を許可します。 サイトにデリバリーコントローラーを追加するか、サイトを作成することを検討してください。また、HKEY_LOCAL_MACHINE\Software\Citrix\DesktopServer\MaxWorkersレジストリキーを介して、デリバリーコントローラーに同時に登録できるVDAの数を増やすこともできます。詳細については、Knowledge Centerの記事「Registry Key Entries Used by Citrix Virtual Apps and Desktops (CTX117446)」を参照してください。この数を増やすと、コントローラーにより多くのCPUおよびメモリリソースが必要になる場合があります。
設定作成失敗 208 ブローカーは、VDAに送信する設定と構成のセットを構築しませんでした。ブローカーがデータを収集できない場合、登録は失敗し、VDAは登録解除されます。 デリバリーコントローラーのイベントログでエラーを確認します。ログに特定の問題が明らかでない場合は、ブローカーサービスを再起動します。ブローカーサービスが再起動されたら、影響を受けるVDAでDesktopサービスを再起動し、それらが正常に登録されることを確認します。
208 ブローカーは、VDAに送信する設定と構成のセットを構築しませんでした。ブローカーがデータを収集できない場合、登録は失敗し、VDAは登録解除されます。 影響を受けるVDAでDesktopサービスを再起動し、それらが正常に登録されることを確認します。Citrixサポートに連絡してください。
設定送信失敗 204 BrokerはVDAに設定と構成データを送信しませんでした。Brokerがデータを収集できても送信できない場合、登録は失敗します。 単一のVDAに限定されている場合は、VDA上のDesktopサービスを再起動して再登録を強制し、アプリケーションイベントログを介してVDAが正常に登録されていることを確認します。発生したエラーをトラブルシューティングします。コントローラーとVDA間の通信問題を引き起こす一般的な問題については、ナレッジセンターの記事「Citrix Virtual Apps and DesktopsにおけるデリバリーコントローラーとのVirtual Delivery Agent登録のトラブルシューティング (CTX136668)」に記載されているトラブルシューティング手順を参照してください。
エージェント要求 2 不明なエラーが発生しました。 Citrixサポートにお問い合わせください。
デスクトップの再起動 201 不明なエラーが発生しました。 Citrixサポートにお問い合わせください。
デスクトップの削除 202 不明なエラーが発生しました。 Citrixサポートにお問い合わせください。
セッション監査の失敗 205 不明なエラーが発生しました。 Citrixサポートにお問い合わせください。
不明なエラー 300 不明なエラーが発生しました。 Citrixサポートにお問い合わせください。
登録状態の不一致 302 不明なエラーが発生しました。 Citrixサポートにお問い合わせください。
不明 - 不明なエラーが発生しました。 Citrixサポートにお問い合わせください。
Citrix Director の障害理由とトラブルシューティング