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


You can use the DHCP-Server template for all vEdge Cloud and vEdge router devices.

You enable DHCP server functionality on a vEdge router interface so it can assign IP addresses to hosts in the service-side network.

To configure a vEdge router to act as a DHCP server using vManage templates:

  1. Create a DHCP-Server feature template to configure DHCP server parameters, as described in this article.
  2. Create one or more interface feature templates, as described in the VPN-Interface-Ethernet and the VPN-Interface-PPP-Ethernet help topics.
  3. Create a VPN feature template to configure VPN parameters. See the VPN help topic.
  4. Create a device template that incorporates the VPN, interface, and DHCP-Server feature templates. See the Configuration ► Templates help topic.

To configure a vEdge router interface to be a DHCP helper, so that it forwards broadcast DHCP requests that it receives from DHCP servers, in the DHCP Helper field of the applicable interfaces template, enter the addresses of the DHCP servers.​

Navigate to the Template Screen

  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 devices. The right pane displays the available templates for the selected devices.
  5. Select the DHCP-Server template.

The right pane displays the DHCP-Server template form:

  • The top of the form contains fields for naming the template.
  • The bottom contains fields for defining parameters applicable to that template.
  • A drop-down menu to the left of each parameter field defines the scope of the parameter. When you first open a feature template form, for each parameter that has a default value, the scope is set to Default. To edit a parameter field, change the scope to Global or Device Specific. Note that if a parameter's scope is Device Specific, you cannot enter a value for it in the feature template. Instead, you enter a value when you attach the template to a device.
  • A plus sign (+) is displayed to the right when you can add multiple entries for the same parameter.

Minimum DHCP Server Configuration

The following parameters are can be configured to specify DHCP server functionality. At a minimum, you must configure the address pool.

Step Parameter Name Description
 1. Template Name Enter template name. It can be up to 128 characters and can contain only alphanumeric characters.
 2. Description (Template) Enter description of the template. It can be up to 2048 characters and can contain only alphanumeric characters.
 3. Address pool Enter the IPv4 prefix range, in the format prefix/length, for the pool of addresses in the service-side network for which the vEdge router interface acts as DHCP server.
 4. Exclude (optional) Enter one or more IP addresses to exclude from the DHCP address pool. To specify multiple individual addresses, list them separated by a comma (for example,,, To specify a range of addresses, separate them with a hyphen (for example,
 5. Maximum leases (optional)

Specify the number of IP addresses that can be assigned on this interface.
Range: 0 through 4294967295

 6. Lease time (optional)

Specify how long a DHCP-assigned IP address is valid.
Range: 0 through 4294967295 seconds

 7. Offer time (optional)

Specify how long the IP address offered to a DHCP client is reserved for that client. By default, an offered IP address is reserved indefinitely, until the DHCP server runs out of addresses. At that point, the address is offered to another client.
Range: 0 through 4294967295 seconds
Default: 600 seconds

 8. Administrative state (optional) Select Up to enable or Down to disable the DHCP functionality on the interface. By default, DHCP server functionality is disabled on a vEdge router interface.
 9. Interface MTU (optional)

Specify the maximum MTU size of packets on the interface.
Range: 68 to 65535 bytes

 10. Domain name (optional) Specify the domain name that the DHCP client uses to resolve hostnames.
 11. Default gateway (optional) Enter the IP address of a default gateway in the service-side network.
 12. DNS servers (optional) Enter one or more IP address for a DNS server in the service-side network. Separate multiple entries with a comma. You can specify up to eight addresses.
 13. TFTP servers Enter the IP address of a TFTP server in the service-side network. You can specify one or two addresses. If two, separate them with a comma.
 14. Save Click Save to save the feature template.

CLI equivalent:

vpn vpn-id
  interface geslot/port
      address-pool prefix/length
      admin-state (down | up)
      exclude ip-address
      lease-time seconds
      max-leases number
      offer-time minutes
        default-gateway ip-address
        dns-servers ip-address
        domain-name domain-name
        interface-mtu mtu
        tftp-servers ip-address


Configure Static Leases

To configure a static lease to assign a static IP address to a client device on the service-side network, click the plus sign (+):

Parameter Name Description
MAC Address Enter the MAC address of the client to which the static IP address is being assigned.
IP Address Enter the static IP address to assign to the client.
Hostname Enter the hostname of the client device.

To remove a static lease, click the trash icon to the right of the entry.

CLI equivalent:

vpn vpn-id
  interface geslot/port
      static-lease mac-address ip ip-address host-name hostname

Release Information

Introduced in vManage NMS in Release 15.2.

  • Was this article helpful?