Software Upgrade
Use the Software Upgrade window to download new software images and to upgrade the software image running on a Cisco Catalyst SD-WAN device.
From a centralized Cisco SD-WAN Manager, you can upgrade the software on Cisco Catalyst SD-WAN devices in the overlay network and reboot them with the new software. You can do this for a single device or for multiple devices simultaneously.
When you upgrade a group of Cisco Catalyst SD-WAN Validator, Cisco Catalyst SD-WAN Controllers, and Cisco IOS XE Catalyst SD-WAN devices or Cisco vEdge devices in either a standalone or Cisco SD-WAN Manager cluster deployment, the software upgrade and reboot is performed first on the Cisco Catalyst SD-WAN Validator, next on the Cisco Catalyst SD-WAN Controller, and finally on the Cisco IOS XE Catalyst SD-WAN devices or Cisco vEdge devices. Up to 40 Cisco IOS XE Catalyst SD-WAN devices or Cisco vEdge devices can be upgraded and rebooted in parallel, depending on CPU resources.
Introduced in the Cisco vManage Release 20.8.1, the software upgrade workflow feature simplifies the software upgrade process for the Cisco Catalyst SD-WAN edge devices through a guided workflow and displays the various device and software upgrade statuses. For more information on creating a Software Upgrade Workflow, see Software Upgrade Workflow.
Note |
|
Upgrade Virtual Image on a Device
-
From the Cisco SD-WAN Manager menu, choose .
-
To choose a device, check the check box for the desired device.
-
Click Upgrade Virtual Image.
The Virtual Image Upgrade dialog box opens.
-
Choose Manager or Remote Server - Manager, as applicable.
-
From the Upgrade to Version drop-down list, choose the virtual image version to upgrade the device to.
-
Click Upgrade.
Upgrade the Software Image on a Device
Note |
|
To upgrade the software image on a device:
-
From the Cisco SD-WAN Manager menu, choose .
-
Click WAN Edge, Control Components, or Manager based on the type of device for which you wish to upgrade the software.
-
In the table of devices, select the devices to upgrade by selecting the check box on the far left.
Note
While upgrading Cisco SD-WAN Manager clusters, select all the nodes of the cluster in the table.
-
Click Upgrade.
-
In the Software Upgrade slide-in pane, do as follows:
-
Choose the server from which the device should download the image: Manager, Remote Server, or Remote Server – Manager.
Note
-
The Remote Server option is introduced in Cisco vManage Release 20.7.1. If you chose Remote Server, ensure that the device can reach the remote server.
-
Starting from Cisco vManage Release 20.9.1, when downloading an image from a remote server manually, ensure that only the following valid characters are used:
-
User ID: a-z, 0-9, ., _, -
-
Password: a-z, A-Z, 0-9, _, *, ., +, =, %, -
-
URL Name or Path: a-z, A-Z, 0-9, _, *, ., +, =, %, -, :, /, @, ?, ~
-
-
-
For Manager, choose the image version from the Version drop-down list.
-
For Remote Server – Manager, choose the Manager OOB VPN from the drop-down list and choose the image version from the Version drop-down list.
-
For Remote Server, configure the following:
Remote Server Name Choose the remote server that has the image. Image Filename Choose the image filename from the drop-down list. -
Check the Activate and Reboot check box.
If you do not check this check box, the software image is downloaded and installed on the device, but, the image is not activated, and the device is not rebooted. You must activate the image after the upgrade task is completed.
- Click Upgrade.
The device restarts, using the new software version, preserving the current device configuration. The Task View page opens, showing the progress of the upgrade on the devices.
-
-
Wait for the upgrade process, which takes several minutes, to complete. When the Status column indicates Success, the upgrade is complete.
-
From the Cisco SD-WAN Manager menu, choose and view the devices.
-
Click WAN Edge, Controller, or Manager based on the type of device for which you wish to upgrade the software.
-
In the table of devices, confirm that the Current Version column for the upgraded devices shows the new version. Confirm that the Reachability column says reachable.
Note |
|
Activate a New Software Image
Use this procedure to activate a software image that is currently loaded on a device. The software image may be a later release (upgrade) or earlier release (downgrade) than the current active release.
When you use Cisco SD-WAN Manager to upgrade the software image on a device, if you did not check the Activate and Reboot check box during the procedure, the device continues to use the existing configuration. Use this procedure to activate the upgraded software version.
Note |
To activate software for Cisco SD-WAN Manager while using a custom user group, you need read permission and read-write permissions to upgrade each software feature. |
To activate a software image:
-
From the Cisco SD-WAN Manager menu, choose .
-
Choose WAN Edge, Control Components, or Manager.
-
For the desired device or devices, check the check box to choose the device or devices,
-
Click Activate. The Activate Software dialog box opens.
-
Choose the software version to activate on the device.
-
Click Activate. Cisco SD-WAN Manager reboots the device and activates the new software image.
If the control connection to Cisco SD-WAN Manager does not come up within the configured time limit, Cisco SD-WAN Manager automatically reverts the device to the previously running software image. The configured time limit for all Cisco Catalyst SD-WAN devices to come up after a software upgrade is 5 minutes, except for Cisco vEdge device, which have a default time of 12 minutes.
Upgrade a CSP Device with a Cisco NFVIS Upgrade Image
Before you begin
Procedure
Step 1 |
From theCisco SD-WAN Manager menu, choose . |
||||
Step 2 |
Check one or more CSP device check boxes for the devices you want to choose. |
||||
Step 3 |
Click Upgrade. The Software Upgrade dialog box appears. |
||||
Step 4 |
Choose the Cisco NFVIS software version to install on the CSP device. If software is located on a remote server, choose the appropriate remote version. |
||||
Step 5 |
To automatically upgrade and activate with the new Cisco NFVIS software version and reboot the CSP device, check the Activate and Reboot check box. If you don’t check the Activate and Reboot check box, the CSP device downloads and verifies the software image. However, the CSP device continues to run the old or current version of the software image. To enable the CSP device to run the new software image, you must manually activate the new Cisco NFVIS software version by choosing the device again and clicking the Activate button in the Software Upgrade window. |
||||
Step 6 |
Click Upgrade. The Task View window displays a list of all running tasks along with total number of successes and failures. The window periodically refreshes and displays messages to indicate the progress or status of the upgrade. You can easily access the software upgrade status window by clicking the Task View icon located in the Cisco SD-WAN Manager toolbar.
|
The CSP device reboots and the new NFVIS version is activated on the device. This reboot happens during the Activate phase. The activation can either happen immediately after upgrade if you check the Activate and Reboot check box, or by manually clicking Activate after choosing the CSP device again.
To verify if CSP device has rebooted and is running, use the task view window. Cisco SD-WAN Manager polls your entire network every 90 seconds up to 30 times and shows the status on th task view window.
Note |
You can delete a Cisco NFVIS software image from a CSP device if the image version isn’t the active version that is running on the device. |
Delete a Software Image
To delete a software image from a Cisco Catalyst SD-WAN device:
-
From the Cisco SD-WAN Manager menu, choose .
-
Click WAN Edge, Control Components, or Manager.
-
Choose one or more devices from which to delete a software image.
-
Click the Delete Available Software.
The Delete Available Software dialog box opens.
-
Choose the software version to delete.
-
Click Delete.
Set the Default Software Version
You can set a software image to be the default image on a Cisco Catalyst SD-WAN device. Performing this operation overwrites the factory-default software image, replacing it with an image of your choosing. It is recommended that you set a software image to be the default only after verifying that the software is operating as desired on the device and in your network.
To set a software image to be the default image on a device:
-
From the Cisco SD-WAN Manager menu, choose .
-
Click WAN Edge, Control Components, or Manager.
-
Choose one or more devices by checking the check box for the desired device or devices.
-
Click Set Default Version.
The Set Default Version dialog box opens.
-
From the Version drop-down list, choose the software image to use as the default for the chosen device or devices.
-
Click Set Default.
Export Device Data in CSV Format
-
From the Cisco SD-WAN Manager menu, choose .
-
Click WAN Edge, Control Components, or Manager.
-
Choose one or more devices by checking the checkbox for the desired device or devices.
-
Click the download icon.
Cisco SD-WAN Manager downloads all data from the device table to an Excel file in CSV format. The file is downloaded to your brower's default download location and is named Software_Upgrade.csv
View Log of Software Upgrade Activities
-
From the Cisco SD-WAN Manager toolbar, click the Tasks icon.
Cisco SD-WAN Manager displays a list of all running tasks along with the total number of successes and failures.
-
Click the arrow to see details of a task. Cisco SD-WAN Manager opens a status window displaying the status of the task and details of the device on which the task was performed.