Migration: ViptelaOS to Cisco IOS XE SD-WAN

[mmanusan]

• Introduction
• Prerequisites
• Pre-Checks
• Migrate from Cisco ViptelaOS to Cisco IOS XE SD-WAN
• Verification

Introduction

This document contains step-by-step instructions on how to change the software on a Cisco ISR1100 Series device running Cisco vEdge software to Cisco IOS XE SD-WAN software.

Devices that run Cisco Viptela OS and can migrate or upgrade to Cisco IOS XE SD-WAN software are listed below:

• ISR1100-4G
• ISR1100-6G
• ISR1100-4GLTENA
• ISR1100-4GLTEGB
• ISR1100X-4G
• ISR1100X-6G

Prerequisites

As part of getting ready for migration, we need to check the minimum software version on controllers and edge box and upgrade them as needed.

• SD-WAN Controllers need to be running recommended release 20.6.x or 20.9.x, Recommended release can be found from software.cisco.com with a golden star here. If the controllers are running older than 20.6.5.1 release (current gold star image), please schedule a MW and get the controllers upgraded.
• ISR1100 when running Cisco Viptela OS should be running 20.6.5.1 or later. If the edge box is running older than 20.6.5.1, schedule a MW and get the device upgraded.
• Verify that control connections from the edge device are all up.
  
  

Once we verify these steps, we have confirmed that the device is migration ready.

Pre-Checks

Before we start the migration process, let's capture the below outputs from the ISR1100 running Viptela OS for baseline or verification once the migration is completed:

1. Control connections from the device to all the controllers using “show control connections”.
2. Capture the BFD sessions and summary using “show bfd sessions” and “show bfd summary”.
3. Capture the OMP routes received from the vSmart using “show omp summary” and “show omp routes”.
4. Capture the route table on the device using “show ip route” and “show ip route vpn <vpn_name>”

Migrate from Cisco ViptelaOS to Cisco IOS XE SD-WAN

In this section, we will discuss the steps to migrate SD-WAN deployment with Cisco ISR1100 running Viptela OS to Cisco IOS XE SD-WAN.

1. Download the ISR1100 image to your system from here. The image name will begin with isr1100be
2. From vManage GUI, add the ISR1100 Cisco IOS XE SD-WAN image to the vManage Repository by choosing Maintenance > Software Repository > Add New Software > vManage.
3. In the pop-up window, we could browse for the image or drag and drop it on the pop-up window and click upload. While the image is getting uploaded to vManage, do not refresh the browser.
4. Once the image is copied/added to the repository, verify the image has been successfully uploaded to the list of images available from Maintenance > Software Repository.
5. Detach the device from the device template. If the device is attached, the upgrade task will fail.
6. Create a device template for the ISR1100 device with the Cisco OS option.
7. Perform the below steps during the MW:
   • Copy the image to the device and upgrade from vManage UI > Maintenance > Software Upgrade and choose the correct WAN edge. Select the device and click Upgrade.
   • On the pop-up window, choose vManage radio button, select the version from the drop-down, and make sure to choose the Cisco IOS XE image.
   • Select “Activate and Reboot” option and click Upgrade.
   • The device starts the upgrade process, and we can verify the status from the task view. This process will typically take some time.
   • After the upgrade, device will have a bare minimum config to form control connections to the vManage
   • Once the device is up and reachable from vManage, next step will be to migrate the device from vEdge to a Cisco Edge router. Go to vManage GUI > Configuration > Devices > WAN Edge List tab and then search for the device using system ip or hostname and click (…) for More Actions and choose “Migrate Device”.
   • On the pop-up window, click “Yes” to confirm the migration.
   • Once the migration task is complete, attach the device template that we created in Step 5.

Verification

Once the Migration activity is done, perform the below verification steps to confirm that everything looks good.

1. Check control connections from the device to all the controllers using “show sdwan control connections”
2. Verify that the data plane (BFD connections) are all up using “show sdwan bfd sessions” and “show sdwan bfd summary”
3. Verify the OMP routes received from the vSmart using “show sdwan omp summary” and “show sdwan omp routes”
4. Verify the route table on the device using “show ip route” show ip route vrf <vrf_name>”