无线 LAN 控制器 (WLC) 软件升级

简介

本文包括常规手续并且解释步骤和需求为了升级软件在无线局域网控制器(WLC)。

请参阅WLC软件版本笔记关于一准确升级路径、下载信息和升级程序信息每特定版本的。

例如，如果移植发布8.8.111.0，请参阅版本注释的“升级Cisco Wireless Release”部分关于Cisco无线控制器和轻量级接入点Cisco Wireless Release 8.8.111.0的。

先决条件

要求

除基础网络知识和熟悉之外与Cisco无线LAN控制器的基本配置和安装，请保证您读指南，并且建议在版本注释提交。例如，为了版本8.8.111.0您有他们此处。

Cisco Wireless Release的8.8.x支持的升级路径：

当前软件版本	Release8.8.x的升级路径
8.2.x	您必须升级到8.5.x版本然后升级到Release8.8.x。
8.3.x	您必须升级到8.5.x版本然后升级到Release8.8.x。
8.4.x	您必须升级到8.5.x版本然后升级到Release8.8.x。
8.5.x	您能升级直接地到Release8.8.x。
8.6.x	您能升级直接地到Release8.8.x。
8.7.x	您能升级直接地到Release8.8.x。

在此过程中，请勿关闭控制器或任何接入点的电源；否则，可能会损坏软件映像。升级含有大量接入点的控制器可能需要 30 分钟之久，具体取决于网络的大小。然而，用并发访问支持控制器软件版本访问接入点升级数量增长的，应该显著减少升级时间。接入点必须始终接通电源，并且在此期间不得重置控制器。

使用以下选项，您可以减少网络中断时间：

1. 您能predownload AP镜像。当网络仍然是时，此功能允许您下载升级镜像到控制器，然后下载镜像到接入点。当控制器重置时，新的CLI允许您指定两个设备的启动镜像和重置接入点。

   • 关于如何配置WLC和拉普的信息此功能的请阅读部分Predownloading镜像对Cisco无线LAN控制器配置指南的接入点部分，版本8.8。

2. 对于FlexConnect接入点，请使用FlexConnect高效AP升级功能减少控制器和AP (主要站点和分组)之间的流量。

   • 关于配置FlexConnect AP升级的更多信息，请参阅配置的FlexConnect AP升级关于Cisco无线LAN控制器配置指南FlexConnect AP章节，版本8.8。

使用的组件

本文档中的信息基于以下软件和硬件版本：

• 一个FTP服务器用存储的升级文件。

• 有HTTP/S访问的PC对文件传输的WLC通过HTTPs。
• 运行8.5.131.0将升级到软件版本8.8.111.0的Cisco 3504 WLC。

支持的平台

本文档也适用于以下硬件平台：

• Cisco 2504/5508系列无线局域网控制器
• Cisco 5520/8540系列无线局域网控制器

• Cisco 3504系列无线局域网控制器

• Cisco无线服务模块2 (WiSM-2)

• Cisco弹性7500系列无线局域网控制器

• Cisco虚拟无线控制器(vWLC)

Note:WLCs 2504/5508/WiSM-2和7500不支持8.8.x版本，但是升级程序是相同的。 

Note:验证您的AP是与在升级期间，您计划升级对避免疏松AP的软件兼容。参考兼容性矩阵：https://www.cisco.com/c/en/us/td/docs/wireless/compatibility/matrix/compatibility-matrix.html。 

WLC 软件升级过程

您能使用CLI或GUI升级Cisco WLC。

Note:强烈建议在执行升级之前备份无线局域网控制器上的配置。

GUI 升级过程

本部分提供有关如何在控制器上使用 GUI 升级 WLC 的信息。

使用 GUI 升级 WLC 时，将在控制器重新启动期间断开第 3 层 (IP) 连接。为此，如果需要，推荐您使用控制台端口连接为了在升级进程中检查控制器的状态和加快所有恢复流程。

执行下列步骤：

1. 上传您的控制器配置文件到服务器备份配置文件。
2. 遵从这些步骤得到控制器软件：
   • 浏览到软件下载门户在：https://software.cisco.com/download/home。
   • 控制器型号的搜索：下载主页> 无线> 无线局域网Controller>独立控制器。
   • 点击您有然后在无线局域网控制器软件的WLC型号。
   • 软件版本被标记如描述此处帮助您确定下载的哪版本。点击控制器软件版本编号：
     • 早期部署(ED) —这些软件版本提供新特性和新的硬件平台支持以及bug修复。
     • 维护部署(MD) —这些软件版本提供bug修复和持续的软件维护。
     • 延迟(DF) —这些软件版本延迟。我们建议您移植到一升级的版本。
   • 点击文件名<filename.aes>。
   • 单击 Download。
   • 读Cisco最终用户软件许可协议并且单击同意。
   • 保存文件到您的硬盘驱动器。
3. 复制控制器软件文件<filename.aes>对在您的TFTP、FTP或者SFTP服务器的默认目录。
4. (可选)请禁用控制器802.11网络。  
   • 注意：对于繁忙网络、控制器在高利用率和小控制器平台，我们建议您禁用802.11网络作为预防措施。
5. 选择命令>打开下载文件的下载文件对控制器页。
6. 从文件类型下拉列表，请选择代码。
7. 从Transfer模式下拉列表，请选择TFTP、FTP、SFTP或者HTTP。
   • 如果选择HTTP将提示对于文件的位置。您需要有从您使用访问WLC的GUI的PC的可用文件。如果选择HTTP，请继续对步骤13。
8. 如果选择TFTP、FTP或者SFTP服务器，请输入TFTP、FTP或者SFTP服务器的IP地址。
9. 如果使用一TFTP server，默认值最大重试次数字段的10重试次数和超时字段的6秒应该正确地运作，不用任何调整。然而，您能更改这些值，如果必须。要执行如此，请进入时期最大TFTP server尝试下载软件在TFTP server尝试下载软件，在超时字段的最大重试次数字段和时间(以秒钟)。
10. 在文件路径领域，请输入软件的目录路径。
11. 在名字段，请输入软件文件<filename.aes>的名称。
12. 如果使用一个FTP服务器，请执行这些步骤：
    • 在服务器登录用户名字段，请输入登录到FTP服务器的用户名。
    • 在服务器登录密码字段，请输入登录到FTP服务器的密码。
    • 在服务器端口数字域，请输入在下载发生的FTP服务器的端口号。默认值是21。
13. 点击下载下载软件到控制器。指示下载的状况的消息显示。
14. 在下载完成后，请点击重新启动。
15. 如果提示保存您的更改，请点击“Save”并且重新启动。
16. 点击OK键确认您的决策重新启动控制器。
17. 如果禁用802.11网络，请重新授权给他们。
18. (可选)验证控制器软件在您的控制器安装，在控制器GUI，请点击监视器并且查看软件版本字段在控制器摘要下。

CLI 升级过程

在此部分，您提交以信息升级与使用的WLC在访问在FTP服务器的控制器的CLI文件。

完成这些步骤：

1. 确保FTP服务器从控制器是可及的，并且确保升级文件位于FTP服务器的目录。

2. 最好通过控制台端口完成此过程，但是也可以使用 SSH 或 Telnet（如果已启用）访问控制器的管理 IP 地址以完成此过程。使用 SSH 或 Telnet 将导致在映像下载后的重新启动进程期间与控制器断开连接。因此，应提供控制台访问以在升级失败时加快控制器故障排除速度和控制器恢复速度。登录到控制器并发出 show sysinfo 命令以验证控制器上运行的当前软件。

   这是显示sysinfo命令的输出示例:，显示该控制器运行8.5.131.0 ：

   (Cisco Controller) >show sysinfo
   
   Manufacturer's Name.............................. Cisco Systems Inc.
   Product Name..................................... Cisco Controller
   Product Version.................................. 8.5.131.0
   RTOS Version..................................... 8.5.131.0
   Bootloader Version............................... 8.5.103.0
   Emergency Image Version.......................... 8.5.103.0

3. 完成以下步骤以定义下载参数：

   1. 发出ftp命令转移下载的模式为了定义文件传输模式。

   2. 发出转移下载用户名/密码命令为了定义用户名和密码访问FTP服务器。

   3. 发出转移下载serverip FTP_server_IP_address命令为了定义FTP服务器IP地址。

   4. 发出转移下载路径‘FTP_server_path’命令为了定义控制器OS软件查找FTP默认目录的路径。

   5. 发出 transfer download filename filename 命令以指定映像的名称。

      示例如下：

      (Cisco Controller) >transfer download datatype code
      (Cisco Controller) >transfer download mode ftp
      (Cisco Controller) >transfer download username admin
      (Cisco Controller) >transfer download password ********
      (Cisco Controller) >transfer download serverip 192.168.1.2
      (Cisco Controller) >transfer download path /Shared/AIR-CT3504/
      (Cisco Controller) >transfer download filename AIR-CT3504-K9-8-8-111-0.aes

4. 发出 transfer download start 命令以启动升级进程。

   以下是升级进程的示例：

   (Cisco Controller) >show boot 
   Primary Boot Image............................... 8.8.111.0
   Backup Boot Image................................ 8.5.131.0 (default)
   
   (Cisco Controller) >show boot 
   
   (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)
   
   FTP Code transfer starting.
   
   FTP receive complete... extracting components.
   
   Checking Version Built.
   
   Image version check passed.
   
   Writing new RTOS to flash disk.
   
   Executing install_rtos script.
   
   Writing new AP Image Bundle to flash disk.
   
   Writing AVC Files to flash disk.
   
   Executing fini script.
   
   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.
   
   (Cisco Controller) >show boot 
   Primary Boot Image............................... 8.8.111.0
   Backup Boot Image................................ 8.8.111.0 (default)
   
   (Cisco Controller) >show boot 
   

5. 在升级进程完成后重新启动控制器以使新代码生效。

6. 发出 reset system 命令，并输入 y 或 yes 以响应问题“Would you like to save them now?”。

   (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最初基础设施(PI)升级WLC

手工升级您的对最新的软件版本的设备可以易出错和费时。Cisco填装基础设施简化软件更新的版本管理和惯例部署到您的设备通过帮助您计划，安排，下载和监控软件镜像更新。您能查看软件镜像详细信息，也查看推荐的软件镜像和删除软件镜像。软件镜像管理页提供镜像管理的多种方面的一张统一的视图例如软件镜像管理生命周期构件、软件镜像摘要和工作详细信息。

头等基础设施存储所有设备的软件镜像在您的网络。镜像根据镜像类型和版本存储。

请访问Cisco PI用户指南的管理设备软件镜像章节详细信息和指南的。

升级在HA AP-SSO环境的WLC

下列是一些软件升级方案列表：

• 在激活控制器的软件升级保证待机热控制器的升级。

• 不支持在职升级。所以，在您升级在HA环境前的控制器您应该计划您的网络中断时间。

• 重新启动激活控制器在软件升级以后也重新启动待机热控制器。

• 我们建议活动和待机热控制器有同一个软件镜像在备份，在运行theconfig引导程序backupcommand前。如果活动和待机热控制器有不同的软件镜像在备份，并且，如果运行theconfig在激活控制器的引导程序backupcommand，两个控制器重新启动与他们的中断HA对的各自备份镜像由于软件不匹配。

• 日程重置适用于在HA环境的两个控制器。控制器在预定时间前重新启动一分钟的对等体在激活控制器超时。

• 您能通过输入thereset对等体systemcommand重新启动从激活控制器的待机热控制器，如果被安排的重置没有计划。如果重置仅待机热控制器用此命令，在待机热控制器的所有未获救的配置丢失。所以，请保证您保存在激活控制器的配置，在您重置待机热控制器前。

• preimage下载，如果SSO在图像传送时，被触发重新发动。

• Onlydebugandshowcommands在待机热控制器允许。

• 在切换以后，如果对等体控制器有是在版本7.5之前的一个控制器软件版本，所有移动性客户端deauthenticated。

为了使更多的指导信息升级在HA AP-SSO设置的WLC，请遵从在高性能的(SSO)部署指南文档的步骤。

删除在无线局域网控制器的主要的或附属镜像

默认情况下，WLC 维护两个映像。这些映像是主映像和备用映像。主映像是 WLC 使用的活动映像，而备用映像用作活动映像的备份。

当您使用新映像升级 WLC 时，WLC 会自动在备用映像上复制新映像。

为了看到您的控制器当前运行的活动镜像(主要的镜像)，请点击从WLC GUI的监视器并且查看软件版本字段在WLC GUI的控制器摘要下。从CLI，您能使用show boot命令为了查看主要的和备份镜像在WLC。下面是一个示例。

(Cisco Controller) >show boot 
Primary Boot Image............................... 8.8.111.0
Backup Boot Image................................ 8.5.131.0 (default)

要删除或覆盖 WLC 上的一个映像，请使用您希望保留的映像启动 WLC 并执行升级。这样，新映像将替换备用映像。

您能随config命令引导程序<primary/backup>手工也改变WLC的活动引导镜像。

(Cisco Controller) >config boot ?

primary        Sets the primary image as active.
backup         Sets the backup image as active.

设置启动镜像可能也配置与WLC GUI。参考如何使用在无线局域网控制器(WLCs)的备份镜像关于详细的过程的更多信息。

Note:您需要保存并重新启动 WLC 配置，以便 WLC 使用新的活动映像。

验证

要验证正在运行的 WLC 软件的版本，请在系统重新启动后登录到控制器。

从 GUI：

在升级以后，从CLI ：

(Cisco Controller) >show sysinfo

Manufacturer's Name.............................. Cisco Systems Inc.
Product Name..................................... Cisco Controller
Product Version.................................. 8.8.111.0
RTOS Version..................................... 8.8.111.0
Bootloader Version............................... 8.5.103.0
Emergency Image Version.......................... 8.5.103.0

调试选项

您能使用调试转移所有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软件升级的典型的原因和纠正措施一起说明几个常见错误， ：

• “% Error:失败的代码文件传输-不可能连接到服务器” -您收到此错误消息，如果服务器不可及的。检查WLC对TFTP/FTP/SCP流量没有由在网络的任何防火墙阻塞的服务器IP连接并且确保。并且请确定TFTP/FTP/SCP服务是否在服务器的启用/运行。 有时计算机运行的服务器应用也许有打开的防火墙。这可能是为什么 WLC 升级未像预期一样进行的一个原因。
• “% Error:失败的代码文件传输-有接收的网络数据失败” -，如果错误在文件传输期间类似信息包丢失或有故障，您收到此错误。您可以要排除故障使用沿网络路径的数据包捕获查找数据包获得丢失或有故障的跳。
• “% Error:代码文件传输失效的服务器返回登录失败” -，如果ftp/scp用户名/密码不匹配在服务器的用户凭证您收到此错误。如果用户名和密码配置的匹配那个在服务器端，配置您可以要验证。
• “% Error:失败的代码文件传输- URL不存在，错误路径或文件名” -您收到此错误消息，如果软件升级文件不是存在服务器的默认目录或，如果在Upgrade页的控制器的‘文件名’字段输入不正确文件名。为了排除此错误，请复制镜像文件对在服务器的默认目录并且验证名称和文件扩展正确地是相同的在服务器和Upgrade页的控制器的‘文件名’字段。

相关信息

• Cisco无线控制器配置指南，版本8.8
• 高性能的(SSO)部署指南