Catalyst 9800 WLC からのログとデバッグの収集

ダウンロード オプション

  • PDF     (548.8 KB)
    Adobe Reader を使ってさまざまなデバイスで表示
  • ePub     (230.0 KB)
    iPhone、iPad、Android、ソニーの Reader、または Windows Phone 上で、さまざまなアプリを使って表示
  • Mobi (Kindle)     (224.0 KB)
    Kindle デバイスで、または Kindle アプリを使って複数のデバイスで表示
Updated: 2024 年 4 月 12 日
Document ID:215523

偏向のない言語

この製品のドキュメントセットは、偏向のない言語を使用するように配慮されています。このドキュメントセットでの偏向のない言語とは、年齢、障害、性別、人種的アイデンティティ、民族的アイデンティティ、性的指向、社会経済的地位、およびインターセクショナリティに基づく差別を意味しない言語として定義されています。製品ソフトウェアのユーザインターフェイスにハードコードされている言語、RFP のドキュメントに基づいて使用されている言語、または参照されているサードパーティ製品で使用されている言語によりドキュメントに例外が存在する場合があります。シスコのインクルーシブ ランゲージの取り組みの詳細は、こちらをご覧ください。

翻訳について

シスコは世界中のユーザにそれぞれの言語でサポート コンテンツを提供するために、機械と人による翻訳を組み合わせて、本ドキュメントを翻訳しています。ただし、最高度の機械翻訳であっても、専門家による翻訳のような正確性は確保されません。シスコは、これら翻訳の正確性について法的責任を負いません。原典である英語版（リンクからアクセス可能）もあわせて参照することを推奨します。

    はじめに

    このドキュメントでは、Catalyst 9800 ワイヤレス LAN コントローラ（WLC）から重要なデバッグまたは show コマンドを収集する手順について説明します。 

    前提条件

    Requirement

    次の項目に関する専門知識があることが推奨されます。

    • Catalyst 9800 ワイヤレス LAN コントローラ（WLC）の基本知識

    使用するコンポーネント

    このドキュメントの情報は、次のソフトウェアとハードウェアのバージョンに基づいています。

    • Catalyst 9800 WLC 

    このドキュメントの情報は、特定のラボ環境にあるデバイスに基づいて作成されました。このドキュメントで使用するすべてのデバイスは、クリアな（デフォルト）設定で作業を開始しています。本稼働中のネットワークでは、各コマンドによって起こる可能性がある影響を十分確認してください。

    背景説明

    このドキュメントでは、Catalyst 9800 ワイヤレス LAN コントローラ（WLC）から重要なデバッグまたは show コマンドを収集する手順について説明します。 

    WLC の問題に関して収集されるログ

    • 正確で詳細な問題の説明を文書化：

    WLC プラットフォーム、コードのバージョン、影響を受ける AP/クライアントの数、問題が発生している SSID、観測された問題に関する情報を提供します。

    例：HA の 9800-40 で、ソフトウェアバージョン 16.12.3 のゲストクライアントが SSID ACME_CORP_GUEST に接続できず、500 の AP と 200 のクライアントが影響を受けています。

    • AP の詳細/クライアントの詳細：メーカー、MAC アドレス、モデル、OS バージョン、WLAN アダプタバージョン。

    AP/クライアントが機能しない具体例（AP/クライアントの MAC アドレス、モデル、ソフトウェアバージョン、および WLAN アダプタドライババージョン）を 1 つ提供します。これが、出力とデバッグの収集に使用される AP/クライアントであることを確認してください。

    例：AP AP02_ACME 9120AXI で問題が発生しており、ドライババージョン 10.21.0.5 を使用するクライアントがインテル AX200 クライアント（MAC アドレス aaaa.bbbb.cccc）に接続できません。

    • 問題のタイムスタンプと問題の頻度：

    問題が発生したのはいつですか。問題はどのくらいの頻度で発生しますか。問題は恒常的に観測されていますか。

    データ収集時に確認された問題の具体的なタイムスタンプを提供します。

    例：クライアントが接続を試みるたびに、この問題が常に発生します。この問題は 2020 年 4 月 16 日に 16.12.3 にアップグレードしてから発生しはじめました。   

    • 機能しているかどうか/変更/トリガー：

    以前は正常に機能していましたか。正常に機能していた場合、問題のトリガーとなった可能性のある変更は何ですか。再現性はありますか。どのような手順で再現できますか。機能していることと機能していないことの詳細情報を提供します。

    例：16.12.2s では正常に機能していましたが、16.12.3 で問題が発生しはじめました。クライアントを ACME_CORP_GUEST に接続すると、この問題が常に再現されます。他の SSID は正常に機能しており、同じクライアントを同じ AP の他の SSID に接続することは可能です。 

    •  Catalyst 9800 CLI から、次の出力を収集します。
    WLC-9800-CLI# show tech wireless

    または、GUI を使用して同じ出力を収集することもできます。[トラブルシューティング（Troubleshooting）] > [デバッグバンドル（Debug Bundle）] メニューに移動します。

    デバッグバンドル

    9800 WLC からの AP/クライアントデバッグに関する詳細情報

    Catalyst 9800 WLCで使用可能なデバッグ機能の一部を、このドキュメント『Catalyst 9800ワイヤレスLANコントローラでのワイヤレスデバッグとログ収集について』にまとめています。 このガイドでは、これらのデバッグの目的と使用法について詳しく説明します。

    ALWAYS-ON トレース

    show logging profile wireless filter mac <radio-or-ethernet-AP-mac> to-file always-on-<FILENAME.txt>

    放射線トレース

    debug wireless mac <MAC> [internal]
    !!Reproduce
    no debug wireless mac <MAC> [internal]
    !! Provide ra_trace file generated in bootflash:
    dir bootflash: | i ra_trace

    Embedded Packet Capture

    AP の IP でフィルタ処理されたパケットキャプチャ

    ip access-list extended CAP-FILTER
     permit ip host <AP_IP> any
     permit ip any host <AP_IP>

    monitor capture MYCAP clear
    monitor capture MYCAP interface Po1 both
    monitor capture MYCAP buffer size 100
    monitor capture MYCAP match any
    monitor capture MYCAP access-list CAP-FILTER
    monitor capture MYCAP start
    !!Reproduce
    monitor capture MYCAP stop
    monitor capture MYCAP export flash:|tftp:|http:.../filename.pcap

    クライアントの MAC でフィルタ処理されたパケットキャプチャ（Cisco IOS® XE 17.1.1s 以降で利用可能）

    monitor capture MYCAP clear
    monitor capture MYCAP interface Po1 both
    monitor capture MYCAP buffer size 100
    monitor capture MYCAP match any
    monitor capture MYCAP inner mac <Client_MAC>
    monitor capture MYCAP start
    !!Reproduce
    monitor capture MYCAP stop
    monitor capture MYCAP export flash:|tftp:|http:.../filename.pcap

    確認

    show monitor capture MYCAP
    show monitor capture MYCAP buffer brief/detail/dump

    シナリオ固有のログ収集：

    WLC プラットフォームの問題

    このシナリオでは、WLC のリロード、スイッチオーバー、クラッシュ、高い CPU 使用率、メモリの問題による WLC の不安定性について説明します。 

    WLC プラットフォームの問題があるかどうかを識別するための重要パフォーマンス評価指標（KPI）を確認できる出力を収集します。

    予想よりも短い稼働時間、高い CPU 使用率、または WLC のクラッシュがないか確認します。

    show ver | i uptime
    show redundancy | i Uptime
    show proc cpu sorted | i CPU
    dir all | i core

    WLC プラットフォームの問題に関して収集する追加のログ：

    クラッシュ/コアダンプのシステムレポート/AP クラッシュを収集します。これは GUI で実行できます。[トラブルシューティング（Troubleshooting）] > [コアダンプおよびシステムレポート（CoreDump and System Report）] に移動してください。

    コア ダンプ

    または CLI を使用します。

    # more bootflash:system-report* 
# copy bootflash:system-report-YYYYMMDD-HHMMSS-Timezone.tar.gz {tftp: | ftp: | https: ..}

    OR

    # more harddisk:system-report*
    # copy harddisk:system-report-YYYYMMDD-HHMMSS-Timezone.tar.gz {tftp: | ftp: | https: ..}

    次の出力も収集します。

    show proc cpu platform sorted 1min
    show proc mem platform accounting
    show redundancy switchover history
    show redundancy history

    APのクラッシュの場合は、WLC GUI > Configuration > Wireless > Access PointsからAPのクラッシュファイルを収集できます。関連するAP > Advancedタブをクリックします。

    AP クラッシュダウンロード

    AP 参加/接続の問題

    このシナリオでは、WLC に参加できない AP、AP の切断、CAPWAP トンネルのフラップ、AP のクラッシュによる AP の不安定性について説明します。

    AP の問題があるかどうかを識別するための重要パフォーマンス評価指標（KPI）を確認できる出力を収集します。

    APのクラッシュをチェックし、稼働時間が予想よりも低いAPの場合は、アソシエーションの稼働時間が予想よりも低いAPをチェックします。

    show ap uptime
    show ap crash-file
    dir all | i crash

    AP の問題に関して収集する追加のログ：

    Always-On Tracing: 
    show logging profile wireless filter mac <radio-or-ethernet-AP-mac> to-file always-on-<FILENAME.txt>
    RadioActive Tracing:
    debug wireless mac <AP_Radio_MAC> 
    debug wireless ip <AP_IP>
    Embedded Captures filtered by AP IP address ACL
    ip access-list extended CAP-FILTER
     permit ip host <AP_IP> any
     permit ip any host <AP_IP>

    monitor capture MYCAP clear
    monitor capture MYCAP interface Po1 both
    monitor capture MYCAP buffer size 100
    monitor capture MYCAP match any
    monitor capture MYCAP access-list CAP-FILTER
    monitor capture MYCAP start
    !!Reproduce
    monitor capture MYCAP stop
    monitor capture MYCAP export flash:|tftp:|http:.../filename.pcap

    show wireless stats ap discovery
    show wireless stats ap join summary
    show wireless stats ap history
    show tech-support wireless ap
    show tech-support wireless ap name <ap-name>

    クライアント接続の問題

    このシナリオでは、クライアント接続の問題、アソシエーションの問題、認証の問題、切断、およびローミングの問題について説明します。

    クライアント接続の問題があるかどうかを識別するための重要パフォーマンス評価指標（KPI）を確認できる出力を収集します。

    クライアント削除の理由を確認し、主要な削除理由を特定し、カウンタが増加するかどうかを確認します。

    show wireless stats client delete reasons | ex 0

    クライアント接続の問題に関して収集する追加のログ：

    Always-On Tracing: 
    show logging profile wireless filter mac <Client_MAC> to-file always-on-<FILENAME.txt>
    RadioActive Tracing:
    debug wireless mac <Client_MAC> 
    Embedded Captures filtered by client MAC:
    monitor capture MYCAP clear
    monitor capture MYCAP interface Po1 both
    monitor capture MYCAP buffer size 100
    monitor capture MYCAP match any
    monitor capture MYCAP inner mac <Client_MAC>
    monitor capture MYCAP start
    !!Reproduce
    monitor capture MYCAP stop
    monitor capture MYCAP export flash:|tftp:|http:.../filename.pcap

    show wireless stats client summary | i MAC|<Client_MAC>
    show tech-support wireless client
    show tech-support wireless client mac-address <Client_MAC>

    ゲスト中央 Web 認証（CWA）またはローカル Web 認証（LWA）の問題

    このシナリオでは、ゲストクライアントの Web 認証の問題、リダイレクト URL を受信しないクライアント、認証できないクライアントについて説明します。

    Web 認証の問題があるかどうかを識別するための重要パフォーマンス評価指標（KPI）を確認できる出力を収集します。

    Web 認証状態でスタックしているクライアントがないか確認し、代行受信された要求、受信されたメッセージ、および返信されたエラーステータス応答の数を調べます。

    show wireless client summary | i Webauth|Number
    show wireless stats client detail | i HTTP

    Web 認証の問題に関して収集する追加のログ：

    Always-On Tracing: 
    show logging profile wireless filter mac <rClient_MAC> to-file always-on-<FILENAME.txt>
    RadioActive Tracing:
    debug wireless mac <Client_MAC> 
    Embedded Captures filtered by client MAC:
    monitor capture MYCAP clear
    monitor capture MYCAP interface Po1 both
    monitor capture MYCAP buffer size 100
    monitor capture MYCAP match any
    monitor capture MYCAP inner mac <Client_MAC>
    monitor capture MYCAP start
    !!Reproduce
    monitor capture MYCAP stop
    monitor capture MYCAP export flash:|tftp:|http:.../filename.pcap
    show wireless stats client summary | i <Client_MAC>
    show wireless stats client delete reasons
    show tech wireless client mac-address <Client_MAC>
    !!Client WLAN Adapter wireshark captures or Over The Air(OTA) sniffer trace.
    show ip http server all
    show tcp statistics
    show ip traffic
    show ip access-list
    show tech-support wireless client 
    show tech-support wireless client mac-address <Client_MAC>

    無線周波数（RF）または無線リソース管理（RRM）の問題

    RF または RRM の問題があるかどうかを識別するための重要パフォーマンス評価指標（KPI）を確認できる出力を収集します。

    同じチャネルを使用している AP、最大送信電力、大きなチャネル数、または高いチャネル使用率を確認します。より詳細な RF 分析を行うには、設定アナライザを使用します。 

    show ap dot11 [24ghz|5ghz] summary
    sh ap auto-rf dot11 [24ghz|5ghz] | i Channel Change Count|Channel Utilization

    RF および RRM の問題に関して収集する追加のログ：

    set platform software trace wireless chassis active r0 rrm all info 
    !!Debug txpower logs:
    set platform software trace wncd chassis active r0 radio-history-txpower info
    !!Debug channel changes logs:
    set platform software trace wncd chassis active r0 radio-history-channel info
    !!Debug radio resets
    set platform software trace wncd chassis active r0 radio-history-reset info
    !!Debug DFS events
    set platform software trace wncd chassis active r0 radio-history-dfs info
    !!Collect and decode traces:
    show logging profile wireless internal [to-file <file-name>] 
    !!Change level back to notice:
    set platform software trace wncd chassis active R0 all-modules notice 
    set platform software trace wireless chassis active R0 rrm all notice

    ライセンスの問題

    ライセンスの問題があるかどうかを識別するための重要パフォーマンス評価指標（KPI）を確認できる出力を収集します。

    WLC が登録済みとして表示され、ライセンスされた AP の数が AP の数と一致することを確認します。

    show license summary | i Status:|AP
    sh ap sum | i Number of APs

    ライセンスの問題に関して収集する追加のログ：

    show tech-support license
    show logging process ios start last boot to-file bootflash: <file-name>

    高可用性の問題

    高可用性の問題があるかどうかを識別するための重要パフォーマンス評価指標（KPI）を確認できる出力を収集します。

    冗長性ピアの稼働時間を調べ、冗長性イベントがあるか確認します。

    show redundancy | i ptime
    sh log | i REDUNDANCY

    高可用性の問題に関して収集する追加のログ：

    show redundancy states
    show redundancy counters
    show redundancy switchover history
    sh logging onboard uptime !!just for physical WLCs: 9800-40/9800-80/9800-L
    show chassis ha-status active
    show chassis ha-status standby
    sh platform software stack-mgr chassis active R0 sdp-counters
    sh platform software stack-mgr chassis standby R0 sdp-counters
    sh platform software stack-mgr chassis active R0 peer-timeout
    sh platform software stack-mgr chassis standby R0 peer-timeout

    Web ユーザーインターフェイスまたは GUI の問題

    関連情報

    更新履歴

    改定 発行日 コメント
    6.0
    12-Apr-2024
    再認定
    5.0
    24-Mar-2023
    CCWアラートを修正し、フォーマットを修正します。再認定
    4.0
    23-Feb-2022
    書式の変更とタイトルの変更（小）
    3.0
    18-Feb-2022
    小さな変更
    2.0
    17-Feb-2022
    修正された小さな間違い
    1.0
    13-May-2020
    初版
    TAC Authored

    シスコ エンジニア提供

    • シャンカル・ラマナタン
      シスコ主任エンジニア

    このドキュメントは役に立ちましたか?

    Feedbackフィードバック

    シスコに問い合わせ

    このドキュメントは次の製品に対応しています