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|
active-active

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|
failover-ignore-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|
active-active

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|
failover-ignore-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
cluster-name

Specifies the name of the cluster.

mode active-standby|
active-active

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
peer-down|normal

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
iPauseFs-number

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
oPauseFs-number

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|
no-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