Troubleshooting Operations from the AP CLI

The AP CLI provides a wide range of commands that can be used to both gather diagnostic information and perform corrective actions. While not all available commands are covered in this chapter, the following tips highlight some of the most effective and commonly used CLI operations for troubleshooting network issues. These examples can help you quickly identify and resolve a variety of problems in real-world deployments.
The following table presents a curated set of AP CLI commands, each accompanied by a concise description and a practical explanation of its relevance. These commands are commonly used for diagnostics, configuration validation, and performance analysis in enterprise wireless environments. Use this reference to support efficient and informed troubleshooting directly from the access point CLI.

Common AP CLI Commands and Their Use Cases

Command Description Purpose and Application
get assoc_rssi_thr wlan_name Retrieves the RSSI threshold for client association on a specific WLAN. Helps assess the signal strength requirements for a client to be able to connect to the SSID. If the signal strength is below the threshold, the client connection will be denied by the AP.
get assoc_snr_thr wlan_name Retrieves the SNR threshold for client association on a specific WLAN. Helps determine the minimum signal-to-noise ratio required for client association. Useful for tuning wireless quality thresholds.
get auto-cell {wifi0|wifi1|wifi2} {options} Displays auto-cell configuration for the specified Wi-Fi interface. Useful for understanding automatic cell size adjustments that affect coverage and roaming behavior. Enter get auto-cell ? to list all available options and parameters for the command.
get boarddata Displays hardware board information. Helps identify hardware model, capabilities, and board-specific configurations for support and diagnostics.
get chanbkgndscan Shows background channel scanning configuration or results. Useful for identifying channel interference and selecting optimal channels for performance.
get chanflybg {options} Displays background channel fly scan data. Helps monitor dynamic channel changes and background scanning behavior. Enter get chanflybg ? to list all available options and parameters for the command.
get channel {wifi0|wifi1|wifi2} Displays the current operating channel of the Wi-Fi interface. Useful for verifying channel assignment and diagnosing co-channel interference.
get channelavailability {wifi0|wifi1|wifi2} Shows available channels for the specified Wi-Fi interface. Helps determine which channels are available for use, based on regulatory domain and hardware support.
get channelfly {wifi0|wifi1|wifi2} Displays ChannelFly status and configuration. Useful for understanding how the AP dynamically selects channels based on performance metrics.
get channselectmode {wifi0|wifi1|wifi2} Shows the channel selection mode (manual or automatic). Helps verify whether the AP is using manual or automatic channel selection.
get client-info [ifname] { stats [ all | client-mac ] } Displays client statistics and information. For the optional ifname variable enter the interface number that can be a wired interface (eth0, for example), wireless interface (wifi0), or WLAN number (wlan32). Provides detailed client connection data, useful for troubleshooting connectivity and performance issues.
get cwmode {wifi0|wifi1|wifi2} Displays the current channel width mode. Helps verify if the AP is using 20, 40, 80, 160, or 320MHz channels, which impacts throughput and interference.
get dns Displays DNS configuration. If a client is having issues accessing websites, verify with this command if a DNS is available for the AP.
get dns-cache {options} Displays cached DNS entries. Useful for checking if domain names are being resolved and cached properly. Enter get dns-cache ? to list all available options and parameters for the command.
get dns-spoof {options} Displays DNS spoofing configuration. Helps verify if DNS spoofing is enabled, which may affect client redirection or security testing. Enter get dns-spoof ? to list all available options and parameters for the command.
get eth {eth1|eth2|...} Displays Ethernet interface status. With this command you can learn if the Ethernet ports of the AP are up or down, as well as the speed capability, negotiated speed, and PoE capability for them.
get himem-log status Displays high memory usage log status. Useful for diagnosing memory-related performance issues or crashes.
get http Displays HTTP service status. Helps verify if the AP's web interface is accessible and functioning.
get https Displays HTTPS service status. Useful for confirming secure web access to the AP is enabled and operational.
get ipaddr {wan|wan-lte|video|mgmt} Displays IP address configuration. Helps verify network connectivity and IP assignment for different interfaces.
get ipmode {wan|lan|video|mgmt} Displays IP mode (static or DHCP). Useful for confirming how the AP obtains its IP address and for troubleshooting DHCP issues.
get mcast Displays multicast configuration. Helps troubleshoot multicast traffic delivery and group membership.
get mem-info Displays memory usage statistics. Useful for identifying memory bottlenecks or leaks affecting AP performance.
get memcache Displays memory cache status. Helps assess memory caching behavior and potential performance optimizations.
get mesh list Displays mesh network topology. Useful for verifying mesh connectivity and node relationships.
get mesh configuration Displays mesh configuration settings. Helps confirm mesh parameters and troubleshoot mesh deployment issues.
get mtu {ifname|wan|l2tp|gre} Displays MTU settings. For the optional ifname variable enter the interface number that can be a wired interface (eth0, for example), wireless interface (wifi0), or WLAN number (wlan32). Useful for diagnosing fragmentation or connectivity issues related to packet size.
get power-mode Displays current PoE operating power mode of the AP. Helps verify if the AP is operating in full power or power-saving mode, which may affect performance.
get qos Displays QoS configuration. Useful for verifying traffic prioritization settings and ensuring QoS policies are applied correctly.
get radiostats {wifi0|wifi1|wifi2} Displays radio statistics over a specified period. Helps monitor radio performance metrics such as retries, errors, and throughput.
get roam_enable wlan_name Displays roaming enable status. Useful for confirming whether client roaming is supported on the WLAN.
get roam_factor wlan_name Displays roaming factor configuration. Helps tune roaming aggressiveness and thresholds for client handoff.
get scanresults wifi_name Displays the list of received signals surrounding the AP cell. For the wifi_name variable enter the radio number (wifi0,wifi1), or WLAN number (like wlan32, for example). Helps diagnose sources of interference and their received signal strength.
get softgre tunnel-index Displays SoftGRE tunnel status. Helps troubleshoot GRE tunnel connectivity and configuration.
get syslog {info|log|status} Displays system log information. Useful for reviewing system events and diagnosing operational issues.
get tunnelmgr {options} Displays tunnel manager status. Helps monitor and troubleshoot tunnel-based traffic forwarding. Enter get tunnelmgr ? to list all available options and parameters for the command.
get txpower {wifi0|wifi1|wifi2} Displays transmit power settings. Useful for verifying RF output levels and adjusting coverage or interference.
get uptime Displays system uptime. Helps determine how long the AP has been running, useful for identifying reboots or stability issues.
get version Displays firmware version. Useful for verifying software version and compatibility with features or bug fixes.
get wlaninfo Displays WLAN configuration details. Helps review SSID settings, security modes, and operational status.
get wlanlist Displays list of configured WLANs. Useful for confirming which SSIDs are active and available on the AP.

Determining Overlapping of Neighbor APs

Determining the extent of overlap between neighboring APs can significantly impact signal interference, channel utilization, and overall network throughput. Complete the following steps to determine overlapping SSIDs:

  1. In the AP CLI, enter the command get scanresults wifi_name. Supported values are: wifi0 (for the 2.4GHz radio), wifi1 (for the 5GHz radio), or wifi2 (for the 6GHz radio
    rkscli: get scanresults wifi0
SSID                        BSSID              Type  Radio    Encr       Chan  RSSI DL/UL  Ant
PIN_HADPSK_Network1         84:23:88:59:ba:40  AP    G/N/AX   WPA2-PSK   8     45/0        0
icx-wlan-1                  2c:c5:d3:01:85:88  AP    G/N(20)  Open       11    36/0        0
Configure.Me-0E40C0         58:b6:33:ce:40:cb  AP    G/N(20)  WPA2-PSK   8     58/0        0
default network             59:fb:96:61:b2:90  AP    G/N/AX   WPA2-PSK   1     66/0        0
L2GRE-VLAN200               50:fb:a6:41:b2:91  AP    G/N/AX   WPA2-PSK   8     36/0        0
ACX88205                    c8:fb:9a:71:a2:82  AP    G/N/AX   WPA2-PSK   6     26/0        0
DMZ Network                 18:fb:9b:49:b2:93  AP    G/N/AX   Open       8     46/0        0
island-0AD290               84:18:3a:4a:d2:93  AP    G/N(20)  WPA2-PSK   6     48/0        0
L2GRE-210                   58:fb:96:41:b2:95  AP    G/N/AX   Open       8     62/0        0
    The RSSI DL/UL column displays the received signal strength in the uplink and downlink aspects. An RSSI reading above 30 indicates a very strong signal near the AP that could be causing interference if the signal is on the same or adjacent channel.
  2. Enter the command get channel wlan_number to find the channel your WLAN is using and search in the get scanresults output entries that share the same or adjacent channel. 
    rkscli: get channel wlan1
wlan1 Channel: 7 (2462 Mhz) (Manual Channel Select)
OK
    According to the example shown, wlan1 is broadcasting on channel 7. From the get scanresults output, we can see no other neighbor SSIDs use channel 7, however, there are multiple SSIDs using channels 6 and 8 (adjacent channels) with RSSIs above 30, thus, causing adjacent channel interference.
  3. Use the BSSID to identify the APs broadcasting the SSIDs. If the overlapping SSID is of your own, you can reduce the transmit power of the neighbor AP. If the SSID comes from an unknown source, you can change the broadcasting channel in the local AP to avoid the co-channel or adjacent channel interference.
  4. In the controller GUI, you can retrieve the BSSID of the APs in the following way: Select Network > Wireless > Access Points, select an AP and scroll to the Details section. Select the General tab and in the WLANs subsection identify the BSSIDs for the selected AP.

    Identifying the BSSIDs on an AP

Parent topic: Diagnosing and Monitoring