12-WLAN Advanced Features Command Reference

HomeSupportResource CenterH3C Access Controllers Command References(R5426P02)-6W10412-WLAN Advanced Features Command Reference
09-WSA commands
Title Size Download
09-WSA commands 80.60 KB

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

display wlan spectrum-analysis channel-quality

Use display wlan spectrum-analysis channel-quality to display channel quality information.

Syntax

display wlan spectrum-analysis channel-quality [ ap ap-name | ap-group ap-group-name ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

ap ap-name: Specifies an AP by its name, a case-sensitive string of 1 to 64 characters. The name can contain letters, numbers, underlines (_), dots (.), left brackets ([), right brackets (]), slashes (/), and hyphens (-).

ap-group ap-group-name: Specifies an AP group by its name, a case-insensitive string of 1 to 31 characters.

Usage guidelines

If you do not specify the ap ap-name or ap-group ap-group-name option, the command displays channel quality information detected by all APs.

Examples

# Display channel quality information detected by AP ap1.

<Sysname> display wlan spectrum-analysis channel-quality ap ap1

AP name   RID   Channel   Avg-AQ   Min-AQ   Interference

ap1       2     1         95       84       1

Table 1 Command output

Field

Description

RID

Radio ID.

Channel

Channel number.

Avg-AQ

Average channel quality.

Min-AQ

Worst channel quality.

Interference

Number of detected interference devices.

 

display wlan spectrum-analysis device

Use display wlan spectrum-analysis device to display interference device information.

Syntax

display wlan spectrum-analysis device [ ap ap-name | ap-group ap-group-name ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

ap ap-name: Specifies an AP by its name, a case-sensitive string of 1 to 64 characters. The name can contain letters, numbers, underlines (_), dots (.), left brackets ([), right brackets (]), slashes (/), and hyphens (-).

ap-group ap-group-name: Specifies an AP group by its name, a case-insensitive string of 1 to 31 characters.

Usage guidelines

If you do not specify the ap ap-name or ap-group ap-group-name option, the command displays information about interference devices detected by all APs.

Examples

# Display information about interference devices detected by AP ap1.

<Sysname> display wlan spectrum-analysis device ap ap1

Interference detected by ap1 Radio1

 

Device ID              : 0x0005

Type                   : Video device using fixed frequency

SI                     : 50

RSSI                   : -35

Duty cycle (%)         : 20

Affected channels      : 3,4,5,6,7

Detected time          : Jan 6 10:42:56 2014

 

Device ID              : 0x0007

Type                   : Bluetooth

SI                     : 80

RSSI                   : -49

Duty cycle (%)         : 35

Affected channels      : 1,3,5,6,10

Detected time          : Jan 6 10:42:56 2014

 

Device ID              : 0x000a

Type                   : Microwave oven

SI                     : 32

RSSI                   : -25

Duty cycle (%)         : 50

Affected channels      : 1,2,7,13,14

Detected time          : Jan 6 10:42:56 2014

Table 2 Command output

Field

Description

Interference detected by

Name of the AP and ID of the radio that detects the interference device.

Device ID

Interference device ID.

Type

Interference device type.

SI

Severity index. A greater value represents greater interference.

RSSI

RSSI of the interference device.

Duty cycle (%)

Percentage of time in a ten second period where an interference device is active.

Affected channels

Channels affected by the interference device.

Detected time

Time when the interference device was most recently detected.

 

snmp-agent trap enable wsa

Use snmp-agent trap enable wsa to enable SNMP notifications for WSA.

Use undo snmp-agent trap enable wsa to disable SNMP notifications for WSA.

Syntax

snmp-agent trap enable wsa

undo snmp-agent trap enable wsa

Default

SNMP notifications for WSA are disabled.

Views

System view

Predefined user roles

network-admin

Usage guidelines

To report critical WSA events to an NMS, enable SNMP notifications for WSA. For WSA notifications to be sent correctly, you must also configure SNMP on the device. For more information about SNMP configuration, see the network management and monitoring configuration guide for the device.

Examples

# Enable SNMP notifications for WSA.

<sysname> system view

[sysname] snmp-agent trap enable wsa

spectrum-analysis

Use spectrum-analysis enable to enable WSA.

Use spectrum-analysis disable to disable WSA.

Use undo spectrum-analysis to restore the default.

Syntax

spectrum-analysis { disable | enable }

undo spectrum-analysis

Default

In radio view, the configuration in an AP group's radio view is used.

In an AP group's radio view, WSA is disabled.

Views

Radio view

AP group radio view

Predefined user roles

network-admin

Usage guidelines

With WSA enabled, APs collect interference device and channel quality information and periodically send the information to the AC for further analysis.

Examples

# Enable WSA for AP ap1.

<sysname> system view

[sysname] wlan ap ap1 model WA4320i-ACN

[sysname-wlan-ap-ap1] radio 1

[sysname-wlan-ap-ap1-radio-1] spectrum-analysis enable

# Enable WSA for the APs with model WA4320i-ACN in AP group apgroup1.

<Sysname> system-view

[Sysname] wlan ap-group apgroup1

[Sysname-wlan-ap-group-apgroup1] ap-model WA4320i-ACN

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

[Sysname-wlan-ap-group-apgroup1-ap-model-WA4320i-ACN-radio-1] spectrum-analysis enable

spectrum-analysis calibrate-channel sensitivity

Use spectrum-analysis calibrate-channel sensitivity to specify a channel quality sensitivity level.

Use undo spectrum-analysis calibrate-channel sensitivity to restore the default.

Syntax

spectrum-analysis calibrate-channel sensitivity { high | low | medium }

undo spectrum-analysis calibrate-channel sensitivity

Default

In radio view, the configuration in an AP group's radio view is used.

In an AP group's radio view, the channel quality sensitivity level is medium.

Views

Radio view

AP group radio view

Predefined user roles

network-admin

Parameters

high: Specifies the high sensitivity level. The corresponding channel quality value is 60.

low: Specifies the low sensitivity level. The corresponding channel quality value is 35.

medium: Specifies the medium sensitivity level. The corresponding channel quality value is 50.

Usage guidelines

WSA notifies RRM to perform DFS when the channel quality is lower than the channel quality value corresponding to the specified sensitivity level. Make sure WSA collaboration is enabled before you execute this command. For more information about WSA collaboration, see Radio Resource Management Configuration Guide.

A smaller channel quality value represents worse channel quality.

Examples

# Set the channel quality sensitivity level to high for AP ap1.

<sysname> system view

[sysname] wlan ap ap1 model WA4320i-ACN

[sysname-wlan-ap-ap1] radio 1

[sysname-wlan-ap-ap1-radio-1] spectrum-analysis calibrate-channel sensitivity high

# Set the channel quality sensitivity level to high for the APs with model WA4320i-ACN in AP group apgroup1.

<Sysname> system-view

[Sysname] wlan ap-group apgroup1

[Sysname-wlan-ap-group-apgroup1] ap-model WA4320i-ACN

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

[Sysname-wlan-ap-group-apgroup1-ap-model-WA4320i-ACN-radio-1] spectrum-analysis calibrate-channel sensitivity high

Related commands

calibrate-channel track spectrum-analysis

spectrum-analysis device

Use spectrum-analysis device to configure interference detection.

Use undo spectrum-analysis device to remove the configuration.

Syntax

spectrum-analysis device { all | device-type } { disable | enable }

undo spectrum-analysis device { all | device-type }

Default

In radio view, the configuration in an AP group's radio view is used.

In an AP group's radio view, APs detect all types of interference devices.

Views

Radio view

AP group radio view

Predefined user roles

network-admin

Parameters

device-type: Specifies an interference device type.

all: Specifies all interference device types.

disable: Disables detecting the specified type of interference devices.

enable: Enables detecting the specified type of interference devices.

Usage guidelines

APs can detect only the types of interference devices in the feature database. The default feature database stores features about microwave ovens, Bluetooth devices, video devices using fixed frequency, frequency-hopping cordless networks, and Microsoft Xboxes.

Types of interference devices that can be detected vary by radio mode.

Examples

# Enable detecting Bluetooth devices for AP ap1.

<sysname> system view

[sysname] wlan ap ap1 model WA4320i-ACN

[sysname-wlan-ap-ap1] radio 2

[sysname-wlan-ap-ap1-radio-2] spectrum-analysis device bluetooth enable

# Enable detecting Bluetooth devices for the APs with model WA4320i-ACN in AP group apgroup1.

<Sysname> system-view

[Sysname] wlan ap-group apgroup1

[Sysname-wlan-ap-group-apgroup1] ap-model WA4320i-ACN

[Sysname-wlan-ap-group-apgroup1-ap-model-WA4320i-ACN] radio 2

[Sysname-wlan-ap-group-apgroup1-ap-model-WA4320i-ACN-radio-2] spectrum-analysis device bluetooth enable

spectrum-analysis trap channel-quality

Use spectrum-analysis trap channel-quality enable to enable channel quality notifications.

Use spectrum-analysis trap channel-quality disable to disable channel quality notifications.

Use undo spectrum-analysis trap channel-quality to restore the default.

Syntax

spectrum-analysis trap channel-quality { disable | enable }

undo spectrum-analysis trap channel-quality

Default

In radio view, the configuration  in an AP group's radio view is used.

In an AP group's radio view, channel quality notifications are enabled.

Views

Radio view

AP group radio view

Predefined user roles

network-admin

Usage guidelines

Channel quality notifications take effect only when you also enable SNMP notifications for WSA.

Examples

# Disable channel quality notifications for AP ap1.

<sysname> system view

[sysname] wlan ap ap1 model WA4320i-ACN

[sysname-wlan-ap-ap1] radio 1

[sysname-wlan-ap-ap1-radio-1] spectrum-analysis trap channel-quality disable

# Disable channel quality notifications for the APs with model WA4320i-ACN in AP group apgroup1.

<Sysname> system-view

[Sysname] wlan ap-group apgroup1

[Sysname-wlan-ap-group-apgroup1] ap-model WA4320i-ACN

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

[Sysname-wlan-ap-group-apgroup1-ap-model-WA4320i-ACN-radio-1] spectrum-analysis trap channel-quality disable

Related commands

snmp-agent trap enable wsa

spectrum-analysis trap channel-quality threshold

spectrum-analysis trap channel-quality threshold

Use spectrum-analysis trap channel-quality threshold to set the channel quality threshold that triggers notifications.

Use undo spectrum-analysis trap channel-quality threshold to restore the default.

Syntax

spectrum-analysis trap channel-quality threshold threshold-value

undo spectrum-analysis trap channel-quality threshold

Default

In radio view, the configuration  in an AP group's radio view is used.

In an AP group's radio view, the channel quality threshold that triggers notifications is 35.

Views

Radio view

AP group radio view

Predefined user roles

network-admin

Parameters

threshold-value: Specifies the channel quality threshold that triggers notifications, in the range of 1 to 100. A smaller channel quality value represents worse channel quality.

Usage guidelines

Channel quality notifications take effect only when you also enable SNMP notifications for WSA.

Examples

# Set the channel quality threshold that triggers notifications to 45 for AP ap1.

<sysname> system view

[sysname] wlan ap ap1 model WA4320i-ACN

[sysname-wlan-ap-ap1] radio 1

[sysname-wlan-ap-ap1-radio-1] spectrum-analysis trap channel-quality threshold 45

# Set the channel quality threshold that triggers notifications to 45 for the APs with model WA4320i-ACN in AP group apgroup1.

<Sysname> system-view

[Sysname] wlan ap-group apgroup1

[Sysname-wlan-ap-group-apgroup1] ap-model WA4320i-ACN

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

[Sysname-wlan-ap-group-apgroup1-ap-model-WA4320i-ACN-radio-1] spectrum-analysis trap channel-quality threshold 45

Related commands

snmp-agent trap enable wsa

spectrum-analysis trap channel-quality enable

spectrum-analysis trap device

Use spectrum-analysis trap device to configure notifications for the specified type of interference devices.

Use undo spectrum-analysis trap device to restore the default.

Syntax

spectrum-analysis trap device { all | device-type } { disable | enable }

undo spectrum-analysis trap device { all | device-type }

Default

In radio view, the configuration  in an AP group's radio view is used.

In an AP group's radio view, notifications are enabled for all types of interference devices.

Views

Radio view

AP group radio view

Predefined user roles

network-admin

Parameters

device-type: Specifies an interference device type.

all: Specifies all interference device types.

disable: Disables notifications for the specified type of interference devices.

enable: Enables notifications for the specified type of interference devices.

Usage guidelines

Notifications for an interference device type take effect only when you also enable SNMP notifications for WSA.

Examples

# Disable notifications when Bluetooth devices are detected on AP ap1.

<sysname> system view

[sysname] wlan ap ap1 model WA4320i-ACN

[sysname-wlan-ap-ap1] radio 2

[sysname-wlan-ap-ap1-radio-2] undo spectrum-analysis trap device Bluetooth

# Disable notifications when Bluetooth devices are detected on the APs with model WA4320i-ACN in AP group apgroup1.

<Sysname> system-view

[Sysname] wlan ap-group apgroup1

[Sysname-wlan-ap-group-apgroup1] ap-model WA4320i-ACN

[Sysname-wlan-ap-group-apgroup1-ap-model-WA4320i-ACN] radio 2

[Sysname-wlan-ap-group-apgroup1-ap-model-WA4320i-ACN-radio-2] undo spectrum-analysis trap device Bluetooth

Related commands

snmp-agent trap enable wsa

spectrum-analysis device

spectrum-analysis trap device

spectrum-analysis trap device enable

Use spectrum-analysis trap device enable to enable interference device notifications.

Use spectrum-analysis trap device disable to disable interference device notifications.

Use undo spectrum-analysis trap device to restore the default.

Syntax

spectrum-analysis trap device { disable | enable }

undo spectrum-analysis trap device

Default

In radio view, the configuration  in an AP group's radio view is used.

In an AP group's radio view, interference device notifications are enabled.

Views

Radio view

AP group radio view

Predefined user roles

network-admin

Usage guidelines

Interference device notifications take effect only when you also enable SNMP notifications for WSA.

Examples

# Disable interference device notifications for AP ap1.

<sysname> system view

[sysname] wlan ap ap1 model WA4320i-ACN

[sysname-wlan-ap-ap1] radio 1

[sysname-wlan-ap-ap1-radio-1] spectrum-analysis trap device disable

# Disable interference device notifications for the APs with model WA4320i-ACN in AP group apgroup1.

<Sysname> system-view

[Sysname] wlan ap-group apgroup1

[Sysname-wlan-ap-group-apgroup1] ap-model WA4320i-ACN

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

[Sysname-wlan-ap-group-apgroup1-ap-model-WA4320i-ACN-radio-1] spectrum-analysis trap device disable

Related commands

snmp-agent trap enable wsa

spectrum-analysis device

spectrum-analysis trap device

wlan spectrum-analysis feature-db file

Use wlan spectrum-analysis feature-db file to import a feature database file.

Use undo wlan spectrum-analysis feature-db file to restore the default.

Syntax

wlan spectrum-analysis feature-db file file-name

undo wlan spectrum-analysis feature-db file

Default

WSA uses the default feature database.

Views

System view

Predefined user roles

network-admin

Parameters

file file-name: Specifies a feature database file by its name.

Usage guidelines

A feature database stores features such as frequency hopping interval and pulse interval about specific types of interference devices.

Before configuring this command, you must upload the feature database file to the AC's storage media.

Examples

# Import the feature database file named feature.sadb.

<sysname> system view

[sysname] wlan spectrum-analysis feature-db file feature.sadb