Fat AP Upgrade Fails

Symptom

A Fat AP fails to be upgraded or downgraded.

Possible Causes

• The AP upgrade file does not match the AP model.
• The AP software version is incompatible.
• The network between the AP and the file server is disconnected.
• The user name or password of the file server is incorrect.
• The password of the file server contains special characters.
• The available memory of the AP is insufficient.
• 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

1. Check whether the AP upgrade file matches the AP model.
   1. Run the display version command to check the AP model and version information.

      <Huawei> display version
      Huawei Versatile Routing Platform Software                                      
      VRP (R) software, Version 5.130 (AP5030DN FAT V200R006C10)                     
      Copyright (C) 2011-2013 HUAWEI TECH CO., LTD
      ......

      The AP software version must match the AP model, that is, the software version for an AP model cannot be loaded to a different AP model.

   2. If the obtained upgrade file does not match its AP model, log in to the Huawei enterprise technical support website (http://support.huawei.com/enterprise) to obtain the upgrade file and Upgrade Guide required by the AP model.

2. Check whether a PC can successfully ping the AP.

   To upgrade an AP, use a PC as the file server, and use FTP, TFTP, or SFTP to upload files. Therefore, the PC and AP must be able to communicate with each other.

   1. Access the Windows command line interface (CLI) on your PC, and run the ping command to check whether the PC can successfully ping the AP.

      C:\Users\xxxx> ping 192.168.0.1
      Pinging 192.168.0.1, with 32 bytes of data:
      Reply from 192.168.0.1: bytes=32 time<1ms TTL=128
      Reply from 192.168.0.1: bytes=32 time<1ms TTL=128
      Reply from 192.168.0.1: bytes=32 time<1ms TTL=128
      Reply from 192.168.0.1: bytes=32 time<1ms TTL=128
      Ping statistics for 192.168.0.1:
      Packets: Sent = 4, Received = 4, Lost = 0 (0% lost)
      Estimated RTT (ms):
      Minimum = 0ms, Maximum = 0ms, Average = 0ms

      If the message "Request time out" is displayed, the target device is unreachable.

   2. If the PC fails to ping the AP, change the IP address of the AP or PC.

      To change the IP address of the AP, perform the following steps:

      1. Run the display this command in the interface view on the AP, and check whether the IP address of the AP is correctly configured.
      2. If the IP address is incorrect, run the ip address ip-address { mask | mask-length } command in the interface view to reconfigure the IP address for the AP.
   3. Run the ping command on the PC again to check whether the PC can successfully ping the AP.

3. Check whether the file server is correctly configured.

   The file system of an AP is different from that of other network devices, such as an AC. An AP has a small storage space and its system software package (a .bin file) cannot be downloaded to a local storage device for the upgrade. An AP can only load system software through a file server. Therefore, when loading the system software, ensure that the FTP, SFTP, or TFTP service is enabled on the file server and the user name and password are correctly configured.

   1. Perform the following operations to check whether the AP can access a file server.

      Assume that the IP address of the file server is 192.168.0.2, and the user name and password are huawei and huawei123, respectively.

      • For the FTP server:

        <Huawei> ftp 192.168.0.2 
        Trying 192.168.0.2 ... 
        Press CTRL+K to abort 
        Connected to 192.168.0.2. 
        220 FTP service ready. 
        User(192.168.0.2:(none)):huawei 
        331 Password required for huawei. 
        Enter password: 
        230 User logged in. 

        If the system prompts you to enter the user name and password, the FTP service is enabled on the file server. You need to enter the user name and password to access the file server.

      • For the SFTP server:

        <Huawei> system-view
        [Huawei] ssh client first-time enable
        [Huawei] sftp 192.168.0.2
        Please input the username: huawei
        Trying 192.168.0.2 ...
        Press CTRL+K to abort
        Enter password:
        sftp-client>

        If the system prompts you to enter the user name and password, the SFTP service is enabled on the file server. You need to enter the user name and password to access the file server.

      • For the TFTP server:

        No user name or password is required for the TFTP server. You can upload a local file on the AP to the file server to check whether the TFTP service is enabled on the file server. If the file is successfully uploaded, the TFTP service is enabled on the file server.

        The following uses the local file test.txt as an example.

        <Huawei> tftp 192.168.0.2 put test.txt

   2. If the FTP, SFTP, or TFTP service is disabled, enable the service on the file server.

      For details, see the help information of the corresponding server.

   3. If the user name and password are incorrect, reconfigure the user name and password.

      You are advised to configure a password that consists of letters and digits but no special characters.

4. Check whether the AP has sufficient available memory 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.

5. 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.
6. Collect the fault information.
   • Version information

     [Huawei-diagnose] vrbd
     [Huawei-diagnose] display upgrade-assistant-package version
     [Huawei-diagnose] display image

   • Configuration information

     <Huawei> display current-configuration

   • File system information

     <Huawei> dir flash:/

   • Log information

     [Huawei-diagnose] display logfile buffer
     [Huawei-diagnose] display diag-logfile buffer

     Export log files: Export all log files (in the .dblg, .log, .dblg.zip, or .log.zip format) that record the fault occurrence time in the flash:/logfile directory using FTP or the web platform.