Login
- Table of Contents
- Related Documents
-
| Title | Size | Download |
|---|---|---|
| 01-Anchor AP commands | 61.88 KB |
Anchor AP commands
Unless otherwise stated, an AC in this document refers to an anchor AP that acts as an AC.
anchor-ap
Use anchor-ap disable to disable AC election for APs.
Use anchor-ap enable to enable AC election for APs.
Use undo anchor-ap to restore the default.
Syntax
anchor-ap { disable | enable }
undo anchor-ap
Default
AC election is disabled.
Views
AP view
Predefined user roles
network-admin
Usage guidelines
By default, the AC election feature for an anchor AP that acts as a fit AP is disabled after the anchor AP is started and associated with the AC. To enable the AC election feature for an anchor AP that acts as a fit AP, execute the anchor-ap enable command on the AC.
Examples
# Enable AC election for anchor AP ap1.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA536-WW
[Sysname-wlan-ap-ap1] anchor-ap enable
display wlan inside-ap
Use display wlan inside-ap to display inside AP information.
Views
Any view
Predefined user roles
network-admin
network-operator
Usage guidelines
This command is available for anchor APs that act as ACs.
An inside AP is a manual AP automatically created for radio management when an anchor AP acts as an AC. The name and serial ID of the inside AP are the MAC address and serial ID of the anchor AP, respectively.
Examples
# Display inside AP information.
<Sysname> display wlan inside-ap
AP name : 7848-59f4-0900
AP ID : 1
MAC address : 7848-59f4-0900
save
Use save file-url to save the running configuration to the specified file, without specifying the file as a next-startup configuration file or backing up AC configuration to other anchor APs that are enabled with the AC election feature.
Use save [ safely ] [ backup | main ] [ force ] [ changed ]to save the running configuration to the root directory of the storage medium, specify the file as a next-startup configuration file, and back up AC configuration to other anchor APs that are enabled with the AC election feature.
Syntax
save file-url
save [ safely ] [ backup | main ] [ force ] [ changed ]
Views
Any view
Predefined user roles
network-admin
Parameters
file-url: Specifies a file path, a string of up to 255 characters. The file must be a .cfg file.
safely: Saves the configuration file in safe mode. If you do not specify this keyword, the device saves the configuration file in fast mode.
backup: Saves the running configuration to a configuration file, and specifies the file as the backup next-startup configuration file. If you do not specify this keyword or the main keyword, the command specifies the saved file as the main next-startup configuration file.
main: Saves the running configuration to a configuration file, and specifies the file as the main next-startup configuration file. If you do not specify this keyword or the backup keyword, the command specifies the saved file as the main next-startup configuration file.
force: Saves the running configuration to the existing next-startup configuration file without prompting for confirmation. If you do not specify this keyword, the system prompts you to confirm the operation. If you do not confirm the operation within 30 seconds, the system automatically aborts the operation. If you enter Y within the time limit, you can continue the save process and change the target file name during the process.
changed: Overwrites the target configuration file with the running configuration if an inconsistency is detected between the settings in the configuration file and the running configuration. The save command does not take effect if no inconsistency is detected. If you do not specify this keyword, the save command always overwrites the target configuration file with the running configuration.
Usage guidelines
If the file specified for this command does not exist, the system creates the file before saving the configuration. If the file already exists, the system prompts you to confirm whether to overwrite the file. If you choose to not overwrite the file, the system cancels the save operation.
When you use the save [ safely ] [ backup | main ] [ force ] [ changed ] command, follow these guidelines:
If the file specified by the save [ safely ] [ backup | main ] [ force ] [ changed ] command already exists on the device, the system performs the following tasks:
· In safe mode, the system saves configuration in a temporary file and starts overwriting the target next-startup configuration file after the save operation is complete. If a reboot, power failure, or out of memory or storage space event occurs during the save operation, the next-startup configuration file is retained.
· In fast mode, the device directly overwrites the target next-startup configuration file. If a reboot, power failure, or out of memory or storage space event occurs during this process, all settings in the next-startup configuration file are lost.
As a best practice, specify the safely keyword for reliable configuration saving.
The save [ safely ] [ backup | main ] [ force ] [ changed ] command enables you to back up the running configuration (except the configuration of the wlan anchor-ap persistent-mode ac command) of the anchor APs that act as ACs to other anchor APs that are online and enabled with the AC election feature as the next-startup configuration file. When the running AC goes offline, the newly elected AC can use the original configuration to manage the fit APs.
Examples
# Save the running configuration to configuration file backup.cfg without specifying the configuration file as a next-startup configuration file or backing up AC configuration to all the other anchor APs.
<Sysname> save backup.cfg
The current configuration will be saved to flash:/backup.cfg. Continue? [Y/N]:y
Now saving current configuration to the device.
Saving configuration flash:/backup.cfg. Please wait...
Configuration is saved to device successfully.
# Save the running configuration to the main next-startup configuration file without any confirmation required.
<Sysname> save force
Validating file. Please wait....
Saved the current configuration to mainboard device successfully.
# Save the running configuration to a file in the root directory of the storage medium, specify the file as the main next-startup configuration file, and back up AC configuration to all the other anchor APs.
<Sysname> save
The current configuration will be written to the device. Are you sure? [Y/N]:y
Please input the file name(*.cfg)[flash:/backup.cfg]
(To leave the existing filename unchanged, press the enter key):test.cfg
Validating file. Please wait............
Saved the current configuration to mainboard device successfully.
startup saved-configuration
Use startup saved-configuration to specify a file as a next-startup configuration file and back up AC configuration to other anchor APs that are enabled with the AC election feature.
Use undo startup saved-configuration to configure the system to start up with the factory defaults at the next startup.
Syntax
startup saved-configuration cfgfile [ backup | main ]
undo startup saved-configuration
Default
No next-startup configuration files are specified.
Views
User view
Predefined user roles
network-admin
Parameters
cfgfile: Specifies the path of a configuration file, a string of up to 255 characters. The file must be a .cfg file and saved in the root directory of the storage medium. The file path can include only the file name, or the storage medium information and file name.
backup: Specifies the configuration file as the backup next-startup configuration file.
main: Specifies the configuration file as the main next-startup configuration file. This is the primary configuration file that the device attempts to load at startup. If the loading attempt fails, the device tries the backup next-startup configuration file.
Usage guidelines
If you do not specify the backup or main keyword, the startup saved-configuration command specifies the main next-startup configuration file.
As a best practice, specify different files as the main and backup next-startup configuration files.
The undo startup saved-configuration command changes the file attribute of the main and backup next-startup configuration files to NULL. However, the command does not delete the two configuration files.
You can also specify a configuration file as a next startup file when you use the save command to save the running configuration.
The wlan anchor-ap persistent-mode ac command will not be deployed to other anchor APs that are online and enabled with the AC election feature.
Examples
# Specify the main next-startup configuration file and back up AC configuration to other anchor APs that are online and enabled with the AC election feature.
<Sysname> startup saved-configuration testcfg.cfg
Please wait ....... Done.
wlan anchor-ap persistent-mode ac
Use wlan anchor-ap persistent-mode ac to enable the persistent mode for the anchor AP that acts as an AC.
Use undo wlan anchor-ap persistent-mode to restore the default.
Syntax
wlan anchor-ap persistent-mode ac
undo wlan anchor-ap persistent-mode
Default
The persistent mode is disabled for an anchor AP that acts as an AC.
Views
System view
Predefined user roles
network-admin
Usage guidelines
This command is available for anchor APs that act as ACs.
After enabling the persistent mode for an anchor AP that acts as an AC, the anchor AP always acts as an AC and will not perform role switchover.
If two anchor APs acting as an AC exist in a WLAN, a new AC election will be triggered as follows:
· The anchor AP with the persistent mode enabled acts as an AC and will not perform role switchover.
· The anchor AP without the persistent mode enabled will switch its role to fit AP even if its MAC address is higher than that of the anchor AP with the persistent mode enabled.
Examples
# Enable the persistent mode for an anchor AP that acts as an AC.
<Sysname> system-view
[Sysname] wlan anchor-ap persistent-mode ac
wlan anchor-ap persistent-mode ap
Use wlan anchor-ap persistent-mode ap to enable the persistent mode for the anchor AP that acts as a fit AP.
Use undo wlan anchor-ap persistent-mode to restore the default.
Syntax
wlan anchor-ap persistent-mode ap
undo wlan anchor-ap persistent-mode
Default
The persistent mode is disabled for an anchor AP that acts as a fit AP.
Views
System view
Predefined user roles
network-admin
Usage guidelines
This command is available for anchor APs that act as fit APs.
After enabling the persistent mode for an anchor AP that acts as a fit AP, the anchor AP always acts as a fit AP and will not perform role switchover.
Examples
# Enable the persistent mode for an anchor AP that acts as a fit AP.
<Sysname> system-view
[Sysname] wlan anchor-ap persistent-mode ap
