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

WLAN Reliability Commands

Command Support

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

ac protect alarm-restrain enable

Function

The ac protect alarm-restrain enable command enables AP Fault alarm suppression.

The undo ac protect alarm-restrain enable command disables AP Fault alarm suppression.

By default, AP Fault alarm suppression is disabled.

Format

ac protect alarm-restrain enable

undo ac protect alarm-restrain enable

Parameters

None

Views

WLAN view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In dual-link cold backup scenarios, after an AP becomes Fault on the active AC, switches to the standby AC, and works properly, the active AC generates an AP Fault alarm. If AP Fault alarms are not needed in this case, you can run the ac protect alarm-restrain enable command to enable AP Fault alarm suppression.

After AP Fault alarm suppression is enabled, the active and standby ACs generate AP Fault alarms only when both ACs detect that an AP becomes faulty on them.

Precautions

The active and standby ACs notify each other of the AP status by exchanging packets. If communication between the ACs fails, AP Fault alarm suppression cannot take effect.

AP Fault alarm suppression can only suppress the AP Fault alarms caused by heartbeat timeout. If an AP is deleted or restarted using the undo ap or ap-reset command, the alarms cannot be suppressed.

Example

# Enable AP Fault alarm suppression.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ac protect alarm-restrain enable
Related Topics

ac protect cold-backup kickoff-station

Function

The ac protect cold-backup kickoff-station command enables the function of disconnecting STAs in open system authentication mode when an active/standby switchover is implemented between ACs that have dual-link cold backup configured.

The undo ac protect cold-backup kickoff-station command restores the default setting.

By default, STAs using open system authentication remain connected to APs when an active/standby AC switchover is implemented.

Format

ac protect cold-backup kickoff-station

undo ac protect cold-backup kickoff-station

Parameters

None

Views

WLAN view

Default Level

2: Configuration level

Usage Guidelines

An active/standby switchover between two ACs that have dual-link cold backup configured causes a short service interruption.
  • STAs not using open system authentication are disconnected from APs and need to go online again after the active/standby switchover.
  • By default, STAs using open system authentication remain connected to APs and do not need to go online again after the active/standby switchover. You can run the ac protect cold-backup kickoff-station command to configure the STAs to be disconnected when an active/standby AC switchover is implemented.

Example

# Enable the function of disconnecting STAs in open system authentication mode when an active/standby switchover is implemented between ACs that have dual-link cold backup configured.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] ac protect cold-backup kickoff-station
Related Topics

ac protect enable

Function

The ac protect enable command enables dual-link backup globally and disables N+1 backup.

The undo ac protect enable command disables dual-link backup globally and enables N+1 backup.

By default, dual-link backup is disabled globally, and N+1 backup is enabled.

Format

ac protect enable

undo ac protect enable

Parameters

None

Views

WLAN view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To ensure service stability, an AP needs to establish connections with two ACs. The two ACs work in active/standby mode. The active AC provides services for APs, whereas the standby AC is a backup to the active AC.

Follow-up Procedure

After dual-link backup or N+1 backup is enabled globally, configure the AC priority and standby AC IP address to implement dual-link backup or N+1 backup.

Precautions

Ensure that active and standby ACs deliver the same WLAN service configuration to an AP that connects to the two ACs.

Example

# Enable dual-link backup globally and disable N+1 backup.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ac protect enable
Warning: This operation maybe cause AP reset, continue?[Y/N]:y
Related Topics

ac protect priority

Function

The ac protect priority command configures the AC priority in the WLAN view.

The undo ac protect priority command restores the default AC priority in the WLAN view.

By default, the AC priority in the WLAN view is 0.

Format

ac protect priority priority

undo ac protect priority

Parameters

Parameter

Description

Value

priority

Specifies the AC priority.

The value is an integer that ranges from 0 to 7. A smaller value indicates a higher priority.

Views

WLAN view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When an AP goes online, ACs deliver their priorities to the AP. The AP selects the AC with a higher priority as the active AC and establishes a CAPWAP tunnel with the active AC.

To implement dual-link backup on all the APs connected to an AC, configure the AC priority and standby AC IP address in the WLAN view to reduce the configuration workload.

Precautions

If the AC priority is configured in the WLAN view and AP system profile view before an AP goes online, the AC priority configured in the AP system profile view is delivered to the AP. If no AC priority is configured in the AP system profile view, the AC priority configured in the WLAN view is delivered to the AP.

Example

# Set the AC priority to 3 in the WLAN view.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ac protect priority 3

ac protect protect-ac

Function

The ac protect protect-ac command configures the standby AC IP address in the WLAN view.

The undo ac protect protect-ac command restores the default standby AC IP address in the WLAN view.

By default, no standby AC IP address is configured in the WLAN view.

Format

ac protect protect-ac ip-address

undo ac protect protect-ac

Parameters

Parameter

Description

Value

ip-address

Specifies an IPv4 address for the standby AC.

The value is in dotted decimal notation.

Views

WLAN view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To implement dual-link backup on all the APs connected to an AC, configure the AC priority and standby AC IP address in the WLAN view to reduce the configuration workload.

Precautions

If standby AC IP addresses are configured in both the WLAN view and AP system profile view before an AP goes online, the standby AC IP address configured in the AP system profile view is delivered to an AP. If no standby AC IP address is configured in the AP system profile view, the standby AC IP address configured in the WLAN view is delivered to an AP. If no standby AC IP address is configured in the WLAN view, dual-link backup is disabled.

Example

# Set the standby AC IP address to 10.33.12.56 in the WLAN view.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ac protect protect-ac 10.33.12.56

ac protect restore disable

Function

The ac protect restore disable command disables global revertive switching.

The undo ac protect restore disable command enables global revertive switching.

By default, global revertive switching is enabled.

Format

ac protect restore disable

undo ac protect restore disable

Parameters

None.

Views

WLAN view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

AC1 is the active AC and AC2 is the standby AC. When the link between AC1 and an AP fails, AC2 takes the active role.

When the link between AC1 and the AP recovers, the AP detects that AC1 priority is higher than AC2 and instructs AC1 and AC2 to perform revertive switching. AC1 then becomes the active AC again.

Precautions

  • The undo wlan ac protect restore disable command must be used before an AP goes online and dual-link backup is implemented. In this way, the AC delivers the revertive switching configuration to the AP when the AP goes online.
  • If global revertive switching is disabled, traffic of an AP cannot be switched back to AC1 when the link between AC1 and the AP restores.
  • The command takes effect after an AP restart.

Example

# Disable global revertive switching.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ac protect restore disable
Related Topics

backup-access

Function

The backup-access command configures a backup AC IP address.

The undo backup-access command restores the default backup AC IP address.

By default, no backup AC IP address is configured.

Format

backup-access ip-address ip-address

undo backup-access

Parameters

Parameter

Description

Value

ip-address ip-address

Specifies an IPv4 address of the backup AC.

The value is in dotted decimal notation.

Views

AP system profile view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In AC backup scenarios, a backup AC IP address is configured so that APs can establish CAPWAP tunnels to the backup AC if they fail to establish CAPWAP tunnels to the primary AC.

Precautions

  • The configurations of primary-access and backup-access take effect only if both the commands are run to configure different IP addresses.
  • primary-access and backup-access cannot be configured with priority or protect-ac.
  • It is not recommended that primary-access and backup-access be configured with ac protect protect-ac or ac protect priority.
  • The configuration takes effect only after the AP is restarted.
  • The IP addresses specified by primary-access and backup-access must be configured the same as CAPWAP source IP addresses. If the CAPWAP source addresses have been translated using NAT, set the primary-access and backup-access IP addresses to the translated addresses.

Example

# Set the backup AC IP address to 10.33.12.78.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ap-system-profile name sys1
[HUAWEI-wlan-ap-system-prof-sys1] backup-access ip-address 10.33.12.78

display ac protect

Function

The display ac protect command displays AC dual-link backup configuration.

Format

display ac protect

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run this command to view AC dual-link backup configuration.

Example

# Display AC dual-link backup configuration.

<HUAWEI> display ac protect
------------------------------------------------------------
Protect state             : disable
Protect AC                : -
Priority                  : 0
Protect restore           : enable
Coldbackup kickoff station: disable
Alarm restrain            : disable
------------------------------------------------------------
Table 11-231  Description of the display ac protect command output
Item Description

Protect state

Whether global dual-link backup and N+1 backup are enabled.
  • disable: Global dual-link backup is disabled, and N+1 backup is enabled.
  • enable: Global dual-link backup is enabled, and N+1 backup is disabled.

To configure the parameter, run the ac protect enable command.

Protect AC

Standby AC IP address.

To configure the parameter, run the ac protect protect-ac command.

Priority

Priority of the local AC.

To configure the parameter, run the ac protect priority command.

Protect restore

Whether global revertive switching is enabled on the AC.

To configure the parameter, run the ac protect restore disable command.

Coldbackup kickoff station

Whether to enable the function of disconnecting STAs in open system authentication mode when an active/standby switchover is implemented between ACs that have dual-link cold backup configured.

To configure the parameter, run the ac protect cold-backup kickoff-station command.

Alarm restrain

Whether to enable AP fault alarm suppression.

To configure the parameter, run the ac protect alarm-restrain enable command.

primary-access

Function

The primary-access command configures a primary AC IP address.

The undo primary-access command restores the default primary AC IP address.

By default, no primary AC IP address is configured.

Format

primary-access ip-address ip-address

undo primary-access

Parameters

Parameter

Description

Value

ip-address ip-address

Specifies an IPv4 address of the primary AC.

The value is in dotted decimal notation.

Views

AP system profile view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In AC backup scenarios, a primary AC IP address is configured. When APs attempt to go online, they preferentially associate with the primary AC and establish CAPWAP tunnels.

Precautions

  • The configurations of primary-access and backup-access take effect only if both the commands are run to configure different IP addresses.
  • primary-access and backup-access cannot be configured with priority or protect-ac.
  • It is not recommended that primary-access and backup-access be configured with ac protect protect-ac or ac protect priority.
  • The configuration takes effect only after the AP is restarted.
  • The IP addresses specified by primary-access and backup-access must be configured the same as CAPWAP source IP addresses. If the CAPWAP source addresses have been translated using NAT, set the primary-access and backup-access IP addresses to the translated addresses.

Example

# Set the primary AC IP address to 10.33.12.56.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ap-system-profile name sys1
[HUAWEI-wlan-ap-system-prof-sys1] primary-access ip-address 10.33.12.56

priority

Function

The priority command sets the AC priority in the AP system profile view.

The undo priority command restores the AC priority to the default setting in the AP system profile view.

By default, no AC priority is configured in the AP system profile view.

Format

priority priority-level

undo priority

Parameters

Parameter

Description

Value

priority-level

Specifies the AC priority.

The value is an integer that ranges from 0 to 7. A smaller value indicates a higher priority.

Views

AP system profile view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When an AP goes online, ACs deliver their priorities to the AP. The AP selects the AC with the highest priority as the active AC and establishes a CAPWAP tunnel with the active AC.

Precautions

If the AC priority is configured in the WLAN view and AP system profile view before an AP goes online, the AC priority configured in the AP system profile view is delivered to the AP. If no AC priority is configured in the AP system profile view, the AC priority configured in the WLAN view is delivered to the AP.

If ACs deliver the same priorities to the AP, the AP selects the AC with the lowest AP load as the active AC. If both AC priorities and AP load are the same, the AP selects the AC with the lowest STA load as the active AC. If AC priorities, AP load, and STA load are the same, the AP selects the AC with the smallest IP address as the active AC to establish a CAPWAP tunnel. The AP or STA load equals the number of allowed APs or STAs minus the number of existing APs or STAs.

Example

# Set the AC priority to 3 in the AP system profile view.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ap-system-profile name ap-system1
[HUAWEI-wlan-ap-system-prof-ap-system1] priority 3

protect-ac

Function

The protect-ac command configures the standby AC's IP address in the AP system profile view.

The undo protect-ac command restores the standby AC's IP address to the default setting in the AP system profile view.

By default, no standby AC's IP address is configured in the AP system profile view.

Format

protect-ac ip-address ip-address

undo protect-ac

Parameters

Parameter

Description

Value

ip-address ip-address

Specifies an IPv4 address for the standby AC.

The value is in dotted decimal notation.

Views

AP system profile view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To connect an AP to two ACs (active and standby ACs) to implement dual-link backup, you can run the protect-ac command to configure the standby AC's IP address in the AP system profile view.

Precautions

If standby AC's IP addresses are configured in both the WLAN view and AP system profile view, the standby AC's IP address configured in the AP system profile view is delivered to an AP. If no standby AC's IP address is configured in the AP system profile view, the standby AC's IP address configured in the WLAN view is delivered to an AP.

Example

# Set the standby AC's IP address to 10.3.3.3 in the AP system profile view.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ap-system-profile name ap-system1
[HUAWEI-wlan-ap-system-prof-ap-system1] protect-ac ip-address 10.3.3.3
Translation
Download
Updated: 2019-10-18

Document ID: EDOC1000178288

Views: 28272

Downloads: 109

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