You are here: Home > CLI Commands > Just_CLI_Topics > show ap spectrum ap-list

show ap spectrum ap-list

show ap spectrum ap-list {ap-name <ap-name> | ip-addr <ip-addr> | ip6-addr <ip6-addr>} [channel <channel> | essid <essid> | freq-band {2.4ghz | 5ghz} | limit <limit> | or | page <page> | sort <sort> | start <start>]

Description

This command shows spectrum data seen by an access point that has been converted to a spectrum monitor.

Syntax

Parameter

Description

ap-name <ap-name>

Name of the spectrum monitor for which you want to view spectrum information.

ip-addr <ip-addr>

IP address of the spectrum monitor for which you want to view spectrum information.

ip6-addr <ip6-addr>

IPv6 address of the spectrum monitor for which you want to view spectrum information.

channel <channel>

View spectrum information for a specific radio channel.

essid <essid>

View spectrum information for a specific ESSIDExtended Service Set Identifier. ESSID refers to the ID used for identifying an extended service set..

freq-band {2.4ghz | 5ghz}

View information for a specific radio type, either 2.4 GHzGigahertz. or 5 GHzGigahertz..

limit <limit>

Limit the displayed output to the specified number of entries

or

Use this parameter to display information that meets either of two criteria, such as a specified ESSIDExtended Service Set Identifier. ESSID refers to the ID used for identifying an extended service set. or channel.

page <page>

Enter a number from 10–100 (inclusive) to specify the number of entries that should appear in each page of the output for this command. For example, if the output of this command has 100 entries and you select a page value of 20, the output will appear in 5 pages each with 20 entries. If you selected a page value of 10, the output would appear in 10 pages with 10 entries.

sort <sort>

Sort the output by the specified data column.

start <start>

Start displaying the output at specific spectrum index value.

Usage Guidelines

The Spectrum Analysis feature provides visibility into RFRadio Frequency. RF refers to the electromagnetic wave frequencies within a range of 3 kHz to 300 GHz, including the frequencies used for communications or Radar signals. coverage, allowing you to troubleshoot RFRadio Frequency. RF refers to the electromagnetic wave frequencies within a range of 3 kHz to 300 GHz, including the frequencies used for communications or Radar signals. interference and identify 802.11802.11 is an evolving family of specifications for wireless LANs developed by a working group of the Institute of Electrical and Electronics Engineers (IEEE). 802.11 standards use the Ethernet protocol and Carrier Sense Multiple Access with collision avoidance (CSMA/CA) for path sharing. devices on the network. Issue this command to display and sort APs seen by a specific spectrum monitor.

Examples

The output of this example shows spectrum data seen by spectrum monitor ap123. The output in the example below has been divided into two tables to better fit this document. In the ArubaOS CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions., the output appears as a single, long table.

(host) [mynode]# show ap spectrum ap-list ap-name ap123

 

Spectrum AP Table

-----------------

bssid essid spectrum-id chan phy-type signal(dBm)

----- ----- ----------- ---- -------- ---------------

00:0b:86:cd:22:d0 ECSD Wireless 2 161 80211a 62

00:0b:86:cb:cf:30 ECSD Wireless 3 157 80211a 68

00:0b:86:f6:f6:a0 osuwireless 3 1 80211b/g 48

00:0b:86:f6:f6:a1 osuvoice 4 1 80211b/g 47

00:0b:86:f6:f6:a2 osuguest 5 1 80211b/g 45

 

avg-rssi(dB) curr-rssi(dB) ibss add-time last-seen

--------     ---------    ---- -------- -----------

29    31     no 2010-05-16 17:41:36 2010-05-18 13:39:38

24    25     no 2010-05-16 17:41:36 2010-05-18 14:19:03

37    38      no 2010-05-16 17:41:36 2010-05-18 15:06:02

38    38     no 2010-05-16 17:41:36 2010-05-18 15:04:23

37    40     no 2010-05-16 17:41:36 2010-05-18 15:07:32

The output of this command includes the following information:

Column

Description

bssid

Basic Service Set Identifier for an AP. This is usually the MACMedia Access Control. A MAC address is a unique identifier assigned to network interfaces for communications on a network. address of the AP.

essid

Extended service set identifier that names a wireless network.

spectrum-id

Identifier assigned to the device by the spectrum monitor.

chan

Radio channel used by the BSSIDBasic Service Set Identifier. The BSSID identifies a particular BSS within an area. In infrastructure BSS networks, the BSSID is the MAC address of the AP. In independent BSS or ad hoc networks, the BSSID is generated randomly..

freq-band

Radio phy type. Possible types include:

2.4 GHzGigahertz.

5 GHzGigahertz.

signal (dBm)

Strength of the signal received by the device, in dBmDecibel-Milliwatts. dBm is a logarithmic measurement (integer) that is typically used in place of mW to represent receive-power level. AMP normalizes all signals to dBm, so that it is easy to evaluate performance between various vendors..

avg-rssi

The average signal-to-noise ratio seen by the AP.

curr-rssi

Most recent signal-to-noise ratio seen by the AP.

ibss

Shows if ad hoc BSSBasic Service Set. A BSS is a set of interconnected stations that can communicate with each other. BSS can be an independent BSS or infrastructure BSS. An independent BSS is an ad hoc network that does not include APs, whereas the infrastructure BSS consists of an AP and all its associated clients. is enabled or disabled. It will be enabled if the bssidBasic Service Set Identifier. The BSSID identifies a particular BSS within an area. In infrastructure BSS networks, the BSSID is the MAC address of the AP. In independent BSS or ad hoc networks, the BSSID is generated randomly. has detected an ad hoc BSSBasic Service Set. A BSS is a set of interconnected stations that can communicate with each other. BSS can be an independent BSS or infrastructure BSS. An independent BSS is an ad hoc network that does not include APs, whereas the infrastructure BSS consists of an AP and all its associated clients. (an ibss bit in an 802.11802.11 is an evolving family of specifications for wireless LANs developed by a working group of the Institute of Electrical and Electronics Engineers (IEEE). 802.11 standards use the Ethernet protocol and Carrier Sense Multiple Access with collision avoidance (CSMA/CA) for path sharing. frame).

add-time

Time when the AP was first detected by the spectrum monitor.

last-seen

Time when the AP was last seen by the spectrum monitor.

Related Commands

Command

Description

ap spectrum local-override

Converts an AP or AMAir Monitor. AM is a mode of operation supported on wireless APs. When an AP operates in the Air Monitor mode, it enhances the wireless networks by collecting statistics, monitoring traffic, detecting intrusions, enforcing security policies, balancing wireless traffic load, self-healing coverage gaps, and more. However, clients cannot connect to APs operating in the AM mode. into a spectrum monitor by adding it to the spectrum local-override list.

rf dot11a-radio-profilemodespectrum-mode

Sets an 802.11a802.11a provides specifications for wireless systems. Networks using 802.11a operate at radio frequencies in the 5 GHz band. The specification uses a modulation scheme known as orthogonal frequency-division multiplexing (OFDM) that is especially well suited to use in office settings. The maximum data transfer rate is 54 Mbps. radio so that the device operates as a spectrum monitor, and can send spectrum analysis data to a desktop or laptop client.

Related Commands

Command

Description

ap spectrum local-override

Converts an AP or AMAir Monitor. AM is a mode of operation supported on wireless APs. When an AP operates in the Air Monitor mode, it enhances the wireless networks by collecting statistics, monitoring traffic, detecting intrusions, enforcing security policies, balancing wireless traffic load, self-healing coverage gaps, and more. However, clients cannot connect to APs operating in the AM mode. into a spectrum monitor by adding it to the spectrum local-override list.

rf dot11a-radio-profilemodespectrum-mode

Sets an 802.11a802.11a provides specifications for wireless systems. Networks using 802.11a operate at radio frequencies in the 5 GHz band. The specification uses a modulation scheme known as orthogonal frequency-division multiplexing (OFDM) that is especially well suited to use in office settings. The maximum data transfer rate is 54 Mbps. radio so that the device operates as a spectrum monitor, and can send spectrum analysis data to a desktop or laptop client.

rf dot11g-radio-profilemodespectrum-mode

Sets an 802.11g802.11g offers transmission over relatively short distances at up to 54 Mbps, compared with the 11 Mbps theoretical maximum of 802.11b standard. 802.11g employs Orthogonal Frequency Division Multiplexing (OFDM), the modulation scheme used in 802.11a, to obtain higher data speed. Computers or terminals set up for 802.11g can fall back to speed of 11 Mbps, so that 802.11b and 802.11g devices can be compatible within a single network. radio so that the device operates as a spectrum monitor, and can send spectrum analysis data to a desktop or laptop client.

Command History

Release

Modification

ArubaOS 8.0.0.0

Command introduced.

Command Information

Platforms

License

Command Mode

All platforms

Base operating system.

Enable or Config mode on the managed device or controller where the AP terminates.

/*]]>*/