### 1.AP发现并接入AC

瘦AP要通过AC升级，首先需要发现并且被允许接入AC。假如AP没有接入AC，请参考瘦AP注册不上故障排查进行定位。

另外10.x AP无法在11.x AC达到上线状态，但是需要发现11.X AC，并且CAPWAP状态走到Join状态，这一点可以通过AP上的syslog信息来确认。

下一步

### 2.AC为AP下发升级文件

AP接入AC后，观察AC端为AP下发升级文件的状态，通过命令:

show ap-config updating-list进行观察

Ruijie#sh ap-config updating-list

AP NAME
AP PID
File Tx Time
AP Reset Ready

假如发现命令没有显示给所配置的AP下发升级文件，则需要检查AC端的升级配置是否正确；如果发现AC为AP反复下发升级文件，需要检查该升级文件是否适用于这台AP。

下一步

### 3.检查AC端升级配置

如果AC上配置了升级，但是却没有下发，需要检查AC上的配置是否正确。AC端的升级配置目前可分为三类：

1、自动升级配置，即ac-controller模式下配置了ap-image auto-upgrade，并且激活了需要升级的BIN文件。这种升级方式只支持11.x AP->11.x AP的版本升级。假设配置了自动升级并且激活了所需要下发的升级文件，但是AC却没有下发，可能是导入的升级文件错误，请确认导入的升级文件是否是正确的升级文件，具体检查升级文件是否正确请跳转到步骤4。并尝试重新通过tftp下载升级文件。重新下载升级文件后，再使用no active-bin-file xxx.bin/active-bin-file xxx.bin重新激活AP的升级文件。

2、通过ap-serial配置升级

即进行AP系列的配置，并且为所配置的AP系列指定升级文件。该命令适用于AP从10.x->11.x，以及11.x->11.x的升级。

如果配置了基于ap-serial的ap-image命令进行升级，但是AC却没有下发，先确认所配置的AP系列是否正确。AP系列命令ap-serial [serial name] [product 1] [product 2]… hw-ver [hardware version]

常见的的配置错误有以下几类：

1、配置的AP型号中包括空格，例如型号AP630(integrated directional antenna)，此时需要将AP型号使用””括起才行，否则配置的型号会被按照空格作为分隔符进行拆分。

Ruijie(config-ac)#ap-serial 630 "AP630(integrated directional antenna)" hw 1.x

2、配置的AP产品型号或者硬件版本号与要升级的AP不匹配，这一点可以通过AC端命令show version [ap-name]或者直接在AP端使用show version detail命令进行查看确认实际的产品型号。

Ruijie#show version 1fen24

AP(1fen24)'s version:

Product ID : AM5528

System uptime : 0:18:15:50

Hardware version : 1.00

Software version : AM_RGOS 11.1(5)B8, Release(03161905)

Patch number : NA

Software number : M05042504192016

Serial number: 1234942570031

MAC address : 00d0.f822.33e6

3、对配置命令的理解存在问题，把硬件版本号或者系列名字当作型号进行了配置。这一点可以通过命令show ac-config serial-product进行确认所配置的是否准确。看是否有配置错误的型号或者硬件版本号。

Ruijie#sh ac-config serial-product

Cnt
------
1
Serial Name
-----------
530
Hardware Version
----------------
1.x
File Name
------------
ap530-mid.bi
AP Product ID
-------------
AP530-I

如果确定配置的AP系列正确但还没有下发，要分为两种情况来看：

10.x->11.x的升级，请看所配置的ap-image [file] [ap-serial]命令中指定的升级文件，是否是10.x升级11.x的中间版本，中间版本升级文件需要使用active-bin-file [file] rgos10进行激活。/p>

11.x->11.x的升级，AC端会检查升级文件是否匹配于所配置的AP系列。关于文件是否适用于该AP，请参考第4步。

3、通过ap-config下ap-image命令单独配置升级

单独配置命令进行升级，目前的AC软件版本只能支持11.x->11.x的升级，如果是10.x是不支持的，假如配置未下发，请参考第4步检查升级文件是否适用。

下一步

### 4.检查升级文件是否适用与该AP

检查升级文件是否适用于某款AP，如果升级文件是11.x版本，可以参考下面的方法进行分析

1)首先检查文件基本信息是否与版本发布文档里面的相同。例如md5值，这个可以直接在AC设备的shell下执行确认拷贝到AC上的版本是否正确。

/data # md5sum ap740.bin

a8f1fd3d115a81c020ba14d845619fde ap740.bin

另外可以通过show ac-config active-file查看升级文件的主版本号以及Softwarenum信息是否正确。可以通过softwarenum了解升级文件的版本日期信息。例如下面的ap740.bin，可以看出来升级文件日期是2016.4.19日的版本。

Ruijie#sh ac-config active-file

Cnt
------
1
2
3
4
File Name
-----------
ap530-mid.bin
ap530.bin
ap740.bin
trunk-am5528-0418.bin
Image Id
------------------------
RGOS 10.4, Release(10779)
1.0.0.a886b3c2
1.0.0.735287c7
1.0.0.89f6a0bf
Software number
------------
NA
M05060803282016
M08285404192016
M05042504192016
Type
-------------
rgos10
main
main
main
Used Cnt
-------------
0
0
0
0
DL Cnt
-------------
0
0
1
1
Ready
-------------
Init
Init
Init
Init

2)检查BIN是否适用于AP

需要在shell下解析BIN文件的信息，查看该升级文件支持的ProductID是否与要升级的AP匹配。

/data # rpm -qpi ap740.bin

Name : main

Version : 1.0.0.735287c7

Release : 1

Architecture: arm

Install Date: (not installed)

Group : main

Size : 45499107

License : GPL

Signature : (none)

Source RPM : main-1.0.0.735287c7-1.src.rpm

Build Date : Tue Apr 19 00:29:25 2016

Build Host : ngcf26

Relocations : (not relocatable)

Summary : sup_list=0x300E0010

Description :

[kernel]

name=vmlinux-3.4.68.820e7cd6923536

ver=3.4.68.820e7cd6923536

target=ap550

[rootfs]

name=rootfs.ubi

ver=1.0.0.75a2620f

target=ap550

buildtime=2016/04/19 08:28:54

[flash]

size=256M

[softver]

ver=AP_RGOS 11.1(5)B8, Release(03161908)

其中的sup_list就是该升级文件支持的AP的ProductID信息，AP上的信息可以通过AC上的show ap-config wtp-info [ap-name]进行查看

Ruijie#show ap-config wtp-info 1fen24

Ap(1fen24)'s status:

…

Upgrading State :Init

AP Image file :NA

Image ID :1.0.0.89f6a0bf

Custom version :AM_RGOS 11.1(5)B8, Release(03161905)

Real version :AM_RGOS 11.1(5)B8, Release(03161905)

Product id :300F0010

Project id :am5528

Patch base :687e9d1

…

其中的Product id字段就是这个AP的信息了，直接与BIN文件中的sup_list进行比较，看是否能匹配到。假如匹配不到，说明BIN文件不适用于这款AP。

还存在一种情况导致AC未下发，就是升级文件已经与AP当前运行的版本相同，这一点通过比较show ac-config active-bin中的Image id和show ap-config wtp-info中的Image ID，如果两者相同，说明版本相同，不进行下发。

除了使用上述信息进行判断，还可以直接通过AP端upgrade download进行AP单独升级来验证，如果AP未升级成功，说明升级文件不匹配。如果upgrade download可以升级，但是AC无法下发，有可能是当前AP型号特殊，需要升级过渡版本或者AC端特殊配置才能支持AC下发，请联系400或者售后进行确认。

下一步

### 5.反复下发情况分析

有时会出现AC上反复下发某个升级文件，而AP却一直没有升级成功。

可能存在以下情况：

1、AP到AC的通路存在丢包，导致AC下发时常中断，无法为AP下发完整的版本。这一点可以通过AC长ping AP 1500字节的报文进行确认。如果是因为丢包造成的反复下发让AP升级不成功，请检查环境排查丢包的原因。

2、AP的空间不足，这一点经常发生在10.X的AP升级到11.x，通过观察AP端的SYSLOG是否有空间不足的提示，以及使用dir命令查看AP的可用空间大小。

3、升级文件不匹配，11.x升级文件的下发AC上会进行检查，如果不匹配将不进行下发，具体可以参考步骤4。而10.x升级到11.X，AC端只能根据配置进行下发，因此也经常出现下发错误的升级文件导致反复下发却升级不成功。这可以通过AP端copy tftp升级来确认该升级文件是否适用于AP。

4、10.x软件版本不支持较大的BIN，10.x的一部分版本存在升级文件大小的限制，例如有版本限制升级文件不大于8M，但是目前中间版本都大于该值，导致直接升级无法成功，此时需要升级10.x过渡版本，具体请联系售后以及400确认是否需要升级过渡版本。

下一步