map vlan

In a VXLAN overlay gateway configuration that uses Layer 2 extension, associates VLANs with VXLAN Network Identifiers (VNIs).

Syntax

map vlan [ vlan_id ] vni [ vni ] [ auto ]

no map vlan vlan_id

no map vlan vni

Parameters

vlan_id

A single VLAN ID or range of VLAN IDs. The range is from 1 through 8191. See the Usage Guidelines.

vni

Specifies the VNI (VXLAN Network Identifier) token.

vni: A single VXLAN VNI or range of VXLAN VNIs. Range is from 1 through 16777215. See the Usage Guidelines.

auto

Enables automatic VLAN-to-VNI mapping for every VLAN associated with the tunnel.

Modes

VXLAN overlay gateway configuration mode

Usage Guidelines

Note the following conditions:

Before using this command, you must first set the VXLAN overlay gateway to layer2-extension, by means of the type command.
Before using this command, you must first configure the appropriate VLANs to be used by the gateway.
Before mapping VLANs to VNIs manually, you cannot have automatic mapping configured (by means of the map vlan vni auto command).
You cannot map one VLAN to multiple VNIs. Similarly, you cannot map a single VNI to multiple VLANs. For example, VLAN-to-VNI mapping should be one to one.
A single VLAN ID and a range of VLAN IDs can both be specified in a single command as follows: x,y-z. The same applies to VNIs.
When using ranges, you must ensure that the number of values in a VLAN ID range corresponds to the number of values in a VNI range.
The no forms of this command are allowed only if no VLANs are referenced by means of the extend vlan command (under a submode of the site command). For example, VLANs extended to a site should have a VNI mapping.
The no map vlan vni auto command disables the automatic assignment of VNIs. It is not allowed if manual VLAN-to-VNI mappings have been configured. For example, "auto" VLAN-to-VNI mapping and "explicit" VLAN-to-VNI mapping are mutually exclusive.
The no map vlan vlan_id command removes the VNI mappings for one or more VLANs.
You cannot delete a VLAN (by means of the no interface vlan command) that is referenced by means of the map vlan vni command.
This command does not trigger VLAN provisioning, unlike the behavior of the attach vlan command.
Either automatic or manual VLAN mapping is supported. Hybrid mode is not supported.

Examples

To configure a manual mapping of VLANs to VNIs in "gateway1":

switch(config)# overlay-gateway gateway1
switch(config-overlay-gw-gateway1)# map vlan 10,20-22 vni 5000-5002,6000

This results in the following in the running configuration:

overlay-gateway gateway1
  type layer2-extension mode vxlan-ipv4
  map vlan 10 vni 5000
  map vlan 20 vni 5001
  map vlan 21 vni 5002
  map vlan 22 vni 6000

To configure an automatic mapping of VLANs to VNIs in "gateway1":

switch(config)# overlay-gateway gateway1
switch(config-overlay-gw-gateway1)# map vlan vni auto