.. Copyright (c) 2023, Xgrid Inc, https://xgrid.co .. Licensed under the Apache License, Version 2.0 (the "License"); .. you may not use this file except in compliance with the License. .. You may obtain a copy of the License at .. http://www.apache.org/licenses/LICENSE-2.0 .. Unless required by applicable law or agreed to in writing, software .. distributed under the License is distributed on an "AS IS" BASIS, .. WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. .. See the License for the specific language governing permissions and .. limitations under the License. .. _convert_sample_file: 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. .. figure:: images/upload_sample_config.png :align: center 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. 3. 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. .. figure:: images/uploading_file.png :align: center Figure 2. Uploading the sample config file 4. 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. .. figure:: images/upload_successful.png :align: center Figure 3. Sample Config file uploaded successfully 5. 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. .. figure:: images/validating_file.png :align: center Figure 4. Validating the config file 6. 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. .. figure:: images/parse_n_verify.png :align: center Figure 5. Parsed sample config file .. |red-alert| image:: images/red_alert.png :width: 15px 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. 7. 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. .. figure:: images/verifying_file.png :align: center Figure 6. Verifying the sample config file 8. After the config file has been successfully verified, the following screen appears on the application window. .. figure:: images/verification_successful.png :align: center Figure 7. Sample config file verified successfully 9. 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. 10. 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. .. figure:: images/tunnel_interfaces2.png :align: center Figure 9. Select tunnel interfaces from drop-down menu 11. 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. 12. Upon successfully modifying the configuration file, the following screen will appear on the application window indicating a successful modification process. .. figure:: images/ios-xe_modification_successful.png :align: center Figure 11. Sample config file modified successfully 13. 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. 14. 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. .. figure:: images/converting_file.png :align: center Figure 12. Converting the sample config file 15. 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. .. figure:: images/conversion_successful.png :align: center Figure 13. Sample config file converted successfully 16. 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. .. figure:: images/export_window.png :align: center Figure 14. Application window to export converted file 17. 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. .. figure:: images/sample_export_config.png :align: center Figure 15. Sample config to export the converted file .. seealso:: To know more details about these fields, refer to the :ref:`Export` section. 18. 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. .. figure:: images/exporting_file.png :align: center Figure 16. Exporting the sample config file 19. After the config file has been successfully exported to vManage, the following screen will appear on the application window indicating a successful export process. .. figure:: images/export_successful1.png :align: center 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. .. |detail| image:: images/detail.png :width: 15px .. |refresh| image:: images/refresh_icon.png :width: 25px