CiscoC9800-L-C-K9：通过 GUI 升级无线控制器

CiscoC9800-L-C-K9：通过 GUI 升级无线控制器

(1)现在的版本

(2)准备好系统文件

已上传

这个报错：

bootflash:/C9800-L-universalk9_wlc.17.12.04.SPA.bin is not valid file or cannot be handled by install CLI

意思就是：系统不认这个 bin 文件，无法用 install 方式安装。结合你的设备是 C9800-L，原因和解决办法如下（按最常见到最少见排序）：

一、镜像平台选错（最常见）

C9800-L（物理机）：必须用 C9800-L-xxxx_wlc.bin

C9800-CL（虚拟机）：用 C9800-CL-xxxx.bin（不带 wlc）

你文件名是：C9800-L-universalk9_wlc.17.12.04.SPA.bin

如果当前是 Bundle 模式，不支持 install add

C9800 有两种模式：

Bundle 模式（老启动方式）：只能用 boot system，不支持 install add

Install 模式（推荐）：支持 install add/activate/commit

查看当前模式

show version | include Install

WLC#show version | include Install

Installation mode is INSTALL

WLC

install add file bootflash:C9800-L-universalk9_wlc.17.12.04.SPA.bin

WLC#install add file bootflash:C9800-L-universalk9_wlc.17.12.04.SPA.bin

install_add: START Wed Jun 10 22:31:13 CST 2026

*Jun 10 14:31:14.610: %INSTALL-5-INSTALL_START_INFO: Chassis 1 R0/0: install_engine: Started install add bootflash:C9800-L-universalk9_wlc.17.12.04.SPA.binFAILED: install_add : bootflash:C9800-L-universalk9_wlc.17.12.04.SPA.bin is not valid file or cannot be handled by install CLI.

WLC#

*Jun 10 14:31:24.754: %INSTALL-3-OPERATION_ERROR_MESSAGE: Chassis 1 R0/0: install_engine: Failed to install_add package bootflash:C9800-L-universalk9_wlc.17.12.04.SPA.bin, Error: File bootflash:C9800-L-universalk9_wlc.17.12.04.SPA.bin is corrupt or is not a valid package.

*Jun 10 14:31:24.777: %INSTALL-3-OPERATION_ERROR_MESSAGE: Chassis 1 R0/0: install_engine: Failed to install_add package bootflash:C9800-L-universalk9_wlc.17.12.04.SPA.bin, Error: install_add : bootflash:C9800-L-universalk9_wlc.17.12.04.SPA.bin is not valid file or canWLC#be handled by install CLI.

WLC#

如果成功，再：

install activate

install commit

核心原因 & 区分镜像（重点）

C9800-L 17.x 分两种 bin 镜像，不能混用：

Bundle 镜像：文件名 C9800-L-universalk9_wlc.xxx.bin

用途：仅用于 Bundle 模式启动，INSTALL 模式下执行 install add 直接报错（你现在遇到的问题）

INSTALL 模式专用镜像：文件名 C9800-L-mono-universalk9_wlc.xxx.bin

带mono标识，才是给install add命令使用的完整安装包，解压后生成.pkg文件

你现在的文件是Bundle 版 bin，在 INSTALL 模式下无法被 install 指令识别，这是根本原因。

#

两种解决办法（二选一）

方案 1（推荐）：下载带 mono 的 INSTALL 专用镜像

重新获取文件：C9800-L-mono-universalk9_wlc.17.12.04.SPA.bin（带 mono）

FTP 二进制模式重新上传到 bootflash

执行完整升级命令

# 清理旧无用包

install remove inactive

# 一键添加+激活+提交（自动重启）

install add file bootflash:C9800-L-mono-universalk9_wlc.17.12.04.SPA.bin activate commit

https://software.cisco.com/download/find/9800

方案 2：切回 Bundle 模式，使用现有镜像

不想重新下镜像，就切换运行模式，用传统 boot 方式升级：

# 进入配置模式

conf t

# 指定Bundle镜像为启动文件

boot system bootflash:C9800-L-universalk9_wlc.17.12.04.SPA.bin

exit

# 保存配置

write memory

# 重启生效

reload

重启后设备变为Bundle 模式，后续升级也只能用boot system方式。

还是从旧版本启动，如下图所示：

重启后：

install remove inactive 是Cisco IOS-XE 平台（无线控制器 WLC、路由器、交换机等） 清理系统内非活跃旧版本镜像 / 安装包的命令，作用是删除设备上留存的冗余固件、补丁文件，释放存储空间。

WLC#install remove inactive

install_remove: START Wed Jun 10 22:54:18 CST 2026

*Jun 10 14:54:19.879: %INSTALL-5-INSTALL_START_INFO: Chassis 2 R0/0: install_engine: Started install remove

查看剩余安装包 / 镜像（确认清理效果）

show install summary

补充说明

该命令不会删除当前正在运行的活跃系统版本，仅清旧包、临时文件；

执行过程请勿断电 / 重启，避免文件系统异常；

若后续出现 %INSTALL-3-ERROR 类日志，代表清理失败，需排查磁盘空间、文件权限。

WLC#show install summary

[ Chassis 2 ] Installed Package(s) Information:

State (St): I - Inactive, U - Activated & Uncommitted,

            C - Activated & Committed, D - Deactivated & Uncommitted

--------------------------------------------------------------------------------

Type  St   Filename/Version    

--------------------------------------------------------------------------------

IMG   C    16.12.04a.0.9                                                       

--------------------------------------------------------------------------------

Auto abort timer: inactive

--------------------------------------------------------------------------------

WLC#

不需要单独下一个叫 …mono?….bin 的文件；

你只要把官方那个 C9800-L-universalk9_wlc.V1712_4_ESW13.SPA.bin 重新上传（二进制），然后在 INSTALL 模式执行：

plaintext

install remove inactive

install add file bootflash:C9800-L-universalk9_wlc.V1712_4_ESW13.SPA.bin activate commit

设备会自动把它当成 mono 包处理，自动生成 .pkg，不用你手动找 mono.bin。

WLC#install add file bootflash:C9800-L-universalk9_wlc.V1712_4_ESW13.SPA.bin activate commit

WLC#$flash:C9800-L-universalk9_wlc.V1712_4_ESW13.SPA.bin activate commit     

install_add_activate_commit: START Wed Jun 10 22:58:40 CST 2026

FAILED: install_add_activate_commit : bootflash:C9800-L-universalk9_wlc.V1712_4_ESW13.SPA.bin is not valid file or cannot be handled by install CLI.

WLC#

*Jun 10 14:58:41.792: %INSTALL-5-INSTALL_START_INFO: Chassis 2 R0/0: install_engine: Started install one-shot bootflash:C9800-L-universalk9_wlc.V1712_4_ESW13.SPA.bin

*Jun 10 14:58:42.130: %INSTALL-3-OPERATION_ERROR_MESSAGE: Chassis 2 R0/0: install_engine: Failed to install_add_activate_commit package bootflash:C9800-L-universalk9_wlc.V1712_4_ESW13.SPA.bin, Error: install_add_activate_commit : bootflash:C9800-L-universalk9_wlc.V1712_4_ESW13.SPA.bin is not valid file or cannot be handled by install CLI.

先确认：你现在到底是不是真正的 INSTALL 模式

show version | include Installation show boot

WLC#show version | include Installation

Installation mode is INSTALL

WLC#

WLC#

WLC#show boot                          

BOOT variable = bootflash:packages.conf,12;,1;C9800-L-universalk9_wlc.17.12.04.SPA.bin,1;bootflash:C9800-L-universalk9_wlc.17.12.04.SPA.bin,12;

CONFIG_FILE variable does not exist

BOOTLDR variable does not exist

Configuration register is 0x2102

Standby not ready to show bootvar

WLC#

Initiating upgrade

Setting boot params.

Verifying file integrity of bootflash:C9800-L-universalk9_wlc.17.12.04.SPA.bin.....

Embedded Hash   SHA1 : 2E68828FA970CC7AAA74EE606FF1A9177FC768E4

Computed Hash   SHA1 : 41E9E65C60C48DEB11216E5383A9F7720FF801CB

Embedded hash verification failed for file bootflash:C9800-L-universalk9_wlc.17.12.04.SPA.bin.

Embedded Hash（内置哈希）是官方原始值：2E68828FA970CC7AAA74EE606FF1A9177FC768E4

你设备现场算出的 41E9E65C60C48DEB11216E5383A9F7720FF801CB 是错误值，证明文件已损坏。

结论：你上传的 17.12.04.SPA.bin 文件是坏的 / 不完整 / 传错了 / 被篡改了。

不是配置问题，不是命令问题，就是镜像文件本身损坏。

删除

WLC#delete bootflash:C9800-L-universalk9_wlc.17.12.04.SPA.bin

Delete filename [C9800-L-universalk9_wlc.17.12.04.SPA.bin]? 

Delete bootflash:/C9800-L-universalk9_wlc.17.12.04.SPA.bin? [confirm]

WLC#

verify bootflash:C9800-L-universalk9_wlc.17.12.04.SPA.bin

固件下载：

https://software.cisco.com/download/home/286323158/type/282046477/release/Dublin-17.12.4?catid=278875243

System Bootstrap, Version 16.12(3r), RELEASE SOFTWARE

Copyright (c) 1994-2019  by cisco Systems, Inc.

Current image running: Boot ROM0

Last reset cause: LocalSoft

The values of MSR  0x198h = 00001400 and MSR 0x199h = 00001400 for KATAR

C9800-L-X-K9 platform with 16777216 Kbytes of main memory

File size is 0x509a0000

Located C9800-L-universalk9_wlc.17.12.04.SPA.bin 

Image size 1352269824 inode num 16, bks cnt 330144 blk size 8*512

######################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################

Boot image size = 1352269824 (0x509a0000) bytes

ROM:RSA Self Test Passed

ROM:Sha512 Self Test Passed

Package header rev 3 structure detected

File's package len 0x509a0000 doesn't match 0x509c470a in header

Calculating SHA-1 hash...done

validate_package_cs: SHA-1 hash:

        calculated 41e9e65c:60c48deb:11216e53:83a9f772:0ff801cb

        expected   2e68828f:a970cc7a:aa74ee60:6ff1a917:7fc768e4

SHA-1 hash doesn't match

Failed to Free memory block at address 0x000000008592f000

boot: error executing "boot bootflash:C9800-L-universalk9_wlc.17.12.04.SPA.bin"

autoboot: boot failed, restarting...

故障总结

C9800-L 无线控制器镜像文件校验失败，无法启动系统，核心原因：固件包大小、SHA1 哈希值与官方标准不匹配，文件损坏 / 传输不完整 / 版本文件错误。

关键报错解读

File's package len 0x509a0000 doesn't match 0x509c470a

固件实际大小 ≠ 头部记录的标准大小，文件残缺 / 篡改。

SHA-1 hash doesn't match

哈希校验不通过，镜像文件已损坏。

boot: error executing "boot bootflash:xxx.bin"

自动启动失败，设备反复重启。

分步解决（按优先级）

1. 重新获取完整官方固件

前往思科官网下载 C9800-L-universalk9_wlc.17.12.04.SPA.bin 原版文件，核对文件大小、MD5/SHA1 值与官网一致。

禁止断点续传、第三方修改、压缩包内直接上传。