- Table of Contents
-
- 02-WLAN
- 00-Preface
- 01-AP management commands
- 02-Radio management commands
- 03-WLAN access commands
- 04-WLAN security commands
- 05-WLAN authentication commands
- 06-WIPS commands
- 07-WLAN QoS commands
- 08-WLAN roaming commands
- 09-WLAN load balancing commands
- 10-WLAN radio resource measurement commands
- 11-Channel scanning commands
- 12-Band navigation commands
- 13-WLAN high availability commands
- 14-802.11r commands
- 15-Wireless location commands
- 16-Hotspot 2.0 commands
- 17-WLAN RRM commands
- 18-WT commands
- 19-IoT AP commands
- 20-CM tunnel commands
- 21-Cloud connection commands
- 22-WLAN IP snooping commands
- 23-WLAN fast forwarding commands
- 24-WLAN forwarding commands
- Related Documents
-
Title | Size | Download |
---|---|---|
11-Channel scanning commands | 42.62 KB |
Channel scanning commands
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 AP group radio view
In AP group radio view, no channel scanning blacklist exists.
Views
Radio view
AP group radio view
Predefined user roles
network-admin
Parameters
channel-list: Specifies channels by their channel numbers in the range of 1 to 165.
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 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 AP group radio view.
Examples
# Add channels 1 and 6 to the channel scanning blacklist for AP 1.
<Sysname> system-view
[Sysname] wlan ap 1 model WA4320i-ACN
[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 WA4320i-ACN in AP group 10.
<Sysname> system-view
[Sysname] wlan ap-group 10
[Sysname-wlan-ap-group-10] ap-model WA4320i-ACN
[Sysname-wlan-ap-group-10-ap-model-WA4320i-ACN] radio 2
[Sysname-wlan-ap-group-10-ap-model-WA4320i-ACN-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 AP group radio view.
In AP group radio view, no channel scanning whitelist exists.
Views
Radio view
AP group radio view
Predefined user roles
network-admin
Parameters
channel-list: Specifies channels by their channel numbers in the range of 1 to 165.
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. 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 AP group radio view.
Examples
# Add channels 1 and 6 to the channel scanning whitelist for AP 1.
<Sysname> system-view
[Sysname] wlan ap 1 model WA4320i-ACN
[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 WA4320i-ACN in AP group 10.
<Sysname> system-view
[Sysname] wlan ap-group 10
[Sysname-wlan-ap-group-10] ap-model WA4320i-ACN
[Sysname-wlan-ap-group-10-ap-model-WA4320i-ACN] radio 2
[Sysname-wlan-ap-group-10-ap-model-WA4320i-ACN-radio-2] scan channel whitelist 1 6
scan idle-time
Use scan idle-time to set the service idle timeout.
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 AP group radio view.
In AP group radio view, the service idle timeout is 100 milliseconds.
Views
Radio view
AP group radio view
Predefined user roles
network-admin
Parameters
idle-time: Specifies the service idle timeout in the range of 60 to 5000 milliseconds. The service idle timeout 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 must be a multiple of the beacon interval. If you set a service idle timeout that is smaller than the beacon interval, the value of the beacon interval is used as the service idle timeout.
The configuration in radio view takes precedence over the configuration in AP group radio view.
Examples
# Set the service idle timeout to 500 milliseconds for AP 1.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA4320i-ACN
[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 WA4320i-ACN in AP group 10.
<Sysname> system-view
[Sysname] wlan ap-group 10
[Sysname-wlan-ap-group-10] ap-model WA4320i-ACN
[Sysname-wlan-ap-group-10-ap-model-WA4320i-ACN] radio 1
[Sysname-wlan-ap-group-10-ap-model-WA4320i-ACN-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 AP group radio view.
In AP group radio view, the maximum service period is 5000 milliseconds.
Views
Radio view
AP group radio view
Predefined user roles
network-admin
Parameters
max-service-time: Specifies the maximum service period in the range of 100 to 5000 milliseconds. When the maximum service period for an AP is reached, the AP begins a scanning period regardless of whether it has traffic to forward.
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.
The configuration in radio view takes precedence over the configuration in AP group radio view.
Examples
# Set the maximum service period to 3000 milliseconds for AP 1.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA4320i-ACN
[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 WA4320i-ACN in AP group 10.
<Sysname> system-view
[Sysname] wlan ap-group 10
[Sysname-wlan-ap-group-10] ap-model WA4320i-ACN
[Sysname-wlan-ap-group-10-ap-model-WA4320i-ACN] radio 1
[Sysname-wlan-ap-group-10-ap-model-WA4320i-ACN-radio-1] scan max-service-time 3000
scan mode all
Use scan mode all to enable an AP to scan all channels.
Use undo scan mode to disable an AP from scanning all channels.
Syntax
scan mode all [ interval interval-value ]
undo scan mode
Default
In radio view, a radio uses the configuration in AP group radio view.
In AP group radio view, an AP does not scan all channels.
Views
Radio view
AP group radio view
Predefined user roles
network-admin
Parameters
interval interval-value: Specifies the interval at which an AP alternatively scans 2.4 GHz channels and 5 GHz channels. The value range for the interval-value argument is 2000 to 10000 milliseconds and the default value is 3000 milliseconds.
Usage guidelines
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.
The configuration in radio view takes precedence over the configuration in AP group radio view.
Examples
# Enable AP ap1 to scan all channels and set the interval-value argument to 5000 milliseconds.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA4330-ACN
[Sysname-wlan-ap-ap1] radio 2
[Sysname-wlan-ap-ap1-radio-1] scan mode all interval 5000
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 and set the interval-value argument to 5000 milliseconds.
<Sysname> system-view
[Sysname] wlan ap-group 10
[Sysname-wlan-ap-group-10] ap-model WA4330-ACN
[Sysname-wlan-ap-group-10-ap-model-WA4330-ACN] radio 2
[Sysname-wlan-ap-group-10-ap-model-WA4330-ACN-radio-2] scan mode all interval 5000
This operation will affect WLAN access and RRM. Are you sure you want to perform
this operation?[Y/N]:Y
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 AP group radio view.
In AP group radio view, the scanning period is 100 milliseconds.
Views
Radio view
AP group 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 AP group radio view.
Examples
# Set the scanning period to 500 milliseconds for AP 1.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA4320i-ACN
[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 WA4320i-ACN in AP group 10.
<Sysname> system-view
[Sysname] wlan ap-group 10
[Sysname-wlan-ap-group-10] ap-model WA4320i-ACN
[Sysname-wlan-ap-group-10-ap-model-WA4320i-ACN] radio 1
[Sysname-wlan-ap-group-10-ap-model-WA4320i-ACN-radio-1] scan scan-time 500