Converting a Sample Config File

This section covers an end-to-end user flow for converting a sample IOS-XE file to SD-WAN compatible config file. The steps given below can be used as a reference while converting Cisco IOS-XE configuration to a compatible SD-WAN configuration.

  1. Select the Upload tab from the top left corner of the UI.
  2. Drag and drop a configuration file into the activity window. The name of the file will be displayed next to the detail icon, for example, ios_running_config, as shown in the figure below.
_images/upload_sample_config.png

Figure 1. Sample config file uploaded

Note

Currently, SD-WAN Conversion Tool supports text files with plain text or a config file without any extension.

  1. Click on Next to upload this file on SD-WAN Conversion Tool. A loading screen will appear on the application window as shown in the figure below.
_images/uploading_file.png

Figure 2. Uploading the sample config file

  1. Upon successfully uploading the file on SD-WAN Conversion Tool, the following message will be displayed on the screen as shown in the figure below. Also, the contents of the original file will be displayed in an on-screen editor.
_images/upload_successful.png

Figure 3. Sample Config file uploaded successfully

  1. Click on Next to proceed. A loading screen will appear on the application window as shown in the figure below. This indicates the beginning of the validation process.
_images/validating_file.png

Figure 4. Validating the config file

  1. Once validation is complete, a parsed file is shown in a side-by-side view, grouped by interfaces/features similar to vManage components. At this stage, the user can update the original file in the on-screen editor and click the refresh button to see reflected changes in supported/unsupported configuration.
_images/parse_n_verify.png

Figure 5. Parsed sample config file

The red-alert icon indicates an unsupported feature. Clicking on any of the listed features displays the status of that feature in the Features tab and highlights it in the editable window.

Note

The user should reconfigure any unsupported features or interfaces if they want them to be a part of the SD-WAN configuration before proceeding to the next step. Any unsupported features left at this point will be removed from the XE SD-WAN configuration.

  1. Once the user has reconfigured the unsupported features and interfaces, click on Next to proceed. A loading screen will appear on the application window that indicates the beginning of the verification process in the backend.
_images/verifying_file.png

Figure 6. Verifying the sample config file

  1. After the config file has been successfully verified, the following screen appears on the application window.
_images/verification_successful.png

Figure 7. Sample config file verified successfully

  1. Click on the dropdown arrow for Device Type to select a device type. By default, vEdge Cloud will be selected. In this example, select CSR1000v as the device type. The CLI Add-On Template feature can be enabled by clicking on the toggle switch. This option is only available if the selected device type is a cEdge device.
_images/verification_successful2.png

Figure 8. Configuring CLI add-on template with toggle switch

  1. Click on the dropdown arrow to select a tunnel interface(s). Multiple interfaces can also be selected as per the use case. For example, GigabitEthernet1 and GigabitEthernet2 have been selected in the figure below.
_images/tunnel_interfaces2.png

Figure 9. Select tunnel interfaces from drop-down menu

  1. Click on Next to proceed. A loading screen appears on the application window as shown in the figure below. This indicates the beginning of the modification process.
_images/modifying_file2.png

Figure 10. Modifying the sample config file

  1. Upon successfully modifying the configuration file, the following screen will appear on the application window indicating a successful modification process.
_images/ios-xe_modification_successful.png

Figure 11. Sample config file modified successfully

  1. If the CLI Add-On Template feature is enabled, the user will be presented with two tabs. One for the XE SD-WAN config, and one for the CLI Add-On config. Both can be edited at this point.
  2. After the config file has been successfully modified, click on Next to proceed. A loading screen will appear on the application window that indicates the beginning of the conversion process.
_images/converting_file.png

Figure 12. Converting the sample config file

  1. Upon successfully converting the config file into a compatible XE SD-WAN config file, the following screen will appear on the application window indicating a successful conversion process.
_images/conversion_successful.png

Figure 13. Sample config file converted successfully

  1. After the config file has been successfully converted to SD-WAN compatible config file, click on Next to proceed. The following application window will appear on the screen.
_images/export_window.png

Figure 14. Application window to export converted file

  1. Fill in the required fields by entering the relevant configuration details to proceed with the export process. An example config is shared in the figure below.
_images/sample_export_config.png

Figure 15. Sample config to export the converted file

See also

To know more details about these fields, refer to the Export section.

  1. Once the user has filled in the relevant fields, click on Next to proceed. A loading screen will appear on the application window that indicates the beginning of the export process in which the config file is exported to vManage.
_images/exporting_file.png

Figure 16. Exporting the sample config file

  1. After the config file has been successfully exported to vManage, the following screen will appear on the application window indicating a successful export process.
_images/export_successful1.png

Figure 17. Config file successful export - Live vManage as target

This concludes the basic workflow for converting an IOS-XE config file to SD-WAN compatible configuration with vManage as the target.