Migrating from vEdge (Viptela OS) to cEdge (IOS-XE) and vice versa

[Javier Teliz]

Migration Using Cisco Catalyst SD-WAN Manager (formerly Cisco vManage)

Note1: Specific requirements:
Cisco vManage Release 20.4.1 or later•
Cisco Integrated Services Routers (ISR)1100 and ISR1100X Release 20.4.1 or later•

Note 2: Migration between Viptela OS and Cisco IOS XE is supported in listed platforms:
Cisco ISR1100X-6G•
Cisco ISR1100X-4G•
Cisco ISR1100-6G•
Cisco ISR1100-4G•
Cisco ISR1100-4GLTE (Cisco ISR1100-4GLTENA and Cisco ISR1100-4GLTEGB )

Migrating from vEdge (Viptela OS) to cEdge (IOS-XE)

Step 1: Detach the Template (If Applicable)

• If a device template is attached, detach it before proceeding with the migration.

Step 2: Upgrade the Software

1. In Cisco vManage, navigate to Maintenance > Software Upgrade.

2. Select the target router from the list and click Upgrade.

3. In the Software Upgrade pop-up:

   • Choose vManage as the upgrade method.

   • In the Version field, select the IOS-XE image.

   • Check the Activate and Reboot and Confirm checkboxes.

   • Click Upgrade. The Task View page will display the upgrade progress.

   • The device will reboot automatically after the upgrade (this process takes approximately 20 minutes).

Step 3: Verify Migration Completion

• In Task View, confirm successful migration by checking for:

  • A green tick mark next to the task.

  • The status "Done – Software Install".

Step 4: Finalize the Migration

1. In Cisco vManage, go to Configuration > Devices.

2. Locate the upgraded device in the WAN Edge List table.

3. Click More Actions (⋮) > Migrate Device.

4. A warning pop-up will appear, notifying that existing statistics, event history, and configuration will be erased. Click Yes to continue.

5. On the Configuration page, click Refresh.

6. Verify that the Device Model column now reflects the correct operating system:

   • If migrated to IOS-XE, it should display Cisco OS.

Post-Migration Note

• Once migrated, the device operates like any other IOS-XE device.

• Optionally, use Cisco vManage to apply a new device template for additional configurations.

---

 

Migrating from cEdge (IOS-XE) to vEdge (Viptela OS)

Step 1: Detach the Template (If Applicable)

• If a device template is attached, detach it before proceeding with the migration.

Step 2: Upgrade the Software

1. In Cisco vManage, go to Maintenance > Software Upgrade.

2. Select the target router from the list and click Upgrade.

3. In the Software Upgrade pop-up:

   • Choose vManage as the upgrade method.

   • In the Version field, select the vEdge image.

   • Check the Activate and Reboot and Confirm checkboxes.

   • Click Upgrade. The Task View page will display the upgrade progress.

   • The device will reboot automatically after the upgrade (this process takes approximately 20 minutes).

Step 3: Verify Migration Completion

• In Task View, confirm successful migration by checking for:

  • A green tick mark next to the task.

  • The status "Done – Software Install".

Step 4: Finalize the Migration

1. In Cisco vManage, go to Configuration > Devices.

2. Locate the upgraded device in the WAN Edge List table.

3. Click More Actions (⋮) > Migrate Device.

4. A warning pop-up will appear, notifying that existing statistics, event history, and configuration will be erased. Click Yes to continue.

5. On the Configuration page, click Refresh.

6. Verify that the Device Model column now reflects the correct operating system:

   • If migrated to vEdge, it should display Viptela OS.

Post-Migration Note

• Once migrated, the device operates like any other vEdge device.

• Optionally, use Cisco vManage to apply a new device template for additional configurations.