Fit AP Upgrade Fails
Symptom
A Fit AP fails to be upgraded or downgraded.
Possible Causes
- The AP upgrade file does not exist.
- The AP upgrade file does not match the AP model.
- The network between the AP and the file server is disconnected.
- The user name or password of the file server is incorrect.
- The FTP/SFTP service is not enabled when the AC functions as the file server.
- The AP is not in normal state.
- The network quality between the AP and the file server is poor.
- The available memory of the AP is insufficient.
- The AP upgrade file name is changed.
- The AP upgrade file is modified.
- When a PC functions as the FTP, SFTP, or TFTP server, the firewall is enabled on the PC. As a result, the AP upgrade file cannot be downloaded.
- The FTP server does not support REST commands.
Troubleshooting Procedure
- Run the display ap update status all command on the AC to check the AP upgrade progress and status.
<AC> display ap update status all FT : File Type ----------------------------------------------------------------------------------------------------------------------------------------- ID Name AP Type AP Group AP MAC FT Update Version Last Update Time Update Status ----------------------------------------------------------------------------------------------------------------------------------------- 0 hw0 AirEngine5760-51 default 60de-4476-e320 FIT V200R020C00B008 2020/08/22 18:51 succeed 1 hw1 AirEngine5760-51 default 60de-4476-e340 FIT V200R020C00B008 2020/08/22 18:51 downloading(progress: 80%/0%) 2 hw2 AirEngine5760-51 default 60de-4476-e360 FIT V200R020C00B008 2020/08/22 18:51 downloading(progress: 100%/50%) 3 hw3 AirEngine5760-51 default 60de-4476-e380 FIT - - - 4 hw4 AirEngine5760-51 default 60de-4476-e3a0 FIT - - - 5 hw5 AirEngine5760-51 default 60de-4476-e3c0 FIT - - - ----------------------------------------------------------------------------------------------------------------------------------------- Total: 6
Table 11-1 Description of the display ap update status all command outputItem
Description
ID
AP ID.
Name
AP name.
AP Type
AP type.
AP Group
AP group.
AP MAC
AP's MAC address.
FT
Type of the AP upgrade file.
Update Version
Target version to which an AP is upgraded.
Last Update Time
Last end time when an AP is upgraded.
Update Status
AP upgrade status. For details about the upgrade status and its corresponding handling suggestions, see Table 11-2.
Table 11-2 AP upgrade status and handling suggestionsAP Upgrade Status
Description
Handling Suggestion
Waiting download
The AP is waiting for an upgrade.
No action is required.
downloading(progress: x%/y%)
x% indicates the download progress of the system software package, and y% indicates the progress of writing the system software package to the flash memory.
No action is required.
failed(AC global caching)
The upgrade failed.
- When an AP is downloading the system software package during an in-service upgrade, the system displays this message if the AP starts automatic upgrade, which triggers a new process for downloading the software package.
- When multiple RUs automatically upgrade at the same time, this message may also be displayed.NOTE:
In this situation, the actual RU upgrade result depends on that displayed in the display ap update status all command output.
Wait until the in-service upgrade is completed.
failed(alloc memory for file)
The upgrade failed because the AP failed to apply for memory resources.
Clear the memory of the AC, and ensure that the memory is sufficient for the AP upgrade.
failed(AP is updating now. Please wait.)
The AC delivers an upgrade instruction again when the AP is running an upgrade task.
The AP is upgrading. Wait until the upgrade is complete.
failed(AP type in the EFS mismatch)
The upgrade failed because the AP type in the EFS file trailer of the current AP version does not match the AP.
The upgrade file is incorrect. Replace the upgrade file.
failed(AP type mismatch with batch upgrade AP type)
The upgrade failed because the AP type is different from the batch upgrade AP type.
Upgrade the AC version. If the problem persists, contact technical support personnel.
failed(AP wait for fragmentation timeout)
The upgrade failed because the time that the AP waits for fragment data expired.
Check the network connection.
failed(block full)
The upgrade failed because the number of APs simultaneously upgraded in AC mode reaches the maximum.
The number of concurrent upgrades exceeds the maximum. Wait until the upgrade of other APs is complete.
failed(change to standby)
The AP upgrade failed because an active/standby switchover is in progress.
Wait until the active/standby switchover is complete.
failed(config changed)
The upgrade failed due to configuration changes.
This is a normal process. Perform the upgrade again.
failed(fail to download the file)
The upgrade failed because the system software package failed to be downloaded.
Check whether the network connection is normal or the system software package exists.
failed(file content error)
The upgrade failed due to incorrect system software file contents.
The upgrade file is incorrect. Replace the upgrade file.
failed(file version inconsistent)
The upgrade failed because the AP type in the EFS file trailer does not match the AP type contained in the system software package name.
The upgrade file is incorrect. Replace the upgrade file or upgrade the AC to the latest version.
failed(invalid file name)
The upgrade failed because the name of the system software package is invalid.
Ensure that the file name of the software package meets the specified requirement.
failed(link down)
The upgrade failed because the AP failed to communicate with the AC.
Check the network connection.
failed(mode changed)
The upgrade failed because the AP upgrade mode is changed during the AP automatic upgrade.
This is a normal process. Perform the upgrade again.
failed(nospace in AP memory)
The upgrade failed because the AP memory resources are insufficient.
Ensure that the AP memory can support the upgrade.
failed(not receive update result)
The upgrade failed because the AC receives no AP upgrade result.
Check the network connection. If the network connection is normal, contact technical support personnel.
failed(over max upgrade time)
The upgrade failed because the upgrade duration exceeds the maximum upgrade time allowed.
Check the network connection. If the network connection is normal, contact technical support personnel.
failed(server password is too long)
The upgrade failed because the password length of the FTP/SFTP server exceeds the maximum.
Change the password of the FTP/SFTP server to a value with a length less than the maximum.
failed(read file)
The upgrade failed because no upgrade file is available in the flash memory.
Check the upgrade file.
failed(receive file failed)
The upgrade failed because fragmented data fails to be received.
Check the network connection. If the network connection is normal, contact technical support personnel.
failed(retransfer over times)
The upgrade failed because the number of times for retransmitting fragmented data exceeds the maximum.
Check the network connection. If the network connection is normal, contact technical support personnel.
failed(send first file failed)
The upgrade failed because the first fragment fails to be sent.
Check the network connection. If the network connection is normal, contact technical support personnel.
failed(other reason)
The upgrade failed due to an unknown error.
Contact technical support personnel.
failed(upgrade timeout)
The upgrade timed out and failed.
Check the network connection. If the network connection is normal, contact technical support personnel.
failed(user canceled)
The upgrade failed because the user canceled the upgrade.
No action is required.
failed(waited for next batch)
The upgrade failed. The AP has to wait for the next upgrade.
No action is required.
failed(write flash error)
The upgrade failed because the system software package failed to be written to the flash memory
Contact technical support personnel.
failed(file changed)
The upgrade failed because the upgrade file was modified during the automatic upgrade.
This is a normal process. Wait for the next upgrade.
failed(age time out)
The upgrade failed because the state machine aged out.
Check the network connection. If the network connection is normal, contact technical support personnel.
succeed
The upgrade succeeded.
No action is required.
succeed(auto resetting)
The upgrade succeeded, and the AP is being automatically restarted.
No action is required.
succeed(need reset)
The upgrade succeeded, and the AP needs to be restarted.
No action is required.
succeed(resetting)
The upgrade succeeded, and the AP is being manually restarted.
No action is required.
succeed(no need to update)
The upgrade succeeded. There is no need to upgrade the AP.
No action is required.
succeed(need mode switch)
The upgrade succeeded. The AP mode needs to be switched.
No action is required.
failed(send upgrade configuration)
The upgrade failed because the upgrade configuration failed to be sent.
Check the network connection. If the network connection is normal, contact technical support personnel.
failed(send upgrade request)
The upgrade failed because the upgrade request failed to be sent.
Check the network connection. If the network connection is normal, contact technical support personnel.
failed(upgrade configuration response error)
The upgrade failed because there was an error in the AP's upgrade response.
Contact technical support personnel.
failed(process upgrade filename)
The upgrade failed because the AC failed to process the upgrade file name.
Contact technical support personnel.
failed(cannot get AP type)
The upgrade failed because the AC failed to obtain the AP type.
Contact technical support personnel.
failed(analyze the version by upgrade filename)
The upgrade failed because the device failed to analyze the version number in the file name.
Contact technical support personnel.
failed(state transition check failed for the update module)
The upgrade failed because the AC failed to check the status transition of the upgrade module.
Contact technical support personnel.
failed(flash component change)
The upgrade failed because the flash model is not supported.
Replace the device with one that supports the new flash memory model or contact technical support personnel.
failed(Backing up the system software)
The upgrade failed because the active and standby areas of the device are synchronizing the system software.
Wait until the synchronization between the active and standby areas is complete.
failed (incompatible hardware BOM version)
The upgrade failed because the AP hardware of the target version is incompatible with the BOM version.
Replace the AP.
failed(patch checksum error)
The upgrade failed because of a patch checksum error.
Check the integrity of the patch file.
failed(patch file error)
The upgrade failed because of a patch file error.
Check the integrity of the patch file.
failed (patch active failed)
The upgrade failed because of a failure to activate the patch.
Check whether the patch and the software package match with each other.
failed(vrp patch process active failed)
The upgrade failed because of a failure to activate the patch on the control plane.
Contact technical support personnel.
failed(vfp patch active failed)
The upgrade failed because of a failure to activate the patch on the forwarding plane.
Contact technical support personnel.
failed(kernel patch actived)
The upgrade failed because of a failure to activate the kernel patch.
Contact technical support personnel.
failed(patch inner proc error)
The upgrade failed because of an internal patch processing failure.
Contact technical support personnel.
failed(wifi target chip patch active failed)
The upgrade failed because of a failure to activate the Wi-Fi chip patch.
Contact technical support personnel.
failed(the current AP version does not support patch updates)
The upgrade failed because the AP version does not support the patch upgrade.
No action is required.
failed(insufficient space on the AP flash memory)
The upgrade failed due to insufficient space on the AP's flash memory.
Delete unnecessary files from the flash memory.
failed(nospace in AC memory)
The upgrade failed because the AC memory resources are insufficient.
Upgrade or restart the AP during off-peak hours.
failed(patch version mismatch)
The upgrade failed because the patch version does not match the AP version.
Check the patch version.
failed(insufficient memory as the security engine is enabled)
The upgrade failed due to the insufficient memory because the security engine is enabled on the device.
Disable the security engine before performing an upgrade.
failed(The current AP version does not support the change of the FTP/SFTP server port.)
The upgrade failed because the FTP/SFTP port number of the AP cannot be changed.
Use the default FTP/SFTP port for the upgrade.
-
The AP requires no upgrade.
No action is required.
If the local upgrade mode is used, refer to the following table for the upgrade failure causes and handling suggestions.
Failure Cause
Description
Suggestion
Upgrade failed because the upgrade is being performed.
An upgrade task is running.
Wait for a while.
Upgrade failed due to insufficient space.
Insufficient space for the upgrade.
Restart the AP and try again.
Upgrade failed due to other reasons.
The upgrade failed due to other reasons.
Contact technical support personnel.
Upgrade failed due to a failure in downloading the version file.
Failed to download the upgrade file.
Check whether the network environment or upgrade file exists on the server or whether the user name and password of the corresponding protocol (such as FTP or SFTP) are correct.
Upgrade failed due to a version mismatch.
Version mismatch.
Check whether the file version number is modified and whether the file size is normal.
Upgrade failed due to an invalid file name.
The file name is invalid.
Check whether the upgrade package name is correct.
Upgrade failed due to a type mismatch.
The upgrade file does not match the AP type.
Check whether the upgrade file size is normal and whether the AP type matches that supported by the upgrade file.
Upgrade failed due to MD5 and CRC check failures.
The upgrade file fails to be verified.
Perform the following operations or contact technical support personnel.
- Check whether the size of the upgrade file package is normal.
- Check whether the type of the upgrade file package matches the device model.
Upgrade failed because data failed to be written into the flash memory.
Failed to write data to the flash memory.
Contact technical support personnel.
Upgrade failed because the upgrade has been cancelled.
The upgrade is canceled.
This is a normal process. Perform the upgrade again.
Upgrade failed because fail to change the password.
The password is changed during the upgrade.
Check whether other operations have been performed to change the password.
Upgrade failed due to CMS check failed.
Failed to verify the digital signature of the upgrade file.
Check whether the upgrade file is correct.
Upgrade failed due to the flash component change. For versions supporting the new flash, query related documentation.
The earlier version does not support the new hardware.
Use the software that supporting the new hardware for the upgrade.
Upgrade failed because the target software is incompatible with the hardware BOM version. For the software version supporting the new BOM, query the product documentation.
The earlier version does not support the new hardware.
Use the software that supporting the new hardware for the upgrade.
System software backup is ongoing on the local device. Try again later.
Data is being synchronized between the active and standby devices.
Wait for a while and try again.
Upgrade failed because the FTP server does not support the REST command.
The FTP server does not support REST commands.
Use an FTP server that supports REST commands.
Upgrade failed due to unknown reasons.
Unknown reason.
Contact technical support personnel.
- Check whether the AP upgrade file exists and whether the file name is correct.
Before upgrading an AP, ensure that the upgrade file is stored in the corresponding directory of the file server and can be read. The name and size of the AP upgrade file must be the same as those of the source file and cannot be changed. If the upgrade file does not exist or the file name or size is incorrect, obtain the correct upgrade file at http://support.huawei.com/enterprise and upload it to the AC or file server.
- If the AP is upgraded in AC mode or SFTP/FTP mode (the AC functions as an SFTP or FTP server), you need to save the AP upgrade file to the default storage path on the AC.
<AC> dir flash:/*.bin Directory of flash:/ Idx Attr Size(Byte) Date Time(LMT) FileName 0 -rw- 12,815,616 May 23 2016 19:09:45 FitAP5X30XN_V200R006C10SPC300.bin 206,324 KB total (89,768 KB free) - If another device functions as the SFTP/FTP server, ensure that the upgrade file is stored in the SFTP/FTP directory and can be read, and that the file name and size are the same as those of the source file.
- If the AP is upgraded in AC mode or SFTP/FTP mode (the AC functions as an SFTP or FTP server), you need to save the AP upgrade file to the default storage path on the AC.
- Check whether the AP upgrade file matches the AP model.
The AP upgrade file must match the AP model, and upgrade files of different AP models cannot be used interchangeably.
- Check whether the AP and file server can ping each other and whether the network quality is good.
Assume that a PC functions as the file server. When upgrading an AP, use the PC as the file server and upload the AP's upgrade file through FTP, TFTP, or SFTP. In addition, ensure that the network port on the PC is directly connected to that on the AP and that the PC can communicate with the AP.
- Open the Windows Command Prompt on your PC, and run the ping command to check whether the PC can successfully ping the AP.
If the message "Request time out" is displayed, the target device is unreachable.
- If the PC fails to ping the AP, change the IP address of the PC to ensure that it is on the same network segment as the IP address of the AP.
The default IP address of the Fit AP is 169.254.1.1. The IP address of the PC must be on the network segment 169.254.1.0 (excluding the IP address 169.254.1.1), with the subnet mask 255.255.255.0. The IP address 169.254.1.100 is recommended.
If the Fit AP's IP address has been changed, run the display ap all command on the AC to check the AP's IP address.
- Run the ping command again on the PC to check whether the PC can successfully ping the AP.
- If large network delay or packet loss occurs between the AP and file server, the AP fails to download the upgrade file due to timeout. In this case, check the intermediate network.
- Open the Windows Command Prompt on your PC, and run the ping command to check whether the PC can successfully ping the AP.
- Check whether the user name or password of the FTP/SFTP server is correct.
If the user name or password of the server is incorrect, downloading the AP upgrade file will fail.
- Run the display ap update configuration command to check the AP upgrade configuration.
[Huawei-wlan-view] display ap update configuration ------------------------------------------------------------------ AP update mode : ftp-mode FTP configuration FTP IP : 192.168.0.11 FTP username : ftp FTP password : ****** FTP max number : 50 SFTP configuration SFTP IP : - SFTP username : anonymous SFTP password : ****** SFTP max number : 50 ------------------------------------------------------------------
- Check whether the user name and password for logging in to the server are correct. If the user name and password are incorrect, run the following commands to reconfigure them:
- Set the upgrade mode to SFTP and configure the SFTP server.
<Huawei> system-view [Huawei] wlan [Huawei-wlan-view] ap update mode sftp-mode [Huawei-wlan-view] ap update sftp-server ip-address 192.168.10.11 sftp-username xxx sftp-password cipher yyy //xxx and yyy indicate the user name and password for logging in to the SFTP server.
- Set the upgrade mode to FTP and configure the FTP server.
<Huawei> system-view [Huawei] wlan [Huawei-wlan-view] ap update mode ftp-mode [Huawei-wlan-view] ap update ftp-server ip-address 192.168.10.11 ftp-username xxx ftp-password cipher yyy //xxx and yyy indicate the user name and password for logging in to the FTP server.
- Set the upgrade mode to SFTP and configure the SFTP server.
- Run the display ap update configuration command to check the AP upgrade configuration.
- Check whether the FTP/SFTP service is enabled on the AC.
- When the AC is configured as the FTP server, run the display ftp-server command to check whether the FTP service is enabled.
<Huawei>display ftp-server FTP server is running Max user number 50 User count 0 Timeout value(in minute) 30 Listening port 21 Acl number 0 FTP server's source address 0.0.0.0
If the FTP service is disabled, run the ftp server enable command in the system view to enable it.
- When the AC is configured as the SFTP server, run the display ssh server status command to check whether the SFTP service is enabled.
<Huawei> display ssh server status SSH version :2.0 SSH connection timeout :60 seconds SSH server key generating interval :0 hours SSH Authentication retries :3 times SFTP Server :Enable Stelnet server :Enable
If the SFTP service is disabled, run the sftp server enable command in the system view to enable it on the SSH server.
- When the AC is configured as the FTP server, run the display ftp-server command to check whether the FTP service is enabled.
- Check whether the AP is in normal state.
If an AP is in normal state, the AP can be upgraded. If the AP is in other states, the AP's upgrade mode will be limited.
<AC> display ap all Total AP information: fault: fault [1] nor : normal [1] --------------------------------------------------------------------------------------------------- ID MAC Name Group IP Type State STA Uptime --------------------------------------------------------------------------------------------------- 0 04f9-3896-8d40 04f9-3896-8d40 default - AirEngine5760-51 fault 0 - 1 dcd2-fcf6-6c20 dcd2-fcf6-6c20 default 192.168.100.251 AirEngine5760-51 nor 0 12D:4H:19M:33S ---------------------------------------------------------------------------------------------------
If an AP is in normal state, the AP can be normally upgraded. If an AP is in ver-mismatch or config-failed state, the AP can only be automatically upgraded. If an AP is in other states, the AP can be upgraded using the CLI by connecting to the serial port or through Uboot.
For details about how to upgrade an AP using Uboot, see the corresponding Upgrade Guide. Log in to the Huawei enterprise technical support website (http://support.huawei.com/enterprise), and obtain the Upgrade Guide for the corresponding AP model and version.
- Check whether the AP has sufficient available storage space.
Run the display memory-usage command on the AP to check whether the available memory of the AP is sufficient.
<Huawei> display memory-usage Memory utilization statistics at 2016-05-23 16:53:36 430 ms System Total Memory Is: 66272 kbytes Total Memory Used Is: 39476 kbytes Memory Using Percentage Is: 60%
If the remaining memory space on an AP is insufficient for storing the new system software package, restart the AP and upgrade it. You can upgrade the AP using Uboot.
For details about how to upgrade an AP using Uboot, see the corresponding Upgrade Guide. Log in to the Huawei enterprise technical support website (http://support.huawei.com/enterprise), and obtain the Upgrade Guide for the corresponding AP model and version.
- When a PC functions as the FTP, SFTP, or TFTP server, you are advised to temporarily disable the firewall and check whether the AP can access the file server.
- Check whether the user in the AAA view has the FTP/SFTP permission and whether the FTP/SFTP path is configured.
local-user admin privilege level 15 local-user admin ftp-directory flash:/ local-user admin service-type telnet terminal ssh ftp http
- Collect fault information.
- Run the following commands on the AC to collect related information.
Information Type
View
Command
AC configuration information
All views
display current-configuration
AP upgrade configuration information
All views
display ap update configuration
AP upgrade result
All views
display ap update status { ap-name ap-name | ap-id ap-id | all }
Error records generated during the AP upgrade
Diagnostic view
display wlan debuginfo [ process process-id ] type 1 from 0 to 1000
Logs on the AC
All views
display logbuffer
- Run the following command on the AP to collect related information.
Information Type
View
Command
Logs on the AP
All views
display logbuffer
- Run the following commands on the AC to collect related information.