Contents

Channel scanning commands· 1

scan channel blacklist 1

scan channel whitelist 2

scan idle-time· 3

scan max-service-time· 4

scan mode all 4

scan mode all interval 5

scan scan-time· 6

scan work-channel-only· 7

Channel scanning commands

The term "AC" in this document refers to MSR routers that can function as ACs. For more information, see "Compatibility of hardware and AC functionality."

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 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 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 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 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 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 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 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 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

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 an AP group's radio view.

Examples

# Enable AP ap1 to scan all channels.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4330-ACN

[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 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 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 WA4330-ACN

[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 WA4330-ACN

[Sysname-wlan-ap-group-1-WA4330-ACN] radio 2

[Sysname-wlan-ap-group-1-WA4330-ACN-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 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

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 WA4320i-ACN

[Sysname-wlan-ap-ap1] radio 1

[Sysname-wlan-ap-ap1-radio-1] scan work-channel-only enable

# Configure APs with model WA4320i-ACN 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 WA4320i-ACN

[Sysname-wlan-ap-group-1-ap-model-WA4320i-ACN] radio 1

[Sysname-wlan-ap-group-1-ap-model-WA4320i-ACN] scan work-channel-only enable