Configuration Conversion Tool

Configuration Conversion Tool feature history

Table 1. Feature History

Feature Name

Release Information

Description

Configuration Conversion Tool

SD-WAN Manager 20.12.1

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

Export option for Configuration Conversion

SD-WAN Manager 20.18.2

You can export the converted template files from the Configuration Conversion Tool.

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

You can use the configuration conversion tool from Cisco Catalyst SD-WAN Portal or from Classic Templates menu.

Procedure

Step 1

Sign in to the SD-WAN Portal using your CCO credentials. If you are a Smart Account administrator, you are logged into the SD-WAN Portal as normal. Choose Configuration Conversion from the menu in order to enter the workflow. If your are not a Smart Account administrator, you get a 403 Forbidden page with a link to the tool.

Step 2

Launch the Configuration Conversion Tool.

Step 3

You can select the flows from SD-WAN Manager or upload the templates that are exported from SD-WAN Manager.

Choice Description
Connect to SD-WAN Manager Enter username, password, and the SD-WAN Manager port. The default port for HTTPS is 443.
Upload templates exported from SD-WAN Manager.

Follow the instructions to upload a file.

Step 4

Click Collect to 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

If you are using from SD-WAN Manager, click Configuration > Templates.

Step 6

In the Device Templates pane, select the device template you want to convert to their new equivalents.

Step 7

Click Configure conversion. The Configuration conversion wizard opens.

The tool converts the device templates and associated feature templates.

Step 8

Click Go to SD-WAN Portal to open SD-WAN Portal.

If cloud services is enabled - it will stat interactive workflow on the portal automatically.

Step 9

From SD-WAN Manager 20.18.2, you can export files. Click Export file to export the templates to your local. The templates are in the JSON format.

It produces a tarball for off-line conversion. You can start air-gap workflow using provided tarball in the portal.

Step 10

Click Convert to convert the selected items.

The Converted Configurations page displays all the newly converted constructs. Review the items created and their statuses.

Step 11

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.