display ap update status

Function

The display ap update status command displays AP upgrade progress.

Format

display ap update status { all | downloading | failed | succeed | ap-name ap-name | ap-id ap-id | ap-type ap-type | ap-group ap-group | waiting }

Parameters

Parameter	Description	Value
all	Displays upgrade progress of all APs.	-
downloading	Displays APs that are upgrading.	-
failed	Displays APs that failed to be upgraded.	-
succeed	Displays APs that have been successfully upgraded.	-
ap-name ap-name	Displays upgrade progress of the AP with a specified name.	The value is a string of 1 to 63 case-sensitive characters, which can be Chinese characters or Chinese + English characters. It cannot contain question marks (?), and cannot start or end with spaces or double quotation marks (" "). If the AP name contains spaces, the input name must start and end with a quotation mark ("), for example, "huawei name1". The quotation marks at the beginning and end of the AP name occupy two characters in total. NOTE: You can only use a command editor of the UTF-8 encoding format to edit Chinese characters.
ap-id ap-id	Displays upgrade progress of the AP with a specified ID.	The AP ID must exist.
ap-type ap-type	Displays upgrade progress of APs of a specified type.	The value is an integer. To view all AP types, run the display ap-type all command.
ap-group ap-group	Displays upgrade progress of APs in a specified AP group.	The value is a string of 1 to 35 characters, which can be Chinese characters or Chinese + English characters. It cannot contain question marks (?) or slashes (/), and cannot start or end with spaces or double quotation marks (" "). If the AP group name contains spaces, the input name must start and end with a quotation mark ("), for example, "huawei name1". The quotation marks at the beginning and end of the AP group name occupy two characters in total. NOTE: You can only use a command editor of the UTF-8 encoding format to edit Chinese characters.
waiting	Displays APs waiting for upgrade.	-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can use this command to check the upgrade progress of all APs or the AP with a specified name, and check information about APs in specified upgrade status.

Example

# Display upgrade progress of all APs.

<HUAWEI> 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    AP5030DN      default    60de-4476-e320  FIT    V200R008C10B008    2016/08/22 18:51   succeed
1    hw1    AP5030DN      default    60de-4476-e340  FIT    V200R008C10B008    2016/08/22 18:51   downloading(progress: 80%/0%)
2    hw2    AP5030DN      default    60de-4476-e360  FIT    V200R008C10B008    2016/08/22 18:51   downloading(progress: 100%/50%)
3    hw3    AP5030DN      default    60de-4476-e380  FIT    -                  -                   -
4    hw4    AP5030DN      default    60de-4476-e3a0  FIT    -                  -                   -
5    hw5    AP5030DN      default    60de-4476-e3c0  FIT    -                  -                   -
----------------------------------------------------------------------------------------------------------------------------------------------
Total: 6

**Table 1** Description of the **display ap update status all** command output
Item	Description
ID	AP ID.
Name	AP name.
AP Type	AP type.
AP Group	AP group.
AP MAC	MAC address of an AP.
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 2.

**Table 2** AP upgrade status and handling suggestions
AP 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 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 online 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 upgrade failed due a revertive switchover failure.	Wait until the active/standby switchover is complete.
failed(fail to download the file)	The upgrade failed because the system software 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 AP version file is incorrect.	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 were 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 FTP/SFTP server password is too long.	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 fragments failed 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 fragment retransmissions exceeds the threshold.	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 failed 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 restarted.	No action is required.
succeed(need reset)	The upgrade succeeded. The AP must 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 system software is being synchronized from the main area to the standby area.	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 were 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.
-	The AP requires no upgrade.	No action is required.