You are on page 1of 13

Wireless LAN Controller (WLC) Software Upgrade

Document ID: 68835
Introduction Prerequisites Requirements Components Used Conventions Configure GUI Upgrade Procedure CLI Upgrade Procedure Use WCS to Upgrade the WLC Verify Troubleshoot NetPro Discussion Forums − Featured Conversations Related Information

Introduction
This document explains the methods that you can use to upgrade the operating system (OS) software on a Cisco Wireless LAN Controller (WLC).

Prerequisites
Requirements
Ensure that you meet these requirements before you attempt this configuration: • You know how to configure basic parameters on the WLC. • You have a TFTP server installed and you know how to use it. If you are new to WLCs and do not know how to configure the WLC, refer to Cisco Wireless LAN Controller Configuration Guide, Release 3.2.

Components Used
The information in this document is based on these software and hardware versions: • Cisco 2006 WLC that runs firmware 3.1.105 • PC on the network that runs TFTP server Tftpd32 version 2.0 The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. If your network is live, make sure that you understand the potential impact of any command.

Cisco − Wireless LAN Controller (WLC) Software Upgrade

Conventions
Refer to Cisco Technical Tips Conventions for more information on document conventions.

Configure
You can upgrade the Cisco WLC with either one of these methods: • GUI • Command−line interface (CLI) When a controller is upgraded, the code on its associated access points is also automatically upgraded. When an access point loads code, each of its lights blinks in succession. Note: Do not power down the controller or any access point during this process. Otherwise, you might corrupt the software image. The upgrade of a controller with a large number of access points can take as long as 30 minutes. The access points must remain powered, and the controller must not be reset during this time. Cisco recommends this sequence when you perform an upgrade: 1. Upload your controller configuration files to a server to back them up. 2. Turn off the controller 802.11a and 802.11b networks. 3. Upgrade your controller. 4. Re−enable your 802.11a and 802.11b networks. This document provides the steps to follow in order to upgrade the WLC with each of these methods.

GUI Upgrade Procedure
In this section, you are presented with the information to upgrade the WLC with use of the GUI on the controller. Note: When you upgrade the WLC with use of the GUI, you lose your connection to the controller for a few seconds during the update process. For this reason, Cisco recommends that you use a direct CLI console port connection in order to update controller software. Step−by−Step Instructions Complete these steps: 1. Complete these steps to log into the WLC through the browser: a. Enter the IP address of the controller in the address line and click Login. You are prompted for user credentials. b. Enter the username and password of the controller and click OK. The default username and password on the WLC is admin.

Cisco − Wireless LAN Controller (WLC) Software Upgrade

The Monitor window appears. The Summary information shows you the OS software version that currently runs on the WLC.

2. Complete these steps to define the download parameters: a. Click Commands in the menu at the top of the window. The Download file to Controller window appears. b. Enter the download parameters. The parameters to define include: ◊ TFTP server IP address ◊ File path ◊ File name ◊ Maximum retries ◊ Timeout c. Click Download in order to start the upgrade process. Here is an example:

Cisco − Wireless LAN Controller (WLC) Software Upgrade

Note: When you perform the upgrade from the GUI, for File Path, you can also insert a dot (.) and make sure that the image is in the root directory of your TFTP server. This way, you do not have to enter the path were the image is saved. This document explains the upgrade of the WLC software from version 3.1.105.0 to version 3.2.78.0. Upgrade the WLC software to the latest release that is available. Refer to the Wireless Software Center for the latest version of the WLC software. Copy the downloaded OS software file for the WLC to the default directory on the TFTP server. Note: You need a valid Cisco.com account in order to download the WLC software. 3. Reboot the system after the file transfer is complete in order for the new software to take effect. Click Click Here in order to reboot, as this example shows:

Cisco − Wireless LAN Controller (WLC) Software Upgrade

4. In the the System Reboot window, click Reboot at the top right side of the window.

5. Click Save and Reboot in the Reboot System > Save window.

Cisco − Wireless LAN Controller (WLC) Software Upgrade

After the reboot, you see that the WLC software is upgraded to the latest code. Here is an example after the upgrade process: Note: The new version is 3.2.78.0.

Cisco − Wireless LAN Controller (WLC) Software Upgrade

CLI Upgrade Procedure
In this section, you are presented with the information to upgrade the WLC with use of the CLI on the controller. Step−by−Step Instructions Complete these steps: 1. Make sure that the TFTP server is reachable from the controller, and then download the desired OS software file. Refer to the Wireless Software Center in order to download the software file. Copy the file to the default directory on the TFTP server. 2. Log in to the WLC CLI.

3. Complete these steps in order to define the download parameters: a. Issue the transfer download mode tftp command in order to define the mode of file transfer. b. Issue the transfer download serverip TFTP_server_IP_address command in order to define the TFTP server IP address. c. Issue the transfer download path 'TFTP_server_path' command in order to define the path of the TFTP default directory where the controller OS software is located.

Cisco − Wireless LAN Controller (WLC) Software Upgrade

d. Issue the transfer download filename filename command in order to specify the name of the image. Here is an example:

4. Issue the transfer download start command in order to initiate the upgrade process. Here is an example of the upgrade process:

5. Reboot the controller after the upgrade process is complete in order for the new code to take effect. Issue the reset system command, and enter yor yes in response to the question "Would you like to save them now?". Here is an example:

Cisco − Wireless LAN Controller (WLC) Software Upgrade

Use WCS to Upgrade the WLC
Complete these steps in order to update controller (and access point) software using the Wireless Control System (WCS). 1. Enter ping ip−address in order to be sure that the WCS server can contact the controller. If you use an external TFTP server, enter ping ip−address in order to be sure that the WCS server can contact the TFTP server. 2. Choose Configure > Controllers in order to navigate to the All Controllers page. 3. Check the check box of the desired controller, choose Download Software from the Select a Command drop−down menu, and click Go. WCS displays the Download Software to Controller page. 4. If you use the built−in WCS TFTP server, check the TFTP Server on WCS System check box. If you use an external TFTP server, uncheck this check box and add the external TFTP server IP address. 5. Click Browse and navigate to the software update file (for example, AS_2000_release.aes for 2000 series controllers). The files are uploaded to the root directory which was configured for use by the TFTP server. You can change to a different directory. 6. Click Download. WCS downloads the software to the controller, and the controller writes the code to Flash RAM. As WCS performs this function, it displays its progress in the Status field. Refer to Performing System Tasks for more information.

Verify
Use this section to confirm that your configuration works properly. In order to verify the version of WLC software that runs, log in to the WLC after the system reboots. Here is an example. You can see that the WLC software is upgraded to 3.2.78.0:

Cisco − Wireless LAN Controller (WLC) Software Upgrade

Troubleshoot
Use this section to troubleshoot your configuration. During the upgrade process, you can come across some errors that affect the upgrade process. This section explains what the error messages mean and how to eliminate the errors and upgrade the controller. • Code file transfer failed − No reply from the TFTP serverYou get this error message if the TFTP server is not active. Check to determine if the TFTP service is enabled on the server. • Code file transfer failed − Error from server: File was not found. Aborting transferYou get this error message if the OS file is not present in the default directory of the TFTP server. In order to eliminate this error, copy the image file to the default directory on the TFTP server. • TFTP Failure while storing in flash!You can get this error if there is a problem with the TFTP server. Some TFTP servers have a limitation on the size of the files that you can transfer. Use a different TFTP server utility. There are many free TFTP server utilities that are available. Cisco recommends use of the Tftpd32 version 2.0 TFTP server. Refer to Tftpd32 in order to download this TFTP server. • The install partitions are destroyed or the image is corruptedIf you are still unsuccessful after an attempt to upgrade the software, there is a possibility that your image is corrupted. Contact Cisco Technical Support for assistance. You can also use the debug transfer trace enable command in order to view the events that occur during the controller software upgrade process. Here is an example, which shows the debug command output for a successful software upgrade:
(Cisco Controller) >debug transfer trace enable (Cisco Controller) >transfer download start

Cisco − Wireless LAN Controller (WLC) Software Upgrade

Mode............................................. Data Type........................................ TFTP Server IP................................... TFTP Packet Timeout.............................. TFTP Max Retries................................. TFTP Path........................................ TFTP Filename....................................

TFTP Code 172.16.1.1 6 10 d:\WirelessImages/ AIR−WLC2006−K9−3−2−78−0.aes

This may take some time. Are you sure you want to start? (y/n) y Mon Feb 13 14:06:56 2006: RESULT_STRING: TFTP Code transfer starting. Mon Feb 13 14:06:56 2006: RESULT_CODE:1 TFTP Code transfer starting. Mon Feb 13 14:06:59 2006: Still waiting! Status = 2 Mon Feb 13 14:07:00 2006: Locking tftp semaphore, pHost=172.16.1.1 pFilename=d:\ WirelessImages/AIR−WLC2006−K9−3−2−78−0.aes Mon Feb 13 14:07:00 2006: Semaphore locked, now unlocking, pHost=172.16.1.1 pFil ename=d:\WirelessImages/AIR−WLC2006−K9−3−2−78−0.aes Mon Feb 13 14:07:00 2006: Semaphore successfully unlocked, pHost=172.16.1.1 pFil ename=d:\WirelessImages/AIR−WLC2006−K9−3−2−78−0.aes Mon Feb 13 14:07:02 2006: Still waiting! Status = 1 Mon Feb 13 14:07:05 2006: Still waiting! Status = 1 Mon Feb 13 14:07:08 2006: Still waiting! Status = 1 Mon Feb 13 14:07:11 2006: Still waiting! Status = 1 Mon Feb 13 14:07:14 2006: Still waiting! Status = 1 Mon Feb 13 14:07:17 2006: Still waiting! Status = 1 Mon Feb 13 14:07:19 2006: tftp rc=0, pHost=172.16.1.1 pFilename=d:\WirelessImage s/AIR−WLC2006−K9−3−2−78−0.aes pLocalFilename=/mnt/download/local.tgz Mon Feb 13 14:07:19 2006: tftp = 6, file_name=d:\WirelessImages/AIR−WLC2006−K9−3 −2−78−0.aes, ip_address=172.16.1.1 Mon Feb 13 14:07:19 2006: upd_get_code_via_tftp = 6 (target=268435457) Mon Feb 13 14:07:19 2006: RESULT_STRING: TFTP receive complete... extracting com ponents. Mon Feb 13 14:07:19 2006: RESULT_CODE:6 TFTP receive complete... extracting components. Mon Feb 13 14:07:20 2006: Still waiting! Status = Mon Feb 13 14:07:23 2006: Still waiting! Status = Mon Feb 13 14:07:23 2006: Still waiting! Status = Mon Feb 13 14:07:23 2006: Still waiting! Status = Mon Feb 13 14:07:25 2006: RESULT_STRING: Executing Mon Feb 13 14:07:25 2006: RESULT_STRING: Executing

2 1 1 1 init script. backup script.

Executing backup script. Mon Feb 13 14:07:26 2006: Still waiting! Status = 2 Mon Feb 13 14:07:29 2006: Still waiting! Status = 1 Mon Feb 13 14:07:31 2006: RESULT_STRING: Writing new bootloader to flash disk. Writing new bootloader to flash disk. Mon Feb 13 14:07:32 2006: Still waiting! Status = 2 Mon Feb 13 14:07:33 2006: RESULT_STRING: Executing install_bootloader script. Executing install_bootloader script. Mon Feb 13 14:07:35 2006: Still waiting! Status = 2 Mon Feb 13 14:07:35 2006: RESULT_STRING: Writing new RTOS to flash disk. Mon Feb 13 14:07:36 2006: RESULT_STRING: Executing install_rtos script. Mon Feb 13 14:07:36 2006: RESULT_STRING: Writing new Code to flash disk. Writing new Code to flash disk. Mon Feb 13 14:07:38 2006: Still waiting! Mon Feb 13 14:07:41 2006: Still waiting!

Status = 2 Status = 1

Cisco − Wireless LAN Controller (WLC) Software Upgrade

Mon Feb 13 14:07:42 2006: RESULT_STRING: Executing install_code script. Executing install_code script. Mon Feb 13 14:07:44 2006: Still waiting! Status = 2 Mon Feb 13 14:07:47 2006: Still waiting! Status = 1 Mon Feb 13 14:07:48 2006: RESULT_STRING: Writing new APIB to flash disk. Writing new APIB to flash disk. Mon Feb 13 14:07:50 2006: Still waiting! Status = 2 Mon Feb 13 14:07:51 2006: RESULT_STRING: Executing install_apib script. Executing install_apib script. Mon Feb 13 14:07:53 2006: Still waiting! Status = 2 Mon Feb 13 14:07:53 2006: Still waiting! Status = 1 Mon Feb 13 14:07:53 2006: Still waiting! Status = 1 Mon Feb 13 14:07:53 2006: Still waiting! Status = 1 Mon Feb 13 14:07:53 2006: Still waiting! Status = 1 Mon Feb 13 14:07:54 2006: RESULT_STRING: Writing new APIB to flash disk. Mon Feb 13 14:07:56 2006: RESULT_STRING: Executing install_apib script. Executing install_apib script. Mon Feb 13 14:07:56 2006: Still waiting! Status = 2 Mon Feb 13 14:07:59 2006: RESULT_STRING: Writing new APIB to flash disk. Writing new APIB to flash disk. Mon Feb 13 14:08:00 2006: Still waiting! Status = 2 Mon Feb 13 14:08:00 2006: RESULT_STRING: Executing install_apib script. Executing install_apib script. Mon Feb 13 14:08:03 2006: Still waiting! Mon Feb 13 14:08:03 2006: RESULT_STRING: Mon Feb 13 14:08:03 2006: RESULT_STRING: Mon Feb 13 14:08:03 2006: RESULT_STRING: Mon Feb 13 14:08:04 2006: RESULT_STRING: ot the switch for update to complete. Mon Feb 13 14:08:04 2006: RESULT_CODE:11 TFTP File transfer is successful. Reboot the switch for update to complete. Mon Feb 13 14:08:06 2006: Still waiting! Status = 2 Mon Feb 13 14:08:08 2006: ummounting: <umount /mnt/download/> cation Mon Feb 13 14:08:08 2006: finished umounting

Status = 2 Writing new Cert−patch to flash disk. Executing install_cert_patch script. Executing fini script. TFTP File transfer is successful. Rebo

cwd

= /mnt/appli

NetPro Discussion Forums − Featured Conversations
Networking Professionals Connection is a forum for networking professionals to share questions, suggestions, and information about networking solutions, products, and technologies. The featured links are some of the most recent conversations available in this technology. NetPro Discussion Forums − Featured Conversations for Wireless Wireless − Mobility: WLAN Radio Standards Wireless − Mobility: Security and Network Management Wireless − Mobility: Getting Started with Wireless Wireless − Mobility: General

Cisco − Wireless LAN Controller (WLC) Software Upgrade

Related Information
• Cisco Wireless LAN Controller Configuration Guide, Release 3.2 • Quick Start Guide: Cisco 2000 Series Wireless LAN Controllers • Cisco Wireless LAN Controller Command Reference, Release 3.2 • Wireless Support Page • Technical Support & Documentation − Cisco Systems

All contents are Copyright © 1992−2006 Cisco Systems, Inc. All rights reserved. Important Notices and Privacy Statement.

Updated: Oct 01, 2006

Document ID: 68835

Cisco − Wireless LAN Controller (WLC) Software Upgrade