此产品的文档集力求使用非歧视性语言。在本文档集中,非歧视性语言是指不隐含针对年龄、残障、性别、种族身份、族群身份、性取向、社会经济地位和交叉性的歧视的语言。由于产品软件的用户界面中使用的硬编码语言、基于 RFP 文档使用的语言或引用的第三方产品使用的语言,文档中可能无法确保完全使用非歧视性语言。 深入了解思科如何使用包容性语言。
思科采用人工翻译与机器翻译相结合的方式将此文档翻译成不同语言,希望全球的用户都能通过各自的语言得到支持性的内容。 请注意:即使是最好的机器翻译,其准确度也不及专业翻译人员的水平。 Cisco Systems, Inc. 对于翻译的准确性不承担任何责任,并建议您总是参考英文原始文档(已提供链接)。
本文档介绍并解释升级无线LAN控制器(WLC)上的软件的过程和要求。
有关每个特定版本的准确升级路径、下载信息和升级程序信息,请参阅 WLC 软件版本说明。
例如,如果迁移到版本8.10.171.0,请参阅Cisco无线控制器和轻量接入点版本8.10.171.0发行版本注释的“升级Cisco无线发行版”部分。
除了基本的网络知识以及对Cisco无线局域网控制器的基本配置和安装的熟悉之外,请确保您阅读发行说明中的指南和建议。例如,请点击此处查看版本 8.10.171.0 的规定和建议。
支持的思科无线版本8.10.x的升级路径:
当前软件版本 | 升级到版本8.10.x的路径 |
8.5.x | 您可以直接升级到版本8.10.x。 |
8.8.x | 您可以直接升级到版本8.10.x |
8.10.x | 您可以直接升级到版本8.10.x |
强烈建议您使用当前推荐的版本保持WLC最新。您可以在此处查看当前推荐的版本:建议使用的 AireOS 无线局域网控制器版本.
在此过程中,请勿关闭控制器或任何接入点的电源;否则,您可以损坏软件映像。升级带有大量接入点的控制器可能需要长达30分钟(具体取决于网络规模)。 但是,随着控制器软件版本支持的并发接入点升级数量的增加,升级时间显着缩短。接入点必须保持通电,此时不能重置控制器。
您可以通过以下选项减少网络停机时间:
您可以预下载AP映像。借助此功能,您可以将升级映像下载到控制器,然后在网络仍处于运行状态时将映像下载到无线接入点。使用新的 CLI,可以为两台设备指定启动映像,并在控制器重置时重置无线接入点。
有关如何为此功能配置WLC和LAP的信息,请参阅Cisco无线LAN控制器配置指南,版本8.10的预下载映像到接入点部分。
对于 FlexConnect 无线接入点,请使用 FlexConnect 高效无线接入点升级功能来减少控制器与无线接入点(主站点和分支机构)之间的流量。
有关FlexConnect AP升级配置的详细信息,请参阅思科无线局域网控制器配置指南,版本8.10的为FlexConnect AP配置FlexConnect AP升级一章。确保您的AP支持您尝试升级到的新版本。请参阅兼容性矩阵https://www.cisco.com/c/en/us/td/docs/wireless/compatibility/matrix/compatibility-matrix.html。
本文档中的信息基于以下软件和硬件版本:
存储升级文件的FTP服务器
本文档中的信息都是基于特定实验室环境中的设备编写的。本文档中使用的所有设备最初均采用原始(默认)配置。如果您的网络处于活动状态,请确保您了解所有命令的潜在影响。
本文档也适用于以下硬件平台:
思科 3504 系列无线局域网控制器
注意:验证您的AP与您计划升级的软件是否兼容,以避免在升级过程中丢失AP。请参阅兼容性列表:https://www.cisco.com/c/en/us/td/docs/wireless/compatibility/matrix/compatibility-matrix.html.
您可以使用 CLI 或 GUI 升级 Cisco WLC。
注意:强烈建议在执行升级之前备份无线局域网控制器上的配置。
本部分提供有关如何在控制器上使用 GUI 升级 WLC 的信息。
当您使用GUI升级WLC时,在控制器重新启动的时间段内,您将丢失第3层(IP)连接。因此,建议使用控制台端口连接检查升级过程中控制器的状态,并在必要时加快任何恢复过程。
执行下列步骤:
注意:对于繁忙的网络、利用率高的控制器和小型控制器平台,我们建议您禁用 802.11 网络,作为一项预防措施。
FTP传输设置
13.单击下载将软件下载到控制器。将显示一条指示下载状态的消息。
14.下载完成后,单击 重新启动
15.如果系统提示您保存更改,请单击 保存并重新启动
16.单击OK确认您决定重新启动控制器
17.如果已禁用802.11网络,请重新启用它们
18.(可选)要验证控制器软件是否已安装在您的控制器上,请在控制器GUI上,单击Monitor并查看Controller Summary下的Software Version字段
在本节中,您会看到使用控制器上的CLI升级WLC以及FTP服务器中的文件的信息。
请完成以下步骤:
请确保可从控制器访问 FTP 服务器,并确保升级文件位于 FTP 服务器的某个目录中。
最好通过控制台端口完成此过程,但您也可以通过SSH或Telnet(如果已启用)访问WLC管理IP地址以完成此过程。使用SSH或Telnet会导致在映像下载后的重新启动过程中与控制器失去连接。因此,如果升级失败,可以使用控制台访问来加快控制器的故障排除和恢复。登录到控制器并发出show sysinfo命令以验证当前在控制器上运行的软件。
以下是show sysinfo命令的示例输出,其中显示控制器运行8.5.182.0:
(c3504-01) >show sysinfo
Manufacturer's Name.............................. Cisco Systems Inc.
Product Name..................................... Cisco Controller
Product Version.................................. 8.5.182.0
RTOS Version..................................... 8.5.182.0
Bootloader Version............................... 8.5.103.0
Emergency Image Version.......................... 8.5.103.0
完成以下步骤以定义下载参数:
发出transfer download mode ftp命令以定义文件传输模式
发出transfer download serverip FTP_server_IP_address 命令以定义FTP服务器IP地址
发出transfer download path 'FTP_server_path'命令以定义控制器操作系统软件所在的FTP默认目录的路径
发出transfer download filename命令以指定映像的名称
示例如下:
(c3504-01) >transfer download datatype code
(c3504-01) >transfer download mode ftp
(c3504-01) >transfer download username admin
(c3504-01) >transfer download password ********
(c3504-01) >transfer download serverip 192.168.1.2
(c3504-01) >transfer download path /Shared/AIR-CT3504/
(c3504-01) >transfer download filename AIR-CT3504-K9-8-10-171-0.aes
发出 transfer download start 命令以启动升级进程。
以下是升级进程的示例:
(c3504-01) >show boot
Primary Boot Image............................... 8.5.182.0 (default) (active)
Backup Boot Image................................ 8.10.162.0
(c3504-01) >transfer download start
Mode............................................. FTP
Data Type........................................ Code
FTP Server IP.................................... 192.168.1.2
FTP Server Port.................................. 21
FTP Path......................................... /Shared/Images/3504/
FTP Filename..................................... AIR-CT3504-K9-8-10-171-0.aes
FTP Username..................................... admin
FTP Password..................................... *********
This may take some time.
Are you sure you want to start? (y/N) y
FTP Code transfer starting.
FTP receive complete... extracting components.
Checking Version Built.
Image version check passed.
Executing Product Check TLV.
Executing init script.
Executing backup script.
Writing new RTOS to flash disk.
Executing install_rtos script.
Writing new Kernel-args to flash disk.
Writing new FP to flash disk.
Writing new AP Image Bundle to flash disk.
Writing AVC Files to flash disk.
Executing fini script.
Reading AP IMAGE version info.
File transfer is successful.
Reboot the controller for update to complete.
Optionally, pre-download the image to APs before rebooting to reduce network downtime.
(c3504-01) >show boot
Primary Boot Image............................... 8.10.171.0 (default)
Backup Boot Image................................ 8.5.182.0 (active)
在升级进程完成后重新启动控制器以使新代码生效。
发出reset system命令,然后输入y或yes,以回答问题“是否要立即保存它们?”。
(Cisco Controller) >reset system
The system has unsaved changes.
Would you like to save them now? (y/N) y
Read from Flash Completed ...
Updating HBL license statistics file
Done.
Configuration Saved!
System will now restart!
Updating license storage ... Done.
Exiting SL process !
There was change in the boot image, System will go for a reboot
Cannot Cancel the WDT. Not petting the WDT.
Collect the core using oct utility
Rebooting the system..
[74411.034881] reboot: Restarting system
Cisco bootloader . . .
Cisco BootLoader Version : 8.5.103.0 (Cisco build) (Build time: Jul 25 2017 - 07:47:10)
Octeon unique ID: 03c000610221f31e0057
OCTEON CN7240-AAP pass 1.3, Core clock: 1500 MHz, IO clock: 800 MHz, DDR clock: 1067 MHz (2134 Mhz DDR)
DRAM: 8 GiB
Clearing DRAM...... done
CPLD Revision : a5
Reset Reason : Soft reset due to RST_SOFT_RST write
SF: Detected S25FL064A with page size 256 Bytes, erase size 64 KiB, total 8 MiB
MMC: Octeon MMC/SD0: 0 (Type: MMC, Version: MMC v5.1, Manufacturer ID: 0x15, Vendor: Man 150100 Snr 0707a546, Product: BJNB4R, Revision: 0.7)
Net: octmgmt0, octmgmt1, octeth0, octeth1, octeth2, octeth3, octeth4, octeth5, octeth6
SF: Detected S25FL064A with page size 256 Bytes, erase size 64 KiB, total 8 MiB
Press <ESC> now to access the Boot Menu...
Loading backup image (8.8.111.0)
94767283 bytes read in 2229 ms (40.5 MiB/s)
Launching...
Verifying images... OK
Launching images...
[...]
XML config selected
Validating XML configuration
octeon_device_init: found 1 DPs
Cisco is a trademark of Cisco Systems, Inc.
Software Copyright Cisco Systems, Inc. All rights reserved.
Cisco AireOS Version 8.8.111.0
Initializing OS Services: ok
Initializing Serial Services: ok
Initializing Network Services: ok
[...]
当您对控制器代码的版本降级时,不会保留配置。可以将控制器从一个版本升级到另一个版本。如果您需要从一个版本降级到另一个版本,则可能无法使用更高版本的配置。解决方法是重新加载保存在备用服务器上的以前的控制器配置文件或重新配置控制器。
手动将设备升级到最新软件版本可能容易出错并耗费时间。Cisco Prime基础设施(PI)借助规划、计划、下载和监控软件映像更新的帮助,简化了软件更新的版本管理和日常部署。您还可以查看软件映像详细信息,查看推荐的软件映像,以及删除软件映像。软件映像管理页面提供映像管理的各个方面的整合视图,例如软件映像管理生命周期构件、软件映像摘要和作业详细信息。
Prime 基础设施存储着网络中各种设备的所有软件映像。根据图像类型和版本存储图像。
有关详细信息,请参阅《Cisco PI用户指南》的管理设备软件映像一章。
在本节中,您会看到一些软件升级方案的列表:
主用控制器上的软件升级可确保备用热控器的升级
不支持服务中升级,因此建议您在升级HA环境中的控制器之前规划网络停机时间
如果在软件升级后重新启动主用控制器,它也会重新启动热备份控制器
建议在运行config boot backupcommand之前,主用和备用热控制器在备份中具有相同的软件映像。如果活动控制器和备用热控制器在备份中有不同的软件映像,并且如果在活动控制器中运行config boot backupcommand,则两个控制器都会使用各自的备份映像重新启动,并且由于软件不匹配而中断HA对。
在高可用性环境中,计划重置将同时应用于两台控制器。对等控制器在活动控制器的计划时间到期前的一分钟重新启动
如果不计划计划定期重置,则可以使用reset peer-systemcommand从主用控制器重新启动备用热控制器。如果使用此命令仅重置备用热控制器,则备用热控制器上所有未保存的配置都将丢失。因此,重置热备用控制器之前,请务必在主用控制器上保存配置。
如果在映像传输时触发SSO,则重新启动映像前下载
备用热控制器上只允许使用debugandshowcommand
有关在HA AP-SSO设置中升级WLC的详细说明,请按照《高可用性(SSO)部署指南》文档中的步骤操作。
默认情况下,WLC 维护两个映像。这些映像是主映像和备用映像。主映像是 WLC 使用的活动映像,而备用映像用作活动映像的备份。
当您使用新映像升级 WLC 时,WLC 会自动在备用映像上复制新映像。
要查看控制器当前运行的活动映像(主映像),请在 WLC GUI 中点击 Monitor(监控),然后在 WLC GUI 中查看“Controller Summary”(控制器摘要)下的“Software Version”(软件版本)字段。在CLI中,您可以使用命令show boot查看主映像并备份WLC上存在的映像。示例如下:
(c3504-01) >show boot
Primary Boot Image............................... 8.5.182.0 (default) (active)
Backup Boot Image................................ 8.10.162.0
要删除或覆盖 WLC 上的一个映像,请使用您希望保留的映像启动 WLC 并执行升级。这样,新映像将替换备用映像。
您还可以使用config boot <primary/backup>命令手动更改WLC的活动引导映像。
(Cisco Controller) >config boot ? primary Sets the primary image as active. backup Sets the backup image as active.
通过 WLC GUI 也可以配置 config boot 映像。有关详细操作步骤的更多信息,请参阅如何使用无线局域网控制器 (WLC) 上的备份映像。
注意:您需要保存并重新启动 WLC 配置,以便 WLC 使用新的活动映像。
要验证已安装的WLC软件的版本,请在系统重新启动后登录到控制器。
从 GUI:
WLC版本验证
升级后,在 CLI 中发出以下命令:
(c3504-01) >show sysinfo
Manufacturer's Name.............................. Cisco Systems Inc.
Product Name..................................... Cisco Controller
Product Version.................................. 8.10.171.0
RTOS Version..................................... 8.10.171.0
Bootloader Version............................... 8.5.103.0
Emergency Image Version.......................... 8.5.103.0
您可以使用debug transfer all enable命令查看控制器软件升级过程中发生的事件。以下是一个示例,其中显示了用于成功软件升级的debug命令输出:
(Cisco Controller) >debug transfer all enable
(Cisco Controller) >transfer download start
Mode............................................. FTP
Data Type........................................ Code
FTP Server IP.................................... 192.168.1.2
FTP Server Port.................................. 21
FTP Path......................................... /Shared/AIR-CT3504/
FTP Filename..................................... AIR-CT3504-K9-8-8-111-0.aes
FTP Username..................................... admin
FTP Password..................................... *********
This may take some time.
Are you sure you want to start? (y/N) y
*TransferTask: Mar 06 14:56:49.928: Memory overcommit policy changed from 0 to 1
*TransferTask: Mar 06 14:56:49.928: Delete ramdisk for ap bundle
*TransferTask: Mar 06 14:56:49.939: RESULT_STRING: FTP Code transfer starting.
*TransferTask: Mar 06 14:56:49.939: RESULT_CODE:1
FTP Code transfer starting.
*TransferTask: Mar 06 14:58:52.024: ftp operation returns error code:0 error:Transfer Successful
*TransferTask: Mar 06 14:58:52.034: tftp = 6, file_name=/Shared/AIR-CT3504/AIR-CT3504-K9-8-8-111-0.aes, ip_address=192.168.1.2, msg=Transfer Successful
*TransferTask: Mar 06 14:58:52.034: upd_get_code = 6 (target=268435457 msg=Transfer Successful)
*TransferTask: Mar 06 14:58:52.034: RESULT_STRING: FTP receive complete... extracting components.
*TransferTask: Mar 06 14:58:52.034: RESULT_CODE:6
FTP receive complete... extracting components.
*TransferTask: Mar 06 14:59:07.442: RESULT_STRING: Checking Version Built.
Checking Version Built.
*TransferTask: Mar 06 14:59:09.442: RESULT_STRING: Image version check passed.
Image version check passed.
*TransferTask: Mar 06 14:59:12.443: RESULT_STRING: Executing Product Check TLV.
*TransferTask: Mar 06 14:59:12.444: RESULT_STRING: Executing Version Built TLV.
*TransferTask: Mar 06 14:59:12.444: RESULT_STRING: Executing init script.
*TransferTask: Mar 06 14:59:12.457: RESULT_STRING: Executing backup script.
*TransferTask: Mar 06 14:59:13.508: RESULT_STRING: Writing new RTOS to flash disk.
Writing new RTOS to flash disk.
*TransferTask: Mar 06 14:59:20.810: RESULT_STRING: Executing install_rtos script.
Executing install_rtos script.
*TransferTask: Mar 06 14:59:24.878: RESULT_STRING: Writing new Kernel-args to flash disk.
*TransferTask: Mar 06 14:59:24.892: RESULT_STRING: Writing new FP to flash disk.
*TransferTask: Mar 06 14:59:25.451: RESULT_STRING: Writing new AP Image Bundle to flash disk.
Writing new AP Image Bundle to flash disk.
*TransferTask: Mar 06 14:59:44.044: RESULT_STRING: Writing AVC Files to flash disk.
Writing AVC Files to flash disk.
*TransferTask: Mar 06 14:59:44.703: RESULT_STRING: Executing fini script.
Executing fini script.
*TransferTask: Mar 06 14:59:52.860: RESULT_STRING: Reading AP IMAGE version info.
*TransferTask: Mar 06 14:59:52.865: RESULT_CODE:11
*TransferTask: Mar 06 14:59:52.865: RESULT_STRING: File transfer is successful.
Reboot the controller for update to complete.
Optionally, pre-download the image to APs before rebooting to reduce network downtime.
File transfer is successful.
Reboot the controller for update to complete.
Optionally, pre-download the image to APs before rebooting to reduce network downtime.
*TransferTask: Mar 06 14:59:58.871: Create ramdisk for ap bundle
*TransferTask: Mar 06 14:59:58.884: Memory overcommit policy restored from 1 to 0
(Cisco Controller) >
使用本部分可以排除软件升级故障。
在升级过程中,可能会遇到错误。此部分介绍几种常见错误及其典型原因,以及为完成 WLC 软件升级而可以采取的纠正措施:
版本 | 发布日期 | 备注 |
---|---|---|
3.0 |
07-Jul-2022 |
修订后的WLC版本和文本。 |
1.0 |
24-Jan-2006 |
初始版本 |