技术支持文档中心无线局域网APAP6000故障处理维护宝典

WLAN 维护宝典(V200)

FIT AP升级失败

FIT AP升级失败

现象描述

FIT AP升级或降级失败。

可能原因

使用命令行display ap update status ap-id ap-id查询AP升级失败的具体原因，常见的原因如下：
  • AP版本文件不存在
  • AP软件版本同设备类型不匹配
  • AP和服务器网络不通
  • 服务器用户名或密码错误
  • AC作服务器时未开启FTP/SFTP Server
  • AP当前非normal状态
  • AP和服务器之间网络质量差
  • AP剩余可用内存不足
  • AP软件版本文件名被修改
  • AP软件版本内容被修改
  • PC作为FTP/SFTP/TFTP服务器时，PC上开启了防火墙，导致版本文件无法下载
  • FTP Server不支持REST命令

操作步骤

  1. 在AC上执行命令display ap update status all查看AP升级进度、状态的信息。

    <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
    表11-1 display ap update status all命令输出信息描述

    项目

    描述

    ID

    AP ID。

    Name

    AP名称。

    AP Type

    AP类型。

    AP Group

    AP组。

    AP MAC

    AP的MAC地址。

    FT

    AP的升级文件类型。

    Update Version

    AP的升级版本号。

    Last Update Time

    AP上次升级结束时间。

    Update Status

    AP的升级状态。详细升级状态及对应的处理建议请参见表11-2。
    表11-2 AP升级状态及处理建议

    AP升级状态

    解释

    处理建议

    Waiting download

    等待升级。

    无需处理。

    downloading(progress: x%/y%)

    x%表示系统软件包的下载进度，y%表示系统软件包的写入到Flash进度。

    无需处理。

    failed(AC global caching)

    升级失败。

    • AP在线升级下载系统软件包过程时，若此时开始进行自动升级，自动升级触发再次下载系统软件包，提示此信息。
    • 多个RU同时进行自动升级时，也可能出现此提示信息。
      说明：

      此种场景下RU的升级结果以执行命令display ap update status all查询到的结果为准。

    请继续等待在线升级。

    failed(alloc memory for file)

    升级失败，AP申请内存失败。

    请清理设备内存，确保有足够内存升级。

    failed(AP is updating now. Please wait.)

    AP已有升级任务运行，AC上再次下发升级命令，提示AP升级失败。

    AP正在升级，请等待升级完成。

    failed(AP type in the EFS mismatch)

    升级失败，系统软件包EFS字段尾中的AP类型与AP不匹配。

    升级文件错误，请更换升级文件。

    failed(AP type mismatch with batch upgrade AP type)

    升级失败，AP类型与批量升级的AP类型不一致。

    请先升级AC版本，若无法解决，请联系技术支持人员。

    failed(AP wait for fragmentation timeout)

    升级失败，AP等待分片数据超时。

    请检查网络连接。

    failed(block full)

    升级失败，ac-mode的升级模式下，同时升级的AP数目达到最大值。

    同时升级超过最大数目，请等待其他AP升级完成。

    failed(change to standby)

    升级失败，AP主备切换时升级失败提示此信息。

    请等待AP主备切换完成。

    failed(config changed)

    升级失败，配置变更导致升级失败。

    正常流程，请尝试重新升级。

    failed(fail to download the file)

    升级失败，下载系统软件包失败。

    请检查网络连接或者系统软件包是否存在。

    failed(file content error)

    升级失败，系统软件包文件内容错误。

    升级文件错误，请更换升级文件。

    failed(file version inconsistent)

    升级失败，系统软件包EFS字段尾中的AP类型与系统软件包名称中的AP类型不匹配。

    升级文件错误，请更换升级文件，或尝试升级AC为最新版本。

    failed(invalid file name)

    升级失败，系统软件包文件名不符合规范。

    请确保软件包文件名符合规范。

    failed(link down)

    升级失败，AP与AC通信故障。

    请检查网络连接。

    failed(mode changed)

    升级失败，在AP进行自动升级时修改AP升级模式，提示此信息。

    正常流程，请尝试重新升级。

    failed(nospace in AP memory)

    升级失败，AP内存不足。

    请确保AP内存满足升级要求。

    failed(not receive update result)

    升级失败，AC没有收到AP的升级结果。

    请检查网络连接，如果网络无问题，请联系技术支持人员。

    failed(over max upgrade time)

    升级失败，超过最大升级时间。

    请检查网络连接，如果网络无问题，请联系技术支持人员。

    failed(server password is too long)

    升级失败，FTP/SFTP升级服务器密码长度太长。

    请修改ftp/sftp服务器密码，确保不超过最大长度。

    failed(read file)

    升级失败，flash中没有升级文件。

    请检查升级文件。

    failed(receive file failed)

    升级失败，上报分片数据接收失败。

    请检查网络连接，如果网络无问题，请联系技术支持人员。

    failed(retransfer over times)

    升级失败，分片数据重传超过最大次数。

    请检查网络连接，如果网络无问题，请联系技术支持人员。

    failed(send first file failed)

    升级失败，第一片分片发送失败。

    请检查网络连接，如果网络无问题，请联系技术支持人员。

    failed(other reason)

    升级失败，未知错误。

    请联系技术支持人员。

    failed(upgrade timeout)

    升级失败，升级超时。

    请检查网络连接，如果网络无问题，请联系技术支持人员。

    failed(user canceled)

    升级失败，用户取消升级。

    无需处理。

    failed(waited for next batch)

    升级失败，需要等待下一批升级。

    无需处理。

    failed(write flash error)

    升级失败，系统软件包写入到Flash失败。

    请联系技术支持人员。

    failed(file changed)

    升级失败，自动升级时更改升级文件。

    正常流程，请等待再次升级。

    failed(age time out)

    升级失败，状态机老化超时。

    请检查网络连接，如果网络无问题，请联系技术支持人员。

    succeed

    升级成功。

    无需处理。

    succeed(auto resetting)

    升级成功，正在自动重启AP中。

    无需处理。

    succeed(need reset)

    升级成功，需要重启AP。

    无需处理。

    succeed(resetting)

    升级成功，正在手动重启AP中。

    无需处理。

    succeed(no need to update)

    升级成功，不需要升级。

    无需处理。

    succeed(need mode switch)

    升级成功，需要切换AP模式。

    无需处理。

    failed(send upgrade configuration)

    升级失败，发送升级配置失败。

    请检查网络连接，如果网络无问题，请联系技术支持人员。

    failed(send upgrade request)

    升级失败，发送升级请求失败。

    请检查网络连接，如果网络无问题，请联系技术支持人员。

    failed(upgrade configuration response error)

    升级失败，AP回应的升级响应错误。

    请联系技术支持人员。

    failed(process upgrade filename)

    升级失败，AC处理升级文件名失败。

    请联系技术支持人员。

    failed(cannot get AP type)

    升级失败，AC获取不到AP类型。

    请联系技术支持人员。

    failed(analyze the version by upgrade filename)

    升级失败，设备解析文件名中的版本号失败。

    请联系技术支持人员。

    failed(state transition check failed for the update module)

    升级失败，升级模块状态迁移检查失败。

    请联系技术支持人员。

    failed(flash component change)

    升级失败，flash型号不支持。

    请更换支持新Flash型号的设备，或联系技术支持人员。

    failed(Backing up the system software)

    升级失败，设备主备区正在同步系统软件。

    请等待主备同步完成。

    failed (incompatible hardware BOM version)

    升级失败，单板BOM版本不支持。

    请更换单板升级。

    failed(patch checksum error)

    升级失败，补丁校验和错误。

    请检查补丁文件完整性。

    failed(patch file error)

    升级失败，补丁文件错误。

    请检查补丁文件完整性。

    failed (patch active failed)

    升级失败，补丁激活失败。

    请检查补丁和软件大包是否匹配。

    failed(vrp patch process active failed)

    升级失败，控制面补丁激活失败。

    请联系技术支持人员。

    failed(vfp patch active failed)

    升级失败，转发面补丁激活失败。

    请联系技术支持人员。

    failed(kernel patch actived)

    升级失败，内核补丁激活失败。

    请联系技术支持人员。

    failed(patch inner proc error)

    升级失败，补丁内部处理失败。

    请联系技术支持人员。

    failed(wifi target chip patch active failed)

    升级失败，wifi芯片补丁激活失败。

    请联系技术支持人员。

    failed(the current AP version does not support patch updates)

    升级失败，当前AP版本不支持补丁升级。

    无需处理。

    failed(insufficient space on the AP flash memory)

    升级失败，当前AP的Flash空间不足。

    请删除Flash中不需要的文件。

    failed(nospace in AC memory)

    升级失败，当前AC内存不足。

    请在业务量较少的情况下进行升级或重启设备。

    failed(patch version mismatch)

    升级失败，补丁版本不匹配。

    请检查补丁版本。

    failed(insufficient memory as the security engine is enabled)

    升级失败，当前设备已开启安全引擎功能导致内存不足。

    请先关闭安全引擎后再进行升级。

    failed(The current AP version does not support the change of the FTP/SFTP server port.)

    升级失败，当前AP不支持修改FTP/SFTP端口号。

    请使用FTP/SFTP默认端口升级。

    -

    不进行升级的AP。

    无需处理。

    如果是通过本地升级的方式，对应的升级失败原因和处理建议请参见下表。

    失败原因

    解释

    处理建议

    Upgrade failed because the upgrade is being performed.

    已有升级任务在运行中。

    请等待一段时间。

    Upgrade failed due to insufficient space.

    升级需要的空间不足。

    可将AP重启后再次尝试。

    Upgrade failed due to other reasons.

    其他原因导致升级失败。

    请联系技术支持人员。

    Upgrade failed due to a failure in downloading the version file.

    下载升级文件失败。

    请排查网络环境或是升级文件是否在服务器上存在，或是对应的协议（FTP、SFTP等）用户名和密码是否正确。

    Upgrade failed due to a version mismatch.

    版本不匹配。

    检查文件版本号是否被修改，文件大小是否正常等文件正确性相关内容

    Upgrade failed due to an invalid file name.

    文件名不合法。

    检查升级包文件名是否正确。

    Upgrade failed due to a type mismatch.

    升级文件类型不匹配。

    检查升级包文件大小是否正常、升级包文件支持的形态是否匹配等内容。

    Upgrade failed due to MD5 and CRC check failures.

    升级文件校验不过。

    文件校验不过请作如下检查或联系技术支持人员。

    1. 检查升级文件包大小是否正常。
    2. 检查升级文件包类型与当前设备款型是否匹配。

    Upgrade failed because data failed to be written into the flash memory.

    写Flash 失败。

    请联系技术支持人员。

    Upgrade failed because the upgrade has been cancelled.

    升级过程中被取消。

    正常流程，请重新升级。

    Upgrade failed because fail to change the password.

    升级过程中密码被改变。

    需排查是否有其他操作将密码改变。

    Upgrade failed due to CMS check failed.

    升级文件数字签名校验失败。

    需检查升级包文件的正确性。

    Upgrade failed due to the flash component change. For versions supporting the new flash， query related documentation.

    针对硬件Flash型号更换，老版本不支持新升级的硬件。

    需要使用支持范围内的软件版本来进行升级。

    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.

    针对硬件升级，老版本不支持新版本硬件。

    需要使用支持范围内的软件版本来进行升级。

    System software backup is ongoing on the local device. Try again later.

    正在进行主备同步。

    请等待一段时间再尝试。

    Upgrade failed because the FTP server does not support the REST command.

    由于FTP服务器不支持REST命令，升级失败。

    使用支持REST命令的FTP服务器。

    Upgrade failed due to unknown reasons.

    未知原因。

    请联系技术支持人员。

  2. 检查AP软件版本是否存在且文件名是否正确

    升级设备前请确保升级文件已存放在文件服务器相关目录下且可以读取；AP升级文件名和大小需要和源文件一致，不可以修改。如果升级文件不存在或文件名、文件大小不正确，请登录华为公司企业业务支持网站（http://support.huawei.com/enterprise）获取正确的升级文件，上传至AC或者文件服务器。

    • 如果通过ac-mode方式或者AC作为SFTP/FTP服务器，需将AP软件版本存储在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)
    • 如果是使用其他软件作为SFTP/FTP服务器，确保软件版本已存放在SFTP/FTP目录下且可读取，同时需要确保文件名和文件大小和源文件一致。

  3. 检查AP软件版本同设备类型是否匹配

    AP软件版本必须同设备类型一致，不同类型AP的软件版本不可互相加载。

  4. 检查AP和服务器网络之间是否可以Ping通且网络质量良好

    以PC作为文件服务器为例，升级AP时，以PC作为文件服务器，利用FTP、TFTP或SFTP软件进行上传操作，PC的网口必须与AP网口直连，并且需要保证PC和AP之间能够正常通信。

    1. 在PC上进入Windows的命令行提示符，执行命令ping，查看PC是否能够ping通AP。

      当系统显示“Request time out”时，表示目标设备不可达。

    2. 如果ping不通AP，则需要修改PC的IP地址，使得PC的IP地址与AP的IP地址同网段。

      FIT AP缺省的IP地址为169.254.1.1，所以PC的IP地址必须在169.254.1.0网段（169.254.1.1除外，建议使用169.254.1.100），子网掩码是255.255.255.0。

      如果FIT AP的IP地址已经修改，可在AC上执行display ap all命令查看AP的IP地址。

    3. 修改完成后，在PC上再次执行ping命令，确认能够ping通AP。
    4. 如果设备与服务器之间网络延时大或者丢包，会导致AP下载软件版本超时失败，需要排查中间网络。

  5. 检查FTP/SFTP服务器用户名或密码是否正确

    服务器用户名或密码配置不正确会导致下载AP软件版本失败。

    1. 执行display ap update configuration命令查看AP版本升级时的配置信息。
      [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
------------------------------------------------------------------
    2. 检查登录服务器的用户名和密码是否配置正确，如果配置错误，执行如下命令进行重新配置。
      • 配置升级模式为SFTP模式并配置SFTP服务器。
        <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,yyy分别指登录SFTP server时的用户名和密码
      • 配置升级模式为FTP模式并配置FTP服务器。
        <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,yyy分别指登录FTP server时的用户名和密码

  6. 检查AC是否未开启FTP/SFTP Server

    • 配置AC为FTP服务器时，执行display ftp-server命令检查是否开启FTP服务。
      <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

      如果FTP服务功能没有开启，请在系统视图下执行ftp server enable命令开启设备的FTP服务。

    • 配置AC为SFTP服务器时，执行display ssh server status命令检查是否开启SFTP服务。
      <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

      如果SFTP服务功能没有开启，请在系统视图下执行sftp server enable命令开启SSH服务器端的SFTP服务。

  7. 检查AP当前是否为normal状态

    AP为“normal”状态时，能够正常升级；AP为其他状态时，升级方式会有限制。

    <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
---------------------------------------------------------------------------------------------------

    如果AP状态为“normal”，能够正常升级；如果AP状态为“ver-mismatch”或“config-failed”，只能进行自动升级；如果AP为其他状态，可通过连接AP串口进行命令行升级或通过Uboot的方式进行升级。

    通过Uboot方式进行升级的具体操作请参见升级指导书，升级指导书获取路径：请先登录华为公司企业业务支持网站（http://support.huawei.com/enterprise），登录后，根据AP类型和版本名称，获取相应的升级指导书。

  8. 检查AP当前空闲内存是否足够

    在AP上执行display memory-usage命令，检查AP当前空闲内存是否足够。

    <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%

    如果当前AP剩余内存空间不够容纳新的系统软件包，则需要重启AP后再尝试进行升级或者通过Uboot的方式进行升级。

    通过Uboot方式进行升级的具体操作请参见升级指导书，升级指导书获取路径：请先登录华为公司企业业务支持网站（http://support.huawei.com/enterprise），登录后，根据AP类型和版本名称，获取相应的升级指导书。

  9. 以PC作为FTP、SFTP或TFTP服务器时，建议暂时关闭防火墙，并检查AP能否正常访问文件服务器。
  10. 检查AAA视图下用户是否具有FTP/SFTP权限，以及是否配置FTP/SFTP路径。

     local-user admin privilege level 15                                                           
 local-user admin ftp-directory flash:/                                                                                             
 local-user admin service-type telnet terminal ssh ftp http

  11. 采集故障信息

    1. 在AC上执行如下命令收集相关信息。

      信息类别

      命令视图

      命令

      AC配置信息

      所有视图

      display current-configuration

      AP升级配置信息

      所有视图

      display ap update configuration

      AP升级结果信息

      所有视图

      display ap update status { ap-name ap-name | ap-id ap-id | all }

      AP在升级过程中产生的错误记录

      诊断视图

      display wlan debuginfo [ process process-id ] type 1 from 0 to 1000

      AC日志信息

      所有视图

      display logbuffer
    2. 在AP上执行如下命令收集相关信息。

      信息类别

      命令视图

      命令

      AP日志信息

      所有视图

      display logbuffer

翻译
收藏
下载文档
更新时间：2024-05-07
文档编号：EDOC1000051014
浏览量：1561722
下载量：26492
平均得分：4.84分

相关文档

数字签名

数字签名校验工具