Login
- Table of Contents
- Related Documents
-
| Title | Size | Download |
|---|---|---|
| 01-WLAN high availability commands | 94.01 KB |
WLAN high availability commands
display wlan persistent-client
display wlan sync-configuration history
reset wlan sync-configuration history
wlan persistent-client reconnect
WLAN uplink detection commands
WLAN high availability commands
Dual-link backup commands
backup-ac
Use backup-ac to specify a backup AC.
Use undo backup-ac to remove the backup AC configuration.
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 WA6320
[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
client-persistence enable
Use client-persistence enable to enable client persistence.
Use undo client-persistence enable to restore the default.
Syntax
client-persistence enable
undo client-persistence enable
Default
Client persistence is disabled.
Views
Global configuration view
Predefined user roles
network-admin
Usage guidelines
In a dual-link network, when the backup AC becomes the master AC, it synchronizes all client entries with the master AC. During the synchronization, wireless clients will go offline simultaneously and it will take a long time for them to come online again. With this feature enabled, the backup AC synchronizes entries with the master AC slowly, allowing wireless clients to slowly go offline and come online, thereby keeping clients online. This function is supported only when the client data packet forwarding location is on the AP.
To use this feature together with portal authentication, configure MAC-based quick portal authentication for users to complete authentication without awareness.
Examples
# Enable client persistence.
<Sysname> system-view
[Sysname] wlan global-configuration
[Sysname-wlan-global-configuration] client-persistence enable
display wlan persistent-client
Use display wlan persistent-client to display information about clients kept online by client persistence.
Syntax
display wlan persistent-client
Views
Any view
Predefined user roles
network-admin
mdc-admin
Usage guidelines
APs report information about clients kept online by client persistence to the backup AC. You can use this method to view the information.
Examples
# Display information about clients kept online by client persistence.
<Sysname> display wlan persistent-client
Total number of persistent clients: 3
MAC address APID RadioID AID BSSID
000f-e265-6400 1 1 1 001c-f08f-f804
000f-e265-6401 2 1 1 001c-f0bf-9c92
84db-ac14-dd08 1 1 2 001c-f08f-f805
Table 1 Command output
|
Field |
Description |
|
Total number of persistent clients |
Total number of clients kept online by client persistence. |
|
MAC address |
Client MAC address. |
|
APID |
ID of the AP with which the client is associated. |
|
RadioID |
ID of the radio with which the client is associated. |
|
AID |
Unique identifier of the client. |
|
BSSID |
BSSID with which the client is associated. |
Related commands
client-persistence enable
reset wlan persistent-client
display wlan sync-configuration history
Use display wlan sync-configuration history to display the history of configuration synchronization between ACs in a dual-link backup system.
Syntax
display wlan sync-configuration history
Views
Any view
Predefined user roles
network-admin
network-operator
Usage guidelines
Perform this task to view the history of configuration synchronization between ACs in a dual-link system, including synchronization time, result, and failure reason.
The system can display up to ten synchronization records.
This command is supported only on the AC with the TM role.
Examples
# Display the history of configuration synchronization between ACs in a dual-link backup system.
<Sysname> display wlan sync-configuration history
Record Time From To Result Failure reason
01 2023-01-05 08:23:01 000f-e212-6103(TM) 000f-e212-6124 Success
02 2023-01-05 08:20:01 000f-e212-6103(TM) 000f-e212-6124 Failure File operation failed
Table 2 Command output
|
Field |
Description |
|
Record |
Record number. |
|
Time |
Time at which the synchronization operation was performed. |
|
From/To |
Source and destination of the synchronization operation. |
|
Result |
Operation result: · Success. · Failure. · In progress. |
|
Failure reason |
Failure reason: · File operation failed. · Config rollback failed. · NCM RPC request delivery failed. · NCM RPC request execution failed. · XML data parsing failed in NCM reply. · Failed to obtain TM VLAN1 IP. · Failed to calculate file MD5. · Others. |
Related commands
reset wlan sync-configuration history
wlan sync-configuration
reset wlan persistent-client
Use reset wlan persistent-client to clear clients kept online by client persistence.
Syntax
reset wlan persistent-client
Views
User view
Predefined user roles
network-admin
mdc-admin
Examples
# Clear clients kept online by client persistence.
<Sysname> reset wlan persistent-client
Related commands
client-persistence enable
reset wlan sync-configuration history
Use reset wlan sync-configuration history to clear the history of configuration synchronization between ACs in a dual-link backup system.
Syntax
reset wlan sync-configuration history
Views
User view
Predefined user roles
network-admin
Usage guidelines
This command is supported only on the AC with the TM role.
Examples
# Clear the history of configuration synchronization between ACs in a dual-link backup system.
<Sysname> reset wlan sync-configuration history
Related commands
display wlan sync-configuration history
wlan persistent-client reconnect
Use wlan persistent-client reconnect to configure delayed client reconnection for client persistence.
Syntax
wlan persistent-client reconnect delay delay-minutes period period-minutes
Views
System view
Predefined user roles
network-admin
Parameters
delay-minutes: Specifies the start time for deleting temporary data of wireless clients, in the range of 1 to 60 minutes.
period-minutes: Specifies the total duration of temporary data deletion for wireless clients, in the range of 1 to 2440 minutes.
Usage guidelines
With client persistence enabled, the backup AC uses temporary client data to ensure that clients do not disconnect during master/backup switchover. After the switchover, you must execute wlan persistent-client reconnect on the new master AC to log off clients in batches and delete their temporary data. After the clients come online again, the new master AC regenerates normal client data.
Examples
# Set a delay of 1 minute before starting to batch delete temporary data of wireless clients, and complete the deletion of all temporary data within 40 minutes.
<Sysname> system-view
[Sysname] wlan persistent-client reconnect delay 1 period 40
wlan sync-configuration
Use wlan sync-configuration to configure synchronizing WLAN configuration between ACs in a dual-link backup system.
Syntax
wlan sync-configuration { from | to } peer-ac mac-address
Views
System view
Predefined user roles
network-admin
Parameters
from: Synchronizes WLAN configuration on the peer AC to the current AC.
to: Synchronizes WLAN configuration on the current AC to the peer AC.
peer-ac mac-address: Specifies the MAC address of the peer AC, in the H-H-H format.
Usage guidelines
Application scenarios
As a best practice to ensure configuration consistency between the two ACs in a dual-link backup system, configure WLAN settings on the AC with the TM role and then use this feature to synchronize the WLAN settings to the AC with the TC role.
WLAN settings includes settings in AP view, AP group view, global configuration view, radio view, an AP group's radio view, and service template view, as well as settings related to authentication.
The following conditions might occur if you enable this feature:
· When the two ACs have the same WLAN settings, WLAN configuration synchronization is not performed.
· When the two ACs have different WLAN settings, the system generates a diff file named wlan_cfgsync.diff on the AC with the TM role and then automatically performs configuration synchronization. To view the WLAN configuration differences between the two ACs, use the more command.
Restrictions and guidelines
To use this feature, first set up a SmartMC network. This command is supported only on the AC with the TM role.
Examples
# Synchronize the WLAN configuration on the current AC to the peer AC in a dual-link backup system.
<Sysname> system-view
[Sysname] wlan sync-configuration to peer-ac 000f-e212-6103
This operation will change the peer AC’s running configuration. Are you sure you want to continue? [Y/N]:Y
Please wait …
Related commands
wlan sync-configuration check
wlan sync-configuration check
Use wlan sync-configuration check to trigger consistency check on the WLAN configuration between the two ACs in a dual-link backup system.
Syntax
wlan sync-configuration check peer-ac mac-address
Views
System view
Predefined user roles
network-admin
Parameters
peer-ac mac-address: Specifies the MAC address of the peer AC, in the H-H-H format.
Usage guidelines
Application scenarios
Perform this task to verify if the WLAN settings on the two ACs in a dual-link backup system are consistent. If an inconsistency is found, the AC with the TM role generates a diff file named wlan_cfgsync.diff. You can use the more command to view the diff file and determine whether to perform WLAN configuration synchronization and the synchronization direction.
Restrictions and guidelines
To use this feature, first set up a SmartMC network. This command is supported only on the AC with the TM role.
Examples
# Trigger consistency check on the WLAN configuration between the two ACs in a dual-link backup system.
<Sysname> system-view
[Sysname] wlan sync-configuration check peer-ac 000f-e212-6103
Related commands
wlan sync-configuration
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. If no configuration exists in AP group view, the AP uses the configuration in global configuration 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 after a 10-minute delay 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 WA6320
[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 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
