診断ツールまたはNetScaler Console GUIを使用して問題をトラブルシューティングする

最終公開日 : Oct 02, 2026
注
診断ツールは、Console Advisory Connectベースのロータッチオンボーディングを使用してオンボーディングされた、またはオンボーディングされる予定のNetScalerインスタンスにのみ適用されます。
詳細については、NetScaler Console Connectを使用したNetScalerインスタンスのロータッチオンボーディングを参照してください。
NetScalerインスタンスをNetScaler Consoleにオンボーディングする際、NetScalerインスタンスのオンボーディングが正常に完了しないいくつかの問題が発生する可能性があります。管理者として、オンボーディング失敗の原因を知る必要があります。以下の状況で、診断ツールを使用して診断チェックを実行できます。
  • 自動オンボーディングまたはスクリプトベースのオンボーディング中に問題が発生した場合
  • NetScalerインスタンスがオンボーディングの準備ができているかを確認したい場合
  • NetScaler Console GUIで「ダウン」ステータスを表示している、すでにオンボーディングされているNetScalerインスタンスの問題を分析したい場合
NetScalerインスタンスでConsole Advisory Connectが有効になっている場合、診断の詳細は自動的にCitrixに送信され、NetScaler Console GUIで詳細を表示できます。Console Advisory Connectが有効になっていない場合は、診断ツールを手動で使用できます。
Related information
Console Advisory Connect を使用した NetScaler インスタンスのロータッチオンボーディング

診断ツールを手動で使用する

診断ツールは、mastoolsアップグレード（13.1-2.x以降）の一部として利用可能で、/var/mastools/scriptsでアクセスできます。NetScalerインスタンスでcat /var/mastools/version.txtコマンドを実行することで、mastoolsのバージョンを確認できます。
診断ツールを実行するには：
  1. SSHクライアントを使用して、NetScalerインスタンスにログオンします。
  2. shellと入力し、Enterキーを押してbashモードに切り替えます。
  3. cd /var/mastools/scriptsと入力します。
  4. sh mastools_diagと入力します。
ツールが起動し、以下の診断チェックの結果が表示されます:
  • エヌエスシーエルアイ
  • DNS設定
  • インターネット接続
  • インスタンスからADMへの接続
  • ユーザー権限
トラブルシューティング後も問題が解決しない場合は、サポートに連絡できます。サポートに連絡する際は、診断ツール実行後に表示される構成情報を提供する必要があります。
以下は、問題のないNetScalerインスタンスの診断結果の例です:
問題のないNetScalerインスタンスの診断結果
  • 1 – 診断チェックの種類を表示します
  • 2 – 診断チェックの結果を緑または赤で表示します。緑は結果が成功したことを示し、赤は結果が成功しなかったことを示します。
  • 3 – 診断ツールを実行するたびに、NetScaler Consoleの構成情報が黄色で表示されます。NetScalerサポートに連絡する場合は、この情報を提供する必要があります。

診断ツールを使用してNetScalerインスタンスのオンボーディング準備状況を検証する

NetScalerインスタンスをNetScaler Consoleにオンボーディングする前に、NetScalerインスタンスで診断ツールを実行して、その準備状況を確認できます。NetScalerインスタンスに問題がなく、オンボーディングの準備ができていれば、ツールは「device not claimed on ADM」というメッセージを表示します。
NetScaler Console で要求されていないデバイス(/en-us/netscaler-console-service/media/device-not-claimed.png)

NetScaler Console GUI で NetScaler 診断情報を表示する

Infrastructure > Instances > NetScaler に移動し、Asset Inventory をクリックすると、新しく追加されたオンボーディング準備状況オプションが表示されます。このオプションは、要確認またはOKなどの NetScaler インスタンスのオンボーディング準備状況を提供します。
  • 要確認。NetScaler インスタンスには修正が必要な問題があります。
  • OK。NetScaler インスタンスはオンボーディングの準備ができています。
注:
オンボーディング準備状況が空白の場合、NetScaler インスタンスが診断サポートを備えた最新のイメージで実行されていないことを意味します。
NetScaler インスタンスに問題がある場合、要確認オプションが表示され、クリックして詳細を表示できます。
自動診断メッセージ(/en-us/netscaler-console-service/media/auto-diagnostic-info.png)
要確認をクリックすると、NetScaler 診断の詳細ページに問題の詳細が表示されます。
自動診断の問題の詳細(/en-us/netscaler-console-service/media/auto-diagnostic-issue.png)
  • カテゴリ。問題のカテゴリを提供します。
  • ステータス。要確認、OK、または該当なしなどの問題のステータスを提供します。
  • 推奨事項。問題のトラブルシューティングに必要な推奨事項を提供します。
問題を修正すると、オンボーディング準備状況のステータスがOKに変更されます。

トラブルシューティング

以下は、NetScalerインスタンスに関するいくつかの問題と、そのトラブルシューティング手順です。

無効なユーザー名またはパスワード

無効な資格情報
回避策: 管理者プロファイルで指定されたユーザー名とパスワードが正しいことを確認してください。NetScalerインスタンスのパスワードを変更した場合は、インスタンスの管理者プロファイルを変更する必要があります。詳細については、「管理者プロファイルの変更」を参照してください。

DNS構成エラー

DNS構成エラー
回避策: DNSが構成されているか、DNS IPアドレスが有効であることを確認してください。詳細については、「DNS構成」を参照してください。

インターネット接続なし

回避策: ファイアウォール設定がインターネットアクセスをブロックしていないこと、および必要なプロキシが構成されていることを確認してください。

NetScaler Consoleエンドポイントへの接続なし

回避策: ファイアウォール設定を確認し、以下のNetScaler Consoleエンドポイントがファイアウォールでブロックされていないことを確認してください。
ADM_GRP_EP = "adm.cloud.com"

ADM_AGENT_EP = "agent.adm.cloud.com"

ADM_TRUST_EP = "trust.citrixnetworkapi.net"

ADM_DOWNLOAD_EP = "download.citrixnetworkapi.net"
診断チェックで問題が見つからず、接続の問題が依然として解決しない場合は、NetScaler Consoleの構成情報（黄色で表示）をメモし、NetScalerサポートに連絡してください。
NetScalerインスタンスがオンボーディングの準備ができていることを確認するためにテスト実行を行うと、以下の問題が発生する可能性があります。

組み込みエージェントのドライランタイムアウト

ドライランの結果が5分以内に取得されない場合、タイムアウトメッセージが表示されます。
タイムアウト(/en-us/netscaler-console-service/media/onboarding-timeout.png)
推奨事項: NetScalerインスタンスが診断サポートを備えた最新のイメージで実行されているかどうかを確認することをお勧めします。また、アセット選択テーブルでは、「オンボーディング準備状況」列が空白で表示されます。

デバイスプロファイルのドロップダウンに表示される赤い枠線

ドライラン中にNetScaler認証が失敗し、デバイスプロファイルのドロップダウンに赤い枠線が表示されます。
プロファイルエラー(/en-us/netscaler-console-service/media/builtin-agent-dry-run.png)
推奨事項: NetScalerユーザー管理者資格情報を再度入力し、デバイスプロファイルを作成し、「テスト」をクリックしてドライランを再度実行します。