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

Use the Catalyst SD-WAN Configuration Conversion Tool to collect templates and policies from your SD-WAN Manager instance, convert them, and create new configuration groups, policy groups, and topology groups in a new 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, and

  • 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

  • Your site must be using Cisco Catalyst SD-WAN Manager Release 20.12.x or later.

  • Your network firewall must accept incoming traffic from 74.207.103.254.

Use the Configuration Conversion Tool

Procedure

Step 1

For the commercial version of the Cisco Catalyst SD-WAN Portal, navigate to https://ssp.sdwan.cisco.com/. For the government version, log in at https://ssp-gov.sdwangov.fedramp.cisco.

Step 2

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

Step 3

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

Step 4

Click Collectto retrieve all legacy constructs, including device templates, feature templates, policies, and associated constructs, from SD-WAN Manager.

When the collection is complete, download the JSON file containing all configurations. Use this file to repeat the process later without collecting the data again from SD-WAN Manager.

Step 5

Click Templates and select the device templates you want 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 policy conversion. This action converts all defined policies 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, a summary of the configurations that were uploaded appears.

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

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