Seamless Software Upgrade for Autonomous Routing Devices
Introduction for Seamless Upgrade of Autonomous Routing Devices
This feature explains how to seamlessly upgrade and onboard an existing Cisco Routing device into the Cisco SD-WAN Manager.
If you are using a device that is running a version earlier than Cisco IOS XE 17.12.1a, the system first upgrades your device and then onboards it into the Cisco SD-WAN Manager.
Prerequisites for Seamless Upgrade of Autonomous Routing Devices
-
The device must be operational.
-
To establish an SSH connection with the device, SSH connectivity from the Cisco SD-WAN Manager to the device with valid SSH username and password is needed. This user must have admin 15 privileges.
-
Auto-boot needs to be enabled on the device. To know more about the usage of configuration registers, refer to Configuration Register Values and their Significance.
-
Ensure that the software image is present on the device or the remote server (with .bin extension).
-
You can use the SCP, FTP, and HTTP protocols to copy images from the remote server.
- If you select SCP as the protocol on the Remote Server page, ensure that it is enabled on the device to download images from the remote server. To enable SCP, use the ip scp server enable command.
-
- If you select HTTP as the protocol on the Remote Server page, ensure that you enable the source interface configuration for HTTP on the router. To configure HTTP, use the ip http client source-interface interface command.
Limitations for Seamless Upgrade of Autonomous Routing Devices
-
Seamless Upgrade is applicable only for hardware routing devices.
-
You can only use the management VPN (VPN 512) and no other VPN for SSH connectivity. VPN 512 is the management interface on the SD-WAN Manager. This should be up for it to form a SSH connection.
Add an Image to the Remote Server
If you want to use an image stored on the remote server for the upgrade, you can proceed using the following steps:
Procedure
Step 1 | Go to Maintenance > Software Repository > Remote Server and click on Add Remote Server. |
Step 2 | Enter the value for these fields:
|
Step 3 | Click Add to get the remote server added to the repository. |
Step 4 | Go to the Add Software Images to the Repository section and follow the steps to add an image to the remote server. |
What's next
Upgrade and Add Devices into the SD-WAN Manager
To upgrade the device with a compatible release version, perform the following steps:
Procedure
Step 1 | From the Cisco SD-WAN Manager menu, choose Tools > Upgrade for SD-Routing Capability > Add Device to upgrade a device. |
Step 2 | Add information for all the mandatory parameters:
Status: The device upgrade status is displayed here. There are 4 types of status that you see while the upgrade is initiated:
If both Image on Device and Remote Server fields are entered, the Image on Device option is used for upgrading the device. |
Step 3 | Save the device details and click Upgrade. Once you click on Upgrade, you are redirected to the Tasks pane where you can see the ongoing upgrade status. Click on Actions to see the detailed logs. The following prechecks are performed by the system in the background before upgrading the device:
If these prechecks are not fulfilled, the upgrade process fails and the error messages are recorded in the logs. |
Step 4 | View the list of devices that are successfully upgraded and onboarded on the Monitor > Devices page. Alternatively, click Tools > Upgrade for SD-Routing Capability > Export to download the .csv file that contains the complete list to your local device. If a device is in the allowed list, then the SD-WAN Manager checks for the device details in its inventory pool. For instances where the device is not in the allowed list, create a system IP Pool by following the steps mentioned in the Network Hierarchy section. |
Import Multiple Devices for Upgrade
To add and upgrade multiple devices, perform the following steps:
Procedure
Step 1 | Go to Tools > Upgrade for SD-Routing Capability > Export to download a sample CSV file. | ||||||||||||||||
Step 2 | Create a CSV file by referring to the same format as the downloaded sample file with the following details:
| ||||||||||||||||
Step 3 | Go to Tools > Upgrade for SD-Routing Capability > Import and upload the CSV file. You can see all the devices populated into the interface on the SD-WAN Manager. You can select the devices to be upgraded by following steps from Step 3. |
Bias-Free Language
The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
Need help?
- Open a Support Case
- (Requires a Cisco Service Contract)