Configuration Conversion Tool

Configuration Conversion Tool feature history

Table 1. Feature History

Feature Name

Release Information

Description

Configuration Conversion Tool

April 2025

The Configuration Conversion Tool converts templates and policies to configuration groups, policy groups, and topology groups.

Information about the Configuration Conversion Tool

The Cisco Catalyst SD-WAN Configuration Conversion Tool converts templates and policies to configuration groups, policy groups, and topology groups. The tool collects the templates and policies from a Cisco SD-WAN Manager instance, converts them, and creates the new constructs in the Cisco SD-WAN Manager instance.

Conversion details

The Configuration Conversion Tool:

  • Converts device templates to configuration groups

  • Converts policies into policy groups and topology groups where applicable

  • Transfers global device values and variable names

Restrictions for the Configuration Conversion Tool

  • The Configuration Conversion Tool is considered to be in beta.

  • The Configuration Conversion Tool does not convert features that do not have a configuration group or policy group equivalent.

Prerequisites for the Configuration Conversion Tool

  • Cisco Catalyst SD-WAN Manager Release 20.12.x or later.

  • Your network's firewall must accept incoming traffic from 74.207.103.254.

Use the Configuration Conversion Tool

Procedure


Step 1

Log in to the Cisco Catalyst SD-WAN Portal using your Cisco login credentials.

Step 2

Launch the Configuration Conversion Tool. If you do not have full access for the Cisco Catalyst SD-WAN Portal, the page displays a message with a link for limited access. Click the link to open the Configuration Conversion Tool.

Step 3

Enter your SD-WAN Manager IP or URL along with user credentials. Port and subdomain fields are optional.

Step 4

Click Collect to retrieve all legacy constructs (device templates, feature templates, policies, and their associated constructs) from SD-WAN Manager.

When the collection is complete, you can download a JSON file containing all the configurations. You can use this file if you repeat this process later instead of collecting these again from SD-WAN Manager.

Step 5

Click Templates and select some or all device templates to convert to their new equivalents.

The tool converts the device templates and associated feature templates.

Step 6

If you need to convert policies, click Policies and select the option to enable conversion of policies. This option converts all defined policies that are referenced by device templates.

Step 7

Click Convert to convert the selected items.

The Converted Configurations page displays all the newly converted constructs.

Step 8

Confirm the list and click Upload to add the configurations to SD-WAN Manager.

You can cancel an upload in progress.

After the upload is complete, you see a summary of the uploaded configurations.

If needed, you can click Rollback to remove all the constructs added to SD-WAN Manager during this session.


The new constructs are now ready to use.

What to do next

Execute the steps in the Existing Deployments section of the Quick Start Guide - Catalyst SD-WAN Simplified Configuration and Policies to migrate your devices to the newly converted configuration groups.