Table Of Contents

802.1Q VLAN Subinterface Commands on Cisco IOS XR Software

dot1q native vlan

dot1q tunneling ethertype 0x9100

dot1q vlan

interface (VLAN)

l2protocol (VLAN)

show vlan interface

show vlan tags

show vlan trunks

802.1Q VLAN Subinterface Commands on Cisco IOS XR Software

---

This module contains commands for configuring and monitoring 802.1Q VLAN commands on Cisco IOS XR software.

dot1q native vlan

To assign the native VLAN ID of a physical interface trunking 802.1Q VLAN traffic, use the dot1q native vlan command in interface configuration mode. To remove the VLAN ID assignment, use the no form of this command.

dot1q native vlan vlan-id

no dot1q native vlan vlan-id

Syntax Description

vlan-id

Trunk interface ID. Range is from 1 to 4094 inclusive (0 and 4095 are reserved).

Defaults

No default behavior or values

Command Modes

Interface configuration

Command History

Release	Modification
Release 3.0	This command was introduced on the Cisco CRS-1.
Release 3.2	No modification.
Release 3.3.0	Support was added for this command on Cisco CRS-1 shared port adapters (SPAs).
Release 3.4.0	No modification.
Release 3.5.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

The dot1q native vlan command defines the default, or native VLAN, associated with a 802.1Q trunk interface. The native VLAN of a trunk interface is the VLAN to which all untagged VLAN packets are logically assigned.

---

Note The native VLAN cannot be configured on a subinterface of the trunk interface. The native VLAN must be configured with the same value at both ends of the link, or traffic can be lost or sent to the wrong VLAN.

---

Task ID

Task ID	Operations
vlan	read, write

Examples

The following example shows how to configure the native VLAN of a TenGigE0/2/0/4 trunk interface as 1. Packets received on this interface that are untagged, or that have an 802.1Q tag with VLAN ID 1, are received on the main interface. Packets sent from the main interface are transmitted without an 802.1Q tag.

RP/0/RP0/CPU0:router(config)# interface TenGigE 0/2/0/4

RP/0/RP0/CPU0:router(config-if)# dot1q native vlan 1

Related Commands

Command	Description
dot1q vlan	Assigns a VLAN ID to a subinterface, or changes the VLAN ID assigned to a subinterface.

dot1q tunneling ethertype 0x9100

To configure the Ethertype used by peer devices when implementing Q-in-Q VLAN tagging to be 0x9100, use the dot1q tunneling ethertype command in interface configuration mode for an Ethernet interface. To return to the default configuration of Ethertype 0x8100, use the no form of this command.

dot1q tunneling ethertype 0x9100

no dot1q tunneling ethertype 0x9100

Syntax Description

This command has no arguments or keywords.

Defaults

The Ethertype field used by peer devices when implementing Q-in-Q VLAN tagging is 0x8100.

Command Modes

Interface configuration

Command History

Release	Modification
Release 3.4.0	This command was first introduced on the Cisco CRS-1.
Release 3.5.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Q-in-Q tunneling uses a second ethertype and VLAN identification field that allows a service provider tag to be added to a packet that already has a customer VLAN tag.

Use the dot1q tunneling ethertype 0x9100 command if the peer switching devices are using an Ethertype field value of 0x9100. All Cisco switching devices use the default Ethertype field value of 0x8100.

After you issue the dot1q tunneling ethertype 0x9100 command, all peer devices will use that Ethertype when implementing Q-in-Q VLAN tagging.

Task ID

Task ID	Operations
vlan	read, write

Examples

The following example shows how to configure the inter-packet gap for a 10-Gigabit Ethernet interface:

RP/0/0/CPU0:router# configure

RP/0/0/CPU0:router(config-if)# interface GigabitEthernet 0/1/5/0

RP/0/0/CPU0:router(config-if)# dot1q tunneling ethertype 0x9100

Related Commands

Command	Description
dot1q vlan	Assigns a VLAN ID to a subinterface, or modifies the VLAN ID that is currently assigned to a subinterface.

dot1q vlan

To assign a VLAN ID to a subinterface (or to modify the VLAN ID that is currently assigned to a subinterface) use the dot1q vlan command in subinterface configuration mode. To remove the VLAN ID assigned to a subinterface, use the no form of this command.

On the Cisco CRS-1:

dot1q vlan vlan-id

no dot1q vlan vlan-id

On the Cisco XR 12000 Series Router.

dot1q vlan vlan-id [vlan-id2 | any]

no dot1q vlan vlan-id

Syntax Description

vlan-id	ID of the subinterface. Range is from 1 to 4094 (0 and 4095 are reserved).
vlan-id2	(Optional) Identifies the host VLAN of a Q-in-Q VLAN pair. Replace vlan-id2 with a number that specifies the host VLAN. Range is from 1 to 4094. Note The vlan-id2 argument is available for Q-in-Q VLANs on a 10-Gigabit Ethernet node that is installed in a Cisco XR 12000 Series Router only.
any	(Optional) Identifies the host VLAN of a Q-in any VLAN pair. Note The any keyword is available for Q-in-any VLANs on a 10-Gigabit Ethernet node that is installed in a Cisco XR 12000 Series Router only.

Defaults

No default behavior or values

Command Modes

Subinterface configuration

Command History

Release	Modification
Release 3.0	This command was introduced on the Cisco CRS-1.
Release 3.2	This command was first supported on the Cisco XR 12000 Series Router.
Release 3.3.0	No modification.
Release 3.4.0	No modification.
Release 3.5.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

The VLAN ID specifies where 802.1Q tagged packets are sent and received on a specified subinterface. An 802.1Q VLAN subinterface must have a configured VLAN ID to send and receive traffic; without a VLAN ID, the subinterface remains in the down state. All VLAN IDs must be unique among all subinterfaces configured on the same physical interface. To change a VLAN ID, the new VLAN must not already be in use on the same physical interface. To exchange VLAN IDs, you must remove the configuration information and reconfigure the ID for each device.

---

Note The subinterface does not pass traffic without an assigned VLAN ID.

---

Task ID

Task ID	Operations
vlan	read, write

Examples

The following example shows how to configure the VLAN ID and IP address on a subinterface:

RP/0/RP0/CPU0:router# configure

RP/0/RP0/CPU0:router(config)# interface TenGigE 0/2/0/4.1

RP/0/RP0/CPU0:router(config-subif)# dot1q vlan 10

RP/0/RP0/CPU0:router(config-subif)# ipv4 addr 10.0.0.1/24

The following example shows how to configure the VLAN IDs for both VLANS in a single Q-in-Q attachment circuit (AC). In this case, incoming traffic must match both of the VLAN IDs before it is accepted by the subinterface:

RP/0/0/CPU0:router# configure

RP/0/0/CPU0:router(config)# interface TenGigE 0/2/0/4.1

RP/0/0/CPU0:router(config-subif)# dot1q vlan 10 20

The following example shows how to configure the VLAN IDs for a Q-in-any AC. In this case, all incoming traffic must have two VLAN tags, where the outer VLAN ID matches the configured value, while the inner VLAN ID can be any value.

RP/0/0/CPU0:router# configure

RP/0/0/CPU0:router(config)# interface TenGigE 0/2/0/4.1 l2transport

RP/0/0/CPU0:router(config-subif)# dot1q vlan 10 any

Related Commands

Command	Description
dot1q native vlan	Defines the native VLAN ID associated with a VLAN trunk.
show interfaces	Displays statistics for all interfaces configured on the router or for a specific node,
show vlan interface	Displays summarized information for the VLAN subinterfaces configured on your router.
show vlan tags	Displays VLAN tagging allocation information.

interface (VLAN)

To create a VLAN subinterface, use the interface command in global configuration mode. To delete a subinterface, use the no form of this command.

interface {GigabitEthernet | TenGigE | FastEthernet | Bundle-Ether} instance.subinterface [l2transport]

no interface {GigabitEthernet | TenGigE | FastEthernet | Bundle-Ether} instance.subinterface [l2transport]

Syntax Description

{GigabitEthernet | TenGigE | FastEthernet | Bundle-Ether}	Type of Ethernet interface on which you want to create a VLAN. Enter GigabitEthernet, TenGigE, FastEthernet, or Bundle-Ether. Note Fast Ethernet interfaces are supported on the Cisco XR 12000 Series Router only. Note Ethernet bundles are available on the Cisco CRS-1 only.
instance.subinterface	Physical interface instance, followed by the subinterface identifier. Naming notation is instance.subinterface, and a period between arguments is required as part of the notation. Replace the instance argument with one of the following Ethernet interface identifiers: •Physical interface instance. Naming notation is rack/slot/module/port and a slash between values is required as part of the notation. –rack—Chassis number of the rack. –slot—Physical slot number of the card. –module—Module number. A physical layer interface module (PLIM) is always 0. –port—Physical port number of the interface. •Ethernet Bundle instance. Range is from 1 through 65535. Replace the subinterface argument with the subinterface value. Range is from 0 through 4095. Note For more information about the syntax for the router, use the question mark (?) online help function.
l2transport	Enables Layer 2 transport port mode on the specified VLAN interface and enters Layer 2 transport configuration mode. The l2transport keyword creates the Vlan interface in L2 mode so that it can be used for L2VPNs and local switching.

Defaults

No default behavior or values

Command Modes

Global configuration

Command History

Release	Modification
Release 3.0	This command was introduced on the Cisco CRS-1.
Release 3.2	This command was first supported on the Cisco XR 12000 Series Router.
Release 3.3.0	No modification.
Release 3.4.0	No modification.
Release 3.5.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

To configure a large number of subinterfaces, we recommend entering all configuration data before you commit the interface command.

To change an interface from Layer 2 to Layer 3 mode and back, you must delete the interface first and then re-configure it in the appropriate mode.

---

Note A subinterface does not pass traffic without an assigned VLAN ID.

---

Task ID

Task ID	Operations
vlan	read, write

Examples

The following example shows how to configure a VLAN subinterface on a 10-Gigabit Ethernet interface:

RP/0/RP0/CPU0:router(config)# interface TenGigE 0/0/0/1.2

RP/0/RP0/CPU0:router(config-subif)# dot1q vlan 1

RP/0/RP0/CPU0:router(config-subif)# ipv4 address 50.0.0.1/24

The following example shows how to create a VLAN subinterface with Layer 2 transport port mode enabled, and enter Layer 2 transport configuration mode under that VLAN:

RP/0/0/CPU0:router(config)# interface GigabitEthernet 0/4/0/1.1

RP/0/RP0/CPU0:router(config-if-l2)#

Related Commands

Command	Description
dot1q native vlan	Defines the native VLAN ID associated with a VLAN trunk.
dot1q vlan	Assigns a VLAN ID to a subinterface, or changes the VLAN ID assigned to a subinterface.

l2protocol (VLAN)

To configure Layer 2 protocol tunneling and data units parameters on an VLAN interface, use the l2protocol command in subinterface configuration mode. To disable a Layer 2 protocol tunneling and Layer 2 protocol data units configuration, use the no form of this command.

l2protocol {cdp | pvst | stp | vtp} {[tunnel] experimental bits | drop}

no l2protocol

Syntax Description

cdp	Configures Cisco Discovery Protocol (CDP) tunneling and data unit parameters for the Ethernet interface.
pvst	Configures VLAN spanning tree protocol tunneling and data unit parameters.
stp	Configures spanning tree protocol tunneling and data unit parameters for the Ethernet interface.
vtp	Configures VLAN trunk protocol tunneling and data unit parameters.
tunnel	Tunnels the packets associated with the specified protocol.
experimental bits	Modifies the experimental bits for the specified protocol.
drop	Drop packets associated with the specified protocol.

Defaults

All Layer 2 protocol data units are tunneled through the network without modification.

Command Modes

Subinterface configuration

Command History

Release	Modification
Release 3.4.0	This command was first introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.5.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

The l2protocol command is accepted only when Layer 2 transport port mode is enabled on the interface.

Task ID

Task ID	Operations
l2vpn	read, write

Examples

The following example shows how configure a VLAN to drop CDP packets:

RP/0/RP0/CPU0:router# configure

RP/0/RP0/CPU0:router(config)# interface GigabitEthernet 0/1/5/0.1 l2transport

RP/0/RP0/CPU0:router(config-subif)# l2protocol cdp drop

Related Commands

Command	Description
show interfaces	Displays statistics for all interfaces configured on the router or for a specific node.
show l2vpn xconnect	Displays brief information on configured xconnects.

show vlan interface

To display summarized information about VLAN subinterfaces, use the show vlan interface command in EXEC mode.

show vlan interface [{GigabitEthernet | TenGigE | FastEthernet | Bundle-Ether} instance | location instance]

Syntax Description

{GigabitEthernet | TenGigE | FastEthernet | Bundle-Ether}	(Optional) Type of Ethernet interface whose VLAN information you want to display. Enter GigabitEthernet, TenGigE, FastEthernet, or Bundle-Ether. Note Fast Ethernet interfaces are supported on the Cisco XR 12000 Series Router only. Note Ethernet bundles are available on the Cisco CRS-1 only.
instance.subinterface	Physical interface instance, followed by the subinterface identifier. Naming notation is instance.subinterface, and a period between arguments is required as part of the notation. Replace the instance argument with one of the following Ethernet interface identifiers: •Physical interface instance. Naming notation is rack/slot/module/port and a slash between values is required as part of the notation. –rack—Chassis number of the rack. –slot—Physical slot number of the card. –module—Module number. A physical layer interface module (PLIM) is always 0. –port—Physical port number of the interface. •Ethernet Bundle instance. Range is from 1 through 65535. Replace the subinterface argument with the subinterface value. Range is from 0 through 4095. Note For more information about the syntax for the router, use the question mark (?) online help function.
location instance	(Optional) Displays VLAN subinterfaces on a particular port. The instance argument is entered in the rack/slot/module/port notation.

Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release	Modification
Release 3.0	This command was introduced Cisco CRS-1.
Release 3.2	This command was first supported on the Cisco XR 12000 Series Router.
Release 3.3.0	No modification.
Release 3.4.0	No modification.
Release 3.5.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Enter the show vlan interface command without including any of the optional parameters to display summarized information about all VLANs configured on the router.

Task ID

Task ID	Operations
vlan	read

Examples

The following is sample output from the show vlan interface command:

RP/0/RP0/CPU0:router#show vlan interface

Interface           Encapsulation  Outer  2nd   Service  MTU    LineP

                                   VLAN   VLAN                  State

Gi0/1/5/0.1         802.1Q            10        L3        1518  up

Gi0/1/5/0.2         None                        L3        1518  down

RP/0/RP0/CPU0:P2_CRS-8#

Table 37 describes the significant fields shown in the display.

Table 37 show vlan interface Field Descriptions 

Field	Description
interface	VLAN subinterface.
encapsulation	Encapsulation of the VLAN subinterface. Currently, this is always 802.1Q.
Outer VLAN	VLAN ID currently assigned to the subinterface. Range is from 1 to 4094 (or blank if no VLAN ID has been assigned).
2nd VLAN	VLAN ID currently assigned to the second subinterface in a pair. Range is from 1 to 4094 (or blank if no VLAN ID has been assigned). For Q-in-any VLANS, this field shows "Any."
Service	Service currently assigned to the VLAN. Possible services are L2 and L3.
MTU	Maximum transmission unit (MTU) value configured for the specified VLAN, in bytes.
LineP state	Displays the line protocol state of the VLAN interface. Possible states: up, down, admin-down. The line protocol state reflects whether a VLAN ID is configured or not.

Related Commands

Command	Description
show interfaces	Displays statistics for all interfaces configured on the router. These statistics include VLAN L2 interface statistics.
show vlan trunks	Displays summary information about VLAN trunk interfaces.

show vlan tags

To display VLAN tagging allocation information, use the show vlan tags command in EXEC mode.

show vlan tags [Bundle-Ether instance | GigabitEthernet instance | TenGigE instance | location node-id]

Syntax Description

Bundle-Ether instance	Displays VLAN tagging information for a specific Ethernet bundle. Note Use the show interfaces bundle-ether command to see a list of all Ethernet bundles currently configured on the router
FastEthernet instance	Displays VLAN tagging information for a specific Fast Ethernet interface. Note Use the show interfaces FastEthernet command to see a list of all Ethernet interfaces currently configured on the router. Note Fast Ethernet interfaces are supported on the Cisco XR 12000 Series Router only.
GigabitEthernet instance	Displays VLAN tagging information for a specific Gigabit Ethernet interface. Note Use the show interfaces GigabitEthernet command to see a list of all Ethernet interfaces currently configured on the router.
TenGigE instance	Displays VLAN tagging information for a specific 10-Gigabit Ethernet interface. Note Use the show interfaces TenGigE command to see a list of all10-Gigabit Ethernet interfaces currently configured on the router.
location node-id	Displays VLAN tagging information for a specific node. The node-id argument is entered in the rack/slot/module notation.

Defaults

Enter the command without any of the optional keywords or arguments to display tagging allocation information for all VLANS configured on the router.

Command Modes

EXEC

Command History

Release	Modification
Release 3.4.0	This command was first introduced on the Cisco CRS-1.
Release 3.5.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Task ID

Task ID	Operations
vlan	read

Examples

The following example shows how to display VLAN tagging allocation information for a router:

RP/0/RP0/CPU0:router# show vlan tags

Interface           Outer  2nd   Service  MTU    LineP

                    VLAN   VLAN                  State

Gi0/1/5/0.1           10         L3        1518  up

Gi0/1/5/0.2           20         L3        1518  up

Gi0/1/5/0.3           30         L3        1518  up

RP/0/RP0/CPU0:router

Table 38 describes the significant fields shown in the display

Table 38 show vlan tags Field Descriptions 

Field	Description
Outer Vlan	The first (outermost) 802.1Q VLAN ID. This field is empty if no VLAN ID is configured. An asterisk (*) indicate the native VLAN.
2nd Vlan	The second 802.1Q VLAN ID. This field reports "any" for a Q-in-Any service. If no VLAN ID is configured, then this field is empty.
Service	Service currently assigned to the subinterface. Can be Layer 2 (L2) or Layer 3 (L3).
MTU	Maximum transmission unit (MTU) value configured for the specified VLAN, in bytes.
LineP state	Displays the state of the VLAN interface. Possible states: up, down, admin-down.

Related Commands

Command	Description
dot1q vlan	Assigns a VLAN ID to a subinterface, or modifies the VLAN ID that is currently assigned to a subinterface.
show vlan interface	Displays summary information about each of the VLAN interfaces and subinterfaces.
show vlan trunks	Displays information about the VLAN trunks currently configured on your router.

show vlan trunks

To display information about VLAN trunks, use the show vlan trunks command in EXEC mode.

show vlan trunks [brief] [location node-id] [type instance] [summary]

Syntax Description

type	(Optional) Type of Ethernet interface whose VLAN trunk information you want to display. Possible Ethernet types are GigabitEthernet, TenGigE, FastEthernet, or Bundle-Ether. Note Fast Ethernet interfaces are supported on the Cisco XR 12000 Series Router only. Note Ethernet bundles are available on the Cisco CRS-1 only.
instance	Either a physical interface instance or an Ethernet Bundle instance. Replace the instance argument with one of the following Ethernet interface identifiers: •Physical interface instance. Naming notation is rack/slot/module/port and a slash between values is required as part of the notation. –rack—Chassis number of the rack. –slot—Physical slot number of the card. –module—Module number. A physical layer interface module (PLIM) is always 0. –port—Physical port number of the interface. •Ethernet Bundle instance. Range is from 1 through 65535. Note For more information about the syntax for the router, use the question mark (?) online help function.
brief	(Optional) Displays a short summary output.
summary	(Optional) Displays a summarize output. Note The summary option can be specified only if the trunk interface is not specified.
location node-id	(Optional) Displays VLAN trunk information for a specific node. The node-id is expressed in the rack/slot/module notation. Note For more information about the syntax for the router, use the question mark (?) online help function.

Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release	Modification
Release 3.0	This command was introducedCisco CRS-1.
Release 3.2	This command was first supported on the Cisco XR 12000 Series Router.
Release 3.3.0	No modification.
Release 3.4.0	No modification.
Release 3.5.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

The show vlan trunks command provides summary information about VLAN trunk interfaces. It is used to determine the number of configured subinterfaces and verify the state of the subinterfaces.

Task ID

Task ID	Operations
vlan	read

Examples

The following is sample output from the show vlan trunks command:

RP/0/RP0/CPU0:router# show vlan trunks 

GigabitEthernet0/4/0/0 is up

  Outer VLAN tag format is Dot1Q (0x8100)

  L3 Encapsulations: Ether, 802.1Q

    Sub-interfaces: 2

      2 are up

      Single tag sub-interfaces: 2

    No native VLAN Id

  L2 Encapsulations: 802.1Q

    VLAN ACs: 1

      1 are up

      Single tag ACs: 1

Table 39 describes the significant fields shown in the display.

Table 39 show vlan trunks summary Field Descriptions

Field	Description
Outer VLAN tag format	The first (outermost) 802.1Q VLAN Id. •This field is empty if no VLAN ID is configured. •An asterisk (*) indicates that a native VLAN is configured.
L3 Encapsulations	VLAN encapsulations currently used for terminated Layer 3traffic. Possible Layer 3 encapsulations are as follows: •Nat - A Native VLAN is configured. •Q - One or more sub-interfaces are configured with either 0 or 1 802.1Q VLAN tags. •2Q - One or more sub-interfaces have been configured with two 802.1Q VLAN tags.
Sub-interfaces	The number of subinterfaces configured on the main Ethernet interface, and the current state of those subinterfaces. Possible states are up, down, and admin-down. Note The number of Down and Admin-down subinterfaces is only reported only if that number is greater than 0.
Single tag sub-interfaces:	Number of sub-interfaces configured with a single 802.1Q tag. Note The number of sub-interfaces is displayed only if that number is greater than 0.
No native VLAN Id	Indicate that a native VLAN ID is not configured on this interface.
L2 Encapsulations:	VLAN encapsulations currently used for terminated L2 traffic. Possible Layer 2 encapsulations are as follows: •Q - One or more single 802.1Q tag ACs are configured. •2Q - One or more double 802.1Q tag ACs have been configured. •Qany - One or more double 802.1Q tag ACs have been configured that have a wildcard "any" innertag.
VLAN ACs	Number of ACs currently configured under the specified interface.
Single tag ACs	Note The number of sub-interfaces sub-interfaces configured with a single 802.1Q tag is displayed only if that number is greater than 0.

Related Commands

Command	Description
interface (VLAN)	Displays summary information about each of the VLAN interfaces and subinterfaces.