Skip to main content
Cisco SD-WAN
Support
Product Documentation
Viptela Documentation

Create Configuration Templates for a vEdge Router

This article describes how to configure vEdge routers that are being managed by a vManage NMS. These routers must be configured from the vManage NMS. If you configure these routers directly from the CLI on the router, the vManage NMS overwrites the configuration with the one stored on the NMS system.

Configuration Prerequisites

Security Prerequisites

Before you can configure the vEdge routers in the Viptela overlay network, the devices must be validated and authenticated so that the vManage NMSs, vSmart controllers, and vBond orchestrators recognize them as being allowed in the overlay network.

To validate and authenticate the vEdge routers, you receive a vEdge authorized serial number file from Viptela, which lists the serial and chassis numbers for all the vEdge routers allowed in your network. Then, you upload the vEdge serial number file to the vManage NMS.

Variables Spreadsheet

The feature templates that you create will most likely contain variables. To have the vManage NMS populate the variables with actual values when you attach a device template to a device, either enter the values manually or click Import File in the upper right corner to load an Excel file in CSV format that contains the variables values.

In the spreadsheet, the header row contains the variable name and each row after that corresponds to a device, defining the values of the variables. The first three columns in the spreadsheet must be (in the order listed below):

  • csv-deviceId—Serial number of the device (used to uniquely identify the device). For vEdge routers, you receive the serial numbers in the vEdge authorized serial number file sent to you from Viptela. For other devices, the serial number is included in the signed certificate you receive from Symantec or from your root CA.
  • csv-deviceIP—System IP address of the device (used to populate the system ip address command).
  • csv-host-name—Hostname of the device (used to populate the system hostname command).

You can create a single spreadsheet for all devices in the overlay network—vEdge routers, vSmart controllers, and vBond orchestrators. You do not need to specify values for all variables for all devices.

Feature Templates for vEdge Routers

The following features are mandatory for vEdge router operation, and so creating a feature template for each of them is required:

Feature

Template Name

Authentication, Authorization, and Accounting (AAA)

AAA

Bidirectional Forwarding Detection (BFD)

BFD

Overlay Management Protocol (OMP)

OMP

Security

Security

System-wide parameters

System

Transport VPN (VPN 0)

VPN, with the VPN ID set to 0

Management VPN (for out-of-band management traffic)

VPN, with the VPN ID set to 512

The following templates are provided for other vEdge router features:

Feature

Template Name

Archive of the router's running configuration

Archive

Banners display before and login and

Banner

BGP

BGP

Bridging Bridge
Bridging interfaces VPN-Interface-Bridge
Cellular profiles and interfaces (in Releases 16.3 and later) Cellular-Profile and VPN-Interface-Cellular

DHCP server

DHCP-Server

Ethernet interfaces VPN-Interface-Ethernet
GRE interfaces VPN-Interface-GRE

IGMP

IGMP

Message logging

Logging

IP multicast

Multicast

NAT pool interfaces VPN-Interface-Natpool

Network Time Protocol

NTP

OSPF

OSPF

PPP interfaces VPN-Interface-PPP and VPN-Interface-PPP-Ethernet

Protocol-Independent Multicast

PIM

SNMP

SNMP

WLAN WiFi Radio (in Releases 16.3 and later) WiFi Radio
WLAN WiFi SSID (in Release 16.3 and later) WiFi SSID

Create Feature Templates

Feature templates are the building blocks of a vEdge router's complete configuration. For each feature that you can enable on a vEdge router, the vManage NMS provides a template form that you fill out with the desired parameters for that feature.

You must create feature templates for the mandatory vEdge router features.

You can create multiple templates for the same feature.

To create vEdge feature templates:

  1. In vManage NMS, select the Configuration ► Templates screen.
  2. From the Templates title bar, select Feature.
  3. Click Add Template.
  4. In the left pane, select one or more router models. You can create a single feature template for features that are available on more than one vEdge model. You must, however, create separate feature templates for software features that are available only on one or a subset of router models.
  5. In the right pane, select the template. The template form is displayed. The top of the form contains fields for naming the template, and the bottom contains fields for defining required parameters applicable to that template. Optional parameters are generally grayed out. A plus sign (+) is displayed to the right when you can add multiple entries for the same parameter.
  6. Enter a template name and description. These fields are mandatory. You cannot use any special characters in template names.
  7. For each required parameter, choose the desired value, and if applicable, select the scope of the parameter. Select the scope from the drop-down menu to the left of each parameter's value box:
     

    Parameter Scope

    Scope Description

    Default

    Use the default value for the parameter.

    If the parameter is already configured on a device, the configured value is not modified. (Because vEdge routers are shipped with a factory-default configuration, some parameters are preconfigured on new routers.)

    If the parameter is not yet configured on a device and if it has a default value, that default value is configured on the device. Examples of parameters that have default values are the various timers for routing protocol hello intervals.

    Device specific

    Use a device-specific value for the parameter.

    When you attach the device template to the router, you must enter the value for the parameter. You can type the values manually, or you can upload an Excel file in CSV format that contains the parameter's value.

    Examples of device-specific parameters are system IP address, hostname, GPS location, and site ID.

    Global

    Enter a value for the parameter, and apply that value to all devices.

    Examples of parameters that you might apply globally to a group of devices are DNS server, syslog server, and interface MTUs.

  8. Click the plus sign (+) below the required parameters to set the values for additional parameters, if applicable.
  9. Click Create.
  10. Create feature templates for each of the required features listed in the previous section.

    For the transport VPN, use the template called VPN-vEdge and in the VPN Template section, set the VPN to 0, with a scope of Global.

    For the management VPN, use the template called VPN-vEdge and in the VPN Template section, set the VPN to 512, with a scope of Global.
  11. Create feature templates for each optional feature that you want to enable on vEdge routers.

Create Device Templates

Device templates contain all or large portions of a device's complete operational configuration. You create device templates by consolidating together individual feature templates. You can also create them by entering a CLI text-style configuration directly on the vManage NMS. You can use both styles of device templates when configuring a vEdge router.

To create vEdge device templates from feature templates:

  1. In vManage NMS, select the Configuration ► Templates screen.
  2. From the Templates title bar, select Device.
  3. Click Create Template, and from the drop-down list, select From Feature Templates.
  4. From the Device Model drop-down, select the router model. You create separate device templates for each vEdge router model in the overlay network.
  5. Enter a name and description for the vEdge router device template. These fields are mandatory. You cannot use any special characters in template names.
  6. Complete the Required Templates section. All required templates are marked with an asterisk. 
    1. For each required template, select the feature template from the drop-down list. These templates are the ones that you previously created (see Create Feature Templates above). After you select a template, the circle next to the template name turns green and displays a green check mark. 
    2. For templates that have Sub-Templates, click the plus (+) sign or the Sub-Templates title to display a list of sub-templates. As you select a sub-template, the name of the sub-template along with a drop-down is displayed. If the sub-template is mandatory, its name is marked with an asterisk. 
    3. Select the desired sub-template.
  7. Complete the Optional Templates section, if required. To do so:
    1. Click Optional Templates to add optional feature templates to the device template.
    2. Select the template to add.
    3. Click the template name and select a specific feature template.
  8. Click Create. The new device template is listed in the Templates table. The Feature Templates column shows the number of feature templates that are included in the device template, and the Type column shows "Feature" to indicate that the device template was created from a collection of feature templates.

To create device templates by entering a CLI text-style configuration directly on the vManage NMS:

  1. In vManage NMS, select the Configuration ► Templates screen.
  2. From the Templates title bar, select Device.
  3. Click Create Template, and from the drop-down list, select CLI Template.
  4. In the Add Device CLI Template box, enter a template name and description, and select the router model.
  5. Enter the configuration in the CLI Configuration box, either by typing it, cutting and pasting it, or uploading a file.
  6. 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}}.
  7. Click Add. The right pane on the screen lists the new device template. The Feature Templates column shows the number of feature templates that are included in the device template, and the Type column shows "CLI" to indicate that the device template was created from CLI text.

Attach Device Templates To Routers

To configure a vEdge router, you attach one device template to a vEdge router. You can attach the same template to multiple vEdge routers simultaneously.

To attach a device template to vEdge routers:

  1. In vManage NMS, select the Configuration ► Templates screen.
  2. From the Templates title bar, select Device.
  3. In the right pane, select the desired device template.
  4. Click the More Actions icon to the right of the row, and select Attach Devices.
  5. In the Attach Devices box, select the desired vEdge routers from the Available Devices list, and click the right-pointing arrow to move them to the Selected Devices box. The Attach Devices box lists only the routers whose router model matches the model in the device template. You can select one or more router. Click Select All to choose all listed routers.
  6. Click Attach.
  7. If the device template contains variables, either enter the values manually or click Import file in the upper right corner to load an Excel file in CSV format that contains the variable values.
  8. Click Next.
  9. To send the configuration in the device template to the vEdge routers, click Configure Device.

Release Information

Introduced in vManage NMS in Release 15.3.

  • Was this article helpful?