CLI.book(4085 VLANs.fm) - Home | Papagayo System, C.A. CIS… · · 2010-11-07Matrix X Router Command Line Interface Reference Guide 14-1 14 802.1Q ... All other available VLAN

14802.1Q VLAN Commands

OverviewThis chapter describes the Matrix X Router’s 802.1Q virtual LANs (VLANs) commands.

The Matrix X Router can support up to 1024 802.1Q VLANs. VLAN ID 1 is reserved by the device as the default VLAN since all ports on the device are assigned to VLAN ID 1, untagged, by default. All other available VLAN IDs can be assigned and configured with the CLI.:

Creating and Naming Static VLANs

PurposeThese switch‐level commands are used to create a new static VLAN, or to enable or disable existing VLAN(s).

CommandsThe commands used to create and name static VLANs are listed below.

For information about... Refer to page...

Creating and Naming Static VLANs 14-1

Assigning Port VLAN IDs (PVIDs) and Ingress Filtering 14-5

Configuring the VLAN Egress List 14-15

Enabling/Disabling GVRP (GARP VLAN Registration Protocol) 14-20


set vlan create 14-2

set vlan name 14-3

clear vlan 14-3

show vlan 14-4

show vlan 14-4

Matrix X Router Command Line Interface Reference Guide 14-1


set vlan createThis command creates a new static IEEE 802.1Q VLAN.

Syntaxset vlan create vlan-id

Parameters

DefaultsNone.

ModeSwitch command, read‐write.

UsageOnce a VLAN is created, you can assign it a name using set vlan name on page 14‐3.

Each VLAN ID must be unique. If a duplicate VLAN ID is entered, the device assumes that the Administrator intends to modify the existing VLAN.

ExamplesThe following example creates VLAN 3:

matrix-x(switch-su)->set vlan create 3

The following example disables VLAN 3:

matrix-x(switch-su)->set vlan disable 3

vlan‐id Valid values are 1‐4094. Each vlan‐id must be unique. If an existing vlan‐id is entered, the existing VLAN is modified.

14-2 802.1Q VLAN Commands


set vlan nameThis command sets or changes the ASCII name for a new or existing VLAN.

Syntaxset vlan name vlan-id string

Parameters

DefaultsNone.


ExampleThis example sets the name for VLAN 7 to green:

matrix-x(switch-su)->set vlan name 7 green

clear vlanThis command removes a static VLAN from the list of VLANs recognized by the device.

Syntaxclear vlan vlan-list

Parameters

DefaultsNone.


ExampleThe following example removes a static VLAN 9 from the device’s VLAN list:

matrix-x(switch-su)#clear vlan 9

vlan‐id Valid values are 1‐4094. Each vlan‐id must be unique. If an existing vlan‐id is entered, the existing VLAN is modified.

string Specifies the string used as the name of the VLAN (1 to 32 characters).

vlan‐list Specifies the VLAN ID of the VLAN(s) to be removed.



show vlanThis command displays existing VLANs.

Syntaxshow vlan [static] [vlan-list]

Parameters

Defaults• If static is not specified, information for static and dynamic VLANs will be displayed.

• If vlan‐list is not specified, information for all VLANs will be displayed.

ModeSwitch command, read‐only.

ExampleThe following example shows the output of this command.

matrix-x(switch-su)-> show vlan static VLAN: 1 NAME: DEFAULT VLAN Status: Enabled VLAN Type: Permanent FID: 1 Creation Time: 0 days 1 hours 58 minutes 58 seconds ago Egress PortsNone. Forbidden Egress PortsNone. Untagged PortsNone.

static (Optional) Displays information related to static VLANs. Static VLANs are manually created using the set vlan create command or SNMP MIBs. The default VLAN, VLAN 1, is always statically configured and can’t be deleted. Only ports that use a specified VLAN as their default VLAN (PVID) will be displayed.

vlan‐list (Optional) Displays information for a specific VLAN or range of VLANs.


Assigning Port VLAN IDs (PVIDs) and Ingress Filtering


About PVIDs and Policy Classification to a VLANPort VLAN IDs (PVIDs) assign VLAN IDs to untagged frames on one or more ports. Using the set port vlan command, you can, for example, assign ports 1, 5, 8, and 9 to VLAN 3. Untagged frames received on those ports will be assigned to VLAN 3. (By default, all ports are members of VLAN ID 1, the default VLAN.)

Policy classification to a VLAN takes precedence over PVID assignment if:

• Policy classification is configured to a VLAN and

• PVID override has been enabled for a policy profile and assigned to port(s) associated with the PVID.

PurposeThese switch‐level commands are used to assign default VLAN IDs to untagged frames on one or more ports, to configure MIB‐II interface mapping to a VLAN, to configure VLAN ingress filtering, and to set the frame discard mode.

CommandsThe commands used to configure port VLAN IDs and ingress filtering are listed below.


show port vlan 14-6

set port vlan 14-7

clear port vlan 14-8

show vlan interface 14-9

set vlan interface 14-10

clear vlan interface 14-11

show port ingress-filter 14-11

set port ingress-filter 14-12

show port discard 14-13

set port discard 14-14

clear port discard 14-14



show port vlanThis command displays port VLAN identifier (PVID) information. PVID determines the VLAN to which all untagged frames received on one or more ports will be classified.

Syntaxshow port vlan [port-string]

Parameters

DefaultsIf port ‐string is not specified, port VLAN information for all ports will be displayed.


ExampleThe following example displays PVIDs assigned to Gigabit Ethernet ports 1 through 6 in slot 5. In this case, untagged frames received on these ports will be classified to VLAN 1:

matrix-x(switch-su)#show port vlan ge.5.1-6ge.5.1 is set to 1 ge.5.2 is set to 1 ge.5.3 is set to 1 ge.5.4 is set to 1 ge.5.5 is set to 1 ge.5.6 is set to 1

port‐string (Optional) Displays PVID information for specific port(s).



set port vlanThis command configures the PVID (port VLAN identifier) for one or more ports.

Syntaxset port vlan port-string pvid

Parameters

DefaultsNone.


UsageThe PVID is used to classify untagged frames as they ingress into a given port. If the specified VLAN has not already been created, this command will create it, add the VLAN to the port’s egress list as untagged, and remove the default VLAN from the port’s egress list.

ExampleThe following example adds Gigabit Ethernet port 10 in slot 1 to the port VLAN list of VLAN 4 (PVID 4). Since VLAN 4 is a new VLAN, it is created. Then port ge.1.10 is added to VLAN 4’s untagged egress list, and is cleared from the egress list of VLAN 1 (the default VLAN):

matrix-x(switch-su)#set port vlan ge.1.10 4matrix-x(switch-su)#set vlan 4 creatematrix-x(switch-su)#set vlan egress 4 ge.1.10 untaggedmatrix-x(switch-su)#clear vlan egress 1 ge.1.10

port‐string Specifies the port(s) for which to configure a VLAN identifier.

pvid Specifies the VLAN ID of the VLAN to which port(s) will be added.



clear port vlanThis command resets a port’s 802.1Q port VLAN ID (PVID) to the host VLAN ID 1.

Syntaxclear port vlan port-string

Parameters

DefaultsNone.


ExampleThe following example resets the Gigabit Ethernet ports 3 and 11 in slot 1 to a VLAN ID of 1 (Host VLAN):

matrix-x(switch-su)#clear port vlan ge.1.3,ge.1.11

port‐string Specifies the port(s) to be reset to the host VLAN ID 1.



show vlan interfaceThis command displays the MIB‐II interface entry mapped to a VLAN.

Syntaxshow vlan interface [vlan-list]

Parameters

DefaultsIf vlan‐list is not specified, MIB2 interface entries will be displayed for all VLANs.


ExampleThis example displays the interface entry for VLAN 1:

matrix-x(switch-su)#show vlan interface 1VLAN Port Storage Type ------------------------------------- 1 vlan.0.1 non-volatile

The following table provides an explanation of the command output.

vlan‐list Displays the MIB2 interface entry for specific VLAN(s).

Output What It Displays...

VLAN VLAN ID.

Port Port-string designation.

Storage Type Whether the entry is stored as a volatile or non-volatile entry. Volatile entries are lost when a system is reset. Non-volatile entries are saved in NVRAM and are persistent until cleared.



set vlan interfaceThis command creates, disables or enables a MIB‐II interface mapped to a VLAN.

Syntaxset vlan interface vlan-list {create | disable | enable} [volatile]

Parameters

DefaultsIf volatile is not specified, entries will be created as nonvolatile.


ExampleThis example creates a volatile interface entry mapped to VLAN 1:

matrix-x(switch-su)#set vlan interface 1 volatile

vlan‐list Specifies the VLAN(s) for which an interface entry will be created, disabled or enabled.

create | disable | enable

Creates, disables or enables an interface entry.

volatile (Optional) When the create keyword is used, stores the entry as a volatile entry. Volatile entries are lost when a system is reset. Non‐volatile entries are saved in NVRAM and are persistent until cleared.



clear vlan interfaceThis command clears the MIB‐II interface entry mapped to a VLAN.

Syntaxclear vlan interface vlan-list

Parameters

DefaultsNone.


ExampleThis example clears the interface entry mapped to VLAN 1:

matrix-x(switch-su)#clear vlan interface 1

show port ingress-filterThis command shows all ports that are enabled for port ingress filtering, which limits incoming VLAN ID frames according to a port VLAN egress list. If the VLAN ID specified in the received frame is not on the port’s VLAN egress list, then that frame is dropped and not forwarded.

Syntaxshow port ingress-filter [port-string]

Parameters

DefaultsIf port‐string is not specified, ingress filtering status for all ports will be displayed.


ExampleThis example displays the port ingress filter status for Gigabit Ethernet ports 10 through 15 in slot 1. In this case, the ports are disabled for ingress filtering:

matrix-x(switch-su)#show port ingress-filter ge.1.10-15Port State-------- ---------

vlan‐list Specifies the VLAN(s) for which an interface entry will be cleared.

port‐string (Optional) Specifies the port(s) for which to display ingress filtering status.



ge.1.10 disabledge.1.11 disabledge.1.12 disabledge.1.13 disabledge.1.14 disabledge.1.15 disabled

set port ingress-filterThis command discards all frames received with a VLAN ID that do not match the port’s VLAN egress list.

Syntaxset port ingress-filter port-string {disable | enable}

Parameters

DefaultsNone.


UsageWhen ingress filtering is enabled on a port, the VLAN IDs of incoming frames are compared to the port’s egress list. If the received VLAN ID does not match a VLAN ID on the port’s egress list, then the frame is dropped.

Ingress filtering is implemented according to the IEEE 802.1Q standard.

ExampleThis example enables port ingress filtering on Gigabit Ethernet port 3 in slot 1:

matrix-x(switch-su)#set port ingress-filter ge.1.3 enable

port‐string Specifies the port(s) on which to enable of disable ingress filtering.

disable | enable Disables or enables ingress filtering.



show port discardThis command displays the frame discard mode for one or more ports. Ports can be set to discard frames based on whether or not they contain a VLAN tag. They can also be set to discard both frame types or none of the frames received.

Syntaxshow port discard [port-string]

Parameters

DefaultsIf port‐string is not specified, frame discarded mode will be displayed for all ports.


ExampleThe following example displays the frame discard mode for Gigabit Ethernet port 7 in slot 5. In this case, the port has been set to discard all tagged frames:

matrix-x(switch-su)#show port discard ge.5.7Port Discard Mode------------ -------------ge.5.7 tagged

port‐string (Optional) Displays the frame discard mode for specific port(s).



set port discardThis command sets the frame discard mode on one or more ports.

Syntaxset port discard port-string {tagged | untagged | none | both}

Parameters

DefaultsBy default, no frames are discarded based on received format.


ExampleThis example sets Gigabit Ethernet port 7 in slot 5 to discard both tagged and untagged frames:

matrix-x(switch-su)#set port discard ge.5.7 both

clear port discardThis command resets the frame discard mode to the factory default setting (none).

Syntaxclear port discard port-string

Parameters

DefaultsNone.


ExampleThis example resets Gigabit Ethernet port 7 in slot 5 to the default discard mode of “none”:

matrix-x(switch-su)# clear port discard ge.5.7

port‐string Specifies the port(s) for which to set frame discard mode.

tagged | untagged | none | both

Sets the port(s) to discard tagged or untagged frames, no frames, or both types of frames.

port‐string Specifies the port(s) for which to reset frame discard mode.


Configuring the VLAN Egress List


PurposeSwitch commands are used to assign or remove ports on the egress list of a particular VLAN. This determines which ports will be eligible to transmit frames for a particular VLAN. For example, ports 1, 5, 9, 8 could be assigned to transmit frames belonging to VLAN 5 (VLAN ID=5).

The port egress type for all ports defaults to tagging transmitted frames, but can be changed to forbidden or untagged. In general, VLANs have no egress (except for VLAN 1) until they are configured by static administration, or through dynamic mechanisms (that is, GVRP, policy classification or Enterasys dynamic egress).

Setting a port to forbidden prevents it from participating in the specified VLAN and ensures that any dynamic requests (either through GVRP or dynamic egress) for the port to join the VLAN will be ignored. Setting a port to untagged allows it to transmit frames without a tag header. This setting is usually used to configure a port connected to an end user device.

The default VLAN defaults its egress to untagged for all ports.

CommandsThe commands used to configure VLAN egress and dynamic VLAN egress are listed below.


set vlan egress 14-16

clear vlan egress 14-17

show vlan dynamicegress 14-18

set vlan dynamicegress 14-19



set vlan egressThis command adds ports to the VLAN egress list for the device, or prevents one or more ports from participating in a VLAN. This determines which ports will transmit frames for a particular VLAN.

Syntaxset vlan egress vlan-list port-string [untagged | forbidden | tagged]

Parameters

DefaultsIf untagged, forbidden or tagged is not specified, the port will be added to the VLAN egress list as tagged.


ExamplesThe following example adds Gigabit Ethernet ports 5 through 10 in slot 1 to the egress list of VLAN 7. This means that these ports will transmit VLAN 7 frames as tagged:matrix-x(switch-su)# set vlan egress 7 ge.1.5-10

The following example forbids Gigabit Ethernet ports 13 through 15 in slot 1 from joining VLAN 7 and disallow egress on those ports:

matrix-x(switch-su)# set vlan egress 7 ge.1.13-15 forbidden

The following example allows Gigabit Ethernet port 2 in slot 1 to transmit VLAN 7 frames as untagged:

matrix-x(switch-su)# set vlan egress 7 ge.1.2 untagged

vlan‐list Specifies the VLAN where a port(s) will be added to the egress list.

port‐string Specifies one or more ports to add to the VLAN egress list of the specified vlan‐list.

untagged | forbidden | tagged

(Optional) Adds the specified ports as:

• untagged — Causes the port(s) to transmit frames without an IEEE 802.1Q header tag.

• forbidden — Instructs the device to ignore dynamic requests (either through GVRP or dynamic egress) from the port(s) to join the VLAN and disallows egress on that port.

• tagged — Causes the port(s) to transmit 802.1Q tagged frames.



clear vlan egressThis command removes ports from a VLAN’s egress list.

Syntaxclear vlan egress vlan-list port-string [forbidden]

Parameters

DefaultsIf forbidden is not specified, tagged and untagged settings will be cleared.


ExamplesThe following example removes Gigabit Ethernet port 1 in slot 3 from the egress list of VLAN 9:

matrix-x(switch-su)# clear vlan egress 9 ge.3.1

The following example removes all Gigabit Ethernet ports in slot 2 from the egress list of VLAN 4:

matrix-x(switch-su)# clear vlan egress 4 ge.2.*

vlan‐list Specifies the number of the VLAN from which a port(s) will be removed from the egress list.

port‐string Specifies one or more ports to be removed from the VLAN egress list of the specified vlan‐list.

forbidden (Optional) Clears the forbidden setting from the specified port(s) and resets the port(s) as able to egress frames if so configured by either static or dynamic means.



show vlan dynamicegressThis command displays which VLANs are currently enabled for VLAN dynamic egress.

Syntaxshow vlan dynamicegress [vlan-list]

Parameters

DefaultsIf vlan‐list is not specified, status for all VLANs where dynamic egress is enabled will be displayed.


ExampleThe following example displays which VLANs are enabled for dynamic egress:

matrix-x(switch-su)# show vlan dynamicegressVLAN 1 is enabledVLAN 101 is enabledVLAN 102 is enabledVLAN 105 is enabled

vlan‐list (Optional) Displays dynamic egress status for specific VLAN(s).



set vlan dynamicegressThis command sets the administrative status of one or more VLANs’ dynamic egress capability. If VLAN dynamic egress is enabled, the device will add the port receiving a tagged frame to the VLAN egress list of the port according to the frame VLAN ID.

Syntaxset vlan dynamicegress vlan-list {enable | disable}

Parameters

DefaultsNone.


ExampleThe following example enables the dynamic egress function on VLAN 7:

matrix-x(switch-su)# set vlan dynamicegress 7 enable

vlan‐list Specifies the number of the VLAN(s) where dynamic egress will be enabled or disabled.

enable | disable Enables or disables dynamic egress.


Enabling/Disabling GVRP (GARP VLAN Registration Protocol)


PurposeThese switch‐level commands are used to dynamically create VLANs across a switched network. The GVRP command set is used to display GVRP configuration information, the current global GVRP state setting, individual port settings (enable or disable) and timer settings. By default, GVRP is enabled on all ports, and globally on the device.

CommandsThe commands used to configure GVRP are listed below.

show gvrpThis command displays GVRP configuration information.

Syntaxshow gvrp [port-string]

Parameters

DefaultsIf port‐string is not specified, GVRP configuration data is displayed for all ports and the device.



show gvrp 14-20

show garp timer 14-21

set gvrp 14-22

clear gvrp 14-23

set garp timer 14-23

clear garp timer 14-24

port-string (Optional) Displays GVRP configuration information for specific port(s).



ExampleThe following example displays GVRP status for the device and Gigabit Ethernet port 1 in slot 7:

matrix-x(switch-su)# show gvrp ge.7.1Global GVRP status is enabled.

Port Number GVRP status Last PDU Origin----------- ----------- -----------------ge.7.1 enabled 00-e0-63-97-d4-36

The following table describes the output.

show garp timerThis command displays Group Address Registration Protocol (GARP) timer values for one or more ports.

Syntaxshow garp timer [port-string]

Parameters

DefaultsIf port‐string is not specified, GARP timer information will be displayed for all ports.


ExampleThe following example displays GARP timer data on Gigabit Ethernet ports 1 through 10 in slot 1:

matrix-x(switch-su)# show garp timer ge.1.1-10Port based GARP Configuration: (Timer units are centiseconds)Port Number Join Leave Leaveall

----------- ----- ------- --------ge.1.1 20 60 1000ge.1.2 20 60 1000ge.1.3 20 60 1000ge.1.4 20 60 1000ge.1.5 20 60 1000ge.1.6 20 60 1000ge.1.7 20 60 1000

Output What It Displays

Port Number Port designation.

GVRP status Whether GVRP is enabled or disabled on the port.

Last PDU Origin MAC address of the last GVRP frame received on the port

port‐string (Optional) Displays GARP timer data for specific port(s).



ge.1.8 20 60 1000ge.1.9 20 60 1000ge.1.10 20 60 1000

The table below describes the command output. See set gvrp for details on enabling or disabling GVRP. See set garp timer for details on changing default timer values.

set gvrpThis command enables or disables GVRP globally on the device or on one or more ports.

Syntaxset gvrp {enable | disable} [port-string]

Parameters

DefaultsIf port‐string is not specified, GVRP will be disabled or enabled for all ports.


ExamplesThe following example enables GVRP globally on the device:

matrix-x(switch-su)#set gvrp enable

The following example disables GVRP globally on the device:

matrix-x(switch-su)#set gvrp disable

The following example enables GVRP on Gigabit Ethernet port 3 in slot 1:

matrix-x(switch-su)#set gvrp enable ge.1.3

Output What It Displays

Port Number Port designation. For a detailed description of possible port-string values, refer to Port Strings Used in the CLI on page 7-2.

Join Join timer setting.

Leave Leave timer setting.

Leaveall Leavall timer setting.

Note: For a functional description of the terms join, leave, and leaveall timers, refer to standard IEEE 802.1Q documentation, which is not supplied with this device.

enable | disable Disables or enables GVRP on the device.

port‐string (Optional) Disables or enables GVRP on specific port(s).



clear gvrpThis command clears GVRP status or on one or more ports.

Syntaxclear gvrp [port-string]

Parameters

DefaultsIf port‐string is not specified, GVRP status will be cleared for all ports.


ExampleThe following example clears GVRP status globally on the device:

matrix-x(switch-su)#clear gvrp

set garp timerThis command adjusts the values of the join, leave, and leave all timers.

Syntaxset garp timer {[join timer-value][leave timer-value][leaveall timer-value]} port-string

Parameters

Defaults• Join 20 centiseconds

• Leave 60 centiseconds

• Leaveall 1000 centiseconds

port‐string (Optional) Clears GVRP status on specific port(s).

join timer‐value Sets the GARP join timer in centiseconds. The value can range from 1 to 2147483647 centiseconds. Default is 20.

leave timer‐value Sets the GARP leave timer in centiseconds. The value can range from 1 to 2147483647 centiseconds. Default is 60.

leaveall timer‐value Sets the GARP leaveall timer in centiseconds. The value can range from 1 to 2147483647 centiseconds. Default is 1000.

port‐string Specifies the port(s) on which to configure GARP timer settings. For a detailed description of possible port‐string values, refer to Port Strings Used in the CLI on page 7‐2.




UsageThe setting of these timers is critical and should only be changed by personnel familiar with the 802.1Q standards documentation, which is not supplied with this device.

ExamplesThe following example sets the GARP join timer value to 100 centiseconds for all ports:

matrix-x(switch-su)#set garp timer join 100 *.*.*

The following example sets the leave timer value to 300 centiseconds for all ports:

matrix-x(switch-su)#set garp timer leave 300 *.*.*

The following example sets the leaveall timer value to 20000 centiseconds for all ports:

matrix-x(switch-su)#set garp timer leaveall 20000 *.*.*

clear garp timerThis command resets GARP timers to default values.

Syntaxclear garp timer {[join] [leave] [leaveall]} port-string

Parameters

DefaultsAt least one optional parameter must be entered.


ExampleThe following example resets the GARP leave timer to 60 centiseconds on Gigabit Ethernet port 3 in slot 5:

matrix-x(switch-su)#clear garp timer leave ge.5.3

join (Optional) Resets the join timer to 20 centiseconds.

leave (Optional) Resets the leave timer to 60 centiseconds.

leaveall (Optional) Resets the leaveall timer to 1000 centiseconds.

port‐string Specifies the port(s) on which to reset GARP timer(s).


Documents

CLI.book(4085 VLANs.fm) - Home | Papagayo System, C.A. CIS… · · 2010-11-07Matrix X Router Command Line Interface Reference Guide 14-1 14 802.1Q ... All other available VLAN