Upgrading the Cisco WAAS Software
This section contains the following topics:
Operating Guidelines for Upgrading the Cisco WAAS Software
Consider the following guidelines when you upgrade your Cisco WAAS software:
-
As shown in , upgrading is supported only from certain older releases to a particular release. If you have a Cisco WAAS device that is running a release from which upgrading to the desired release is not supported, first upgrade the device to an intermediate supported release and then to the final desired release.
When you perform a software upgrade using the Cisco WAAS Central Manager, there is only a limited system check to verify the support of the target Cisco WAAS version. To ensure that you have a successful Cisco WAAS upgrade, use Table 14-1 to verify that the target version is supported for your system.
For more information on Cisco WAAS software versions, see Release Note for Cisco Wide Area Application Services.
Table 1. Upgrade Paths to Cisco WAAS Version 6.4.3x Current Cisco WAAS Version
Cisco WAAS Central Manager Upgrade Path
Cisco WAAS Upgrade Path
5.5.3 and later
Upgrade directly to 6.4.3x
Upgrade directly to 6.4.3x
4.3.x through 5.5.1
-
Upgrade to 5.5.3, 5.5.5x (5.5.5, 5.5.5a), or 5.5.7x
-
Upgrade to 6.4.3x
-
Upgrade to 5.5.3, 5.5.5x, or 5.5.7x
-
Upgrade to 6.4.3x
4.2.x
-
Upgrade to version 4.3.x through 5.4.x
-
Upgrade to 5.5.3 or 5.5.5x (5.5.5, 5.5.5a), or 5.5.7x
-
Upgrade to 6.4.3x
-
Upgrade to version 4.3.x through 5.4.x
-
Upgrade to 5.5.3, 5.5.5x, or 5.5.7x
-
Upgrade to 6.4.3x
-
-
We recommend that all the devices in your Cisco WAAS network run the same version of the Cisco WAAS software. If some of your Cisco WAAS devices are running different software versions, the Cisco WAAS Central Manager should be the latest version. For details on Cisco WAAS version interoperability limitations, see the Release Note for Cisco Wide Area Application Services.
-
If the Cisco WAAS Central Manager detects any registered Cisco WAE devices that are at a higher version level than the current one, it raises a minor alarm to alert you. Additionally, the Cisco WAE devices are shown in red on the device listing page.
-
The Cisco WAAS Central Manager running Cisco WAAS Version 5.4.1 can manage Cisco WAE devices running Cisco WAAS Version 4.3.1 and later. However, some Cisco WAAS Central Manager windows with Cisco Version 5.4.1 features will not be applicable to Cisco WAAS devices that are running a version earlier than Cisco WAAS Version 5.4.1. If you modify this configuration, the configuration is saved, but it does not affect the earlier-version devices until these are upgraded to Cisco WAAS Version 5.4.1.
-
If you are upgrading from a Cisco WAAS Version earlier than Cisco WAAS Version 6.1.1x to Cisco WAAS Version 6.x and use virtual blade, the upgrade procedure may get stuck in the Proceeding with Download phase. To remedy this scenario, follow these steps:
-
To remove the Cisco WAAS device registration record and its configuration on the Cisco WAAS Central Manager, on the Cisco branch device, run the cms degister EXEC command.
-
Wait ten minutes.
-
To enable synchronization of the Cisco WAAS network configuration of the Cisco WAAS device with the local Cisco WAAS CLI configuration, on the Cisco WAAS branch device, run the cms enable EXEC command.
-
Using the Cisco WAAS Central Manager, install the specified Cisco WAAS 6.x version.
-
-
Cisco WAAS Version 5.4.x is not supported running in a mixed-version Cisco WAAS network with any Cisco WAAS device that is running a Cisco WAAS version earlier than Cisco WAAS 4.3.1.
Consider these upgrade guidelines:
-
If you have Cisco WAAS devices running versions earlier than Cisco WAAS Version 4.3.1, you must first upgrade these devices to Cisco WAAS Version 4.3.1, or a later version, before you install version Cisco WAAS Version 5.2 on the Cisco WAAS Central Manager.
-
Do not upgrade any Cisco WAAS device to a version later than the existing Cisco WAAS Central Manager version.
-
After all the Cisco WAAS devices are upgraded to Cisco WAAS Version 4.3.1 or later, you can begin the upgrade to Cisco WAAS Version 5.4.1 on the Cisco WAAS Central Manager.
-
Directly upgrading a device from Cisco WAAS Version 4.0, Version 4.1 or Version 4.2 to Cisco WAAS Version 5.4.1 is not supported.
-
Before Starting the Upgrade:
-
Disable WCCP on all Cisco WAEs in an AppNav cluster. After upgrade is complete, confirm the following before you re-enable WCCP.
-
The Cisco WAEs are up and running.
-
The AppNav cluster is re-converged properly.
-
All disks are ready (not initializing).
-
There are no alarms on the device.
-
The show accelerator EXEC command shows all enabled Application Optimizers are healthy.
After you have confirmed that each of these is complete, re-enable WCCP.
-
Checklist for Upgrading the Cisco WAAS Software
The Checklist for Upgrading the Cisco WAAS Software table highlights the tasks needed to upgrade the Cisco WAAS software. In addition, consider these guidelines:
-
To downgrade or roll back the Cisco WAAS software to a lower version, first downgrade or roll back the Cisco WAE devices’ version, then the standby Central Manager (if applicable), and finally the primary Cisco WAAS Central Manager. For more information about downgrading, see the Release Note for Cisco Wide Area Application Services.
-
You cannot downgrade an Cisco ENCS 5400-W device to a Cisco WAAS software version lower than 6.4.1, either from a device or a device group level. A warning message is displayed if you attempt to downgrade.
Task |
Additional Information and Instructions |
---|---|
1. Determine the current software version running on your Cisco WAAS network. |
Check the software version that you are currently using so when you go to Cisco.com, you know if there is a newer version to download. For more information, see Determining the Current Software Version. |
2. Obtain the new Cisco WAAS software version from cisco.com. |
Visit cisco.com to download a newer software version and place this file on a local FTP or HTTP server. For more information, see Obtaining the Latest Cisco WAAS Software Version. |
3. Register the new software version with the Cisco WAAS Central Manager. |
Register the URL of the new software file so the Cisco WAAS Central Manager knows where to go to access the file. For more information, see Specifying the Location of the Software File in the Cisco WAAS Central Manager GUI. |
4. Upgrade all your Cisco WAAS Central Managers and Cisco WAAS devices. |
Upgrade the Standby and Primary Cisco WAAS Central Managers. For more information, see Upgrading the Cisco WAAS Central Manager. After upgrading the Cisco WAAS Central Manager, upgrade all your Cisco WAAS devices that are members of a device group. For more information, see Upgrading Multiple Devices Using Device Groups. |
5. Delete the software version file. |
After completely upgrading your Cisco WAAS network, you can remove the software file if desired. For more information, see Deleting a Software File. |
Determining the Current Software Version
To view the current software version running on a particular device, choose Devices > All Devices. The All Devices window displays the software version for each listed device.
You can also click Devices > device-name or the Edit icon next to the name of a device in the Devices window. The Device Dashboard window appears, listing the software version for that device.
Note |
The software version is not upgraded until a software upgrade is successfully completed. If a software upgrade is in progress, the version number displayed is the base version, not the upgraded version number. |
Alternatively, in the device context, choose Monitor > CLI Commands > Show Commands. Choose the version and click Submit. A secondary window is displayed with the CLI output for the show version EXEC command.
Obtaining the Latest Cisco WAAS Software Version
Procedure
Step 1 |
Launch your web browser and access the Cisco Software Download page: |
Step 2 |
Choose Application Networking Services > Wide Area Application Services > Cisco Wide Area Application Services (WAAS) Software download area. |
Step 3 |
Choose the Cisco WAAS software version that you want and download the appropriate software image. |
Step 4 |
Register the location of the software file in the WAAS Central Manager GUI, as described in Specifying the Location of the Software File in the Cisco WAAS Central Manager GUI. |
Specifying the Location of the Software File in the Cisco WAAS Central Manager GUI
Before you begin
To upgrade your Cisco WAAS software, you must first specify the location of the Cisco WAAS software file in the Cisco WAAS Central Manager GUI and configure the software file settings.
There are two types of Cisco WAAS software files:
-
Universal: Includes Cisco WAAS Central Manager, Application Accelerator, and AppNav Controller functionality. You can use this type of software file to upgrade a device operating in any mode.
-
Accelerator only: Includes Application Accelerator and AppNav Controller functionality only. You can use this type of software file to upgrade only an Application Accelerator or AppNav Controller device. If you want to change an Application Accelerator or AppNav Controller to a Central Manager, you must install the Universal software file, reload the device, change the device mode to central-manager, and then reload the device again. Additionally, kdump analysis functionality is not included in the Accelerator only image.
Procedure
Step 1 |
From the Cisco WAAS Central Manager menu, choose Admin > Version Management > Software Update. |
||
Step 2 |
Click the Create New Software File icon in the taskbar. The Creating New Software File window appears. |
||
Step 3 |
In the Software File URL field, specify the location of the new WAAS software file as follows: |
||
Step 4 |
(Optional) If your server requires user login authentication, enter your username in the Username field and enter your login password in the Password field. Enter the same password in the Confirm Password field. The Software Version and Image Type fields cannot be edited. They are filled in automatically after you submit the settings and the image is validated. |
||
Step 5 |
To automatically reload a device when you upgrade the software, at the Advanced Settings pane, check the Auto Reload check box. If you do not check this check box, you should manually reload a device after you upgrade the software on it to complete the upgrade process. |
||
Step 6 |
(Optional) Enter comments in the Comments field. |
||
Step 7 |
Click Submit. The software image file is validated and the Software Version and Image Type fields are filled in with the appropriate information extracted from the image file.
The software file that you want to use is now registered with the Cisco WAAS Central Manager. When you perform the software upgrade or downgrade, the URL that you just registered becomes one of the choices available in the Update Software window. |
||
Step 8 |
To reload a device from the CLI, run the reload EXEC command.
|
Upgrading the Cisco WAAS Central Manager
Before you begin
When upgrading software in your Cisco WAAS network, begin with Cisco WAAS Central Manager before upgrading Cisco WAAS WAE devices.
Primary and Standby Cisco WAAS Central Manager devices must be running the same version of Cisco WAAS software. If they are not, the Standby Cisco WAAS Central Manager detects this and will not process any configuration updates it receives from the Primary Cisco WAAS Central Manager. If the Primary Cisco WAAS Central Manager sees that the Standby Cisco WAAS Central Manager has a different version level, it shows the Standby Cisco WAAS Central Manager in red on the device listing page.
If you use the primary Cisco WAAS Central Manager to perform the software upgrade, you need to upgrade your standby Cisco WAAS Central Manager first, and then upgrade your primary Cisco WAAS Central Manager. We also recommend that you create a database backup for the primary Cisco WAAS Central Manager and copy the database backup file to a safe place before you upgrade the software.
Use this upgrade procedure for Cisco WAAS Central Manager devices. You can also use this upgrade procedure to upgrade Cisco WAAS devices one at a time (after the Cisco WAAS Central Manager).
Procedure
Step 1 |
From the Cisco WAAS Central Manager menu, choose Devices > device-name. The Device Dashboard window appears. |
Step 2 |
Verify that the device is not already running the version to which you plan to upgrade. |
Step 3 |
Click Update. The Software Update window appears. |
Step 4 |
To choose the software file URL from the Software Files list, click the radio button next to the corresponding filename. The list displays only software files with an image type of Universal, because you are upgrading a Cisco WAAS Central Manager device. If no such images are available, you must create a software file, as described in Specifying the Location of the Software File in the Cisco WAAS Central Manager GUI. |
Step 5 |
To confirm you decision, click Submit and then click OK. The Devices Listing window is displayed again. You can monitor the progress of your upgrade from this window. Software upgrade status messages are displayed in the Software Version column. These intermediate messages are also written to the system log on the Cisco WAAS devices. See theTable 1 table for a description of upgrade status messages. |
Step 6 |
Clear your browser cache, close the browser, and restart the browser session to the WAAS Central Manager. |
What to do next
The Cisco WAAS Central Manager may reboot at the conclusion of the upgrade procedure (if Auto Reload is in the Creating New Software File window), causing you to temporarily lose contact with the device and the Cisco WAAS Central Manager GUI.
Upgrade Status Message |
Status |
---|---|
Pending |
The request has not yet been sent from the Cisco WAAS Central Manager to the device, or receipt of the request is yet to be acknowledged by the device. |
Downloading |
The download method for the software file is being determined. |
Proceeding with Download |
The download method for the software file is determined to be a direct download. Proceeding with the request for direct download of the software file. |
Download in Progress (Completed...) |
The direct download of the software file is being processed. Completed indicates the number of megabytes processed. |
Download Successful |
The direct download of the software file is successful. |
Download Failed |
The direct download of the software file cannot be processed. Further troubleshooting is required; see the device system message log. If you are upgrading several devices at once, the download may fail if the server hosting the software file becomes overloaded with requests. Retry the upgrade by clicking the Retry link if it is displayed. |
Proceeding with Flash Write |
A request has been made to write the software file to the device flash memory. |
Flash Write in Progress (Completed...) |
The write of the device flash memory is being processed. Completed indicates the number of megabytes processed. |
Flash Write Successful |
The flash write of the software file has been successful. |
Reloading |
A request to reload the device has been made in order to complete the software upgrade. The device may be offline for several minutes. |
Reload Needed |
A request to reload the device has not been made. The device must be reloaded manually to complete the software upgrade. |
Cancelled |
The software upgrade request was interrupted, or a previous software upgrade request was bypassed from the Cisco WAAS CLI. |
Update Failed |
The software upgrade could not be completed. Troubleshooting is required; see the device system message log. If you are upgrading several devices at once, the upgrade may fail if the server hosting the software file becomes overloaded with requests. Retry the upgrade by clicking the Retry link if it is displayed. |
Upgrading Multiple Devices Using Device Groups
Before you begin
This procedure is for Cisco WAE devices only. Cisco WAAS Central Manager devices cannot be upgraded using device groups.
Procedure
Step 1 |
From the Cisco WAAS Central Manager menu, choose Device Groups > device-group-name. |
Step 2 |
Choose Admin > Versioning > Software Update. The Software Update for Device Group window appears. |
Step 3 |
To choose the software file URL from the Software File URL list, click the radio button next to the filename. If no images are available, create a software file, as described in Specifying the Location of the Software File in the Cisco WAAS Central Manager GUI. If you are updating many devices and you want to use a smaller size software file to save network bandwidth, specify a software file with an image type of Accelerator only, which is smaller than a Universal image. If you later want to change an Accelerator-only device to a Cisco WAAS Central Manager, you must install the Universal software file, reload the device, change the device mode to central-manager, and then reload the device again. |
Step 4 |
Click Submit. To view the progress of an upgrade, choose Devices > All Devices to display the All Devices window, and to view the software upgrade status message in the Software Version column. These intermediate messages are also written to the system log on Cisco WAAS devices. See the Table 1 table for a description of the upgrade status messages. |
Upgrading Cisco WAAS Central Manager to New Hardware and Converting an Existing Cisco WAAS Central Manager to a Cisco WAE
Before you begin
Consider the following guidelines:
-
To add a new piece of hardware as a primary Cisco WAAS Central Manager, and use the existing Cisco WAAS Central Manager as a Cisco WAE, it is important to first add it to the system and then configure it.
-
To prevent the former Cisco WAAS Central Manager from later being used as a Cisco WAE, perform a database backup of the former Central Manager and restore it on the new device.
Procedure
Step 1 |
Add a hardware device as the new Cisco WAAS Central Manager and configure it as a Standby Cisco WAAS Central Manager. There may be multiple Standby Cisco WAAS Central Managers in the system. For more information, see Configuring the Cisco WAAS Central Manager Role. |
Step 2 |
Enable the new hardware device to be the primary Cisco WAAS Central Manager after it is available online and has finished synchronizing with other systems. For more information, see Converting a Standby Cisco WAAS Central Manager to a Primary Cisco WAAS Central Manager. |
Step 3 |
To remove the former Cisco WAAS Central Manager from the Cisco WAAS Central Manager database:
|
Step 4 |
After the former Cisco WAAS Central Manager has been deregistered, perform the following tasks:
|
Step 5 |
After the device has been reloaded, perform the following tasks:
|
Deleting a Software File
Before you begin
After you have successfully upgraded your Cisco WAAS devices, you can remove the software file from your Cisco WAAS system.
Note |
You may want to wait a few days before removing a software file in the event that you may have to downgrade your system for any reason. |
Procedure
Step 1 |
From the Cisco WAAS Central Manager menu, choose Admin > Version Management > Software Update. |
Step 2 |
Click the Edit icon next to the software file that you want to delete. The Modifying Software File window appears. |
Step 3 |
Click the Trash icon in the taskbar. You are prompted to confirm your decision to delete the software file. |
Step 4 |
Click OK. The selected software file is removed from your Cisco WAAS network. |