smart-rf

Displays Self-Monitoring At Run Time RF (Smart RF) statistical history to assess adjustments made to device configurations to compensate for detected coverage holes or device failures

When invoked by an administrator, Smart RF instructs access point radios to change to a specific channel and begin beaconing using the maximum available transmit power. Within a well-planned deployment, any RF Domain member access point radio should be reachable by at least one other radio. Smart RF records signals received from its neighbors as well as signals from external, un-managed radios. AP-to-AP distance is recorded in terms of signal attenuation. The information from external radios is used during channel assignment to minimize interference.

Supported in the following platforms:

  • Access Points — AP505i, AP510i/e, AP560i/h
  • Service Platforms — NX5500, NX7500, NX9500, NX9600, VX9000

Syntax

show smart-rf [ap|channel-distribution|history|history-timeline|interfering-ap|
interfering-neighbors|radio|select-shutdown]
show smart-rf ap {<MAC>|<DEVICE-NAME>|activity|energy|neighbors|on <DOMAIN-NAME>}
show smart-rf ap {<MAC>|<DEVICE-NAME>} {on <DOMAIN-NAME>}
show smart-rf ap (activity|energy|neighbors) [<MAC>|<DEVICE-NAME>] {(on <DOMAIN-NAME>)}
show smart-rf [channel-distribution|history|history-timeline] {on <DOMAIN-NAME>}
show smart-rf radio {<MAC>|activity|all-11an|all-11bgn|channel|energy|neighbors|
on <DOMAIN-NAME>}
show smart-rf radio {<MAC>|all-11an|all-11bgn|energy <MAC>} {on <DOMAIN-NAME>}
show smart-rf radio {activity|neighbors} {<MAC>|all-11an|all-11bgn} 
{on <DOMAIN-NAME>}
show smart-rf interfering-ap {<MAC>|<DEVICE-NAME>|on <DOMAIN-NAME>}
show smart-rf interfering-neighbors {<MAC>|<DEVICE-NAME>|on <DOMAIN-NAME>|
threshold <50-100>}
show smart-rf select-shutdown {AP-MAC|<AP-DEVICE-NAME>|on <RF-DOMAIN-NAME>}

Parameters

show smart-rf ap {<MAC>|<DEVICE-NAME>} {on <DOMAIN-NAME>}
smart-rf Displays Smart RF related information
ap Displays access point related Smart RF information
<MAC> Optional. Uses MAC addresses to identify access points. Displays all access points, if no MAC address is specified.
<DEVICE-NAME> Optional. Uses an administrator defined name to identify an access point
on <DOMAIN-NAME> Optional. Displays access point details on a specified RF Domain
  • <DOMAIN-NAME> – Specify the domain name.
show smart-rf ap (activity|energy|neighbors) [<MAC>|<DEVICE-NAME>] 
{(on <DOMAIN-NAME>)}
smart-rf Displays Smart RF related information
ap Displays AP related Smart RF information
activity Optional. Displays Smart RF activity related information
Use this option to view the following:
  • Time-period – Lists the frequency Smart RF activity is trended for the RF Domain. Trending periods include the current hour, last 24 hours, or the last seven days. Comparing Smart RF adjustments versus the last seven days enables an administrator to assess whether periods of interference and poor performance were relegated to just specific periods.
  • Power changes – Displays the number of Smart RF initiated power level changes needed for RF Domain member devices during each of the three trending periods. Determine whether power compensations were relegated to known device outages or if compensations were consistent over the course of a day or week.
  • Channel changes – Lists the number of Smart RF initiated channel changes needed for RF Domain member devices during each of the three trending periods. Determine if channel adjustments were relegated to known device count increases or decreases over the course of a day or week.
  • Coverage changes – Displays the number of Smart RF initiated coverage changes needed for RF Domain member devices during each of the three trending periods. Determine if coverage changes were relegated to known device failures or known periods of interference over the course of a day or week.
energy Optional. Displays AP energy for a specified AP or all APs

Use this option to view an RF Domain member access point‘s operating channels, noise level and neighbor count. This information helps assess whether Smart RF neighbor recovery is needed in respect to poorly performing access points.

neighbors Optional. Displays AP neighbors

Use this option to view attributes of neighbor radio resources available for Smart RF radio compensations for other RF Domain member device radios.

{<MAC>| <DEVICE-NAME>} The following keywords are common to all of the above parameters:
  • <MAC> – Displays all of the above mentioned information for a specified AP, identified by its MAC address. Specify the AP‘s MAC address.
  • <DEVICE-NAME> – Displays all of the above mentioned information for a specified AP, identified by its hostname. Specify the AP‘s hostname.
on <DOMAIN-NAME> Optional. Displays Access Point details on a specified RF Domain.
  • <DOMAIN-NAME> – Specify the domain name.
show smart-rf [channel-distribution|history|history-timeline] {on <DOMAIN-NAME>}
smart-rf Displays Smart RF related information
channel-distribution Displays Smart RF channel distribution information. This provides an overview of how RF Domain member devices are utilizing different channels to optimally support connect devices and avoid congestion and interference with neighboring devices. Assess whether the channel spectrum is being effectively utilized and whether channel changes are warranted to improve RF Domain member device performance.
history Displays Smart RF calibration history. Use this option to view description and types of Smart RF events impacting RF Domain member devices.
history-timeline Displays extended Smart RF calibration history on an hourly or daily timeline. Use this option to view the time stamp when Smart RF status was updated on behalf of a Smart RF adjustment within the selected RF Domain.
on <DOMAIN-NAME> This parameter is common to all of above smart RF options:
  • on <DOMAIN-NAME> – Optional. Displays Smart RF configuration, based on the parameters passed, on a specified RF Domain
  • on <DOMAIN-NAME> – Specify the RF Domain name.
show smart-rf radio {<MAC>|all-11an|all-11bgn|energy <MAC>} {on <DOMAIN-NAME>}
smart-rf Displays Smart RF related information
radio Displays radio related commands
<MAC> Optional. Displays details of a specified radio. Specify the radio's MAC address in the AA-BB-CC-DD-EE-FF format.
all-11an Optional. Displays all 11a radios currently in the configuration
all-11bgn Optional. Displays all 11bg radios currently in the configuration
energy {<MAC>} Optional. Displays radio energy

Specify the MAC address of the radio

  • <MAC> – Optional. Specify the radio's MAC address in the AA-BB-CC-DD-EE-FF format.

Use this option to view an RF Domain member access point radio‘s operating channel, noise level and neighbor count. This information helps assess whether Smart RF neighbor recovery is needed in respect to poorly performing radios.

on <DOMAIN-NAME> The following keyword is common to all of the above parameters:
  • on <DOMAIN-NAME> – Optional. Displays radio details on a specified RF Domain
    • <DOMAIN-NAME> – Specify the RF Domain name.
show smart-rf radio {activity|neighbors} {<MAC>|all-11an|all-11bgn} 
{on <DOMAIN-NAME>}
smart-rf Displays Smart RF related information
radio Displays radio related commands
activity Optional. Displays changes related to radio power, number of radio channels, or coverage holes. Use additional filters to view specific details.
<MAC> Optional. Displays radio activity for a specified radio
  • <MAC> – Specify the radio's MAC address.
all-11an Optional. Displays radio activity of all 11a radios in the configuration
all-11bgn Optional. Displays radio activity of all 11bg radios in the configuration
on <DOMAIN-NAME> Optional. Displays radio activity of all radios within a specified RF Domain
  • <DOMAIN-NAME> – Specify the RF Domain name.
show smart-rf interfering-ap {<MAC>|<DEVICE-NAME>|on <DOMAIN-NAME>}
smart-rf Displays Smart RF related information
interfering-ap Displays interfering access points (requiring potential isolation) information
<MAC> Optional. Displays information of a specified interfering access point
  • <MAC> – Specify the Access Point's MAC address.
Note: Considers all APs if this parameter is omitted
<DEVICE-NAME> Optional. Displays interfering Access Point information on a specified device
  • <DEVICE-NAME> – Specify the device name.
Note: Considers all APs if this parameter is omitted
on <DOMAIN-NAME> Optional. Displays all interfering Access Point information within a specified RF Domain
  • <DOMAIN-NAME> – Specify the RF Domain name.
show smart-rf interfering-neighbors {<MAC>|<DEVICE-NAME>|on <DOMAIN-NAME>|
threshold <50-100>}
smart-rf Displays Smart RF related information
interfering-ap Displays interfering neighboring Access Point information
<MAC> Optional. Displays interfering neighboring Access Point information
  • <MAC> – Specify the Access Point's MAC address.
Note: Considers all APs if this parameter is omitted
<DEVICE-NAME> Optional. Displays all interfering neighboring Access Point information on a specified device
  • <DEVICE-NAME> – Specify the device name.
Note: Considers all APs if this parameter is omitted
threshold <50-100> Optional. Specifies the maximum attenuation threshold of interfering neighbors
  • <50-100> – Specify a value from 50 -100 dB.

Attenuation is a measure of the reduction of signal strength during transmission. Attenuation is the opposite of amplification, and is normal when a signal is sent from one point to another. If the signal attenuates too much, it becomes unintelligible. Attenuation is measured in decibels.

on <DOMAIN-NAME> Optional. Displays radio activity of all radios within a specified RF Domain
  • <DOMAIN-NAME> – Specify the RF Domain name.
show smart-rf select-shutdown {AP-MAC|<AP-DEVICE-NAME>|on <RF-DOMAIN-NAME>}
smart-rf Displays Smart RF related information
select-shutdown Displays 2.4 GHz APs shutdown to maintain co-channel interference (CCI) levels within specified limits. Note, this information is displayed only if select-shutdown is enabled in the smart-rf policy context. For more information, see select-shutdown.
<AP-MAC> Optional. Displays if a specified AP, identified by its MAC address, was shutdown as part of the select-shutdown feature.
  • <AP-MAC> – Specify the access point‘s MAC address.
Note: Considers all APs if this parameter is omitted.
<AP-DEVICE-NAME> Optional. Displays if a specified AP, identified by its device name, was shutdown as part of the select-shutdown feature.
  • <DEVICE-NAME> – Specify the AP‘s device name.
Note: Considers all APs if this parameter is omitted.
on <RF-DOMAIN-NAME> Optional. Displays APs, within a specified RF Domain, that were shutdown as part of the select-shutdown feature.
  • <RF-DOMAIN-NAME> – Specify the RF Domain name.

Examples

nx9500-6C8809(config)#show smart-rf calibration-status
No calibration currently in progress
nx9500-6C8809(config)#
rfs4000-22E006#show smart-rf select-shutdown
--------------------------------------------------------------------------------
            RADIO                       RADIO-MAC                  STATE
--------------------------------------------------------------------------------
  ap7532-15E868:R1             FC-0A-81-A3-27-60             On
  ap7532-82C614:R1             84-24-8D-93-E7-D0             On
  ap7532-15E54C:R1             FC-0A-81-A3-1A-90             Hidden
  ap7522-189548:R1             84-24-8D-2C-02-C0             On
  ap7522-847CC8:R1             84-24-8D-9F-F3-B0             On
  ap7532-1601A4:R1             FC-0A-81-A3-14-A0             Hidden
--------------------------------------------------------------------------------
rfs4000-22E006#