No relevant resource is found in the selected language.

This site uses cookies. By continuing to browse the site you are agreeing to our use of cookies. Read our privacy policy>Search

Reminder

To have a better experience, please upgrade your IE browser.

upgrade

Command Reference

S7700 and S9700 V200R011C10

This document describes all the configuration commands of the device, including the command function, syntax, parameters, views, default level, usage guidelines, examples, and related commands.
Rate and give feedback:
Huawei uses machine translation combined with human proofreading to translate this document to different languages in order to help you better understand the content of this document. Note: Even the most advanced machine translation cannot match the quality of professional translators. Huawei shall not bear any responsibility for translation accuracy and it is recommended that you refer to the English document (a link for which has been provided).
WLAN Roaming Commands

WLAN Roaming Commands

Command Support

Only the X series interface cards of S7700 and S9700 support WLAN-AC commands.

beacon disable

Function

The beacon disable command disables RUs from sending Beacon frames.

The undo beacon disable command enables RUs to send Beacon frames.

By default, RUs are enabled to send Beacon frames.

Format

beacon disable

undo beacon disable

Parameters

None

Views

AP radio view, AP group radio view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To ensure synchronization of Beacon frames in scenarios with densely deployed RUs, you can run the beacon disable command to disable some RUs from sending Beacon frames. This configuration is recommended on a network enabled with agile distributed SFN roaming. In other scenarios, the default configuration is recommended.

Precautions

Disabling RUs from sending Beacon frames may cause STAs to go offline due to a failure to receive Beacon frames.

Example

# Disable RUs from sending Beacon frames.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ap-id 1
[HUAWEI-wlan-ap-1] radio 0
[HUAWEI-wlan-radio-1/0] beacon disable
Warning: This configuration is recommended in SFN roaming scenarios. This action
 may cause service interruption. Continue? [Y/N]Y
Related Topics

cts delay

Function

The cts delay command sets a delay for RUs to respond to STAs with CTS packets.

The undo cts delay command deletes the delay configured for RUs to respond to STAs with CTS packets.

By default, RUs respond to STAs with CTS packets with no delay.

Format

cts delay delay-time

undo cts delay

Parameters

Parameter

Description

Value

delay-time

Specifies the delay time after which RUs respond to STAs with CTS packets.

The value is an integer that ranges from 1 to 255, in microseconds.

Views

AP radio view, AP group radio view

Default Level

2: Configuration level

Usage Guidelines

After the undo cts disable command is executed to enable RUs to respond to STAs with CTS packets, you can configure a response delay. When multiple RUs respond to STAs with CTS packets, you can configure the delay for some RUs to prevent conflicts.

Example

# Set the delay for RUs to respond to STAs with CTS packets to 60 microseconds.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ap-id 1
[HUAWEI-wlan-ap-1] radio 0
[HUAWEI-wlan-radio-1/0] undo cts disable
[HUAWEI-wlan-radio-1/0] cts delay 60

cts disable

Function

The cts disable command disables RUs from responding to STAs with CTS packets.

The undo cts disable command enables RUs to respond to STAs with CTS packets.

By default, RUs are enabled to respond to STAs with CTS packets.

Format

cts disable

undo cts disable

Parameters

None

Views

AP radio view, AP group radio view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To prevent CTS conflicts in scenarios with densely deployed RUs, you can run the cts disable command to disable some RUs from responding to STAs with CTS packets. This configuration is recommended on a network enabled with agile distributed SFN roaming. In other scenarios, the default configuration is recommended.

Precautions

Disabling RUs from responding to STAs with CTS packets may cause STAs to go offline due to a failure to receive CTS packets.

Example

# Disable RUs from responding to STAs with CTS packets.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ap-id 1
[HUAWEI-wlan-ap-1] radio 0
[HUAWEI-wlan-radio-1/0] cts disable
Warning: This configuration is recommended in SFN roaming scenarios. This action
 may cause service interruption. Continue? [Y/N]y
Related Topics

display station roam-statistics

Function

The display station roam-statistics command displays STA roaming statistics.

Format

display station roam-statistics [ ap-name ap-name | ap-id ap-id ]

Parameters

Parameter

Description

Value

ap-name ap-name

Displays statistics about STAs associated with the RU with a specified name.

Only cloud central APs support this parameter.

The RU name must exist.

ap-id ap-id

Displays statistics about STAs associated with the RU with a specified ID.

Only cloud central APs support this parameter.

The RU ID must exist.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run the display station roam-statistics command to view STA roaming statistics.

  • If no parameter is specified, roaming statistics about all STAs associated with a central AP is displayed.
  • If an RU name or ID is specified, roaming statistics about all STAs associated with the RU is displayed.

Example

# Display roaming statistics about all STAs.

<HUAWEI> display station roam-statistics
----------------------------------------------------------------------------------
 Online stations                                                     :0
 Online roaming stations                                             :0
----------------------------------------------------------------------------------
Table 11-122  Description of the display station roam-statistics command output

Item

Description

Online stations

Number of online STAs.

Online roaming stations

Number of online roaming STAs.

# Display roaming statistics about STAs associated with a specified AP.
<HUAWEI> display station roam-statistics ap-name N1-2
------------------------------------------------------------------------------
 Online stations                                                     :0
 Online roaming stations                                             :0
------------------------------------------------------------------------------
Table 11-123  Description of the display station roam-statistics ap-name command output

Item

Description

Online stations

Number of online STAs.

Online roaming stations

Number of online roaming STAs.

display station roam-track

Function

The display station roam-track command displays the roaming track of a STA.

Format

display station roam-track sta-mac mac-address

Parameters

Parameter

Description

Value

sta-mac mac-address

Specifies the MAC address of a specified STA.

The value is in H-H-H format. An H is a hexadecimal number of four digits.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

During the roaming process of a STA, the AC records the STA's roaming track (that is, information about the APs that the STA connects to). You can run the display station roam-track command to view the roaming track of the STA.

Example

# Display the roaming track of the STA with the MAC address 0011-43c7-d73e.

<HUAWEI> display station roam-track sta-mac 0011-43c7-d73e
Access SSID:huawei
Rx/Tx:link receive rate/link transmit rate(Mbps)
c:PMK Cache Roam r:802.11r Roam s:Same Frequency Network
------------------------------------------------------------------------------
L2/L3           AC IP                  AP name              Radio ID
BSSID           TIME                   In/Out RSSI          Out Rx/Tx
------------------------------------------------------------------------------
--              192.168.109.1          Huawei1              1
dcd2-fc9d-0bb0  2015/01/12 16:52:58   -51/-48              46/13
L2              192.168.109.1          Huawei2              1
e468-a34d-afb0  2015/01/12 16:55:45   -58/-                -/-
------------------------------------------------------------------------------
Number: 1
Table 11-124  Description of the display station roam-track command output

Item

Description

Access SSID

SSID associated with a STA.

Rx/Tx

Negotiated rate between the STA and AP.

L2/L3

Roaming mode.

Suffix description:

  • c: PMK cache roam.
  • r: 802.11r roam.
  • s: Agile distributed single frequency network (SFN) roaming.

AC IP

IP address of an AC that the STA has associated with.

AP name

Name of an AP that the STA has associated with.

Radio ID

ID of a radio that the STA has associated with.

BSSID

BSSID of an AP that the STA has associated with.

TIME

Time duration when the STA has associated with an AP.

In/Out RSSI

RSSI of the AP that the STA has associated with and RSSI of the AP away from which the STA has left.

Out Rx/Tx

Negotiated rate of the STA when it disconnects from an AP.

Number

Number of STA roaming tracks.

dot11r enable

Function

The dot1r enable command enables 802.11.1r.

The undo dot11r enable command disables 802.11.1r.

By default, 802.11r is disabled.

Format

dot11r enable [ reassociate-timeout time ]

undo dot11r enable

Parameters

Parameter Description Value
reassociate-timeout time

STA re-association timeout period.

The value is an integer that ranges from 1 to 10, in seconds. The default value is 1.

Views

SSID profile view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

During roaming, the STA needs to be re-authenticated and re-negotiate a key, so services are interrupted for a short period of time. You can enable 802.11r to reduce the number of information exchanges during roaming, thus reducing the network delay.

Precautions

  • IEEE 802.11r supports open system, WPA2-PSK, and 802.1x authentication.
  • The 802.11r fast roaming and Protected Management Frame (PMF) functions are mutually exclusive. If the 802.11r fast roaming function has been configured, the PMF function cannot be configured.

Example

# Enable 802.11r.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] ssid-profile name ssid1
[HUAWEI-wlan-ssid-prof-ssid1] dot11r enable

sfn-roam enable

Function

The sfn-roam enable command enables agile distributed SFN roaming.

The undo sfn-roam enable command disables agile distributed SFN roaming.

By default, agile distributed SFN roaming is disabled.

Format

sfn-roam enable

undo sfn-roam enable

Parameters

None

Views

VAP profile view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In the agile distributed Wi-Fi networking, some scenarios require high network connection stability, such as healthcare scenarios. In this case, you can run the sfn-roam enable command to enable agile distributed SFN roaming. All RUs are deployed to work on the same channel and use the same BSSID for communicating with STAs. When the STAs move within the signal coverage of the same SSID, they are not aware of roaming and services are not interrupted.

Precautions

  • Network planning precautions:

    • Agile distributed SFN roaming is supported only by the AD9430DN-12 (including matching RUs) and AD9430DN-24 (including matching RUs). RUs support agile distributed SFN roaming in the following combination modes:

      • Between the R230D and R240D (Note: Only the 2.4 GHz radio of the R230D and R240D supports agile distributed SFN roaming, and the 5 GHz radio does not support.)
      • Among the R250D, R250D-E, and R450D
    • For the central AP, after agile distributed SFN roaming is enabled, the total number of agile distributed SFN roaming STAs on a single frequency band (2.4 GHz or 5 GHz) of all RUs does not exceed 128, and that of STAs associated with other VAPs on the same band does not exceed 128.

    • After agile distributed SFN roaming is enabled, configure all RUs to work on the same channel. When agile distributed SFN roaming is enabled on the 5 GHz frequency band, configure non-radar channels.

    • RUs involved in roaming must be associated with the same central AP but do not support agile distributed SFN roaming between central APs.

    • Inter-RU roaming is Layer 2 roaming within a central AP. Agile distributed SFN roaming is not performed on Layer 3.

  • Configuration precautions:

    • When agile distributed SFN roaming is enabled for both the 2.4 GHz and 5 GHz radios, it is recommended that different SSIDs be used. Otherwise, the radio switchover may occur, affecting user experience.

    • Agile distributed SFN roaming can be enabled only on one VAP of a radio. If multiple VAPs are configured on a radio, it is recommended that the total VAP rate limit on all VAPs with agile distributed SFN roaming disabled be set to 5 Mbit/s.

    • Radios enabled with agile distributed SFN roaming do not support channel scanning, channel calibration, or smart roaming.

    • Agile distributed SFN roaming can be configured based only on AP groups but not based on APs.

    • RUs involved in agile distributed SFN roaming need to have the following items configured the same:

      • SSID

      • VAP profile and VAP ID

      • Security policy. Agile distributed SFN roaming supports these encryption modes: WPA+PSK, WPA2+PSK, WPA-WPA2+PSK, WPA+802.1X (EAP authentication), WPA2+802.1X (EAP authentication), WPA-WPA2+802.1X (EAP authentication), and Portal+PSK.

Example

# Enable agile distributed SFN roaming.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] vap-profile name vap1
[HUAWEI-wlan-vap-prof-vap1] sfn-roam enable
Warning: This feature requires that radios work on the same channel. Enabling th
is feature will disable the channel calibration, channel scanning, and smart roa
ming functions on the AP and disconnect STAs connected to the VAP. Open, WEP, an
d WAPI encryption modes are not supported. The PSK + WPA2 mode is recommended. A
 radio allows SFN to be enabled only for one VAP. Continue?[Y/N]:y

sfn-roam report-interval

Function

The sfn-roam report-interval command sets an interval at which RUs report STA RSSIs.

The undo sfn-roam report-interval command restores the default interval at which RUs report STA RSSIs.

By default, RUs report STA RSSIs to the central AP at an interval of 400 milliseconds.

Format

sfn-roam report-interval report-interval-value

undo sfn-roam report-interval

Parameters

Parameter

Description

Value

report-interval-value

Specifies an interval for RUs to report STA RSSIs.

The value is an integer that ranges from 200 to 1000, in milliseconds.

Views

RRM profile view

Default Level

2: Configuration level

Usage Guidelines

The interval at which RUs report STA RSSIs helps you adjust the roaming sensitivity. A shorter interval indicates a higher sensitivity. A large value causes the slow roaming switchover, affecting user experience. A small value causes frequent roaming switchovers, affecting system performance. This interval must be smaller than the decision period for agile distributed SFN roaming.

Example

# Set the interval for RUs to report the STA RSSI to 500 milliseconds.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] rrm-profile name wlan-rrm
[HUAWEI-wlan-rrm-prof-wlan-rrm] sfn-roam report-interval 500

sfn-roam roam-check better-times

Function

The sfn-roam roam-check better-times command sets the number of times the RSSI of agile distributed SFN roaming RUs is higher than that of the local RU.

The undo sfn-roam roam-check better-times command restores the default number of times the RSSI of agile distributed SFN roaming RUs is higher than that of the local RU.

By default, the number of times the RSSI of agile distributed SFN roaming RUs is higher than that of the local RU is 2.

Format

sfn-roam roam-check better-times better-times

undo sfn-roam roam-check better-times

Parameters

Parameter

Description

Value

better-times

Specifies the number of times the RSSI of agile distributed SFN roaming RUs is higher than that of the local RU.

The value is an integer that ranges from 1 to 32.

Views

RRM profile view

Default Level

2: Configuration level

Usage Guidelines

You can adjust the roaming sensitivity by setting the number of times the RSSI of agile distributed SFN roaming RUs is higher than that of the local RU. A roaming switchover occurs when the RSSI of a surrounding RU is higher than that of the local RU for the specified times within the roaming decision period. A large value causes the slow roaming switchover, affecting user experience. A small value causes frequent roaming switchovers, affecting system performance.

Example

# Set the number of times the RSSI of agile distributed SFN roaming RUs is higher than that of the local RU to 5.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] rrm-profile name wlan-rrm
[HUAWEI-wlan-rrm-prof-wlan-rrm] sfn-roam roam-check better-times 5
Related Topics

sfn-roam roam-check check-interval

Function

The sfn-roam roam-check check-interval command sets the decision period for agile distributed SFN roaming.

The undo sfn-roam roam-check check-interval command restores the default decision period for agile distributed SFN roaming.

The default decision period for agile distributed SFN roaming is 700 milliseconds.

Format

sfn-roam roam-check check-interval check-interval-value

undo sfn-roam roam-check check-interval

Parameters

Parameter

Description

Value

check-interval-value

Specifies the decision period for agile distributed SFN roaming.

The value is an integer that ranges from 300 to 1500, in milliseconds.

Views

RRM profile view

Default Level

2: Configuration level

Usage Guidelines

The decision period for agile distributed SFN roaming helps you adjust the roaming sensitivity. A shorter period indicates a higher sensitivity. A large value causes the slow roaming switchover, affecting user experience. A small value causes frequent roaming switchovers, affecting system performance. The default value is recommended. Ensure that the interval at which RUs report STA RSSIs is smaller than the decision period for agile distributed SFN roaming.

Example

# Set the default decision period for agile distributed SFN roaming to 800 milliseconds.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] rrm-profile name wlan-rrm
[HUAWEI-wlan-rrm-prof-wlan-rrm] sfn-roam roam-check check-interval 800

sfn-roam roam-check gap-rssi

Function

The sfn-roam roam-check gap-rssi command sets the RSSI gap for agile distributed SFN roaming RUs.

The undo sfn-roam roam-check gap-rssi command restores the default RSSI gap for agile distributed SFN roaming RUs.

The default RSSI gap for agile distributed SFN roaming RUs is 6 dB.

Format

sfn-roam roam-check gap-rssi gap-rssi

undo sfn-roam roam-check gap-rssi

Parameters

Parameter

Description

Value

gap-rssi

Specifies the RSSI gap for agile distributed SFN roaming RUs.

The value is an integer that ranges from 1 to 32, in dB.

Views

RRM profile view

Default Level

2: Configuration level

Usage Guidelines

The RSSI gap for agile distributed SFN roaming RUs helps you adjust the roaming sensitivity. A roaming switchover occurs when the RSSI gap between the local RU and a surrounding RU reaches the specified value. A large value causes the slow roaming switchover, affecting user experience. A small value causes frequent roaming switchovers, affecting system performance.

Example

# Set the RSSI gap for agile distributed SFN roaming RUs to 10 dB.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] rrm-profile name wlan-rrm
[HUAWEI-wlan-rrm-prof-wlan-rrm] sfn-roam roam-check gap-rssi 10
Related Topics

sfn-roam roam-check high-threshold

Function

The sfn-roam roam-check high-threshold command sets the upper RSSI threshold for agile distributed SFN roaming.

The undo sfn-roam roam-check high-threshold command restores the default upper RSSI threshold for agile distributed SFN roaming.

By default, the upper RSSI threshold for agile distributed SFN roaming is -55 dBm.

Format

sfn-roam roam-check high-threshold high-threshold-value

undo sfn-roam roam-check high-threshold

Parameters

Parameter

Description

Value

high-threshold-value

Specifies the upper RSSI threshold for agile distributed SFN roaming.

The value is an integer that ranges from -60 to -45, in dBm.

Views

RRM profile view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

You can set the STA RSSI threshold to control the sensitivity of agile distributed SFN roaming and prevent STAs from frequently roaming at radio borders of RUs. A roaming switchover occurs when the total number of records in the following conditions exceeds the value specified by the sfn-roam roam-check better-times command:
  • When the HAP detects that the STA RSSI is lower than the lower threshold: The central AP makes a record if the SNR of the FAP is higher than that of the HAP.
  • When the HAP detects that the STA RSSI is between the upper and lower thresholds: The central AP makes a record if the SNR of the FAP is 3 dB higher than that of the HAP.
  • When the HAP detects that the STA RSSI is higher than the upper threshold: The central AP makes a record if the SNR of the FAP is 5 dB higher than that of the HAP.

Precautions

The lower RSSI threshold for agile distributed SFN roaming must be no higher than the upper threshold.

Example

# Set the upper RSSI threshold for agile distributed SFN roaming to -50 dBm.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] rrm-profile name wlan-rrm
[HUAWEI-wlan-rrm-prof-wlan-rrm] sfn-roam roam-check high-threshold -50

sfn-roam roam-check low-threshold

Function

The sfn-roam roam-check low-threshold command sets the lower RSSI threshold for agile distributed SFN roaming.

The undo sfn-roam roam-check low-threshold command restores the default lower RSSI threshold for agile distributed SFN roaming.

By default, the lower RSSI threshold for agile distributed SFN roaming is -60 dBm.

Format

sfn-roam roam-check low-threshold low-threshold-value

undo sfn-roam roam-check low-threshold

Parameters

Parameter

Description

Value

low-threshold-value

Specifies the lower RSSI threshold for agile distributed SFN roaming.

The value is an integer that ranges from -70 to -55, in dBm.

Views

RRM profile view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

You can set the STA RSSI threshold to control the sensitivity of agile distributed SFN roaming and prevent STAs from frequently roaming at radio borders of RUs. A roaming switchover occurs when the total number of records in the following conditions exceeds the value specified by the sfn-roam roam-check better-times command:
  • When the HAP detects that the STA RSSI is lower than the lower threshold: The central AP makes a record if the SNR of the FAP is higher than that of the HAP.
  • When the HAP detects that the STA RSSI is between the upper and lower thresholds: The central AP makes a record if the SNR of the FAP is 3 dB higher than that of the HAP.
  • When the HAP detects that the STA RSSI is higher than the upper threshold: The central AP makes a record if the SNR of the FAP is 5 dB higher than that of the HAP.

Precautions

The lower RSSI threshold for agile distributed SFN roaming must be no higher than the upper threshold.

Example

# Set the lower RSSI threshold for agile distributed SFN roaming to -65 dBm.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] rrm-profile name wlan-rrm
[HUAWEI-wlan-rrm-prof-wlan-rrm] sfn-roam roam-check low-threshold -65

sfn-roam roam-check rssi-accumulate

Function

The sfn-roam roam-check rssi-accumulate command sets the cumulative RSSI change threshold for agile distributed SFN roaming STAs.

The undo sfn-roam roam-check rssi-accumulate command restores the default cumulative RSSI change threshold for agile distributed SFN roaming STAs.

By default, the cumulative RSSI change threshold of agile distributed SFN roaming STAs is 8 dB.

Format

sfn-roam roam-check rssi-accumulate threshold rssi-accumulate-value

undo sfn-roam roam-check rssi-accumulate

Parameters

Parameter

Description

Value

threshold rssi-accumulate-value

Specifies the cumulative RSSI change threshold for agile distributed SFN roaming STAs.

The value is an integer that ranges from 1 to 32, in dB.

Views

RRM profile view

Default Level

2: Configuration level

Usage Guidelines

The cumulative RSSI change threshold of agile distributed SFN roaming STAs helps you adjust the roaming sensitivity. A roaming switchover occurs when the cumulative RSSI change value reaches the specified threshold. A large value causes the slow roaming switchover, affecting user experience. A small value causes frequent roaming switchovers, affecting system performance.

Example

# Set the cumulative RSSI change threshold for agile distributed SFN roaming STAs to 10 dB.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] rrm-profile name wlan-rrm
[HUAWEI-wlan-rrm-prof-wlan-rrm] sfn-roam roam-check rssi-accumulate threshold 10
Related Topics

sfn-roam roam-check sta-holding times

Function

The sfn-roam roam-check sta-holding times command sets the number of STA holding times for agile distributed SFN roaming.

The undo sfn-roam roam-check sta-holding times command restores the default number of STA holding times for agile distributed SFN roaming.

By default, the number of STA holding times for agile distributed SFN roaming is 3.

Format

sfn-roam roam-check sta-holding times sta-holding-times

undo sfn-roam roam-check sta-holding times

Parameters

Parameter

Description

Value

sta-holding-times

Specifies the number of STA holding times for agile distributed SFN roaming.

The value is an integer that ranges from 1 to 32.

Views

RRM profile view

Default Level

2: Configuration level

Usage Guidelines

To prevent frequent agile distributed SFN roaming switchovers, you can specify a proper number of STA holding times. A large value causes the slow roaming switchover, affecting user experience. A small value causes frequent roaming switchovers, affecting system performance.

Example

# Set the number of STA holding times for agile distributed SFN roaming to 5.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] rrm-profile name wlan-rrm
[HUAWEI-wlan-rrm-prof-wlan-rrm] sfn-roam roam-check sta-holding times 5
Related Topics
Translation
Download
Updated: 2019-10-18

Document ID: EDOC1000178288

Views: 26600

Downloads: 109

Average rating:
This Document Applies to these Products
Related Version
Related Documents
Share
Previous Next