- Table of Contents
-
- 03-WLAN Command References
- 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-AC hierarchy commands
- 17-WLAN RRM commands
- 18-WLAN IP snooping commands
- 19-WLAN probe commands
- 20-WLAN forwarding commands
- 21-Spectrum management commands
- 22-WLAN radio load balancing commands
- 23-User isolation commands
- 24-Packet capture commands
- 25-802.1X client commands
- 26-IP source guard commands
- Related Documents
-
Title | Size | Download |
---|---|---|
11-Channel scanning commands | 43.63 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 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 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 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 WA4320H
[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 WA4320H in AP group 10.
<Sysname> system-view
[Sysname] wlan ap-group 10
[Sysname-wlan-ap-group-10] ap-model WA4320H
[Sysname-wlan-ap-group-10-ap-model-WA4320H] radio 2
[Sysname-wlan-ap-group-10-ap-model-WA4320H-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 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 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 WA4320H
[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 WA4320H in AP group 10.
<Sysname> system-view
[Sysname] wlan ap-group 10
[Sysname-wlan-ap-group-10] ap-model WA4320H
[Sysname-wlan-ap-group-10-ap-model-WA4320H] radio 2
[Sysname-wlan-ap-group-10-ap-model-WA4320H-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 WA4320H
[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 WA4320H in AP group 10.
<Sysname> system-view
[Sysname] wlan ap-group 10
[Sysname-wlan-ap-group-10] ap-model WA4320H
[Sysname-wlan-ap-group-10-ap-model-WA4320H] radio 1
[Sysname-wlan-ap-group-10-ap-model-WA4320H-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 5000 milliseconds.
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 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 WA4320H
[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 WA4320H in AP group 10.
<Sysname> system-view
[Sysname] wlan ap-group 10
[Sysname-wlan-ap-group-10] ap-model WA4320H
[Sysname-wlan-ap-group-10-ap-model-WA4320H] radio 1
[Sysname-wlan-ap-group-10-ap-model-WA4320H-radio-1] scan max-service-time 3000
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 WA4320H
[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 WA4320H in AP group 10.
<Sysname> system-view
[Sysname] wlan ap-group 10
[Sysname-wlan-ap-group-10] ap-model WA4320H
[Sysname-wlan-ap-group-10-ap-model-WA4320H] radio 1
[Sysname-wlan-ap-group-10-ap-model-WA4320H-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 WA4320H
[Sysname-wlan-ap-ap1] radio 1
[Sysname-wlan-ap-ap1-radio-1] scan work-channel-only enable
# Configure APs with model WA4320H 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 WA4320H
[Sysname-wlan-ap-group-1-ap-model-WA4320H] radio 1
[Sysname-wlan-ap-group-1-ap-model-WA4320H] scan work-channel-only enable