WX3820X无线AC控制器云集群升级指导

一、官方权威文档获取渠道
1. 新华三官网标准升级手册（V9 平台 WX3800X 系列通用）
软件升级通用指导：https://www.h3c.com/cn/d_201904/1173580_30005_0.htmH3C
2. 云集群拆分升级实操案例（知了社区官方标准方案，适配 WX3820X）
https://zhiliao.h3c.com/questions/dispcont/320789
3. WX3800X 产品白皮书（云集群特性说明）
***.***/userfiles/20085/attachment/4091930/20220811_2fee895e4590293afe09dd2c6c44139c/20220712_7461559_H3C_WX3800X_New_Generation_Access_Controller_Datasheet_1628871_294549_0.pdf
4. 版本说明书（必看，随 IPE 包配套下载）
官网软件下载页对应 Rxxxx 版本，文档内包含：AP 兼容清单、BootROM 配套要求、云集群升级限制、ISSU 支持判断。
二、核心升级原则（云集群≠IRF 堆叠，必须拆分升级，不支持集群内 ISSU）
云集群双机 1+1 主备不支持集群内在线平滑 ISSU，必须先拆分集群，单机依次升级；
升级顺序：拆分集群 → 先升级备机 → 业务切至备机 → 升级主机 → 重新合并集群；
拆分期间备机 License 共享失效风险：操作全程控制在 30 分钟内完成（超过 30 天共享授权失效，短时无影响）；
两台 AC 最终必须完全一致版本，否则无法合并云集群。
三、完整标准化升级步骤
前置准备（升级前必做）
备份两台 AC 配置
plaintext
# 主、备AC分别执行
save force
tftp put flash:/startup.cfg tftp服务器IP startup.cfg
# 备份当前启动镜像
dir flash:/
tftp put flash:/wx3820x.ipe tftp服务器IP old-wx3820x.ipe

校验集群健康状态
plaintext
display wlan cloud-cluster status
# 确认成员状态Normal、无split分裂告警
display wlan ap all
# AP全部在线，无离线故障

上传目标版本 IPE 到主、备两台 AC flash 根目录
plaintext
# tftp上传示例
tftp 192.168.1.100 get wx3820x-cmw910-rxxxx.ipe
dir flash:/ | include wx3820x

核对版本兼容性：目标版本说明书确认支持 WX3820X、现有 WA 系列 AP 型号。
步骤 1：拆分云集群（主 AC 执行）
plaintext
# 查看集群成员ID
display wlan cloud-cluster member
# 拆分备机（替换为备机实际member ID）
wlan cloud-cluster member 2 split

拆分效果：
备 AC 独立脱离集群，所有在线 AP 自动迁移至主 AC，WiFi 业务无中断；
备 AC 变为单机，原有集群配置保留，可独立升级。
步骤 2：升级备 AC（先升备，业务不中断）
Console/SSH 单独登录备 AC；
指定新版本 IPE 为下次启动主文件
plaintext
boot-loader file flash:/wx3820x-cmw910-rxxxx.ipe slot 1 main
save
reboot

重启完成后校验版本
plaintext
display version
display boot-loader
# 确认集群拆分状态，单机运行正常
display wlan cloud-cluster status

步骤 3：业务手动切换至已升级备 AC
plaintext
# 主AC执行，强制AP迁移至备机
wlan cloud-cluster switchover
# 验证AP全部切换到备AC上线
display wlan ap all

此时主 AC 无在线 AP，可安全升级。
步骤 4：升级主 AC
登录主 AC，执行相同升级操作：
plaintext
boot-loader file flash:/wx3820x-cmw910-rxxxx.ipe slot 1 main
save
reboot

重启后核对版本与备机完全一致。
步骤 5：两台 AC 全部升级完成后，合并云集群
登录主 AC 执行合并：
plaintext
# 填入备机集群成员ID
wlan cloud-cluster member 2 merge
# 查看集群恢复正常
display wlan cloud-cluster status

步骤 6：收尾验证
display wlan cloud-cluster status 双机 Normal，主备角色正常；
display wlan ap all AP 均衡分布、无离线；
测试漫游、Portal、802.1X 等无线业务正常；
保存配置，两台 AC 分别save force。
四、关键风险与注意事项
License 共享限制
拆分集群后备机不再共享主机 License，短时间（半小时内）升级无影响；若拆分超过 30 天，备机无线授权失效，AP 无法注册。
版本必须完全一致
主、备 AC 小版本号必须 100% 匹配，高低版本无法合并云集群。
禁止集群内直接重启整机升级
未拆分集群直接重启单台 AC，会触发集群分裂、AP 批量掉线、业务长时间中断。
AP 固件同步
集群合并后，AC 会自动下发配套 AP 镜像，等待 AP 自动升级完成，避免无线漫游异常。
回滚方案
升级异常无法合并集群：单机执行boot-loader切回旧 IPE，重启后重新拆分 / 合并。
五、快速排查验证命令
plaintext
# 集群状态
display wlan cloud-cluster status
display wlan cloud-cluster member

# 版本校验
display version
display boot-loader

# AP在线统计
display wlan ap all
display wlan ap statistics image-download

参考官网案例：

WX3820X 的“云集群”功能本质上是一种双AC高可用性组网，其升级并非独立操作，而是遵循标准的 Comware V9 系统升级流程。

你可以参考 WX3800X 系列的配置指导（Configuration Guides）和软件升级（Software upgrade）章节来操作，并额外关注集群环境下的特殊步骤。

📋 升级前的准备工作

在正式开始升级前，请务必完成以下准备：

1. 检查当前版本与兼容性：登录AC，使用 display version 命令查看当前软件版本。然后访问H3C官网，确认目标版本与你的WX3820X硬件及当前BootWare版本兼容。

2. 备份关键数据：这是最重要的一步。请务必备份好当前的配置文件（.cfg文件）和License文件。

3. 准备升级文件：从H3C官网下载正确的WX3820X升级文件（.ipe文件），并将其上传到主AC设备的Flash或CF卡中。

4. 检查集群状态：在升级前，请确保云集群（双AC）处于稳定运行状态，主备AC的角色明确且同步正常。

🚀 云集群环境升级步骤

在云集群（双AC）环境下升级，核心原则是“主备轮流升级，确保业务不中断”。

1. 升级备AC：

   • 在业务低峰期，先对当前备用的AC执行升级操作。

   • 使用 boot-loader file ... slot ... main 命令指定下次启动的软件包。

   • 执行 reboot 命令重启备AC。

   • 备AC重启并完成升级后，它会重新加入集群并自动与主AC同步状态。

2. 执行主备倒换：

   • 备AC升级成功后，手动执行主备倒换操作，将业务流量切换到已升级的备AC上。

   • 通常在Web界面或通过 system-view 下的 wlan ac-role { master | backup } 等命令可以完成角色切换。

   • 确认业务已成功切换到新的主AC，且运行稳定。

3. 升级原主AC：

   • 现在，原主AC已变为备用角色，可以安全地对其执行与第一步相同的升级操作。

4. 恢复主备角色（可选）：

   • 两台AC都升级完成后，如果需要，可以再次执行主备倒换，将主AC角色切换回原来的设备。

✅ 验证与回滚

• 验证：升级全部完成后，执行 display version 确认两台AC的版本都已更新。同时，检查AP是否全部重新上线，业务是否正常。

• 回滚：如果升级失败，可以重启AC并让其加载之前备份的旧版软件包，或者使用 boot-loader 命令指定备份的软件包为下次启动文件来快速回滚。

⚠️ 关键注意事项

• AP License同步：在双AC集群中，License需要在主备AC间同步。升级后，请务必检查License状态是否正常。

• AP热备份功能：为确保AP在AC升级期间不掉线，请确认已开启全局AP热备份功能：

  text

  <H3C> system-view [H3C] wlan ap-backup hot-backup enable global

  同时，建议也开启终端热备份功能：

  text

  [H3C] wlan client-backup hot-backup enable

• 业务影响评估：虽然“主备轮流升级”能将业务中断降到最低，但在主备倒换的瞬间，仍可能会有毫秒级的丢包。建议在业务低峰期操作。