VLAN Commands
vlan-create
This command is used to create a new VLAN on the network.
Syntax vlan-create
id vlan-id |
Specify a VLAN identifier for the VLAN. This is a value between 2 and 4092. |
range vlan-list |
Specify a range of VLAN IDs. |
vnet vnet-name |
Specify the VNET assigned to this VLAN. |
vxlan vxlan-id |
Specify the VXLAN mapped to the VLAN for the tunnel. |
vxlan-mode standard|transparent |
Specify the VXLAN mode as standard or transparent. |
replicators vtep-group name|none |
Specify the replicator group. |
public-vlan vlan-id |
Specify the ID of the public VLAN. |
scope local|cluster|fabric |
Specify a scope for the VLAN. |
Specify any of the following options: |
|
description description-string |
Specify a description for the VLAN. |
stats|no-stats |
Specify if you want to collect statistics for a VLAN. Statistic collection is enabled by default. |
ports port-list |
Specifies the switch network data port number, list of ports, or range of ports. Port numbers must be in the range of 1 to 64. |
untagged-ports untagged-port-list |
Specifies the ports that should have untagged packets mapped to the VLAN. Untagged packets are packets that do not contain IEEE 802.1Q VLAN tags.. |
Defaults None.
Access CLI
History
Version 1.2 |
Command introduced. |
Version 2.2 |
The parameter, stats, added. The scope option, cluster, deprecated. |
Version 2.3 |
The parameter, name, changed to description. |
Version 2.4.1 |
The parameters, vxlan, vxlan-mode, and public-vlan, added. The option, cluster, added. |
Version 2.5.2 |
The parameter vxlan-mode standard|transparent added. |
Version 2.6.2 |
The parameter, range, added. |
Version 3.0.0 |
The parameter, range, deprecated. The parameter, replicators, added. |
Usage VLANs are used to isolate network traffic at Layer 2. Use this command to create a new VLAN.
Informational Note:
The VLAN identifiers 0 and 4095 are reserved and cannot be used per the IEEE 802.1Q standard.
The range of configurable VLAN identifiers is 2 through 4092.
Examples To create a new fabric-wide VLAN with the description, finance VLAN, and an identifier of 7, use the following command:
CLI network-admin@switch > vlan-create id 7 description finance-VLAN scope fabric
vlan-delete
This command deletes an existing VLAN.
Syntax vlan-delete
id vlan-id |
Specify the VLAN identifier. This is a value between 2 and 4092. |
range vlan-list |
Specify a range of VLAN IDs. |
vnet vnet-name |
Specify the VNET assigned to this VLAN. |
Defaults None.
Access CLI
History .
Version 1.2 |
Command introduced. |
Version 2.4.1 |
The parameter, vnet, added. |
Version 2.6.2 |
The parameter, range, added. |
Usage VLANs can be used to isolate network traffic at Layer 2. Use this command to delete an existing VLAN.
Examples To delete a VLAN with the identifier 7, use the following command:
CLI network-admin@switch > vlan-delete id 7
vlan-modify
This command is used to modify a VLAN or VXLAN on the network.
Syntax vlan-modify
id vlan-id |
Specify a VLAN identifier for the VLAN. This is a value between 2 and 4092. |
range vlan-list |
Specify a range of VLAN IDs. |
Specify any of the following options: |
|
description description-string |
Specify a description for the VLAN. |
vxlan vxlan-id |
Specify the VXLAN mapped to the VLAN for the tunnel. |
replicators vtep-group name|none |
Specify the replicator group. |
vnet vnet-name |
Specify the VNET assigned to this VLAN. |
public-vlan vlan-id |
Specify the public VLAN for the VNET VLAN. |
Defaults None.
Access CLI
History
Version 2.2.4 |
Command introduced. |
Version 2.4.1 |
The parameter, vxlan and vnet, added. |
Version 2.6.2 |
The parameter, range, added. |
Version 3.0.0 |
The parameter, range, deprecated. The parameter, replicators, added. |
Usage VLANs are used to isolate network traffic at Layer 2. Use this command to modify a VLAN.
Examples To create a modify a VLAN named finance to the name finance-2, use the following command:
CLI network-admin@switch > vlan-modify id 7 name finance-2
vlan-show
This command displays a list of existing VLANs or VXLANs on the switch.
Syntax vlan-show
id vlan-id |
Displays the VLAN ID as a value from 2 to 4092. |
vnet vnet-name |
Displays the VNET assigned to this VLAN. |
type public|private |
Displays the VLAN type |
vxlan vxlan-id |
Displays the VXLAN ID. |
vxlan-type user|fabric |
Displays the VXLAN type as user or fabric. |
vxlan-mode standard|transparent |
Displays the VXLAN mode as standard or transparent. |
hw-vpn hw-vpn-number |
Displays the hardware VPN. |
hw-mcast-group hw-mcast-group-number |
Displays the hardware multicast group. |
replicators vtep-group name|none |
Displays the replicator group. |
repl-vtep ip-address |
Displays the replicator VTEP. |
public-vlan vlan-id |
Displays the ID of the public VLAN. |
scope local|fabric |
Displays the scope of the VLAN. |
description description-string |
Displays a description for the VLAN. |
active yes|no |
Displays if the VLAN is active on the network. |
stats|no-stats |
Displays if stats collection is enabled. |
vrg vrg-name |
Displays the name of the VRG assigned to the VLAN. |
ports port-list |
Displays the list of ports assigned to the VLAN. |
untagged-ports port-list |
Displays the list of untagged ports assigned to the VLAN. |
active-edge-ports |
Displays any active edge ports for the VLAN. |
Defaults None.
Access CLI
History
Version 1.2 |
Command introduced. |
Version 2.4.1 |
The parameters, vnet, type, vxlan, vxlan-mode, and public-vlan, added. The option, cluster, added. |
Version 2.6.2 |
The parameter, range, added. |
Version 3.0.0 |
The parameter, range, deprecated. |
Usage VLANs are used to isolate network traffic at Layer 2. Use this command to modify a VLAN.
Examples To display a list of VLANs, use the following command:
CLI network-admin@switch > vlan-show
switch: pubdev03
id: 1
type: public
scope: local
description: default-1
active: yes
stats: yes
vrg: 0:0
ports: 1-54,57-72,128,255
untagged-ports: 1-54,57-72,128,255
active-edge-ports: 65,128
switch: pubdev02
id: 1
type: public
scope: local
description: default-1
active: yes
stats: yes
vrg: 0:0
ports: 1-8,15-54,57-72,128
untagged-ports: 1-8,15-54,57-72,128
active-edge-ports: 65,128
vlan-port-add
This command is used to add a port to an existing VLAN.
Syntax vlan-port-add
vlan-id vlan-id |
Specifies the identifier of the VLAN in the range from 2 to 4092. |
vlan-range vlan-list |
Specify the range of VLAN IDs. |
vlan-vnet vnet-name |
Specify the name of the VNET assigned to the VLAN. |
Specify the following port arguments: |
|
switch switch-name |
Specify the name of the switch with the port. |
ports port-list |
Specifies the switch network data port number, list of ports, or range of ports. Port numbers must be in the range of 1 to 64. |
untagged yes|no |
Specifies if the ports tag packets with the IEEE 802.1Q VLAN header or untagged packets should automatically be mapped to the VLAN. This means that both ingress and egress packets do not contain the 802.1Q VLAN header. |
Defaults None.
Access CLI
History
Version 1.2 |
Command introduced. |
Version 2.4.1 |
The parameter, vnet, added. |
Version 3.0.0 |
The parameter, vlan-range, added. |
Usage VLANs can be used to isolate network traffic at Layer 2. This command adds a new port to a VLAN.
Examples To add ports 17 and 18 and set them to transmit and receive untagged Ethernet packets on VLAN 7 on VNET finance-1, use the following command:
CLI network-admin@switch > vlan-port-add vlan-id 7 vlan-vnet finance-1 ports 17,18 untagged yes
vlan-port-remove
This command removes an existing port from a VLAN.
Syntax vlan-port-remove
vlan-id vlan-id |
Specifies the identifier of the VLAN in the range from 2 to 4092. |
vlan-range vlan-list |
Specify the range of VLAN IDs. |
vlan-vnet vnet-name |
Specify the name of the VNET assigned to the VLAN. |
Specify the following port arguments: |
|
switch switch-name |
Specify the name of the switch with the port. |
ports port-list |
Specifies the switch network data port number, list of ports, or range of ports. Port numbers must be in the range of 1 to 64. |
Defaults None.
Access CLI
History
Version 1.2 |
Command introduced. |
Version 2.4.1 |
The parameter, vnet, added. |
Version 3.0.0 |
The parameter, vlan-range, added. |
Usage VLANs can be used to isolate network traffic at Layer 2. This command removes a VLAN port.
Examples To remove ports 17 and 18 from VLAN 7 and VNET, finance-1, use the following command:
CLI network-admin@switch > vlan-port-remove vlan-id 7 vnet finance-1 ports 17,18
vlan-stats-show
This command displays traffic statistics per VLAN.
Syntax vlan-stats-show
time date/time: yyyy-mm-ddThh:mm:ss |
Specifies the time for the statistics. |
start-time start-time |
Specifies the start time for the statistics display using the notation yyyy-mm-ddThh:mm:ss. |
end-time end-time |
Specifies the end time for the statistics display using the notation yyyy-mm-ddThh:mm:ss. |
duration duration: #d#h#m#s |
Specify the duration for the traffic statistics. |
interval duration: #d#h#m#s |
Specifies the time interval for the statistics display. |
since-start|no-since-start |
Specifies if the statistics are collected from the start of the VLAN. |
older-than duration: #d#h#m#s |
Specifies if the statistics are older than the stated duration. |
within-last duration: #d#h#m#s |
Specifies the statistics collected within the last duration. |
vlan vlan-id |
Specify a specific VLAN to display statistics. |
vnet vnet-name |
Specify a VNET name. |
public-vlan vlan-id |
Specify a public VLAN ID. |
vxlan vxlan-id |
Specify a VXLAN ID. |
ibits ibits-number |
Displays the number of incoming bits for the VLAN. |
obits obits-number |
Displays the number of outgoing bits for the VLAN. |
Defaults None.
Access CLI
History
Version 1.2 |
Command introduced. |
Version 2.2.3 |
The parameter, id, and name, deprecated. The parameters, duration, and interval, added. |
Version 2.4.1 |
The parameters, vnet, public-vlan, and VXLAN added. |
Version 3.0.0 |
The parameters, ibits and obits, added. |
Usage VLANs can be used to isolate network traffic at Layer 2. This command displays traffic statistics per VLAN.
Examples This example shows how to display traffic statistics logs between the times of 8:00 am and 8:01 am on January 31, 2019.
CLI network-admin@switch > vlan-stats-log-show start-time 12:00:00 end-time 12:25:00
switch: pleiades24
time: 12:20:42
vlan: 1
ibytes: 546M
ipkts: 1.64M
idrops-bytes: 256
idrops-pkts: 4
obytes: 0
opkts: 0
odrops-bytes: 0
odrops-pkts: 0
switch: pleiades25
time: 12:20:42
vlan: 100
ibytes: 305M
ipkts: 4.41M
idrops-bytes: 64
idrops-pkts: 1
obytes: 0
opkts: 0
odrops-bytes: 0
odrops-pkts: 0
vlan-stats-settings-modify
This command allows you to modify the settings for collection of VLAN statistics.
Syntax vlan-stats-settings-modify
Specify one or more of the following options: |
|
enable|disable |
Specify to enable or disable statistics collection. |
interval duration:#d#h#m#s |
Specify the interval between statistics collection. |
disk-space disk-space-number |
Specify the amount of disk space to reserve for the statistics. |
Defaults None.
Access CLI
History Command introduced in Version 2.1.
Usage Use this command to modify the setting for statistics collection.
Examples To modify the VLAN statistics disk size to 8G, use the following command:
CLI network-admin@switch > vlan-stats-settings-modify disk-space 8g
vlan-stats-settings-show
This command allows to display the settings for collecting VLAN statistics.
Syntax vlan-stats-settings-show
Defaults None.
Access CLI
History Command introduced in Version 2.1..
Usage Use this command to display the settings for statistics collection.
Examples To display the VLAN statistics settings, use the following command:
CLI network-admin@switch > vlan-stats-settings-show
switch: pleiades25
enable: yes
interval: 1m
disk-space: 50M