Citrix Director の障害理由とトラブルシューティング
以下の表は、さまざまな障害カテゴリ、その理由、および問題を解決するために必要なアクションについて説明しています。詳細については、「列挙型、エラーコード、および説明」を参照してください。
接続障害エラー
| カテゴリ | 理由 | 問題 | アクション |
|---|---|---|---|
| 該当なし | [0] 不明。このエラーコードはマッピングされていません。 | 監視サービスは、ブローカリングサービスから共有された情報から、報告された起動または接続障害の理由を判断できません。 | コントローラーでCDFログを収集し、Citrixサポートに連絡してください。 |
| [0] なし | [1] なし | なし | 該当なし |
| [2] マシンの障害 | [2] セッションの準備 | デリバリーコントローラーからVDAへのセッション準備要求が失敗しました。考えられる原因:コントローラーとVDA間の通信の問題、Broker Serviceが準備要求を作成する際に発生した問題、またはVDAが要求を受け入れない原因となるネットワークの問題。 | コントローラーとVDA間の通信の問題を引き起こす一般的な問題については、ナレッジセンターの記事「Citrix Virtual Apps and DesktopsにおけるデリバリーコントローラーへのVirtual Delivery Agent登録のトラブルシューティング」に記載されているトラブルシューティング手順を参照してください。 |
| [2] マシンの障害 | [3] 登録タイムアウト | VDAは電源がオンになっていましたが、デリバリーコントローラーへの登録を試行中にタイムアウトが発生しました。 | デリバリーコントローラーでCitrix Broker Serviceが実行されており、VDAでDesktop Serviceが実行されていることを確認してください。停止している場合は、それぞれを開始してください。 |
| [1] クライアント接続の失敗 | [4] 接続タイムアウト | VDAがセッション起動のために準備された後、クライアントはVDAに接続しませんでした。セッションは正常に仲介されましたが、クライアントがVDAに接続するのを待っている間にタイムアウトが発生しました。考えられる原因:ファイアウォール設定、ネットワークの中断、またはリモート接続を妨げる設定。 | Directorコンソールで、クライアントが現在アクティブな接続を持っているかどうかを確認してください。これは、ユーザーに影響がないことを意味します。セッションが存在しない場合は、クライアントとVDAのイベントログでエラーがないか確認してください。クライアントとVDA間のネットワーク接続に関する問題を解決してください。 |
| [4] 利用可能なライセンスなし | [5] ライセンス | ライセンス要求が失敗しました。考えられる原因:ライセンス数が不足しているか、ライセンスサーバーが30日以上ダウンしている。 | ライセンスサーバーがオンラインで到達可能であることを確認します。ライセンスサーバーへのネットワーク接続の問題を解決するか、ライセンスサーバーが誤動作しているように見える場合は再起動します。環境内に十分なライセンスがあることを確認し、必要に応じて追加のライセンスを割り当てます。 |
| [1] クライアント接続失敗 | [6] チケット発行 | チケッティング中に障害が発生しました。これは、VDAへのクライアント接続がブローカーされた要求と一致しないことを示しています。起動要求チケットはブローカーによって準備され、ICA®ファイルで配信されます。ユーザーがセッションを起動しようとすると、VDAはICAファイル内の起動チケットをブローカーで検証します。考えられる原因:ICAファイルが破損しているか、ユーザーが不正な接続を試みています。 | デリバリーグループで定義されたユーザーグループに基づいて、ユーザーがアプリケーションまたはデスクトップにアクセスできることを確認します。ユーザーにアプリケーションまたはデスクトップを再起動するよう指示し、これが一時的な問題であるかどうかを判断します。問題が再発する場合は、クライアントデバイスのイベントログでエラーを確認します。ユーザーが接続しようとしているVDAが登録されていることを確認します。登録されていない場合は、VDAのイベントログを確認し、登録に関する問題を解決します。 |
| [1] クライアント接続失敗 | [7] その他 | クライアントが最初にVDAに接続した後、接続シーケンスを完了する前に、セッションがVDAから終了したと報告されました。 | 起動前にユーザーによってセッションが終了されていないことを確認します。セッションの再起動を試み、問題が解決しない場合は、CDFログを収集してCitrixサポートに連絡してください。 |
| [1] クライアント接続失敗 | [8] 一般的な失敗 | セッションの起動に失敗しました。考えられる原因:ブローカーがまだ起動中または初期化中にブローカーによる起動が要求されたか、起動のブローカーフェーズ中に内部エラーが発生しました。 | 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がないか確認します。容量を増やすために不要な場合は、メンテナンスモードを無効にします。Citrixポリシー設定の最大セッション数の値を増やして、サーバーVDAあたりのセッション数を増やすことを検討してください。マルチセッション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コンソールでマシンが実行中であることを確認してください。そうでない場合は、マシンにパーソナルvDiskが割り当てられていることを確認し、ハイパーバイザーにログインしてVMをリセットしてください。 |
| [2] マシン障害 | [19] 拒否されました | デリバリーコントローラーは、エンドユーザーからの接続に備えるようVDAに要求を送信しますが、VDAはこの要求を積極的に拒否します。 | pingを使用して、デリバリーコントローラーとVDAが正常に通信できることを確認してください。通信できない場合は、ファイアウォールまたはネットワークルーティングの問題を解決してください。 |
| [2] マシン障害 | [20] 構成セットの障害 | デリバリーコントローラーは、セッション起動中にポリシー設定やセッション情報などの必要な構成データをVDAに送信しませんでした。考えられる原因:コントローラーとVDA間の通信の問題、構成セット要求の作成中にブローカーサービスで発生した問題、またはVDAが要求を受け入れない原因となるネットワークの問題。 | - |
| [3] 利用可能な容量がありません | [21] 最大インスタンス総数を超過しました | アプリケーションのインスタンスの最大数に達しました。VDA上でアプリケーションの追加インスタンスを開くことはできません。この問題は、アプリケーション制限機能に関連しています。 | ライセンスが許す範囲で、「同時に実行するインスタンスの数を制限する」というアプリケーション設定をより高い値に増やすことを検討してください。 |
| [3] 容量不足 | [22] ユーザーあたりの最大インスタンス数を超過しました | ユーザーがアプリケーションの複数のインスタンスを開こうとしていますが、アプリケーションはユーザーごとに単一のインスタンスのみを許可するように構成されています。この問題は、アプリケーション制限機能に関連しています。 | デフォルトでは、ユーザーごとにアプリケーションのインスタンスは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 | VMが起動シーケンスを完了せず、ハイパーバイザーと通信していません。 | VMがハイパーバイザー上で正常に起動したことを確認してください。OSの問題など、VM上の他のメッセージを確認してください。ハイパーバイザーツールがVMにインストールされていることを確認してください。VDAがVMにインストールされていることを確認してください。 |
| 起動に失敗 | 1 | ハイパーバイザー上で起動しようとしたときに、VMで問題が発生しました。 | ハイパーバイザーのログを確認してください。 |
| なし | 0 | - | - |
マシンの登録解除理由 (障害タイプが「未登録」または「不明」の場合に適用)
| エラーコード | エラーコードID | 問題 | 対策 |
|---|---|---|---|
| エージェントシャットダウン | 0 | VDAは正常にシャットダウンされました。 | 既存の電源管理ポリシーに基づいてVDAがオフになることを想定していない場合は、VDAの電源をオンにします。イベントログでエラーを確認してください。 |
| エージェント中断 | 1 | VDAは休止状態またはスリープモードです。 | VDAを休止状態から復帰させます。電源設定を介してCitrix Virtual Apps and Desktops VDAの休止状態を無効にすることを検討してください。 |
| 互換性のないバージョン | 100 | Citrixプロトコルバージョンの不一致により、VDAがデリバリーコントローラーと通信できません。 | 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間の通信問題を引き起こす一般的な問題については、ナレッジセンターの記事「Citrix Virtual Apps and DesktopsにおけるデリバリーコントローラーへのVirtual Delivery Agent登録のトラブルシューティング (CTX136668)」に記載されているトラブルシューティング手順を参照してください。Citrixサポートにお問い合わせください。 | |
| エージェントの不正なアクティブディレクトリオーユー | 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がブローカーに登録要求を行いましたが、要求の内容が破損しているか無効です。 | コントローラーとVDA間の通信の問題を引き起こす一般的な問題については、ナレッジセンターの記事「(https://support.citrix.com/article/CTX136668)」に記載されているトラブルシューティング手順を参照してください。 |
| シングル/マルチセッションの不一致 | 111 | VDAのオペレーティングシステムタイプは、マシンカタログまたはデリバリーグループと互換性がありません。 | VDAを、同じオペレーティングシステムを持つマシンを含む正しいマシンカタログタイプまたはデリバリーグループに追加してください。 |
| カタログの機能レベルが低すぎます | 112 | マシンカタログが、インストールされているVDAバージョンよりも高いVDA機能レベルに設定されています。 | VDAのマシンカタログ機能レベルがVDAの機能レベルと一致していることを確認します。VDAの機能レベルと一致するようにマシンカタログをアップグレードまたはダウングレードします。 |
| デスクトップグループの機能レベルが低すぎます | 113 | デリバリーグループが、インストールされているVDAバージョンよりも高いVDA機能レベルに設定されています。 | VDAのデリバリーグループ機能レベルがVDAの機能レベルと一致していることを確認します。VDAの機能レベルと一致するようにマシンカタログをアップグレードまたはダウングレードします。 |
| 電源オフ | 200 | VDAが正常にシャットダウンされませんでした。 | VDAが電源オン状態であるべき場合は、Citrix StudioからVDAを起動し、正常に起動して登録されることを確認します。起動または登録に関する問題をトラブルシューティングします。VDAが再び稼働したら、イベントログを確認してシャットダウンの根本原因を特定するのに役立ててください。 |
| エージェントが設定の更新を拒否しました | 203 | Citrixポリシーなどの設定が変更または更新されましたが、VDAへの更新の送信中にエラーが発生しました。これは、更新がインストールされているVDAバージョンと互換性がない場合に発生する可能性があります。 | 必要に応じてVDAをアップグレードします。適用された更新がVDAバージョンでサポートされているかどうかを確認します。 |
| セッション準備失敗 | 206 | BrokerがVDAで実行中のセッションの監査を完了しませんでした。 | 広範囲にわたる場合は、デリバリーコントローラーでCitrix Broker Serviceを再起動してください。 |
| 206 | BrokerがVDAで実行中のセッションの監査を完了しませんでした。 | Citrixサポートに連絡してください。 | |
| 接続喪失 | 207 | デリバリーコントローラーがVDAとの接続を失いました。これはネットワーク障害が原因である可能性があります。 | デリバリーコントローラーでCitrix Broker Serviceが実行されており、VDAでDesktopサービスが実行されていることを確認してください。停止している場合はそれぞれ起動してください。すでに起動している場合は、VDAでDesktopサービスを再起動して登録プロセスを再開し、VDAが正常に登録されることを確認してください。アプリケーションイベントログの詳細を通じて、VDA用に構成されたデリバリーコントローラーが正確であることを確認してください。pingを使用して、デリバリーコントローラーとVDAが正常に通信できることを確認してください。通信できない場合は、ファイアウォールまたはネットワークの問題を解決してください。 |
| 207 | デリバリーコントローラーがVDAとの接続を失いました。これはネットワーク障害が原因である可能性があります。 | VDA上でDesktopサービスが実行されていることを確認します。停止している場合は開始します。 | |
| ブローカー登録制限に達しました | 301 | デリバリーコントローラーは、同時に登録できるVDAの構成済み最大数に達しました。デフォルトでは、デリバリーコントローラーは10,000の同時VDA登録を許可します。 | サイトにデリバリーコントローラーを追加するか、サイトを作成することを検討してください。また、HKEY_LOCAL_MACHINE\Software\Citrix\DesktopServer\MaxWorkers レジストリキーを介して、デリバリーコントローラーに同時に登録できるVDAの数を増やすこともできます。詳細については、Knowledge Centerの記事「Citrix Virtual Apps and Desktopsで使用されるレジストリキーエントリ (CTX117446)」を参照してください。この数を増やすと、コントローラーにより多くのCPUおよびメモリリソースが必要になる場合があります。 |
| 設定作成の失敗 | 208 | Brokerは、VDAに送信する設定と構成のセットを構築しませんでした。Brokerがデータを収集できない場合、登録は失敗し、VDAは登録解除されます。 | デリバリーコントローラーのイベントログでエラーがないか確認してください。ログに特定の問題が明らかでない場合は、Broker Serviceを再起動してください。Broker Serviceが再起動されたら、影響を受けるVDAでDesktopサービスを再起動し、それらが正常に登録されることを確認してください。 |
| 208 | Brokerは、VDAに送信する設定と構成のセットを構築しませんでした。Brokerがデータを収集できない場合、登録は失敗し、VDAは登録解除されます。 | 影響を受けるVDAでDesktopサービスを再起動し、それらが正常に登録されることを確認してください。Citrixサポートに連絡してください。 | |
| 設定送信の失敗 | 204 | ブローカーが設定および構成データをVDAに送信しませんでした。ブローカーがデータを収集できても送信できない場合、登録は失敗します。 | 単一の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 の障害理由とトラブルシューティング
コピー完了
コピー失敗