CLI Add-On Feature Templates

Feature history for CLI add-on feature templates

Table 1. Feature History Table

Feature Name

Release Information

Description

CLI Add-On Feature Templates

Cisco IOS XE Catalyst SD-WAN Release 17.2.1r

Cisco vManage 20.1.1

This feature adds a new feature template called the CLI add-on feature template. You can use this feature template to attach specific CLI configurations to a device. If a configuration cannot be specified using Cisco SD-WAN Manager but can be configured using the CLI on the device, then you can use this feature template to specify such configurations. You can also use CLI add-on feature templates to add small pieces of CLI configuration, instead of an entire running configuration.

This feature is not intended to replace existing feature templates but instead to enhance their functionality.

Note that not all CLIs are qualified. For more information, see Qualified CLIs for Cisco IOS XE Release 17.2.1r.

Additional Commands Qualified for CLI Add-On Feature Templates

Cisco IOS XE Catalyst SD-WAN Release Amsterdam 17.2.x

Cisco SD-WAN Release 20.1.12

With each release, we qualify commands for use with the CLI add-on feature templates feature. In this release, we qualified additional commands. See the Appendix in the Cisco IOS XE SD-WAN Qualified Command Reference Guide.

CLI add-on feature templates for Cisco SD-WAN

The CLI add-on feature template is a template that:

  • Allows you to add custom device commands not available in standard feature templates.

  • Gives the commands in it priority over those present in the feature templates during merges.

When you specify commands using the template, always use the commands as per the syntax displayed in the show sdwan running-config output.

For example, for Cisco AAA, the attempts login command is not available in Cisco SD-WAN Manager.

By using a CLI add-on feature template, you can specify the aaa authentication attempts login number command for a device.

After you create the feature template, ensure that you add it to the device template.

You must define the CLI add-on feature template before you use it in a device template.

Restrictions for add-on feature templates

The CLI add-on feature templates:

  • Are supported only on devices running Cisco IOS XE Catalyst SD-WAN Release 17.2.1r or later.

  • Allow only one CLI add-on template per device template.

  • Require verification of each command by logging in and running it on the intended device before adding it to the CLI add-on feature template.

  • Include only supported commands. Using unsupported commands cause errors and configuration failures.

    For example, "login local" is not supported.

Create a CLI add-on feature template

Procedure

Step 1

From the Cisco SD-WAN Manager menu, choose Configuration > Templates > Feature Templates > Add Template to select an appropriate device model.

Note

 

In Cisco SD-WAN Release 20.7.x and earlier releases, Feature Templates is titled as Feature.

Step 2

From Select Devices, select the devices for which you are creating the template.

Step 3

From Select Template, scroll down to the OTHER TEMPLATES section.

Step 4

Click CLI Add-On Template.

Step 5

In the mandatory Template Name field, enter a name for the feature template; In the mandatory Description field, enter a description for the device template.

This Template Name field can contain only uppercase and lowercase letters, the digits 0 through 9, hyphens (-), and underscores (_). It does not support spaces or any other characters. The Description field can only contain any characters and spaces.

Step 6

In CLI Configuration, enter the configuration either by typing it, cutting and pasting it, or uploading a file.

Step 7

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}}.

Step 8

Click Save. The new feature template is displayed in the Feature Template table.

Step 9

To use the CLI add-on feature template, edit the device template as follows:

  1. From the Cisco SD-WAN Manager menu, choose Configuration > Templates.

  2. Click Device Templates.

    In Cisco SD-WAN Release 20.7.x and earlier releases, Device Templates is titled as Device.