Managing AP Equipment
Modifying AP Names
Modifying the AP Group to Which APs Belong
Context
If the current AP group is not applicable to an AP or the AP is added to an incorrect AP group, you can modify configurations to add the AP to a new AP group.
Modifying the AP group results in AP restart and service interruption. Exercise caution when performing this operation.
Procedure
- Run system-view
The system view is displayed.
- Run wlan ac
The WLAN view is displayed.
- Run ap-regroup { ap-name ap-name | ap-id ap-id } new-group new-group-name
An AP is added to a new AP group.
The AP group to which an AP is added must have been created using the ap-group name group-name command.
Performing an In-Service Upgrade on APs
Context
To upgrade the functions or versions of an existing WLAN, perform an in-service upgrade on APs on the WLAN.
In an in-service upgrade, an AP is already online. If the AP finds that its version is different from the version of the AP upgrade file specified on the AC, the AP starts to upgrade its version.
Unlike automatic upgrade, an in-service upgrade allows an AP to work properly without affecting services. To minimize the impact of an AP upgrade, you are advised to configure APs to download upgrade files in the daytime and reset the APs in batches at night. For details about automatic upgrade, see (Optional) Configuring Automatic Upgrade When APs Go Online.
- Upgrade of a single AP: allows you to upgrade a single AP to check whether the upgrade version can function properly. If the upgrade is successful, upgrade other APs in batches.
- AP upgrade based on the AP type: allows you to upgrade APs of the same type.
- AP upgrade based on the AP type and group: allows you to upgrade APs of the same type in the same group.
- AP upgrade based on the AP group: allows you to upgrade APs in the same AP group.
In an in-service upgrade, if APs fail to load the upgrade file and are reset, APs are upgraded automatically.
Procedure
- Run system-view
The system view is displayed.
- Run wlan ac
The WLAN view is displayed.
- Run the following commands as required.
FTP mode
Run ap update mode ftp-mode
The AP upgrade mode is set to FTP mode.
The default upgrade mode is ftp-mode.
Run ap update ftp-server ip-address server-ip-address ftp-username ftp-username ftp-password cipher ftp-password
Basic FTP information is configured.
By default, no FTP server IP address is configured, the FTP server user name is anonymous, the FTP server password is anonymous@huawei.com.
Run ap update ftp-server max-connect-number max-connect-number
The maximum number of APs to be upgraded simultaneously is configured.
By default, a maximum of 50 APs can be upgraded simultaneously in FTP mode.
An external FTP server can be used, which is recommended. The AC can also function as the FTP server.- When an external FTP server is used, the maximum number of APs that can be upgraded simultaneously is the configured max-connect-number.
If an AC is used as the FTP server, a maximum of five APs can be upgraded simultaneously even if the specified number is larger than five.
When the AC functions as the FTP server, run the ap update ftp-server max-connect-number max-connect-number command to set the maximum number of APs that can be upgraded simultaneously. The value of max-connect-number is an integer ranging from 1 to 5. During the upgrade, a maximum of 1 to 5 APs can be upgraded at a time until all APs are upgraded. If the configured number of APs to be upgraded simultaneously is larger than 5, an error message will be displayed after the first 5 APs are upgraded. The remaining APs cannot be automatically upgraded. You have to repeat the command until all APs are upgraded.
SFTP mode
Run ap update mode sftp-mode
The AP upgrade mode is set to SFTP mode.
The default upgrade mode is ftp-mode.
Run ap update sftp-server ip-address server-ip-address sftp-username sftp-username sftp-password cipher sftp-password
Basic SFTP information is configured.
By default, no SFTP server IP address is configured, the SFTP server user name is anonymous, the SFTP server password is anonymous@huawei.com.
Run ap update sftp-server max-connect-number max-connect-number
The maximum number of APs to be upgraded simultaneously is configured.
By default, a maximum of 50 APs can be upgraded simultaneously in SFTP mode.
An external SFTP server can be used, which is recommended. The AC can also function as the SFTP server.- When an external SFTP server is used, the maximum number of APs that can be upgraded simultaneously is the configured max-connect-number.
If an AC is used as the SFTP server, a maximum of five APs can be upgraded simultaneously even if the specified number is larger than five.
When the AC functions as the SFTP server, run the ap update sftp-server max-connect-number max-connect-number command to set the maximum number of APs that can be upgraded simultaneously. The value of max-connect-number is an integer ranging from 1 to 5. During the upgrade, a maximum of 1 to 5 APs can be upgraded at a time until all APs are upgraded.
If max-connect-number is set larger than 5, an error message will be displayed after the first five APs are upgraded. The remaining APs cannot be automatically upgraded. You have to repeat the command until all APs are upgraded.
- Configure in-service upgrade.
- Perform an in-service upgrade on a single AP.
Run ap update load { ap-name ap-name | ap-mac ap-mac | ap-id ap-id } update-filename update-file-name
The specified AP is upgraded.
- Run ap update reset { ap-name ap-name | ap-mac ap-mac | ap-id ap-id }
The specified AP is reset for upgrade.
- Upgrade APs of the same AP type.
Run ap update update-filename filename ap-type type-id [ ap-group ap-group-name ]
The upgrade file name for APs of a specified type is specified.
- Run ap update multi-load ap-type type-id [ ap-group group-name | { ap-name ap-name | ap-id ap-id } &<1-10> ]
APs are upgraded in batches based on the AP type.
- Run ap update multi-reset ap-type type-id [ ap-group group-name | { ap-name ap-name | ap-id ap-id } &<1-10> ]
APs of the specified AP type are reset in batches.
Resetting an AP
Context
If an AP cannot work properly after being upgraded, reset the AP. You can run the display ap all command to check the AP State field to determine whether an AP is working properly. If the State field displays name-conflicted, ver-mismatch, config, config-failed, committing, or commit-failed, an AP fails to work properly.
Restoring the Factory Settings of an AP
Context
You can delete the current and historical user configurations and restore the factory settings of APs.
When the configuration on an AP is incorrect or deleted, you can restore the factory settings of the AP.
Restoring the factory settings of an AP will reset the AP and restore all the AP configurations to factory settings.
Deleting an AP
Verifying the AP Management Configuration
Procedure
- Run the display ap { all | ap-group ap-group } command to check AP information.
- Run the display ap update configuration command to check the AP upgrade configuration.
- Run the display ap update status { all | downloading | failed | succeed | ap-name ap-name | ap-id ap-id } command to check the AP upgrade progress.
- Run the display ap-type { all | id type-id | type ap-type } command to check information about AP types.
- Run the display ap version { all | { ap-group ap-group-name | version-name version-name } * } command to check information about AP versions.
