VLAG Commands
vlag-create
To create a new virtual link aggregation group (VLAG), use this command.
Informational Note: Before you configure VLAGs, you must have two switches in a cluster configuration. One switch is the local switch used to specify the local port and the other is a peer switch used to specify the peer port.
A switch can only participate in one cluster.
Syntax vlag-create name
name name-string |
Specify the name of the VLAG. |
port vlag-usable-port |
Specify the local VLAG port. |
peer-port vlag-usable-port |
Specify the peer VLAG port. |
mode active-standby| |
Specify the mode for the VLAG. Active-standby indicates one side is active and the other is in standby mode. (Not Supported) Active-Active indicates that both sides of the VLAG are up by default. |
peer-switch fabric-node-name |
Specify the fabric name of the peer switch. |
peer-port port-number |
Specify the port number on the peer switch. |
failover-move-L2| |
Specify the failover action as move or ignore. |
lacp-mode off|passive|active |
Specify the LACP mode. |
lacp-timeout slow|fast |
Specify the LACP timeout as slow (30 seconds) or fast (4 seconds). |
lacp-fallback bundle|individual |
Specify the LACP fallback mode as bundle or individual. |
lacp-fallback-timeout seconds |
Specify the LACP fallback timeout between 30 and 60 seconds. The default value is 50 seconds. |
lacp-port-priority number |
Specify the LACP port priority as a value between 1 and 65535. |
Defaults None.
Access CLI
History
Version 1.2 |
Command introduced. |
Version 2.1 |
The parameters for failover and LACP added. |
Version 2.2 |
The parameters for mode lacp-mode, active-standby and active-active added. Local-port changed to port. |
Version 2.2.6 |
The parameter, port, deprecated. The parameters, port vlag-usable-port name, and peer-port vlag-usable-port name added. |
Version 2.4.0 |
The parameters, lacp-fallback and lacp-fallback-timeout, added. |
Version 2.5.0 |
The parameter, lacp-port-priority, added. |
Usage A virtual link aggregation group (VLAG) allows links that are physically connected to two different Pluribus Networks devices to appear as a single trunk to a third device. The third device can be a switch, server, or any Ethernet device. A VLAG can provide Layer 2 multipathing, which allows you to create redundancy by increasing bandwidth, enabling multiple parallel paths between nodes and loadbalancing traffic where alternative paths exist. This command creates a new VLAG.
Examples This example shows how to create a VLAG with identifier 1 to aggregate the links connected to port 1 of both the local and peer switch.
CLI network-admin@switch > vlag-create id 1 port 1 peer-switch a1634:b peer-port 1
vlag-delete
This command deletes an existing VLAG from the configuration.
Syntax vlag-delete name name-string
name name-string |
Specify the VLAG name. |
Defaults None.
Access CLI
History Command introduced in nvOS Version 1.2.1.
Usage A virtual link aggregation group (VLAG) allows links that are physically connected to two different Pluribus Networks devices to appear as a single trunk to a third device. The third device can be a switch, server, or any Ethernet device. A VLAG can provide Layer 2 multipathing, which allows you to create redundancy by increasing bandwidth, enabling multiple parallel paths between nodes and loadbalancing traffic where alternative paths exist. This command deletes a VLAG.
Examples To delete a VLAG with the identifier, 34, use the following command:
CLI network-admin@switch > vlag-delete 34
vlag-modify
To modify an existing virtual link aggregation group (VLAG), use this command.
Syntax vlag-modify
name name-string |
Specify the name of the VLAG. |
port vlag-usable-port |
Specify the local VLAG port. |
peer-port vlag-usable-port |
Specify the peer VLAG port. |
mode active-standby| |
Specify the mode for the VLAG. Active-standby indicates one side is active and the other is in standby mode. (Not Supported) Active-Active indicates that both sides of the VLAG are up by default. |
peer-switch fabric-node-name |
Specify the fabric name of the peer switch. |
peer-port port-number |
Specify the port number on the peer switch. |
failover-move-L2| |
Specify the failover action as move or ignore. |
lacp-mode off|passive|active |
Specify the LACP mode. |
lacp-timeout slow|fast |
Specify the LACP timeout as slow (30 seconds) or fast (4 seconds). |
lacp-fallback bundle|individual |
Specify the LACP fallback mode as bundle or individual. |
lacp-fallback-timeout seconds |
Specify the LACP fallback timeout between 30 and 60 seconds. The default value is 50 seconds. |
lacp-port-priority number |
Specify the LACP port priority as a value between 1 and 65535. |
Defaults None.
Access CLI
History
Version 1.2 |
Command introduced. |
Version 2.1 |
The parameters for failover and LACP added. |
Version 2.2 |
The parameters for mode lacp-mode, active-standby and active-active added. Local-port changed to port. |
Version 2.2.6 |
The parameter, port, deprecated. The parameters, port vlag-usable-port name, and peer-port vlag-usable-port name added. |
Version 2.4.0 |
The parameters, lacp-fallback and lacp-fallback-timeout, added. |
Version 2.5.0 |
The parameter, lacp-port-priority, added. |
Usage A virtual link aggregation group (VLAG) allows links that are physically connected to two different Pluribus Networks devices to appear as a single trunk to a third device. The third device can be a switch, server, or any Ethernet device. A VLAG can provide Layer 2 multipathing, which allows you to create redundancy by increasing bandwidth, enabling multiple parallel paths between nodes and loadbalancing traffic where alternative paths exist. This command modifies an existing VLAG configuration.
Examples This example shows how to modify a VLAG named spine1-vlag to lacp-timeout fast.
CLI network-admin@switch > vlag-modify name spine1-vlag lacp-timeout fast
vlag-show
This command displays current VLAG configurations on the fabric.
Syntax vlag-show
id vlag-id |
Specifies the VLAG identifier. |
name name-string |
Specifies the name of the VLAG. |
cluster |
Specifies the name of the cluster. |
mode active-standby| |
Specifies the mode for the VLAG. Active-standby indicates one side is active and the other is in standby mode. Active-Active indicates that both sides of the VLAG are up by default. |
failover-move-L2|failover-ignore-L2 |
Specifies the behavior in the event of a failover. |
status |
Specifies the status of the VLAG. |
local-state enabled|up|coming-up |
Specifies the local state of the VLAG. |
peer-state enabled|up|coming-up |
Specifies the peer state of the VLAG. |
lacp-mode off|passive|active |
Specifies the LACP mode. |
lacp-timeout slow|fast |
Specifies the LACP timeout. |
lacp-key lacp-key-number |
Specifies the generated LACP key. |
lacp-system-id lacp-system-id-number |
Specifies the LACP system ID. |
lacp-fallback bundle|individual |
Specifies the LACP fallback mode as bundle or individual. |
lacp-fallback-timeout seconds |
Specifies the LACP fallback timeout between 30 and 60 seconds. The default value is 50 seconds. |
lacp-individual port-list |
Specifies the LACP ports operating individually. |
lacp-port-priority number |
Specify the LACP port priority as a value between 1 and 65535. |
Defaults None.
Access CLI
History
Version 1.2 |
Command introduced. |
Version 2.1 |
The parameters for failover and LACP added. |
Version 2.2 |
The parameters for mode lacp-mode, active-standby and active-active added. Local-port changed to port. |
Version 2.2.6 |
The parameter, port, deprecated. The parameters, port vlag-usable-port name, and peer-port vlag-usable-port name added. |
Version 2.4.0 |
The parameters, lacp-fallback and lacp-fallback-timeout, added. |
Version 2.5.0 |
The parameter, lacp-port-priority, added. |
Usage A virtual link aggregation group (VLAG) allows links that are physically connected to two different Pluribus Networks devices to appear as a single trunk to a third device. The third device can be a switch, server, or any Ethernet device. A VLAG can provide Layer 2 multi-pathing, which allows you to create redundancy by increasing bandwidth, enabling multiple parallel paths between nodes and load-balancing traffic where alternative paths exist.
Examples To display all VLAGs, use the following command:
CLI network-admin@switch > vlag-show format all layout vertical
id: a000030:0
name: fh2
cluster: pubdev
mode: active-active
switch: pubdev01
port: 55
peer-switch: pubdev02
peer-port: 55
failover-move-L2: no
status: normal
local-state: enabled
lacp-mode: off
lacp-timeout: slow
lacp-key: 13811
lacp-system-id: 110013777969294
vlag-stats-clear
This command is used to clear collected statistics from a VLAG configuration.
Syntax vlag-stats-clear
time date/time: yyyy-mm-ddTHH:mm:ss |
Display by date and time. |
start-time date/time: yyyy-mm-ddTHH:mm:s |
Display by start date and time. |
end-time date/time: yyyy-mm-ddTHH:mm:ss |
Display by end date and time. |
duration duration: #d#h#m#s |
Display by duration. |
interval duration: #d#h#m#s |
Display by interval. |
since-start |
Specify a start time for the statistics. |
older-than duration: #d#h#m#s |
Display statistics older than a specific date. |
within-last duration: #d#h#m#s |
Display statistics within a specific duration. |
tunnel-name tunnel-name |
Display by tunnel name. |
counter counter-number |
Displays the number of counters. |
ibytes ibytes-number |
Displays the number of incoming bytes. |
ibits ibits-number |
Displays the number of incoming bits. |
iUpkts iUpkts-number |
Displays the number of incoming Unicast packets. |
iBpkts iBpkts-number |
Displays the number of incoming Broadcast packets. |
iMpkts iMpkts-number |
Displays the number of incoming Multicast packets. |
iPauseFs |
Displays the number of incoming Pause frames. |
iCongDrops iCongDrops-number |
Displays the number of incoming packets dropped due to congestion. |
ierrs errs-number |
Displays the number of incoming packets with errors. |
obytes obytes-number |
Displays the number of outgoing bytes. |
obits obits-number |
Displays the number of outgoing bits. |
oUpkts oUpkts-number |
Displays the number of outgoing Unicast packets. |
oBpkts oBpkts-number |
Displays the number of outgoing Broadcast packets. |
oMpkts oMpkts-number |
Displays the number of outgoing Multicast packets. |
oPauseFs |
Displays the number of outgoing Pause frames. |
oCongDrops oCongDrops-number |
Displays the number of outgoing packets dropped due to congestion. |
oerrs oerrs-number |
Displays the number of outgoing packets with errors. |
mtu-errs mtu-errs-number |
Displays the number of MTU errors. |
HER-pkts HER-pkts-number |
Displays the number of head-end replicated packets. |
HER-bytes HER-bytes-number |
Displays the number of head-end replicated bytes. |
Defaults None
Access Network Administrator
History Command introduced in Version 2.6.0.
Usage Use this command to clear statistics about a VLAG configuration.
Examples To clear statistics for a VLAG configuration, use the following syntax:
CLI network-admin@switch > vlag-stats-clear
vlag-stats-show
This command is used to display information about VLAG statistics.
Syntax vlag-stats-show
Specify any of the following options: |
|
time date/time: yyyy-mm-ddThh:mm:ss |
Specifies a time for the packet count statistics using the timestamp format YYYY-MM-DDTHH:MM:SS, where: • YYYY specifies the 4 digit calendar year; • MM specifies the 2 digit month of the year; • DD specifies the 2 digit day of the month; • HH specifies the 2 digit time of the day (24H notation); • MM specifies the 2 digit minute of the hour; SS specifies the 2 digit second of the minute |
start-time start-time |
Specifies a start time for the packet count statistics using the timestamp format YYYY-MM-DDTHH:MM:SS, where: • YYYY specifies the 4 digit calendar year; • MM specifies the 2 digit month of the year; • DD specifies the 2 digit day of the month; • HH specifies the 2 digit time of the day (24H notation); • MM specifies the 2 digit minute of the hour; • SS specifies the 2 digit second of the minute. |
end-time end-time |
Specifies an end time for the packet count statistics using the timestamp format YYYY-MM-DDTHH:MM:SS, where: • YYYY specifies the 4 digit calendar year; • MM specifies the 2 digit month of the year; • DD specifies the 2 digit day of the month; • HH specifies the 2 digit time of the day (24H notation); • MM specifies the 2 digit minute of the hour; • SS specifies the 2 digit second of the minute. |
duration duration |
Specifies the duration in seconds. |
interval duration: #d#h#m#s |
Specifies the interval between statistics collection. |
since-start| |
Specifies if the statistics are collected from the start of collecting statistics. |
older-than duration: #d#h#m#s |
Specifies if the statistics are older than the duration in days, hours, minutes, and seconds. |
within-last duration: #d#h#m#s |
Specifies if the statistics are within the duration in days, hours, minutes, and seconds. |
vlag_name name-string |
Specifies the name of the VLAG. |
port port-list |
Specifies one or more switch network data port numbers. The port number must be in the range of 1 to 64. Multiple ports can be specified as a comma-separated list of numbers or a range (-). |
counter counter-number |
Specifies the counter number. |
ibytes ibytes-number |
Specifies the incoming number of bytes. |
ibits ibits-number |
Displays the number of incoming bits. |
iUpkts iUpkts-number |
Specifies the number of incoming unicast packets. |
iBpkts iBpkts-number |
Specifies the number of incoming broadcast packets. |
iMpkts iMpkts-number |
Specifies the number of incoming multicast packets. |
iPauseFs iPauseFs-number |
Specifies the number of incoming pause frames. |
iCongDrops iCongDrops-number |
Specifies the number of incoming packets dropped due to congestion. |
idiscards idiscards-number |
Specifies the number of incoming packets discarded. |
ierrs ierrs-number |
Specifies the number of incoming errors. |
obytes obytes-number |
Specifies the number of outgoing bytes. |
obits obits-number |
Displays the number of outgoing bits. |
oUpkts oUpkts-number |
Specifies the number of outgoing unicast packets. |
oBpkts oBpkts-number |
Specifies the number of outgoing broadcast packets. |
oMpkts oMpkts-number |
Specifies the number of outgoing multicast packets. |
oPauseFs oPauseFs-number |
Specifies the number of outgoing pause frames. |
oCongDrops oCongDrops-number |
Specifies the number of outgoing packets dropped due to congestion. |
odiscards odiscards-number |
Specifies the number of outgoing discarded packets. |
oerrs oerrs-number |
Specifies the number of outgoing errors. |
mtu-errs mtu-errs-number |
Specifies the number of MTU errors. |
HER-packets HER-pts-number |
Specifies the number of Head End Replicated (HER) packets. |
HER-bytes HER-bytes-number |
Specifies the number of Head End Replicated (HER) bytes. |
Defaults None
Access Network Administrator
History Command introduced in Version 2.6.0.
Usage Use this command to display statistics about a VLAG configuration.
Examples To display statistics for a VLAG configuration, use the following syntax:
CLI network-admin@switch > vlag-stats-show