Login
- Table of Contents
-
- 09-Radio Resources Management Command Reference
- 00-Preface
- 01-Radio management commands
- 02-WLAN radio load balancing commands
- 03-WLAN load balancing commands
- 04-WLAN radio resource measurement commands
- 05-Band navigation commands
- 06-WLAN RRM commands
- 07-Channel scanning commands
- 08-Spectrum management commands
- Related Documents
-
| Title | Size | Download |
|---|---|---|
| 07-Channel scanning commands | 83.85 KB |
Channel scanning commands
The AP models and serial numbers in this document are used only as examples. Support for AP models and serial numbers depends on the AC model.
scan channel blacklist
Use scan channel blacklist to configure the channel scanning blacklist.
Use undo scan channel blacklist to remove the specified channels from the channel scanning blacklist.
Syntax
scan channel blacklist channel-list
undo scan channel blacklist { channel-list | all }
Default
In radio view, a radio uses the configuration in an AP group's radio view.
In an AP group's radio view, no channel scanning blacklist exists.
Views
Radio view
AP group's radio view
Predefined user roles
network-admin
Parameters
channel-list: Specifies channels by their channel numbers. The value range for the channel-list argument depends on the country code and radio mode.
all: Specifies all channels in the channel scanning blacklist.
Usage guidelines
After you configure the channel scanning blacklist for an AP, the AP will not scan non-working channels in the blacklist. You cannot configure both the channel scanning blacklist and whitelist for the same AP. Before configuring the channel scanning blacklist, remove all channels in the channel scanning whitelist.
The configuration in radio view takes precedence over the configuration in an AP group's radio view.
Examples
# Add channels 1 and 6 to the channel scanning blacklist for AP 1.
<Sysname> system-view
[Sysname] wlan ap 1 model WA6320
[Sysname-wlan-ap-ap1] radio 2
[Sysname-wlan-ap-ap1-radio-2] scan channel blacklist 1 6
# Add channels 1 and 6 to the channel scanning blacklist for APs with model WA6320 in AP group 10.
<Sysname> system-view
[Sysname] wlan ap-group 10
[Sysname-wlan-ap-group-10] ap-model WA6320
[Sysname-wlan-ap-group-10-ap-model-WA6320] radio 2
[Sysname-wlan-ap-group-10-ap-model-WA6320-radio-2] scan channel blacklist 1 6
scan channel whitelist
Use scan channel whitelist to configure the channel scanning whitelist.
Use undo scan channel whitelist to remove the specified channels from the channel scanning whitelist.
Syntax
scan channel whitelist channel-list
undo scan channel whitelist { channel-list | all }
Default
In radio view, a radio uses the configuration in an AP group's radio view.
In an AP group's radio view, no channel scanning whitelist exists.
Views
Radio view
AP group's radio view
Predefined user roles
network-admin
Parameters
channel-list: Specifies channels by their channel numbers. The value range for the channel-list argument depends on the country code and radio mode.
all: Specifies all channels in the channel scanning whitelist.
Usage guidelines
After you configure the channel scanning whitelist for an AP, the AP will scan only channels in the whitelist and the working channel. You cannot configure both the channel scanning blacklist and whitelist for the same AP. Before configuring the channel scanning whitelist, remove all channels in the channel scanning blacklist.
The configuration in radio view takes precedence over the configuration in an AP group's radio view.
Examples
# Add channels 1 and 6 to the channel scanning whitelist for AP 1.
<Sysname> system-view
[Sysname] wlan ap 1 model WA6320
[Sysname-wlan-ap-ap1] radio 2
[Sysname-wlan-ap-ap1-radio-2] scan channel whitelist 1 6
# Add channels 1 and 6 to the channel scanning whitelist for APs with model WA6320 in AP group 10.
<Sysname> system-view
[Sysname] wlan ap-group 10
[Sysname-wlan-ap-group-10] ap-model WA6320
[Sysname-wlan-ap-group-10-ap-model-WA6320] radio 2
[Sysname-wlan-ap-group-10-ap-model-WA6320-radio-2] scan channel whitelist 1 6
scan idle-time
Use scan idle-time to set the service idle timeout timer.
Use undo scan idle-time to restore the default.
Syntax
scan idle-time idle-time
undo scan idle-time
Default
In radio view, a radio uses the configuration in an AP group's radio view.
In an AP group's radio view, the service idle timeout timer is 100 milliseconds.
Views
Radio view
AP group's radio view
Predefined user roles
network-admin
Parameters
idle-time: Specifies the service idle timeout timer in the range of 60 to 5000 milliseconds. The service idle timeout timer cannot be greater than the maximum service period.
Usage guidelines
During a service period, an AP does not begin a new scanning period until the current service period exceeds the scanning period even if the specified service idle timeout expires.
The service idle timeout timer must be a multiple of the beacon interval. The value of the beacon interval is used as the service idle timeout timer if the service idle timeout timer is smaller than the beacon interval.
The configuration in radio view takes precedence over the configuration in an AP group's radio view.
Examples
# Set the service idle timeout timer to 500 milliseconds for AP 1.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA6320
[Sysname-wlan-ap-ap1] radio 1
[Sysname-wlan-ap-ap1-radio-1] scan idle-time 500
# Set the service idle timeout timer to 500 milliseconds for APs with model WA6320 in AP group 10.
<Sysname> system-view
[Sysname] wlan ap-group 10
[Sysname-wlan-ap-group-10] ap-model WA6320
[Sysname-wlan-ap-group-10-ap-model-WA6320] radio 1
[Sysname-wlan-ap-group-10-ap-model-WA6320-radio-1] scan idle-time 500
Related commands
beacon interval
scan max-service-time
Use scan max-service-time to set the maximum service period.
Use undo scan max-service-time to restore the default.
Syntax
scan max-service-time { max-service-time | no-limit }
undo scan max-service-time
Default
In radio view, a radio uses the configuration in an AP group's radio view.
In an AP group's radio view, the maximum service period is not limited. An AP does not start a scanning period unless the service idle timeout timer expires.
Views
Radio view
AP group's radio view
Predefined user roles
network-admin
Parameters
max-service-time: Specifies the maximum service period in the range of 100 to 5000 milliseconds.
no-limit: Configures the radio to not limit the service period. Specify this keyword to ensure wireless service quality. The AP does not start a scanning period unless the service idle timeout expires.
Usage guidelines
When the maximum service period for an AP is reached, the AP begins a scanning period regardless of whether it has traffic to forward. The maximum service period cannot be smaller than the scanning period.
The configuration in radio view takes precedence over the configuration in an AP group's radio view.
Examples
# Set the maximum service period to 3000 milliseconds for AP 1.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA6320
[Sysname-wlan-ap-ap1] radio 1
[Sysname-wlan-ap-ap1-radio-1] scan max-service-time 3000
# Set the maximum service period to 3000 milliseconds for APs with model WA6320 in AP group 10.
<Sysname> system-view
[Sysname] wlan ap-group 10
[Sysname-wlan-ap-group-10] ap-model WA6320
[Sysname-wlan-ap-group-10-ap-model-WA6320] radio 1
[Sysname-wlan-ap-group-10-ap-model-WA6320-radio-1] scan max-service-time 3000
scan mode all
Use scan mode all enable to enable an AP to scan all channels.
Use scan mode all disable to disable an AP from scanning all channels.
Use undo scan mode to restore the default.
Syntax
scan mode all { disable | enable }
undo scan mode
Default
In radio view, a radio uses the configuration in an AP group's radio view.
In an AP group's radio view, a radio does not scan all channels.
Views
Radio view
AP group's radio view
Predefined user roles
network-admin
Usage guidelines
|
|
CAUTION: After you execute this command on a radio, the other radios on the same AP might change working channels. Please be cautious. |
This command is applicable only to dual-band radios.
After you configure this command for an AP, the AP alternatively scans 2.4 GHz channels and 5 GHz channels at the specified interval. As a best practice, do not enable all-channel scanning and wireless access services at the same time.
If you configure the settings of an AP such as the radio mode, channel, bandwidth, or transmit power after enabling the AP to scan all channels, the configuration might not take effect.
The configuration in radio view takes precedence over the configuration in an AP group's radio view.
Examples
# Enable AP ap1 to scan all channels.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA6320
[Sysname-wlan-ap-ap1] radio 2
[Sysname-wlan-ap-ap1-radio-2] scan mode all enable
This operation will affect WLAN access and RRM. Are you sure you want to perform
this operation?[Y/N]:Y
# Enable APs with model WA4330-ACN in AP group 10 to scan all channels.
<Sysname> system-view
[Sysname] wlan ap-group 10
[Sysname-wlan-ap-group-10] ap-model WA6320
[Sysname-wlan-ap-group-10-ap-model-WA6320] radio 2
[Sysname-wlan-ap-group-10-ap-model-WA6320-radio-2] scan mode all enable
This operation will affect WLAN access and RRM. Are you sure you want to perform
this operation?[Y/N]:Y
scan mode all interval
Use scan mode all interval to set the interval for an AP to scan all channels.
Use undo scan mode interval to restore the default.
Syntax
scan mode all interval interval-value
undo scan mode all interval
Default
In radio view, a radio uses the configuration in an AP group's radio view.
In an AP group's radio view, the interval for an AP to alternatively scan 2.4 GHz channels and 5 GHz channels is 3000 milliseconds.
Views
Radio view
AP group's radio view
Predefined user roles
network-admin
Parameters
interval interval-value: Specifies the interval for an AP to alternatively scan 2.4 GHz channels and 5 GHz channels, in the range of 2000 to 10000 milliseconds.
Examples
# Set the interval for an AP to alternatively scan 2.4 GHz channels and 5 GHz channels to 5000 milliseconds for AP ap1.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA6320
[Sysname-wlan-ap-ap1] radio 2
[Sysname-wlan-ap-ap1-radio-2] scan mode all interval 5000
# Set the interval for an AP to alternatively scan 2.4 GHz channels and 5 GHz channels to 5000 milliseconds for APs with model WA4330-ACN in AP group 1.
<Sysname> system-view
[Sysname] wlan ap-group 1
[Sysname-wlan-ap-group-1] ap-model WA6320
[Sysname-wlan-ap-group-1-WA6320] radio 2
[Sysname-wlan-ap-group-1-WA6320-radio-2] scan mode all interval 5000
scan scan-time
Use scan scan-time to set the scanning period.
Use undo scan scan-time to restore the default.
Syntax
scan scan-time scan-time
undo scan scan-time
Default
In radio view, a radio uses the configuration in an AP group's radio view.
In an AP group's radio view, the scanning period is 100 milliseconds.
Views
Radio view
AP group's radio view
Predefined user roles
network-admin
Parameters
scan-time: Specifies the scanning period in the range of 100 to 5000 milliseconds. The scanning period cannot be greater than the maximum service period.
Usage guidelines
The configuration in radio view takes precedence over the configuration in an AP group's radio view.
Examples
# Set the scanning period to 500 milliseconds for AP 1.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA6320
[Sysname-wlan-ap-ap1] radio 1
[Sysname-wlan-ap-ap1-radio-1] scan scan-time 500
# Set the scanning period to 500 milliseconds for APs with model WA6320 in AP group 10.
<Sysname> system-view
[Sysname] wlan ap-group 10
[Sysname-wlan-ap-group-10] ap-model WA6320
[Sysname-wlan-ap-group-10-ap-model-WA6320] radio 1
[Sysname-wlan-ap-group-10-ap-model-WA6320-radio-1] scan scan-time 500
scan work-channel-only
Use scan work-channel-only enable to enable an AP to scan only the working channel.
Use scan work-channel-only disable to disable an AP from scanning only the working channel.
Use undo scan work-channel-only to restore the default.
Syntax
scan work-channel-only { disable | enable }
undo scan work-channel-only
Default
In radio view, a radio uses the configuration in an AP group's radio view.
In an AP group's radio view, an AP scans all supported channels in turn.
Views
Radio view
AP group's radio view
Predefined user roles
network-admin
Usage guidelines
The configuration in radio view takes precedence over the configuration in an AP group's radio view.
Examples
# Configure AP ap1 to scan only the working channel.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA6320
[Sysname-wlan-ap-ap1] radio 1
[Sysname-wlan-ap-ap1-radio-1] scan work-channel-only enable
# Configure APs with model WA6320 in AP group 1 to scan only the working channel.
<Sysname> System-view
[Sysname] wlan ap-group 1
[Sysname-wlan-ap-group-1] ap-model WA6320
[Sysname-wlan-ap-group-1-ap-model-WA6320] radio 1
[Sysname-wlan-ap-group-1-ap-model-WA6320] scan work-channel-only enable
wlan channel-report disable
Use wlan channel-report disable to disable APs from sending channel reports.
Use undo wlan channel-report disable to enable APs to send channel reports.
Syntax
wlan channel-report disable
undo wlan channel-report disable
Default
APs send channel reports.
Views
System view
Predefined user roles
network-admin
Usage guidelines
A channel report contains channel information such as channel load, channel usage, channel interference, bit error rate, and retransmission rate.
With channel report sending disabled, automatic channel adjustment, automatic power adjustment, and radio resource measurement are unavailable.
Examples
# Disable APs from sending channel reports.
<Sysname> system-view
[Sysname] wlan channel-report disable
Related commands
calibrate-channel self-decisive
wlan channel-report interval
Use wlan channel-report interval to set the interval at which APs send channel reports.
Use undo wlan channel-report interval to restore the default.
Syntax
wlan channel-report interval interval
undo wlan channel-report interval
Default
An AP sends a channel report every 150 seconds.
Views
System view
Predefined user roles
network-admin
Parameters
interval: Specifies the interval for APs to send channel reports, in the range of 50 to 86400 seconds.
Usage guidelines
Set a proper reporting interval. A small reporting interval causes a heavy AC load. A large reporting interval affects automatic channel adjustment and automatic power adjustment.
Examples
# Set the interval to 1800 seconds for APs to send channel reports.
<Sysname> system-view
[Sysname] wlan channel-report interval 1800
Related commands
wlan rrm calibration-channel interval
wlan neighbor-report disable
Use wlan neighbor-report disable to disable APs from sending neighbor reports.
Use undo wlan neighbor-report disable to enable APs to send neighbor reports.
Syntax
wlan neighbor-report disable
undo wlan neighbor-report disable
Default
APs send neighbor reports.
Views
System view
Predefined user roles
network-admin
Usage guidelines
A neighbor report contains neighbor radio information such as RSSI.
With neighbor report sending disabled, automatic channel adjustment, automatic power adjustment, and radio resource measurement are unavailable.
Examples
# Disable APs from sending neighbor reports.
<Sysname> system-view
[Sysname] wlan neighbor-report disable
Related commands
calibrate-channel self-decisive
wlan neighbor-report interval
Use wlan neighbor-report interval to set the interval at which APs send neighbor reports.
Use undo wlan neighbor-report interval to restore the default.
Syntax
wlan neighbor-report interval interval
undo wlan neighbor-report interval
Default
An AP sends a neighbor report every 150 seconds.
Views
System view
Predefined user roles
network-admin
Parameters
interval: Specifies the interval for APs to send neighbor reports, in the range of 50 to 86400 seconds.
Usage guidelines
Set a proper reporting interval. A small reporting interval causes a heavy AC load. A large reporting interval affects automatic channel adjustment and automatic power adjustment.
Examples
# Set the interval to 1800 seconds for APs to send neighbor reports.
<Sysname> system-view
[Sysname] wlan neighbor-report interval 1800
Related commands
wlan rrm calibration-channel interval
wlan radio continuous-service suppression
Use wlan radio continuous-service suppression to suppress the continuous service.
Syntax
wlan radio continuous-service suppression
Views
System view
Predefined user roles
network-admin
Usage guidelines
If an AP provides the continuous service, the maximum service period is not limited and the AP does not start a scanning period unless the service idle timeout timer expires.
During the AP operation, you can suppress the continuous service to collect the complete channel report and neighbor report that are the bases for adjusting the channel and power automatically. During the service suppression period, an AP alternatively scans channels and provides wireless access services. To configure a scanning period and maximum service period rather than use their default values, you can execute the scan scan-time scan-time and scan max-service-time max-service-time, respectively.
After you execute this command, you can execute the wlan radio continuous-service suppression-time time to set the continuous service suppression time.
Before configuring this command, make sure the continuous service is enabled.
To avoid the possible impact on the service caused by packet loss, suppress the continuous service during the network maintenance as a best practice.
Examples
# Suppress the continuous service.
<Sysname> system-view
[Sysname] wlan radio continuous-service suppression
Related commands
scan max-service-time
scan scan-time
wlan radio continuous-service suppression-time
wlan radio continuous-service suppression-time
Use wlan radio continuous-service suppression-time to set the continuous service suppression time.
Use undo wlan radio continuous-service suppression-time to restore the default.
Syntax
wlan radio continuous-service suppression-time time
undo wlan radio continuous-service suppression-time
Default
The continuous service suppression time is 10 minutes.
Views
System view
Predefined user roles
network-admin
Parameters
time: Specifies the continuous service suppression time in the range of 1 to 500 minutes.
Usage guidelines
If an AP provides the continuous service, the maximum service period is not limited and the AP does not start a scanning period unless the service idle timeout timer expires.
During the AP operation, you can suppress the continuous service to collect the complete channel report and neighbor report that are bases for adjusting the channel and power automatically. During the service suppression period, an AP alternatively scans channels and provides wireless access services. To configure a scanning period and maximum service period rather than use their default values, you can execute the scan scan-time scan-time and scan max-service-time max-service-time, respectively.
Examples
# Set the continuous service suppression time to 30 minutes.
<Sysname> system-view
[Sysname] wlan radio continuous-service suppression-time 30
Related commands
scan max-service-time
scan scan-time
wlan radio continuous-service suppression
