Device Configuration-Based CLI Templates for Cisco IOS XE Catalyst SD-WAN Devices
Cisco SD-WAN Manager configures Cisco IOS XE Catalyst SD-WAN devices using a combination of feature templates and policies (localized policies, security policies). In Cisco vManage 20.1.1 and onwards, Cisco SD-WAN Manager allows you to specify CLI templates that use the device configuration with Cisco IOS XE Catalyst SD-WAN devices. You can use these templates to push the device configuration (yang-cli) to devices directly.
In a single operation, Cisco SD-WAN Manager pushes the difference between the device configuration and configuration provided by the user in the template directly to the Cisco IOS XE Catalyst SD-WAN devices. Cisco SD-WAN Manager also displays a preview of the configuration before it is pushed to the device, as it does with other templates. The described workflow also applies if you want to make any additions, changes, or removals to the template.
Note |
To configure features not accessible using Cisco SD-WAN Manager, we recommend doing the following:
|
Feature Information for CLI Template for Cisco XE SD-WAN Routers
Feature Name |
Release Information |
Description |
---|---|---|
Device Configuration CLI Templates |
Cisco IOS XE Catalyst SD-WAN Release 17.2.1r Cisco vManage 20.1.1 |
The CLI Templates feature has been updated to support device configuration-based CLIs. You can use these templates to push the device configuration (yang-cli) to devices directly. |
Limitations
Auxiliary ports: When using a CLI template for Cisco Integrated Services Routers that have an auxiliary port, do not include commands for auxiliary ports, such as line aux 0 . Doing so results in an error. These commands may be executed directly on the device.
When you import the CLI template configuration using the command, show sdwan running-config
, you need to add quotes manually for the CLI template on the Cisco SD-WAN Manager.
From Cisco Catalyst SD-WAN Manager Release 20.12.x, policies configured using a Cisco SD-WAN Controller template are ignored. To configure policies, navigate to , add the policy and activate it for Cisco SD-WAN Controllers.
Configure CLI Templates in Cisco SD-WAN Manager
-
From the Cisco SD-WAN Manager menu, choose .
-
Click Device Templates.
Note
In Cisco vManage Release 20.7.x and earlier releases, Device Templates is titled as Device.
-
From the Create Template drop-down list, select CLI Template.
-
From the Device Model drop-down list, select the type of device for which you are creating the template.
-
In Template Name, enter a name for the template.
The name can be up to 128 characters and can contain only alphanumeric characters.
-
In Template Description, enter a description of the template.
The description can be up to 2048 characters and can contain only alphanumeric characters.
-
Choose Device configuration. Using this option, you can provide IOS-XE configuration commands that appear in the output of the
show sdwan running-config
command. -
(Optional) To load the running config of a connected device, select it from the Load Running config from reachable device list and click Search.
-
In CLI Configuration, enter the configuration either by typing it, cutting and pasting it, or uploading a file.
-
To convert an actual configuration value to a variable, select the value and click Create Variable. Enter the variable name, and click Create Variable. You can also type the variable name directly, in the format {{variable-name}}; for example, {{hostname}}.
These variables can be filled in device variables page per device after attaching the template. Values can be entered manually or can be uploaded via a csv file.
-
To save the feature template, click Add. The new device template is displayed in the Device Template table.