WX2510H-PWR-WiNet 加载 WAP722XS-W2 用户脚本

https://www.h3c.com/cn/d_202410/2286926_30005_40.htm

通过这个链接进行下载

要版本吗？

1：个人觉得是你的AP有问题（大概率是AP的版本高于AC的版本，有错误提示的，所以才不可以正常上线）。

如果是这个问题的话，最简单的办法把AP格式化一下，重新下载一下版本就行。

2:WX2510H-PWR-WiNet,如果授权不够，能识别不能正常上线的。这个问题的话，直接加点授权上去就可以了。

3：个人觉得厂家既然把固件放出来，应该不会不测试就敢标支持这个型号的无线AP.

再搞不行，截图出来帮你看看或者联系人帮你远程看一下吧。应该就我说的这2个问题。

你遇到的这个问题，核心原因在于 AC当前的软件版本（R5480）内置的AP型号数据库（APDB）过旧，没有包含WAP722XS-W2的识别信息。

虽然部分资料显示R5480“原生支持”该型号，但实际排查结果（wlan ap test model ?列表中没有该型号）表明，当前软件版本的APDB并未正确收录它。这意味着AC无法识别AP的型号，自然也无法让其上线。

 核心原因与验证

你可以先在AC上执行以下命令，验证是否确实是APDB不支持：

如果输出列表中没有 WAP722XS-W2，即可确认问题根源。

 获取APDB脚本的官方途径

H3C通常不单独提供 .apdb 用户脚本文件，而是将其作为软件版本升级包的一部分进行分发。因此，获取适配R5480的APDB脚本，最直接的官方途径是：

1. 访问H3C官网软件下载页面：
   https://www.h3c.com/cn/Service/Document_Software/Software_Download/IP_Wlan/Enterprise_Series/H3C_WX2510H/

2. 在“软件下载”区域，查找与 R5480 版本配套的 “APDB增量补丁包” 或 “用户脚本”。如果官网没有单独提供，可以下载最新的完整软件版本（如R5535P12或更高），其内部已包含最新的APDB。

3. 如果官网未提供：直接拨打 400-810-0504 热线，提供设备型号和当前版本，申请获取适配R5480的APDB脚本文件或获取升级建议。

 替代方案：升级AC软件版本（推荐）

如果无法获取单独的APDB脚本，升级AC软件版本是更彻底、更推荐的解决方案。新版本软件不仅包含最新的APDB，还可能修复了旧版本的其他问题。

升级路径参考：

• 当前版本：CMW710-R5480

• 建议升级至：R5535P12 或更高的稳定版本

• 下载地址：H3C官网 WX2510H 系列软件下载页面（同上）

升级操作要点：

1. 备份配置：升级前务必备份当前配置。

2. 上传版本：通过TFTP/FTP将新的 .ipe 文件上传到AC的Flash中。

3. 指定启动文件：执行 boot-loader file flash:/xxx.ipe main。

4. 重启设备：执行 reboot 并确认。

5. 验证：重启后再次执行 display wlan ap-model，确认 WAP722XS-W2 已出现在列表中。

 补充：AP镜像文件与模式检查

除了APDB，还需确保AP的镜像文件和工作模式正确。

• AP镜像文件：WAP722XS-W2 属于 WA4300S系列，对应的FIT AP镜像文件是 wa4300s_fit.bin（而非WA5300系列的 wa5300.ipe）。你可以检查AC的Flash中是否存在该文件，以及AP是否成功下载了该镜像。

  • 检查命令：dir flash:/apimage/

• AP工作模式：确认你的WAP722XS-W2是 FIT（瘦）模式。如果是FAT（胖）模式，需要先将其切换为FIT模式才能被AC管理。

> 背景：R5480 基线系统内置 APDB 没有 WAP722XS-W2 型号，需要**用户 APDB 脚本 (.apdb)**，加载后 AC 才能识别该 AP、建立 CAPWAP 隧道。
> ⚠️重点：**我无法直接提供 apdb 脚本文件**；apdb 属于 H3C 内部版本配套文件，需要联系 H3C TAC / 代理商，提供 AC 型号 + 版本 + AP 型号申请对应 R5480 版本的 WAP722XS-W2.apdb。

## 一、前置硬性约束（加载前必须核对）

1. apdb 脚本**必须适配 CMW710-R5480 版本**，其他 R 版本 apdb 不能混用，会加载失败。
2. 用户 apdb 脚本内的 AP 型号**不能和 AC 系统自带 APDB 型号重复**；WAP722XS-W2 在 R5480 系统库不存在，满足条件。
3. 加载前：**不能有 WAP722XS-W2 手工 AP、自动 AP 上线、AP 组绑定**，否则执行`wlan apdb file`直接报错。
4. AC 仅支持**同时加载 1 份用户 apdb 脚本**；多次加载，最后一次生效。

## 二、操作完整步骤

### 步骤 1：上传 .apdb 文件到 AC flash 根目录

通过 TFTP/FTP/SCP 把`WAP722XS-W2-R5480.apdb`上传到 AC 的`flash:/`根目录

```
#上传后校验文件是否存在
dir flash:/
```

### 步骤 2：系统视图加载 APDB 脚本

```
system-view
#加载用户apdb脚本
wlan apdb file WAP722XS-W2-R5480.apdb
#保存配置
save
```

>
> 卸载脚本命令（需要替换脚本时使用）

```
system-view
undo wlan apdb file
save
```

### 步骤 3：验证加载结果

```
#查看当前加载的用户APDB
display wlan apdb user

#查看AP数据库，确认WAP722XS-W2型号已经出现
display wlan apdb model | include WAP722XS-W2
```

成功加载后，WAP722XS-W2 上电，AC 可以识别 AP 型号，正常 CAPWAP 上线。

## 三、常见加载失败原因

1. apdb 版本不匹配（不是 R5480 专用 apdb）→报错文件非法。
2. 已经存在 WAP722XS-W2 手工 AP/AP 组，需要先删除对应 AP 配置。

```
#删除手工AP
undo wlan ap apname
```

3. apdb 文件不在 flash 根目录，路径错误。
4. 文件损坏，上传不完整；重新上传。

## 四、重要注意事项

1. AC 重启之后，**apdb 文件必须还保留在 flash 里**，否则重启后用户 APDB 丢失，WAP722XS-W2 无法识别。
2. 如果后续替换 apdb 文件：flash 内替换文件后，**必须重新执行 wlan apdb file 重新加载**，否则新脚本不生效。
3. 补丁 R5480C02 不影响 APDB 加载逻辑，加载操作和原生 R5480 完全一致。

## 五、向 H3C TAC 申请 apdb 脚本需要提供信息

1. AC 型号：WX2510H-PWR-WiNet，硬件 Ver.B
2. 版本：CMW710-R5480，补丁 R5480C02
3. 需要 AP 型号：WAP722XS-W2
4. 需求：提供适配 R5480 版本的 apdb 用户脚本文件

## 六、排错命令清单

```
#查看用户APDB
display wlan apdb user
#查看全部AP型号库
display wlan apdb model
#查看wlan apdb相关日志
display logbuffer | include apdb
```