Debug Wireless Clients

An administrator can select an RF domain and capture connected client debug messages at a specified interval and from a selected location. Client debug information can either be collected historically or in real time.

To troubleshoot issues with wireless client connectivity within a controller, service platform, virtual platform or access point managed RF domain:

  1. Select Diagnostics > Debug Wireless Clients.
  2. Configure the Basic, Debug Messages, Wireless Clients, and Settings parameters:
    Site Use the Select a site drop-down menu to identify a site (RF domain) used for wireless client debugging.

    RF domains allow administrators to assign configuration data to multiple devices deployed in a common coverage area, such as in a floor, building, or site.
    Device Use the Select a device drop-down menu to select one or more devices assigned to the site (RF domain) from which debug messages are to be collected.
    Send Data To

    Use the Send Data To drop-down menu to select where wireless client debug messages are collected.

    If Screen is selected, the wireless client debug information is sent to the Event Logs window at the bottom of the dialog window. If File is selected, the file location must be specified in the Path/File field for the Settings parameters to transfer the logs to the server. The default setting is File.
    Debug Messages

    Select the All radio button to capture all debug messages for wireless clients associated with the selected devices in the selected RF domain.

    Choose Selected to specify which types of debug messages to capture.

    If you choose Selected, you can capture any combination of the following debug messages:
    • Management
    • RADIUS
    • EAP
    • System
    • Migration
    • WPA/WPA2
    Wireless Clients

    Select the All radio button to capture debug information from all wireless clients associated with the selected devices in the selected RF domain.

    Choose Selected to capture information from up to three specified wireless clients. Specify the MAC address for the wireless clients. The information captured and displayed on-screen or logged to a file contains only information from the specified wireless clients.
    Duration of Message Capture Use the spinner controls to select how long to capture wireless client debug information. This can range between 1 second and 24 hours. The default value is 60 seconds.
    Maximum Events Per Wireless Client Use the spinner controls to select the maximum number of debug messages to capture per wireless client. Set the limit from between 1 to 9999 events. The default value is 50 events.
    Path/File

    If the Send Data To field is set to File, you must specify the path to the file in the Path/File field.
    Event Logs When the Send Data To field is set to Screen, this pane displays live debug information captured for wireless clients associated with the selected device in the selected RF domain.
  3. When all configuration fields are complete, select Start to start the wireless client debug message capture.

    If information is being sent to the screen, it displays in the Event Logs pane. If the data is being sent to a file, that file populates with debug information. If you have set a long message capture duration and want to end the capture early, select Stop.

    The Event Logs pane displays the following information.

    Field Description
    Status Running or completed
    Session name Name is automatically generated when starting the remote debug wireless session
    Started by User details
    Type Network type
    Hosts Controller or access point information
    Message Success information or error message
9037761-04 Rev AB