02-WLAN

HomeSupportResource CenterH3C Access Controllers Command References(E5208P03 E5215P01 R5215P01)-6W10202-WLAN
13-WLAN high availability commands
Title Size Download
13-WLAN high availability commands 63.99 KB

WLAN high availability commands

Dual-link backup commands

backup-ac

Use backup-ac to specify a backup AC.

Use undo backup-ac to restore the default.

Syntax

backup-ac { ip ipv4-address | ipv6 ipv6-address }

undo backup-ac { ip | ipv6 }

Default

In AP view, an AP uses the configuration in AP group view.

In AP group view, no backup AC is specified.

Views

AP view

AP group view

Predefined user roles

network-admin

Parameters

ip ip-address: Specifies a backup AC by its IPv4 address.

ipv6 ipv6-address: Specifies a backup AC by its IPv6 address.

Usage guidelines

You can specify only one IPv4 address or one IPv6 address in either AP view or AP group view.

The configuration in AP view takes precedence over the configuration in AP group view. If you execute the undo command in AP view, the backup AC specified in AP group view will be used.

Executing the undo command also terminates the backup CAPWAP tunnel.

Examples

# Specify a backup AC for AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

[Sysname-wlan-ap-ap1] backup-ac ip 192.168.1.1

# Specify a backup AC for AP group group1.

<Sysname> system-view

[Sysname] wlan ap-group 1

[Sysname-wlan-ap-group-1] backup-ac ip 192.168.1.1

display wlan ap backup dual-link

Use display wlan ap backup dual-link to display dual-link backup state information for all APs or the specified AP.

Syntax

display wlan ap backup dual-link { all | ap-name name ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

all: Specifies all APs.

ap-name name: Specifies an AP by its name, a case-insensitive string of 1 to 63 characters. The string can contain letters, digits, underscores (_), dots (.), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).

Examples

# Display backup state information for AP ap1.

<Sysname> display wlan ap backup dual-link ap-name ap1

Backup mode: Dual-link

Ap name                         State          VSRP instance

ap1                             Idle           Not configured

# Display backup state information for all APs.

<Sysname> display wlan ap backup dual-link all

Backup mode: Dual-link

  AP name           State                VSRP instance

  ap1               Idle                 Not configured

  ap2               Master-Init          1

  ap3               Master-Batch         2

  ap4               Idle                 Not configured

  ap5               Master-Run           instance1

  ap6               Idle                 Not configured

  ap7               Backup-Init          instance2

  ap8               Idle                 Not configured

Table 1 Command output

Field

Description

Backup mode

Backup mode: Dual-link.

State

Backup state:

·     Idle—The AP is offline.

·     Master-Init—The AP is online and the AC is the master AC. The backup AC has not started to backup data.

·     Master-Batch—The AP is online and the AC is the master AC. Data backup is in process.

·     Master-Run—The AP is online and the AC is the master AC. Data backup has completed.

·     Backup-Init—The AP is online and the AC is the backup AC. The backup AC has not started to backup data.

·     Backup-Batch—The AP is online and the AC is the backup AC. Data backup is in process.

·     Backup-Run—The AP is online and the AC is the backup AC. Data backup has completed.

·     Backup-to-Master—The backup AC is switching to the master AC.

VSRP instance

VSRP instance associated with the AC interface. This field displays Not configured if no VSRP instance is associated with the AC interface.

 

wlan backup-mode dual-link

Use wlan backup-mode dual-link to enable dual-link backup.

Use undo wlan backup-mode to disable dual-link backup.

Syntax

wlan backup-mode dual-link

undo wlan backup-mode

Default

Dual-link backup is disabled.

Views

System view

Predefined user roles

network-admin

Usage guidelines

For successful data backup between two ACs in a VSRP group, make sure the ACs are both enabled with dual-link backup.

If you disable the dual-link backup feature on an AC during a backup process, the process will be terminated.

Examples

# Enable dual-link backup.

<Sysname> system-view

[Sysname] wlan backup-mode dual-link

Related commands

backup-ac

wlan tunnel-preempt

Use wlan tunnel-preempt enable to enable master CAPWAP tunnel preemption.

Use wlan tunnel-preempt disable to disable master CAPWAP tunnel preemption.

Use undo wlan tunnel-preempt to restore the default.

Syntax

wlan tunnel-preempt { disable | enable }

undo wlan tunnel-preempt

Default

In AP view, an AP uses the configuration in AP group view.

In AP group view, an AP uses the configuration in global configuration view.

In global configuration view, master CAPWAP tunnel preemption is disabled.

Views

AP view

AP group view

Global configuration view

Predefined user roles

network-admin

Usage guidelines

When this feature is enabled, the backup CAPWAP tunnel will become the master tunnel if the backup AC has higher AP connection priority than the master AC.

When this feature is disabled, the backup CAPWAP tunnel becomes the master tunnel only when the master AC fails.

Examples

# Enable master CAPWAP tunnel preemption for AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

[Sysname-ap-ap1] wlan tunnel-preempt enable

# Enable master CAPWAP tunnel preemption for APs in AP group group1.

<Sysname> system-view

[Sysname] wlan ap-group group1

[Sysname-wlan-ap-group-group1] wlan tunnel-preempt enable

# Enable master CAPWAP tunnel preemption globally.

<Sysname> system-view

[Sysname] wlan global-configuration

[Sysname-wlan-global-configuration] wlan tunnel-preempt enable

wlan vsrp-instance

Use wlan vsrp-instance to associate an interface with a VSRP instance.

Use undo wlan vsrp-instance to disassociate a VSRP instance from an interface.

Syntax

wlan vsrp-instance instance-name

undo wlan vsrp-instance

Default

No VSRP instance is associated with an interface.

Views

Layer 3 interface view

VLAN interface view

Predefined user roles

network-admin

Parameters

instance-name: Specifies a VSRP instance by its name, a case-sensitive string of 1 to 31 characters. The instance must exist.

Usage guidelines

Before you execute this command, create a VSRP instance and associate the VSRP instance with a VSRP peer.

A VSRP instance can be associated with multiple interfaces, and all the associations take effect and are independent of each other.

For two ACs to establish a data backup channel, associate the same VSRP instance with the interfaces on the ACs. The ACs back up APs that come online only on the associated interfaces.

Executing the undo command also terminates the data channel between the two ACs.

Examples

# Associate VLAN-interface 1 with VSRP instance instance1.

<Sysname> system-view

[Sysname] interface vlan-interface 1

[Sysname-Vlan-interface1] wlan vsrp-instance instance1

AP load balancing commands

The following matrix shows the feature and hardware compatibility:

 

Hardware series

Model

AP load balancing compatibility

WX1800H series

WX1804H

WX1810H

WX1820H

No

WX2500H series

WX2510H

WX2540H

WX2560H

No

WX3000H series

WX3010H

WX3010H-L

WX3010H-X

WX3024H

WX3024H-L

No

WX3500H series

WX3508H

WX3510H

WX3520H

WX3540H

Yes

WX5500E series

WX5510E

WX5540E

Yes

WX5500H series

WX5540H

WX5560H

WX5580H

Yes

Access controller modules

EWPXM1MAC0

EWPXM1WCME0

EWPXM2WCMD0F

LSQM1WCMX20

LSQM1WCMX40

LSUM1WCME0

LSUM1WCMX20RT

LSUM1WCMX40RT

Yes

 

display wlan ap backup multislot

Use display wlan ap-backup multislot to display AP load balancing status for all IRF member ACs.

Syntax

display wlan ap backup multislot

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display AP load balancing status for all IRF member ACs.

<Sysname> display wlan ap backup multislot

Borad Status

 

Total number of slots: 2

 Slot ID              State

 1                      active-backup

 2                      active-only

Table 2 Command output

Field

Description

Total number of slots

Number of IRF member ACs.

Slot ID

IRF member ID of an AC.

State

AP load balancing and backup status:

·     active-backup—The AC is an active AC and backs up AP information.

·     active-only—The AC is an active AC only.

·     backup-only—The AC only backs up AP information.

·     inactive—The AC is not active AC and does not back up AP information.

 

wlan ap-backup active count

Use wlan ap-backup active count to set the number of active ACs in an IRF fabric.

Use undo wlan ap-backup active count to restore the default.

Syntax

wlan ap-backup active count number

undo wlan ap-backup active count

Default

The number of active ACs is 1. Only the master AC can act as an active AC to establish CAPWAP tunnels with APs.

Views

System view

Predefined user roles

network-admin

Parameters

number: Specifies the number of active ACs. The value range varies by device model.

Usage guidelines

After you set the number of active ACs, the master AC will select an active AC among the non-active ACs according to the order in which they are saved to the AC information table. An AC has higher priority if its information is saved earlier.

When an active AC fails, the master AC randomly selects a new active AC from non-active ACs.

Examples

# Set the number of active ACs to 2.

<Sysname> system-view

[Sysname] wlan ap-backup active count 2

wlan ap-backup load-balance

Use wlan ap-backup load-balance to set the threshold and gap threshold for AP load balancing.

Use undo wlan ap-backup load-balance to restore the default.

Syntax

wlan ap-backup load-balance threshold threshold-value gap gap-value

undo wlan ap-backup load-balance threshold

Default

The AP load-balancing threshold is the maximum number of APs supported by the current AC. The gap threshold is a quarter of APs associated with the directly connected AC.

Views

System view

Predefined user roles

network-admin

Parameters

threshold threshold-value: Specifies the threshold in the range of 0 to 65534 for AP load balancing. The threshold-value argument represents the number of APs associated with the directly connected AC.

gap gap-value: Specifies the gap threshold for AP load balancing in percentage. The value range for the gap-value argument is 0 to 100. The gap-value argument represents the percentage of the AP number difference between the directly connected AC and any other active AC to the AP number on the directly connected AC.

Usage guidelines

This command specifies the threshold and gap threshold used in the load balancing algorithm. In an IRF fabric, the master AC uses the LB algorithm to select an AC from active ACs to establish a CAPWAP tunnel with a requesting AP. For information about the LB algorithm, see WLAN high availability in WLAN Configuration Guide.

Examples

# Set the threshold to 3 and the gap threshold to 20% for AP load balancing.

<Sysname> system-view

[Sysname] wlan ap-backup load-balance threshold 3 gap 20

WLAN uplink detection commands

wlan uplink track

Use wlan uplink track to associate a track entry with WLAN uplink detection.

Use undo wlan uplink track to restore the default.

Syntax

wlan uplink track track-entry-number

undo wlan uplink track

Default

WLAN uplink detection is not associated with any track entry.

Views

System view

Predefined user roles

network-admin

Parameters

track-entry-number: Specifies a track entry ID in the range of 1 to 1024.

Usage guidelines

This command enables the AC to adjust radio state based on the uplink state associated with a track entry. When the track entry is in Negative state, the AC disables radios of all connected APs. When the track entry is in Positive state, the AC enables radios of all connected APs.

If you execute this command multiple times, the most recent configuration takes effect.

Examples

# Associate track entry 1 with WLAN uplink detection.

<Sysname> system-view

[Sysname] wlan uplink track 1