text: Specifies a description for a VLAN or VLAN interface. The string can include case-sensitive letters, digits, special characters (including ~ ! @ # $ % ^ & * ( ) - _ + = { } [ ] | \ : ; " ' < > , . /), spaces, and other Unicode characters and symbols.

· For a VLAN, this is a string of 1 to 32 characters.

· For a VLAN interface, this is a string of 1 to 80 characters.

NOTE:

· Each Unicode character takes the space of two regular characters.

· To use Unicode characters or symbols in an interface description, install the specific input method editor and log in to the device through remote login software that supports the character type.

· When the length of a description string reaches or exceeds the maximum line width on the terminal software, the software starts a new line, possibly breaking a Unicode character into two. As a result, garbled characters may be displayed at the end of a line.

Description

Use the description command to change the description of the VLAN or VLAN interface.

Use the undo description command to restore the default.

· For a VLAN, the default description is the VLAN ID. For example, VLAN 0001.

· For a VLAN interface, the default description is the name of the interface. For example, Vlan-interface1 Interface.

You can configure a description to describe the function or connection of a VLAN or VLAN interface, which is very helpful when a large number of VLANs are created on the device.

Examples

# Change the description of VLAN 2 to sales-private.

<Sysname> system-view

[Sysname] vlan 2

[Sysname-vlan2] description sales-private

# Change the description of VLAN-interface 2 to linktoPC56.

<Sysname> system-view

[Sysname] vlan 2

[Sysname-vlan2] quit

[Sysname] interface vlan-interface 2

[Sysname-Vlan-interface2] description linktoPC56

display interface vlan-interface

Syntax

display interface [ vlan-interface ] [ brief [ down ] ] [ | { begin | exclude | include } regular-expression ]

display interface vlan-interface vlan-interface-id [ brief ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

vlan-interface-id: Specifies a VLAN interface number.

brief: Displays brief interface information. If you do not specify this keyword, the command displays detailed interface information.

down: Displays information about interfaces in the DOWN state and the causes. If you do not specify this keyword, this command displays information about interfaces in all states.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see the Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, which is a case sensitive string of 1 to 256 characters.

Description

Use the display interface vlan-interface command to display information about a specified or all VLAN interfaces.

If you do not provide the vlan-interface keyword, this command displays information about all interfaces.

If you provide the vlan-interface keyword but do not specify the VLAN interface number, this command displays information about all VLAN interfaces.

Related commands: reset counters interface vlan-interface.

Examples

# Display information for VLAN-interface 2, which supports interface statistics collection.

<Sysname> display interface vlan-interface 2

Vlan-interface2 current state: DOWN

Line protocol current state: DOWN

Description: Vlan-interface2 Interface

The Maximum Transmit Unit is 1500

Internet protocol processing : disabled

IP Packet Frame Type: PKTFMT_ETHNT_2, Hardware Address: 000f-e249-8050

IPv6 Packet Frame Type: PKTFMT_ETHNT_2, Hardware Address: 000f-e249-8050

Last clearing of counters: Never

Last 300 seconds input: 0 bytes/sec 0 packets/sec

Last 300 seconds output: 0 bytes/sec 0 packets/sec

0 packets input, 0 bytes, 0 drops

0 packets output, 0 bytes, 0 drops

# Display brief information for VLAN-interface 2.

<Sysname> display interface vlan-interface 2 brief

The brief information of interface(s) under route mode:

Link: ADM - administratively down; Stby - standby

Protocol: (s) - spoofing

Interface Link Protocol Main IP Description

Vlan2 DOWN DOWN --

# Display brief information for VLAN interfaces in DOWN state.

<Sysname> display interface vlan-interface brief down

The brief information of interface(s) under route mode:

Link: ADM - administratively down; Stby - standby

Interface Link Cause

Vlan2 DOWN Not connected

Table 1 Output description

Field	Description
Vlan-interface2 current state	The physical state of a VLAN interface: · DOWN ( Administratively )—The administrative state of the VLAN interface is down, because it has been shut down with the shutdown command. · DOWN—The administrative sate of the VLAN interface is up, but its physical sate is down. The VLAN corresponding to this interface does not contain any physical port in the UP state (possibly because the ports are not well connected or the lines have failed). · UP—Both the administrative state and the physical state of the VLAN interface are up.
Line protocol current state	The link layer protocol state of a VLAN interface: · DOWN—The protocol state of the VLAN interface is down. · UP—The protocol state of the VLAN interface is up.
Description	The description string of a VLAN interface.
The Maximum Transmit Unit	The MTU of a VLAN interface.
Internet protocol processing : disabled	The interface is not capable of processing IP packets. This information is displayed when the interface is not configured with an IP address.
Internet Address is 192.168.1.54/24 Primary	The primary IP address of the interface is 192.168.1.54/24. This information is displayed only if the primary IP address is configured for the interface.
IP Packet Frame Type	The IPv4 outgoing frame format.
Hardware address	The MAC address corresponding to a VLAN interface.
IPv6 Packet Frame Type	The IPv6 outgoing frame format.
Last clearing of counters	The time when the reset counts interface vlan-interface command was last used to clear the interface statistics. Never indicates the reset counters interface command has never been used on the interface since the device’s startup.
Last 300 seconds input: 0 bytes/sec 0 packets/sec	Average rate of input packets in the last 300 seconds (in bps and pps).
Last 300 seconds output: 0 bytes/sec 0 packets/sec	Average rate of output packets in the last 300 seconds (in bps and pps).
0 packets input, 0 bytes, 0 drops	Total number and size (in bytes) of the received packets of the interface and the number of the dropped packets.
0 packets output, 0 bytes, 0 drops	Total number and size (in bytes) of the sent packets of the interface and the number of the dropped packets.
The brief information of interface(s) under route mode	Brief information about Layer 3 interfaces.
Link: ADM - administratively down; Stby - standby	ADM—The interface has been administratively shut down. To recover its physical state, perform the undo shutdown command. Stby—The interface is operating as a standby interface. To see the main interface, use the display standby state command.
Protocol: (s) - spoofing	If the network layer protocol state of an interface is shown as UP, but its link is an on-demand link or not present at all, its protocol attribute includes the spoofing flag (an s in parentheses).
Interface	The abbreviated interface name.
Link	The physical link state of the interface: · UP—The link is up. · ADM—The link has been administratively shut down. To recover its physical state, perform the undo shutdown command.
Protocol	Protocol connection state of the interface, which can be UP, DOWN, or UP(s).
Main IP	The main IP address of the interface.
Description	The description of the interface.
Cause	The cause of a DOWN physical link. If the port has been shut down with the shutdown command, this field displays Administratively. To restore the physical state of the interface, use the undo shutdown command.

display vlan

Syntax

display vlan [ vlan-id1 [ to vlan-id2 ] | all | dynamic | reserved | static ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

vlan-id1: Displays information about a VLAN specified by VLAN ID, ranging from 1 to 4094.

vlan-id1 to vlan-id2: Displays information about VLANs specified by a VLAN ID range.

all: Displays all VLAN information except for the reserved VLANs.

dynamic: Displays the number of dynamic VLANs and the ID for each dynamic VLAN. The dynamic VLANs are generated through GVRP or those distributed by a RADIUS server.

reserved: Displays information about the reserved VLANs. Protocol modules determine which VLANs are reserved VLANs according to function implementation, and reserved VLANs serve protocol modules. You cannot do any configuration on reserved VLANs.

static: Displays the number of static VLANs and the ID for each static VLAN. The static VLANs are manually created.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see the Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, which is a case sensitive string of 1 to 256 characters.

Description

Use the display vlan command to display VLAN information.

Related commands: vlan.

Examples

# Display VLAN 2 information.

<Sysname> display vlan 2

VLAN ID: 2

VLAN Type: static

Route interface: not configured

Description: VLAN 0002

Name: VLAN 0002

Tagged Ports: none

Untagged Ports:

GigabitEthernet1/0/1 GigabitEthernet1/0/2 GigabitEthernet1/0/3

# Display VLAN 3 information.

<Sysname> display vlan 3

VLAN ID: 3

VLAN Type: static

Route Interface: configured

IP Address: 1.1.1.1

Subnet Mask: 255.255.255.0

Description: VLAN 0003

Name: VLAN 0003

Tagged Ports: none

Untagged Ports: none

Table 2 Output description

Field	Description
VLAN Type	VLAN type, static or dynamic.
Route interface	Indicates whether the VLAN interface is configured or not.
Description	Description of the VLAN.
Name	Name configured for the VLAN.
IP Address	Primary IP address of the VLAN interface (available only when an IP address is configured for the VLAN interface). To display secondary IP addresses, use the display interface vlan-interface command in any view or the display this command in VLAN interface view.
Subnet Mask	Subnet mask of the primary IP address (available only when an IP address is configured for the VLAN interface).
Tagged Ports	Ports through which VLAN packets are sent tagged.
Untagged Ports	Ports through which VLAN packets are sent untagged.

interface vlan-interface

Syntax

interface vlan-interface vlan-interface-id

undo interface vlan-interface vlan-interface-id

View

System view

Default level

2: System level

Parameters

vlan-interface-id: Specifies a VLAN interface number, ranging from 1 to 4094.

Description

Use the interface vlan-interface command to create a VLAN interface and enter its view or enter the view of an existing VLAN interface.

Use the undo interface vlan-interface command to remove the specified VLAN interface.

Create the VLAN before you create the VLAN interface.

To configure an IP address for a VLAN interface that will perform IP routing, use the ip address command in VLAN interface view.

Related commands: display interface vlan-interface.

Examples

# Create VLAN-interface 2.

<Sysname> system-view

[Sysname] vlan 2

[Sysname-vlan2] quit

[Sysname] interface vlan-interface 2

[Sysname-Vlan-interface2]

ip address

Syntax

ip address ip-address { mask | mask-length }

undo ip address [ ip-address { mask | mask-length }

View

VLAN interface view

Default level

2: System level

Parameters

ip-address: Specifies an IP address in dotted decimal notation.

mask: Specifies a subnet mask in dotted decimal notation.

mask-length: Sets the number of consecutive 1s in the subnet mask, ranging from 0 to 32.

Description

Use the ip address command to assign an IP address and subnet mask to a VLAN interface.

Use the undo ip address command to remove the IP address and subnet mask for a VLAN interface.

By default, no IP address is assigned to any VLAN interface.

Related commands: display ip interface (Layer 3—IP Services Command Reference).

Examples

# Specify the IP address as 1.1.0.1, the subnet mask as 255.255.255.0 for VLAN interface 1.

<Sysname> system-view

[Sysname] interface vlan-interface 1

[Sysname-Vlan-interface1] ip address 1.1.0.1 255.255.255.0

name

Syntax

name text

undo name

View

VLAN view

Default level

2: System level

Parameters

text: Specifies a VLAN name, a string of 1 to 32 characters. The string can include case-sensitive letters, digits, special characters (including ~ ! @ # $ % ^ & * ( ) - _ + = { } [ ] | \ : ; " ' < > , . /), and spaces.

Description

Use the name command to configure a name for the VLAN.

Use the undo name command to restore the default name of the VLAN.

By default, the name of a VLAN is its VLAN ID. For example, VLAN 0001.

When 802.1X or MAC address authentication is configured on a switch, you can use a RADIUS server to issue VLAN configuration to ports that have passed the authentication. Some servers can send IDs or names of the issued VLANs to the switch. You can use VLAN names, rather than VLAN IDs, to distinguish a large number of VLANs.

Examples

# Configure the name of VLAN 2 as Test VLAN.

<Sysname> system-view

[Sysname] vlan 2

[Sysname-vlan2] name Test VLAN

reset counters interface vlan-interface

Syntax

reset counters interface vlan-interface [ vlan-interface-id ]

View

User view

Default level

2: System level

Parameters

vlan-interface-id: Specifies a VLAN interface number.

Description

Use the reset counters interface vlan-interface command to clear the statistics on a VLAN interface.

Before collecting the traffic statistics within a specific period of time on an interface, you need to clear the existing statistics first.

If the vlan-interface-id argument is not specified, this command clears the statistics of all VLAN interfaces.

If the vlan-interface-id argument is specified, this command clears the statistics of the specified VLAN interface.

Related commands: display interface vlan-interface.

Examples

# Clear the statistics on VLAN-interface 2.

<Sysname> reset counters interface vlan-interface 2

shutdown

Syntax

shutdown

undo shutdown

View

VLAN interface view

Default level

2: System level

Parameters

None

Description

Use the shutdown command to shut down a VLAN interface.

Use the undo shutdown command to bring up a VLAN interface.

By default, a VLAN interface is up unless all ports in the VLAN are down.

You can use the undo shutdown command to bring up a VLAN interface after you have configured related parameters and protocols for the VLAN interface. You can shut down a failed interface with the shutdown command and then bring it up with the undo shutdown command to see if it recovers.

In a VLAN, the state of any Ethernet port is independent of the state of the VLAN interface.

Examples

# Shut down VLAN-interface 2 and then bring it up.

<Sysname> system-view

[Sysname] interface vlan-interface 2

[Sysname-Vlan-interface2] shutdown

[Sysname-Vlan-interface2] undo shutdown

vlan

Syntax

vlan { vlan-id1 [ to vlan-id2 ] | all }

undo vlan { vlan-id1 [ to vlan-id2 ] | all }

View

System view

Default level

2: System level

Parameters

vlan-id1, vlan-id2: Specifies a VLAN ID, ranging from 1 to 4094.

vlan-id1 to vlan-id2: Specifies a VLAN range.

all: Creates or removes all VLANs except reserved VLANs. The keyword is not supported when the maximum number of VLANs that can be created on a device is less than 4094.

Description

Use the vlan vlan-id command to create a VLAN and enter its view or enter the view of an existing VLAN.

Use the vlan vlan-id1 to vlan-id2 command to create VLANs ranging from vlan-id1 to vlan-id2, except reserved VLANs.

Use the undo vlan command to remove the specified VLANs.

You cannot create or remove the default VLAN (VLAN 1).

You cannot create or remove reserved VLANs reserved for specific functions.

For the following VLANs, you must remove the related configurations first, because you cannot use the undo vlan command to directly remove them:

· Protocol reserved VLANs

· Voice VLANs

· Management VLANs

· Dynamic VLANs

· VLANs configured with QoS policies

· Control VLANs configured for smart link groups

· Source VLANs for port mirroring

· Remote probe VLANs for remote port mirroring

Related commands: display vlan.

Examples

# Enter VLAN 2 view.

<Sysname> system-view

[Sysname] vlan 2

[Sysname-vlan2]

# Create VLAN 4 through VLAN 100.

<Sysname> system-view

[Sysname] vlan 4 to 100

Please wait............. Done.

Port-based VLAN configuration commands

display port

Syntax

display port { hybrid | trunk } [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

hybrid: Displays hybrid ports.

trunk: Displays trunk ports.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see the Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, which is a case sensitive string of 1 to 256 characters.

Description

Use the display port command to display information about the hybrid or trunk ports on the device, including the port names, PVIDs, and allowed VLAN IDs.

Examples

# Display information about the hybrid ports in the system.

<Sysname> display port hybrid

Interface PVID VLAN passing

GE1/0/4 100 Tagged: 1000, 1002, 1500, 1600-1611, 2000,

2555-2558, 3000, 4000

Untagged:1, 10, 15, 18, 20-30, 44, 55, 67, 100,

150-160, 200, 255, 286, 300-302

# Display information about the trunk ports in the system.

<Sysname> display port trunk

Interface PVID VLAN passing

GE1/0/8 2 1-4, 6-100, 145, 177, 189-200, 244, 289, 400,

555, 600-611, 1000, 2006-2008

Table 3 Output description

Field	Description
Interface	Port name.
PVID	Port VLAN ID.
VLAN passing	VLANs for which the port allows packets to pass through.
Tagged	VLANs for which the port sends packets without removing VLAN tags.
Untagged	VLANs for which the port sends packets after removing VLAN tags.

port

Syntax

port interface-list

undo port interface-list

View

VLAN view

Default level

2: System level

Parameters

interface-list: Specifies an interface list, in the format of interface-list = { interface-type interface-number [ to interface-type interface-number ] }&<1-10>, where interface-type interface-number represents the interface type and interface number and &<1-10> indicates that you can specify up to 10 ports or port ranges.

Description

Use the port command to assign the specified access ports to the VLAN.

Use the undo port command to remove the specified access ports from the VLAN.

By default, all ports are in VLAN 1.

This command is only applicable on access ports.

By default, all ports are access ports. However, you can manually configure the port type. For more information, see “port link-type.”

You cannot assign Layer 2 aggregate interfaces to a VLAN.

Related commands: display vlan.

Examples

# Assign GigabitEthernet 1/0/1 through GigabitEthernet 1/0/3 to VLAN 2.

<Sysname> system-view

[Sysname] vlan 2

[Sysname-vlan2] port gigabitethernet 1/0/1 to gigabitethernet 1/0/3

port access vlan

Syntax

port access vlan vlan-id

undo port access vlan

View

Ethernet interface view, port group view, aggregate interface view

Default level

2: System level

Parameters

vlan-id: Specifies a VLAN ID, ranging from 1 to 4094. Make sure that the VLAN specified by the VLAN ID already exists.

Description

Use the port access vlan command to assign the access ports to the specified VLAN.

Use the undo port access vlan command to restore the default.

By default, all access ports belong to VLAN 1.

The configuration made in Ethernet interface view applies only to the port.

The configuration made in port group view applies to all ports in the port group.

The configuration made in aggregate interface view applies to the aggregate interface and its aggregation member ports.

· If the system fails to apply the configuration to the aggregate interface, it stops applying the configuration to aggregation member ports.

· If the system fails to apply the configuration to an aggregation member port, it skips the port and moves to the next member port.

Examples

# Assign GigabitEthernet 1/0/1 to VLAN 3.

<Sysname> system-view

[Sysname] vlan 3

[Sysname-vlan3] quit

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] port access vlan 3

# Assign aggregate interface Bridge-Aggregation 1 and its member ports to VLAN 3.

<Sysname> system-view

[Sysname] vlan 3

[Sysname-vlan3] quit

[Sysname] interface bridge-aggregation 1

[Sysname-Bridge-Aggregation1] port access vlan 3

port hybrid pvid

Syntax

port hybrid pvid vlan vlan-id

undo port hybrid pvid

View

Ethernet interface view, port group view, aggregate interface view

Default level

2: System level

Parameters

vlan-id: Specifies a VLAN ID, ranging from 1 to 4094.

Description

Use the port hybrid pvid command to configure the PVID of the hybrid port.

Use the undo port hybrid pvid command to restore the default.

By default, the PVID of a hybrid port is VLAN 1.

You can use a nonexistent VLAN as the PVID for a hybrid port. If you remove the PVID of a hybrid port with the undo vlan command, it does not affect the setting of the PVID on the port.

The configuration made in Ethernet view applies only to the port.

The configuration made in port group view applies to all ports in the port group.

The configuration made in aggregate interface view applies to the aggregate interface and its aggregation member ports.

· If the system fails to apply the configuration to the aggregate interface, it stops applying the configuration to aggregation member ports.

· If the system fails to apply the configuration to an aggregation member port, it skips the port and moves to the next member port.

H3C recommends that you set the same PVID for the local and remote hybrid ports.

You must use the port hybrid vlan command to configure the hybrid port to allow and forward packets from the PVID.

Related commands: port link-type and port hybrid vlan.

Examples

# Configure VLAN 100 as the PVID of the hybrid port GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] vlan 100

[Sysname-vlan100] quit

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] port link-type hybrid

[Sysname-GigabitEthernet1/0/1] port hybrid pvid vlan 100

# Configure VLAN 100 as the PVID of the hybrid Layer 2 aggregate interface Bridge-Aggregation 1.

<Sysname> system-view

[Sysname] interface bridge-aggregation 1

[Sysname-Bridge-Aggregation1] port link-type hybrid

[Sysname-Bridge-Aggregation1] port hybrid pvid vlan 100

port hybrid vlan

Syntax

port hybrid vlan vlan-id-list { tagged | untagged }

undo port hybrid vlan vlan-id-list

View

Ethernet interface view, port group view, aggregate interface view

Default level

2: System level

Parameters

vlan-id-list: Specifies a list of VLANs that the hybrid ports will be assigned to, in the format of [ vlan-id1 [ to vlan-id2 ] ]&<1-10>, where vlan-id ranges from 1 to 4094 and &<1-10> indicates that you can specify up to 10 VLAN IDs or VLAN ID ranges. Make sure that the specified VLANs already exist.

tagged: Configures the ports to send the packets of the specified VLANs without removing VLAN tags.

untagged: Configures the ports to send the packets of the specified VLANs after removing VLAN tags.

Description

Use the port hybrid vlan command to assign the hybrid ports to the specified VLANs.

Use the undo port hybrid vlan command to remove the hybrid ports from the specified VLANs.

By default, a hybrid port only allows packets from VLAN 1 to pass through untagged.

A hybrid port can carry multiple VLANs. If you execute the port hybrid vlan command multiple times, the VLANs the hybrid port carries are the set of VLANs specified by vlan-id-list in each execution.

The configuration made in Ethernet view applies only to the port.

The configuration made in port group view applies to all ports in the port group.

The configuration made in aggregate interface view applies to the aggregate interface and its aggregation member ports.

· If the system fails to apply the configuration to the aggregate interface, it stops applying the configuration to aggregation member ports.

· If the system fails to apply the configuration to an aggregation member port, it skips the port and moves to the next member port.

Related commands: port link-type.

Examples

# Assign the hybrid port GigabitEthernet 1/0/1 to VLAN 2, VLAN 4, and VLAN 50 through VLAN 100, and configure GigabitEthernet 1/0/1 to send packets of these VLANs with tags kept.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] port link-type hybrid

[Sysname-GigabitEthernet1/0/1] port hybrid vlan 2 4 50 to 100 tagged

# Assign hybrid ports in port group 2 to VLAN 2, and configure these hybrid ports to send packets of VLAN 2 with VLAN tags removed.

<Sysname> system-view

[Sysname] vlan 2

[Sysname-vlan2] quit

[Sysname] port-group manual 2

[Sysname-port-group-manual-2] group-member gigabitethernet 1/0/1 to gigabitethernet 1/0/6

[Sysname-port-group-manual-2] port link-type hybrid

[Sysname-port-group-manual-2] port hybrid vlan 2 untagged

Configuring GigabitEthernet1/0/1... Done.

Configuring GigabitEthernet1/0/2... Done.

Configuring GigabitEthernet1/0/3... Done.

Configuring GigabitEthernet1/0/4... Done.

Configuring GigabitEthernet1/0/5... Done.

Configuring GigabitEthernet1/0/6... Done.

# Assign the hybrid Layer 2 aggregate interface Bridge-Aggregation 1 and its member ports to VLAN 2, and configure them to send packets of VLAN 2 with tags removed.

<Sysname> system-view

[Sysname] interface bridge-aggregation 1

[Sysname-Bridge-Aggregation1] port link-type hybrid

[Sysname-Bridge-Aggregation1] port hybrid vlan 2 untagged

Please wait... Done.

Configuring GigabitEthernet1/0/1... Done.

Configuring GigabitEthernet1/0/2... Done.

Configuring GigabitEthernet1/0/3... Done.

The output shows that GigabitEthernet 1/0/1, GigabitEthernet 1/0/2, and GigabitEthernet 1/0/3 are the member ports of the aggregation group corresponding to Bridge-Aggregation 1.

port link-type

Syntax

port link-type { access | hybrid | trunk }

undo port link-type

View

Ethernet interface view, port group view, aggregate interface view

Default level

2: System level

Parameters

access: Configures the link type of a port as access.

hybrid: Configures the link type of a port as hybrid.

trunk: Configures the link type of a port as trunk.

Description

Use the port link-type command to configure the link type of a port.

Use the undo port link-type command to restore the default link type of a port.

By default, any port is an access port.

The configuration made in Ethernet view applies only to the port.

The configuration made in port group view applies to all ports in the port group.

The configuration made in aggregate interface view applies to the aggregate interface and its aggregation member ports.

· If the system fails to apply the configuration to the aggregate interface, it stops applying the configuration to aggregation member ports.

· If the system fails to apply the configuration to an aggregation member port, it skips the port and moves to the next member port.

To change the link type of a port from trunk to hybrid or vice versa, you must set the link type to access.

After you change the link type of an interface with the port link-type command, the loopback detection action configured on the interface with the loopback-detection action command automatically restores the default. For more information about the loopback-detection action command, see the Interface Command Reference.

Examples

# Configure GigabitEthernet 1/0/1 as a trunk port.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] port link-type trunk

# Configure all the ports in the manual port group group1 as hybrid ports.

<Sysname> system-view

[Sysname] port-group manual group1

[Sysname-port-group manual group1] group-member gigabitethernet 1/0/1

[Sysname-port-group manual group1] group-member gigabitethernet 1/0/2

[Sysname-port-group manual group1] port link-type hybrid

# Configure Layer 2 aggregate interface Bridge-Aggregation 1 and its member ports as hybrid ports.

<Sysname> system-view

[Sysname] interface bridge-aggregation 1

[Sysname-Bridge-Aggregation1] port link-type hybrid

port trunk permit vlan

Syntax

port trunk permit vlan { vlan-id-list | all }

undo port trunk permit vlan { vlan-id-list | all }

View

Ethernet interface view, port group view, aggregate interface view

Default level

2: System level

Parameters

vlan-id-list: Specifies a list of VLANs that the trunk ports will be assigned to, in the format of [vlan-id1 [ to vlan-id2 ] ]&<1-10>, where vlan-id ranges from 1 to 4094 and &<1-10> indicates that you can specify up to 10 VLAN IDs or VLAN ID ranges.

all: Permits all VLANs to pass through the trunk ports. On GVRP-enabled trunk ports, you must configure the port trunk permit vlan all command to ensure that the traffic of all dynamically registered VLANs can pass through. To prevent unauthorized VLAN users from accessing restricted resources through a GVRP-disabled port, do not use the port trunk permit vlan all command on the port.

Description

Use the port trunk permit vlan command to assign the trunk ports to the specified VLANs.

Use the undo port trunk permit vlan command to remove the trunk ports from the specified VLANs.

By default, a trunk port allows only packets from VLAN 1 to pass through.

A trunk port can carry multiple VLANs. If you execute the port trunk permit vlan command multiple times, the trunk port carries the set of VLANs specified by vlan-id-list in each execution.

On a trunk port, only traffic of the PVID can pass through untagged.

The configuration made in Ethernet view applies only to the port.

The configuration made in port group view applies to all ports in the port group.

The configuration made in aggregate interface view applies to the aggregate interface and its aggregation member ports.

· If the system fails to apply the configuration to the aggregate interface, it stops applying the configuration to aggregation member ports.

· If the system fails to apply the configuration to an aggregation member port, it skips the port and moves to the next member port.

Related commands: port link-type.

Examples

# Assign the trunk port GigabitEthernet 1/0/1 to VLAN 2, VLAN 4, and VLAN 50 through VLAN 100.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] port link-type trunk

[Sysname-GigabitEthernet1/0/1] port trunk permit vlan 2 4 50 to 100

Please wait........... Done.

# Assign the trunk Layer 2 aggregate interface Bridge-Aggregation 1 to VLAN 2.

<Sysname> system-view

[Sysname] interface bridge-aggregation 1

[Sysname-Bridge-Aggregation1] port link-type trunk

[Sysname-Bridge-Aggregation1] port trunk permit vlan 2

Please wait... Done.

Configuring GigabitEthernet1/0/1... Done.

Configuring GigabitEthernet1/0/2... Done.

Configuring GigabitEthernet1/0/3... Done.

The output shows that GigabitEthernet 1/0/1, GigabitEthernet 1/0/2, and GigabitEthernet 1/0/3 are the member ports of the aggregation group corresponding to Bridge-Aggregation 1.

port trunk pvid

Syntax

port trunk pvid vlan vlan-id

undo port trunk pvid

View

Ethernet interface view, port group view, aggregate interface view

Default level

2: System level

Parameters

vlan-id: Specifies a VLAN ID, ranging from 1 to 4094

Description

Use the port trunk pvid command to configure the PVID for the trunk port.

Use the undo port trunk pvid command to restore the default.

By default, the PVID of a trunk port is VLAN 1.

You can use a nonexistent VLAN as the PVID for a trunk port. If you remove the PVID of a trunk port with the undo vlan command, it does not affect the setting of the PVID on the port.

The configuration made in Ethernet view applies only to the port.

The configuration made in port group view applies to all ports in the port group.

The configuration made in aggregate interface view applies to the aggregate interface and its aggregation member ports.

· If the system fails to apply the configuration to the aggregate interface, it stops applying the configuration to aggregation member ports.

· If the system fails to apply the configuration to an aggregation member port, it skips the port and moves to the next member port.

The local and remote trunk ports must use the same PVID for the traffic of the PVID to be transmitted properly.

You must use the port trunk permit vlan command to configure the trunk port to allow and forward packets from the PVID.

Related commands: port link-type and port trunk permit vlan.

Examples

# Configure VLAN 100 as the PVID of the trunk port GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] port link-type trunk

[Sysname-GigabitEthernet1/0/1] port trunk pvid vlan 100

# Configure VLAN 100 as the PVID of the trunk Layer 2 aggregate interface Bridge-Aggregation 1.

<Sysname> system-view

[Sysname] interface bridge-aggregation 1

[Sysname-Bridge-Aggregation1] port link-type trunk

[Sysname-Bridge-Aggregation1] port trunk pvid vlan 100

MAC-based VLAN configuration commands

display mac-vlan

Syntax

display mac-vlan { all | dynamic | mac-address mac-address [ mask mac-mask ] | static | vlan vlan-id } [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

all: Displays all the MAC address-to-VLAN entries.

dynamic: Displays dynamically configured MAC address-to-VLAN entries.

mac-address mac-address: Displays the MAC address-to-VLAN entry containing the specified MAC address.

mask mac-mask: Displays the MAC address-to-VLAN entries with their MAC addresses in the specified range.

static: Displays the statically configured MAC address-to-VLAN entries.

vlan vlan-id: Displays the MAC address-to-VLAN entries associated with the specified VLAN.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see the Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, which is a case sensitive string of 1 to 256 characters.

Description

Use the display mac-vlan command to display the specified MAC address-to-VLAN entries.

If mac-address mac-address is specified but mask is not specified, only the MAC address-to-VLAN entry containing the specified MAC address is displayed.

Examples

# Display all the MAC address-to-VLAN entries.

<Sysname> display mac-vlan all

The following MAC-VLAN address exist:

S: Static D: Dynamic

MAC ADDR MASK VLAN ID PRIO STATE

-------------------------------------------------------------------

0008-0001-0000 FFFF-FF00-0000 5 3 S

0002-0001-0000 FFFF-FFFF-FFFF 5 3 S&D

Total MAC VLAN address count:2

Table 4 Output description

Field	Description
S: Static	The character S stands for the MAC address-to-VLAN entries that are configured statically.
D: Dynamic	The character D stands for the MAC address-to-VLAN entries that are configured dynamically.
MAC ADDR	MAC address of a MAC address-to-VLAN entry.
MASK	Mask of the MAC address of a MAC address-to-VLAN entry.
VLAN ID	VLAN ID of a MAC address-to-VLAN entry.
PRIO	802.1p priority corresponding to the MAC address of a MAC address-to-VLAN entry
STATE	The state of a MAC address-to-VLAN entry: · S—The MAC address-to-VLAN entry is configured statically. · D—The MAC address-to-VLAN entry is configured automatically through the authentication server. · S&D—The MAC address-to-VLAN entry is configured both statically and dynamically.

display mac-vlan interface

Syntax

display mac-vlan interface [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

|: Filters command output by specifying a regular expression. For more information about regular expressions, see the Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, which is a case sensitive string of 1 to 256 characters.

Description

Use the display mac-vlan interface command to display all the ports with MAC-based VLAN enabled.

Related commands: mac-vlan enable.

Examples

# Display all the interfaces with MAC-based VLAN enabled.

<Sysname> display mac-vlan interface

MAC VLAN is enabled on following ports:

---------------------------------------

GigabitEthernet1/0/1 GigabitEthernet1/0/2 GigabitEthernet1/0/3

mac-vlan enable

Syntax

mac-vlan enable

undo mac-vlan enable

View

Layer 2 Ethernet port view

Default level

2: System level

Parameters

None

Description

Use the mac-vlan enable command to enable the MAC-based VLAN feature on a port.

Use the undo mac-vlan enable command to disable the MAC-based VLAN feature on a port.

By default, the MAC-based VLAN feature is disabled on a port.

Examples

# Enable the MAC-based VLAN feature on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname–GigabitEthernet1/0/1] mac-vlan enable

mac-vlan mac-address

Syntax

mac-vlan mac-address mac-address [ mask mac-mask ] vlan vlan-id [ priority pri ]

undo mac-vlan { all | mac-address mac-address [ mask mac-mask ] | vlan vlan-id }

View

System view

Default level

2: System level

Parameters

mac-address mac-address: Specifies a MAC address.

mask mac-mask: Specifies a mask for the MAC address in the format of H-H-H. The mac-mask argument is comprised of the high-order part (all the binary bits of which are 1s) and the low-order part (all the binary bits of which are 0s). By default, the hexadecimal digits of this argument are all Fs.

vlan vlan-id: Specifies a VLAN ID, ranging from of 1 to 4094.

priority pri: Specifies the 802.1p priority value corresponding to the specified MAC address. The pri argument ranges from 0 to 7.

all: Removes all the static MAC address-to-VLAN entries.

Description

Use the mac-vlan mac-address command to associate the specified VLAN and priority value with the specified MAC addresses.

Use the undo mac-vlan command to remove the association.

Two MAC address-to-VLAN entry tables exist in a device. One table contains the MAC address-to-VLAN entries configured with the mask keyword specified. A MAC address-to-VLAN entry of this type describes the relationship between a group of MAC addresses and a VLAN, and a priority value. Another table contains the MAC address-to-VLAN entries configured without the mask keyword specified. A MAC address-to-VLAN entry of this type describes the relationship between a single MAC address and a VLAN, and a priority value. The system adds/removes MAC address-to-VLAN entries to/from the two tables according to the configuration.

Examples

# Associate a single MAC address 0-1-1 with VLAN 100 and 802.1p priority 7.

<Sysname> system-view

[Sysname] mac-vlan mac-address 0-1-1 vlan 100 priority 7

# Associate the MAC addresses with the high-order six hexadecimal digits being 111122 with VLAN 100 and 802.1p priority 4.

<Sysname> system-view

[Sysname] mac-vlan mac-address 1111-2222-3333 mask ffff-ff00-0000 vlan 100 priority 4

mac-vlan trigger enable

Syntax

mac-vlan trigger enable

undo mac-vlan trigger enable

View

Layer 2 Ethernet port view

Default level

2: System level

Parameters

None

Description

Use the mac-vlan trigger enable command to enable dynamic MAC-based VLAN assignment. The port configured with this command will be dynamically assigned to VLANs based on the source MAC addresses of the received packets.

Use the undo mac-vlan trigger enable command to restore the default.

By default, dynamic MAC-based VLAN assignment is not enabled.

After receiving a packet with an unknown source MAC address, a port submits the packet to the CPU. If the source MAC address matches a MAC address-to-VLAN entry (whose mask is all Fs) maintained by the device, the device dynamically learns the source MAC address and assigns the receiving port to the corresponding VLAN. Then, subsequent packets with this source MAC address can be directly forwarded through the port. If the MAC address does not match any MAC address-to-VLAN entry or matches only a MAC address-to-VLAN entry whose mask is not all Fs, the device will not dynamically learn the MAC address and assign the receiving port to the corresponding VLAN.

Examples

# Enable dynamic MAC-based VLAN assignment on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] mac-vlan trigger enable

port pvid disable

Syntax

port pvid disable

undo port pvid disable

View

Layer 2 Ethernet port view

Default level

2: System level

Parameters

None

Description

Use the port pvid disable command to disable the PVID of the port from forwarding packets whose source MAC addresses do not match any MAC address-to-VLAN entry.

Use the undo port pvid disable command to restore the default.

By default, when a port receives a packet with an unknown source MAC address that does not match any MAC address-to-VLAN entry, it forwards the packet in its PVID.

Examples

# Disable the PVID of GigabitEthernet 1/0/1 from forwarding packets whose source MAC addresses do not match any MAC address-to-VLAN entry.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] port pvid disable

Protocol-based VLAN configuration commands

display protocol-vlan interface

Syntax

display protocol-vlan interface { interface-type interface-number1 [ to interface-type interface-number2 ] | all } [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

2: System level

Parameters

interface-type interface-number1: Specifies an interface by its type and number.

interface-type interface-number1 to interface-type interface-number2: Specifies an interface range.

all: Displays information about protocol-based VLANs on all ports.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see the Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, which is a case sensitive string of 1 to 256 characters.

Description

Use the display protocol-vlan interface command to display information about protocol-based VLANs for the specified ports.

Examples

# Display protocol-based VLAN information on GigabitEthernet 1/0/1.

[Sysname] display protocol-vlan interface gigabitethernet 1/0/1

Interface: GigabitEthernet1/0/1

VLAN ID Protocol Index Protocol Type

======================================================

2 0 ipv6

3 0 ipv4

Table 5 Output description

Field	Description
VLAN ID	ID of the protocol-based VLAN bound to the port
Protocol Index	Protocol template index
Protocol Type	Protocol type specified by the protocol template

display protocol-vlan vlan

Syntax

display protocol-vlan vlan { vlan-id1 [ to vlan-id2 ] | all } [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

2: System level

Parameters

vlan-id1: Specifies a protocol-based VLAN ID, ranging from 1 to 4094.

vlan-id1 to vlan-id2: Displays protocol-based VLAN information of a VLAN range from vlan-id1 to vlan-id2. The vlan-id2 argument specifies a protocol-based VLAN ID, ranging from 1 to 4094, but you must ensure that its value is greater than or equal to that of vlan-id1.

all: Displays information about all protocol-based VLANs.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see the Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, which is a case sensitive string of 1 to 256 characters.

Description

Use the display protocol-vlan vlan command to display the protocols and protocol indexes configured on the specified VLANs.

Related commands: display vlan.

Examples

# Display the protocols and protocol indexes configured on all protocol-based-VLANs.

<Sysname> display protocol-vlan vlan all

VLAN ID:2

Protocol Index Protocol Type

======================================================

0 ipv4

3 ipv6

VLAN ID:3

Protocol Index Protocol Type

======================================================

0 ipv4

1 ipv6

For the output description, see Table 5.

port hybrid protocol-vlan

Syntax

port hybrid protocol-vlan vlan vlan-id { protocol-index [ to protocol-end ] | all }

undo port hybrid protocol-vlan { vlan vlan-id { protocol-index [ to protocol-end ] | all } | all }

View

Ethernet interface view, port group view, aggregate interface view

Default level

2: System level

Parameters

vlan vlan-id: Specifies a VLAN ID, ranging from 1 to 4094.

protocol-index: Specifies a protocol index. The value can be specified by the users or assigned by the system automatically when the protocol-based VLAN is created. You can use the display protocol-vlan vlan all command to display the protocol indexes.

to protocol-end: Specifies the end protocol index. The protocol-end argument must be greater than or equal to the beginning protocol index.

all: Specifies all protocols bound to vlan-id.

Description

Use the port hybrid protocol-vlan command to associate the hybrid ports with a protocol-based VLAN.

Use the undo port hybrid protocol-vlan command to remove the association.

The configuration made in Ethernet interface view applies only to the port.

The configuration made in port group view applies to all ports in the port group.

The configuration made in aggregate interface view applies to the aggregate interface and its aggregation member ports.

Before you use this command, make the following configurations:

· Create a VLAN and associate it with specified protocols.

· Configure the link type as hybrid.

· Configure the port to allow the protocol-based VLAN to pass through.

Related commands: display protocol-vlan interface.

Examples

# Associate the hybrid port GigabitEthernet 1/0/1 with protocol 0 (IPv4) in VLAN 2.

<Sysname> system-view

[Sysname] vlan 2

[Sysname-vlan2] protocol-vlan ipv4

[Sysname-vlan2] quit

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] port link-type hybrid

[Sysname-GigabitEthernet1/0/1] port hybrid vlan 2 untagged

Please wait... Done

[Sysname-GigabitEthernet1/0/1] port hybrid protocol-vlan vlan 2 0

# Associate the hybrid Layer 2 aggregate interface Bridge-Aggregation 1 with protocol 0 in VLAN 2.

<Sysname> system-view

[Sysname] vlan 2

[Sysname-vlan2] protocol-vlan ipv4

[Sysname-vlan2] quit

[Sysname] interface bridge-aggregation 1

[Sysname-Bridge-Aggregation1] port link-type hybrid

[Sysname-Bridge-Aggregation1] port hybrid vlan 2 untagged

Please wait... Done

Configuring GigabitEthernet1/0/1... Done.

Configuring GigabitEthernet1/0/2... Done.

Configuring GigabitEthernet1/0/3... Done.

[Sysname-Bridge-Aggregation1] port hybrid protocol-vlan vlan 2 0

The output shows that GigabitEthernet 1/0/1, GigabitEthernet 1/0/2, and GigabitEthernet 1/0/3 are the member ports of the aggregation group corresponding to Bridge-Aggregation 1.

protocol-vlan

Syntax

protocol-vlan [ protocol-index ] { at | ipv4 | ipv6 | ipx { ethernetii | llc | raw | snap } | mode { ethernetii etype etype-id | llc { dsap dsap-id [ ssap ssap-id ] | ssap ssap-id } | snap etype etype-id } }

undo protocol-vlan { protocol-index [ to protocol-end ] | all }

View

VLAN view

Default level

2: System level

Parameters

at: Specifies the AppleTalk based VLAN.

ipv4: Specifies the IPv4 based VLAN.

ipv6: Specifies the IPv6 based VLAN.

ipx: Specifies the IPX based VLAN. The keywords ethernetii, llc, raw, and snap are encapsulation formats for IPX.

mode: Configures a user-defined protocol template for the VLAN, which could also have the following encapsulation formats: ethernetii, llc, and snap.

ethernetii etype etype-id: Matches Ethernet II encapsulation format and the corresponding protocol type values. The etype-id argument is the protocol type ID of inbound packets, ranging from 0x0600 to 0xFFFF (excluding 0x0800, 0x809B, 0x8137, and 0x86DD).

llc: Matches the llc encapsulation format.

dsap dsap-id: Specifies the destination service access point, ranging from of 0x00 to 0xFF.

ssap ssap-id: Specifies the source service access point, ranging from of 0x00 to 0xFF.

snap etype etype-id: Matches SNAP encapsulation format and the corresponding protocol type values. The etype-id argument is the Ethernet type of inbound packets, ranging from 0x0600 to 0xFFFF (excluding 0x8137).

protocol-index: Specifies a protocol template index. System will automatically assign an index if this parameter is not specified.

to protocol-end: Specifies the end protocol index. The protocol-end argument must be greater than or equal to the protocol-index argument.

all: Removes all the protocols bound to the VLAN.

CAUTION:

· In the protocol-vlan command, do not set the dsap-id argument and the ssap-id argument to 0xe0 (which corresponds to the ipx llc protocol template) or 0xff (which corresponds to the ipx raw protocol template) at the same time.

· When you use the mode keyword to configure a protocol-based VLAN, do not set the etype-id argument of ethernetii packets to 0x0800, 0x8137, 0x809b, and 0x86dd, which correspond to ipv4, ipx, appletalk, and ipv6 protocol templates.

Description

Use the protocol-vlan command to configure the VLAN as a protocol based VLAN and configure the protocol template for the VLAN.

Use the undo protocol-vlan command to remove the configured protocol template.

By default, no VLAN is bound to any protocol template.

Related commands: display protocol-vlan vlan.

Examples

# Configure VLAN 3 as an IPv4 based VLAN.

<Sysname> system-view

[Sysname] vlan 3

[Sysname-vlan3] protocol-vlan ipv4

CAUTION:

IP uses ARP for address resolution in Ethernet. To prevent communication failure, configure the IP and ARP templates in the same VLAN and associate them with the same port.

# Create an ARP protocol template for VLAN 3 (ARP code is 0x0806) to make VLAN 3 transmit ARP packets.

· To use Ethernet encapsulation, use the command:

[Sysname-vlan3] protocol-vlan mode ethernetii etype 0806

· To use 802.3 encapsulation, use the command:

[Sysname-vlan3] protocol-vlan mode snap etype 0806

Voice VLAN configuration commands

The term "switch" or "device" in this chapter refers to the switching engine on a WX3000E wireless switch.

The WX3000E series comprises WX3024E and WX3010E wireless switches.

The port numbers in this chapter are for illustration only.

display voice vlan oui

Syntax

display voice vlan oui [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

|: Filters command output by specifying a regular expression. For more information about regular expressions, see the Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, which is a case sensitive string of 1 to 256 characters.

Description

Use the display voice vlan oui command to display the supported organizationally unique identifier (OUI) addresses, the OUI address masks, and the description strings.

Related commands: voice vlan mac-address.

NOTE:

In general, as the first 24 bits of a MAC address (in binary format), an OUI address is a globally unique identifier assigned to a vendor by IEEE. OUI addresses mentioned in this document, however, are different from those in common sense. OUI addresses in this document are used to determine whether a received packet is a voice packet. They are the results of the AND operation of the two arguments mac-address and oui-mask in the voice vlan mac-address command.

Examples

# Display the supported OUI addresses, and their masks and descriptions.

<Sysname> display voice vlan oui

Oui Address Mask Description

0001-e300-0000 ffff-ff00-0000 Siemens phone

0003-6b00-0000 ffff-ff00-0000 Cisco phone

0004-0d00-0000 ffff-ff00-0000 Avaya phone

00d0-1e00-0000 ffff-ff00-0000 Pingtel phone

0060-b900-0000 ffff-ff00-0000 Philips/NEC phone

00e0-7500-0000 ffff-ff00-0000 Polycom phone

00e0-bb00-0000 ffff-ff00-0000 3com phone

Table 6 Output description

Field	Description
Oui Address	OUI addresses supported.
Mask	Masks of the OUI addresses supported.
Description	Description strings of the OUI addresses supported.

display voice vlan state

Syntax

display voice vlan state [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

|: Filters command output by specifying a regular expression. For more information about regular expressions, see the Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, which is a case sensitive string of 1 to 256 characters.

Description

Use the display voice vlan state command to display voice VLAN configuration.

Related commands: voice vlan enable, voice vlan qos, and voice vlan qos trust.

Examples

# Display voice VLAN configurations.

<Sysname> display voice vlan state

Maximum of Voice VLANs: 1

Current Voice VLANs: 1

Voice VLAN security mode: Security

Voice VLAN aging time: 1440 minutes

Voice VLAN enabled port and its mode:

PORT VLAN MODE

-----------------------------------------------

GigabitEthernet1/0/1 2 AUTO

GigabitEthernet1/0/2 2 AUTO

Table 7 Output description

Field	Description
Voice VLAN system capacity	Maximum number of voice VLANs supported by the system.
Current Voice VLAN Count	Number of existing voice VLANs.
Voice VLAN security mode	Security mode of the voice VLAN: Security for security mode; Normal for normal mode.
Voice VLAN aging time	Aging time of the voice VLAN.
Current voice vlan enabled port and its mode	Voice VLAN-enabled port and its voice VLAN assignment mode.
PORT	Voice VLAN-enabled port name.
VLAN	ID of the voice VLAN enabled on the port.
MODE	Voice VLAN assignment mode of the port, manual or automatic.

voice vlan aging

Syntax

voice vlan aging minutes

undo voice vlan aging

View

System view

Default level

2: System level

Parameters

minutes: Sets the voice VLAN aging time, ranging from 5 to 43200 minutes.

Description

Use the voice vlan aging command to configure the voice VLAN aging time.

Use the undo voice vlan aging command to restore the default.

By default, the voice VLAN aging time is 1440 minutes.

When a port in automatic voice VLAN assignment mode receives a voice packet, the system decides whether to assign the port to the voice VLAN based on the source MAC address of the voice packet. Upon assigning the port to the voice VLAN, the system starts the aging timer. If no voice packets are received on the port until the aging time expires, the system automatically removes the port from the voice VLAN. This aging time applies only to the ports in automatic voice VLAN assignment mode.

Related commands: display voice vlan state.

Examples

# Configure the voice VLAN aging time as 100 minutes.

<Sysname> system-view

[Sysname] voice vlan aging 100

voice vlan enable

Syntax

voice vlan vlan-id enable

undo voice vlan [ vlan-id ] enable

View

Ethernet interface view

Default level

2: System level

Parameters

vlan-id: Specifies a VLAN ID, ranging from 2 to 4096.

Description

Use the voice vlan enable command to enable the voice VLAN feature and configure a VLAN as the voice VLAN for the Ethernet port.

Use the undo voice vlan enable command to disable the voice VLAN feature on an Ethernet port.

By default, the voice VLAN feature is disabled on ports.

You can enable the voice VLAN feature on a hybrid or trunk port operating in automatic voice VLAN assignment mode, but not on an access port operating in automatic voice VLAN assignment mode.

Examples

# Enable the voice VLAN feature on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] voice vlan 2 enable

voice vlan mac-address

Syntax

voice vlan mac-address mac-address mask oui-mask [ description text ]

undo voice vlan mac-address oui

View

System view

Default level

2: System level

Parameters

mac-address: Specifies a source MAC address of voice traffic, in the format of H-H-H. For example, 1234-1234-1234.

mask oui-mask: Specifies the valid length of the OUI address by a mask in the format of H-H-H, formed by consecutive 1s and 0s. For example, FFFF-0000-0000. To filter the voice device of a specific vendor, set the mask to FFFF-FF00-0000.

description text: Specifies a string that describes the OUI address. The string is of 1 to 30 case-sensitive characters.

oui: Specifies the OUI address you want to remove, in the format of H-H-H. For example, 1234-1200-0000. An OUI address is the logic AND result of mac-address and oui-mask. An OUI address cannot be a broadcast address, a multicast address, or an all-zero address. You can use the display voice vlan oui command to display the OUI addresses.

Description

Use the voice vlan mac-address command to allow packets carrying the specified OUI address to pass through.

Use the undo voice vlan mac-address command to prohibit packets carrying the specified OUI address from passing through.

By default, the system is configured with the default OUI addresses. You can remove the default OUI addresses and then add recognizable OUI addresses manually.

Table 8 Default OUI addresses

Number	OUI address	Vendor
1	0001-E300-0000	Siemens phone
2	0003-6B00-0000	Cisco phone
3	0004-0D00-0000	Avaya phone
4	00D0-1E00-0000	Pingtel phone
5	0060-B900-0000	Philips/NEC phone
6	00E0-7500-0000	Polycom phone
7	00E0-BB00-0000	3Com phone

The system supports up to 16 OUI addresses.

Related commands: display voice vlan oui.

Examples

# Add a recognizable OUI address 1234-1200-0000 by specifying the MAC address as 1234-1234-1234 and the mask as fff-ff00-0000, and configure its description string as PhoneA.

<Sysname> system-view

[Sysname] voice vlan mac-address 1234-1234-1234 mask ffff-ff00-0000 description PhoneA

voice vlan mode auto

Syntax

voice vlan mode auto

undo voice vlan mode auto

View

Ethernet interface view

Default level

2: System level

Parameters

None

Description

Use the voice vlan mode auto command to configure the port to operate in automatic voice VLAN assignment mode.

Use the undo voice vlan mode auto command to configure the port to operate in manual voice VLAN assignment mode.

By default, a port operates in automatic voice VLAN assignment mode.

The voice VLAN modes of different ports are independent of one another.

To make voice VLAN take effect on a port which is enabled with voice VLAN and operates in manual voice VLAN assignment mode, you need to assign the port to the voice VLAN manually.

Examples

# Configure GigabitEthernet 1/0/1 to operate in manual voice VLAN assignment mode.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] undo voice vlan mode auto

voice vlan qos

Syntax

voice vlan qos cos-value dscp-value

undo voice vlan qos

View

Interface view

Default level

2: System level

Parameters

cos-value: Sets the CoS precedence value for voice VLAN traffic. The default value is 6.

dscp-value: Sets the DSCP value for voice VLAN traffic. The default value is 46.

Description

Use the voice vlan qos command to configure the interface to modify the CoS and DSCP values marked for incoming traffic of the voice VLAN into specified values.

Use the undo voice vlan qos command to restore the default.

By default, an interface modifies the CoS value and the DSCP value marked for voice VLAN traffic into 6 and 46 respectively.

Configure the QoS priority settings for voice VLAN traffic on an interface before you enable voice VLAN on the interface. If the configuration order is reversed, the priority settings will fail.

The voice vlan qos command and the voice vlan qos trust command can overwrite each other. When you execute the two commands on a port multiple times, the most recent one takes effect.

Related commands: voice vlan qos trust.

Examples

# Configure interface GigabitEthernet 1/0/1 to modify the CoS value and the DSCP value marked for voice VLAN packets into 5 and 45 respectively.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] voice vlan qos 5 45

voice vlan qos trust

Syntax

voice vlan qos trust

undo voice vlan qos

View

Interface view

Default level

2: System level

Parameters

None

Description

Use the voice vlan qos trust command to configure the interface to trust the priority settings carried in incoming voice traffic. With this command configured, an interface keeps the CoS and DSCP values marked for incoming voice traffic unchanged.

Use the undo voice vlan qos command to restore the default.

By default, an interface modifies the CoS value and the DSCP value marked for voice VLAN traffic into 6 and 46 respectively.

Configure the QoS priority trust mode for voice VLAN traffic on an interface before enabling voice VLAN on the interface. If the configuration order is reversed, your priority trust setting will fail.

The voice vlan qos command and the voice vlan qos trust command can overwrite each other. After you execute the two commands on a port multiple times, the one that was last executed takes effect.

Related commands: voice vlan qos.

Examples

# Configure interface GigabitEthernet 1/0/1 to trust the priority settings carried in incoming voice VLAN traffic.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] voice vlan qos trust

voice vlan security enable

Syntax

voice vlan security enable

undo voice vlan security enable

View

System view

Default level

2: System level

Parameters

None

Description

Use the voice vlan security enable command to enable the voice VLAN security mode.

Use the undo voice vlan security enable command to disable the voice VLAN security mode.

When you enable the security mode for a voice VLAN, only voice traffic can be transmitted in the voice VLAN.

The device matches the source MAC addresses of the packets against the supported OUI addresses to determine whether they are voice traffic and filters all non-voice traffic, guaranteeing high priority and high quality for voice traffic.

When a voice VLAN operates in common mode, other data traffic is also allowed to be transmitted in the voice VLAN.

Examples

# Disable voice VLAN security mode.

<Sysname> system-view

[Sysname] undo voice vlan security enable

02-Layer 2 Command Reference

VLAN configuration commands

description

display interface vlan-interface

display vlan

ip address

reset counters interface vlan-interface

shutdown

port

port hybrid pvid

port link-type

port trunk permit vlan

MAC-based VLAN configuration commands

display protocol-vlan vlan

voice vlan enable

Intelligent Terminal Products

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Become a Partner

Partner Policy & Program

Global Learning

Partner Sales Resources

Service Business

News & Events

Contact Us