lag commands

configure 
lag lag-interface 
access 
adapt-qos 
include-egr-hash-cfg boolean
mode keyword
bandwidth number
booking-factor number
admin-state keyword
apply-groups reference
apply-groups-exclude reference
bandwidth-threshold 
action keyword
cost number
value number
description very-long-description
dynamic-cost boolean
encap-type keyword
hash-weight-threshold 
action keyword
cost number
value number
hold-time-down number
lacp 
administrative-key number
fallback 
mode keyword
timeout number
mode keyword
system-id mac-address
system-priority number
lacp-mux-control keyword
lacp-xmit-interval keyword
lacp-xmit-stdby boolean
lldp-member-template 
dest-mac keyword 
apply-groups reference
apply-groups-exclude reference
notification boolean
port-id-subtype keyword
receive boolean
transmit boolean
tunnel-nearest-bridge boolean
tunnel-nearest-customer boolean
tunnel-nearest-non-tpmr boolean
tx-mgmt-address keyword 
admin-state keyword
apply-groups reference
apply-groups-exclude reference
tx-tlvs 
port-desc boolean
sys-cap boolean
sys-desc boolean
sys-name boolean
mac-address mac-address
max-ports number
mode keyword
monitor-oper-group reference
port reference 
apply-groups reference
apply-groups-exclude reference
hash-weight (number | keyword)
priority number
sub-group (number | keyword)
port-threshold 
action keyword
cost number
value number
port-type keyword
ptp-timestamping 
admin-state keyword
apply-groups reference
apply-groups-exclude reference
ipv4-address ipv4-address
ipv6-address ipv6-address
selection-criteria 
mode keyword
slave-to-partner boolean
subgroup-hold-time (number | keyword)
standby-signaling keyword

lag command descriptions

lag [lag-name] lag-interface

Synopsis Enter the lag list instance
Context configure lag lag-interface
Treelag

Description

Commands in this context configure the Link Aggregation Group (LAG) attributes.

Introduced25.3.R2

Platforms

SAR Gen 2

[lag-name] lag-interface

Synopsis LAG name
Contextconfigure lag lag-interface
Treelag

Description

This command configures a LAG name or ID. The LAG name or ID must start with "lag-" followed by the lag name or ID, for example, lag-newyork-to-boston or lag-700.

String length1 to 27
String format'lag-interface' must be lag- followed by number 1-800 or up to 23 chars (e.g. lag-1 or lag-my-lag)

Notes

This element is part of a list key.

Introduced25.3.R2

Platforms

SAR Gen 2

access

Synopsis Enter the access context
Context configure lag lag-interface access
Treeaccess
Introduced25.3.R2

Platforms

SAR Gen 2

adapt-qos
Synopsis Enter the adapt-qos context
Context configure lag lag-interface access adapt-qos
Treeadapt-qos
Introduced25.3.R2

Platforms

SAR Gen 2

mode keyword
Synopsis QoS adaptation mode
Context configure lag lag-interface access adapt-qos mode keyword
Treemode
Optionslink, distribute, port-fair
Introduced25.3.R2

Platforms

SAR Gen 2

bandwidth number
Synopsis Administrative bandwidth applied to this LAG
Contextconfigure lag lag-interface access bandwidth number
Treebandwidth
Range1 to 6400000000
Unitsbps
Introduced 25.3.R2

Platforms

SAR Gen 2

booking-factor number
Synopsis Booking factor against the administrative bandwidth
Contextconfigure lag lag-interface access booking-factor number
Treebooking-factor
Range1 to 1000

Default

100

Introduced25.3.R2

Platforms

SAR Gen 2

admin-state keyword

Synopsis Administrative state of the LAG
Context configure lag lag-interface admin-state keyword
Treeadmin-state
Optionsenable, disable

Default

disable

Introduced 25.3.R2

Platforms

SAR Gen 2

bandwidth-threshold

Synopsis Enter the bandwidth-threshold context
Contextconfigure lag lag-interface bandwidth-threshold
Treebandwidth-threshold

Description

Commands in this context configure the behavior for the LAG when the number of operational links changes so that the usable bandwidth of the LAG is equal to or below the bandwidth-threshold level.

Introduced26.7.R1

Platforms

SAR Gen 2

action keyword
Synopsis Action to be taken when LAG operational state changes
Contextconfigure lag lag-interface bandwidth-threshold action keyword
Treeaction

Description

This command specifies the action that the system takes if the usable bandwidth of the LAG is at or below the threshold value.

Options

down – Specifies the LAG is brought down at threshold

dynamic-cost – Specifies dynamic costing is activated

static-cost – Specifies static costing is activated

Default

down

Introduced26.7.R1

Platforms

SAR Gen 2

cost number
Synopsis Static cost of the LAG
Context configure lag lag-interface bandwidth-threshold cost number
Treecost

Description

This command specifies the decimal integer static cost of the LAG.

Range1 to 16777215
Introduced26.7.R1

Platforms

SAR Gen 2

value number
Synopsis Integer bandwidth threshold value
Context configure lag lag-interface bandwidth-threshold value number
Treevalue

Description

This command specifies the bandwidth threshold as a percentage of the total bandwidth for the LAG. When the usable bandwidth is equal to or below the threshold, the system invokes the configured action. If the usable bandwidth exceeds the bandwidth threshold, any action taken for being below the threshold value ceases.

Range1 to 100
Introduced26.7.R1

Platforms

SAR Gen 2

description very-long-description

Synopsis Text description
Context configure lag lag-interface description very-long-description
Treedescription
String length1 to 255
String format'string-not-all-spaces' must contain at least one non-space character
Introduced25.3.R2

Platforms

SAR Gen 2

dynamic-cost boolean

Synopsis Allow LAG costing using operational aggregate bandwidth
Contextconfigure lag lag-interface dynamic-cost boolean
Treedynamic-cost

Default

false

Introduced25.3.R2

Platforms

SAR Gen 2

encap-type keyword

Warning:

Modifying this element toggles the admin-state of the parent element automatically for the new value to take effect.

Warning:

Modifying this element recreates the parent element automatically for the new value to take effect.

SynopsisEncapsulation type
Contextconfigure lag lag-interface encap-type keyword
Treeencap-type
Optionsnull, dot1q, qinq
Introduced25.3.R2

Platforms

SAR Gen 2

hash-weight-threshold

Synopsis Enter the hash-weight-threshold context
Contextconfigure lag lag-interface hash-weight-threshold
Treehash-weight-threshold
Introduced25.3.R2

Platforms

SAR Gen 2

action keyword
Synopsis Action when the sum of the hash weight is not exceeded
Contextconfigure lag lag-interface hash-weight-threshold action keyword
Treeaction
Optionsdown, dynamic-cost, static-cost

Default

down

Introduced25.3.R2

Platforms

SAR Gen 2

cost number
Synopsis Static cost of the LAG
Context configure lag lag-interface hash-weight-threshold cost number
Treecost
Range1 to 16777215
Introduced25.3.R2

Platforms

SAR Gen 2

value number
Synopsis Sum of the hash weight values of all active LAG ports
Contextconfigure lag lag-interface hash-weight-threshold value number
Treevalue
Range1 to 6400000
Introduced25.3.R2

Platforms

SAR Gen 2

hold-time-down number

Synopsis Delay time for reporting the LAG is down
Contextconfigure lag lag-interface hold-time-down number
Treehold-time-down
Range1 to 2000
Unitsdeciseconds
Introduced 25.3.R2

Platforms

SAR Gen 2

lacp

Synopsis Enable the lacp context
Context configure lag lag-interface lacp
Treelacp
Introduced25.3.R2

Platforms

SAR Gen 2

administrative-key number
Synopsis Key to identify the channel group on each LACP port
Contextconfigure lag lag-interface lacp administrative-key number
Treeadministrative-key

Description

This command configures the administrative key that identifies the channel group on each port configured to use LACP.

In an MC-LAG configuration, both redundant nodes must be configured with the same key values. In any other case, the key is only locally significant.

Range1 to 65535

Notes

This element is mandatory.

Introduced25.3.R2

Platforms

SAR Gen 2

fallback
Synopsis Enable the fallback context
Context configure lag lag-interface lacp fallback
Treefallback

Description

Commands in this context enable LACP fallback. LACP fallback allows one or more designated links of an LACP-controlled LAG to go into forwarding mode if LACP is not yet operational after a configured timeout period. Links capable of forwarding traffic assume the Ethernet and IP characteristics configured for the LAG.

Introduced25.3.R2

Platforms

SAR Gen 2

mode keyword
Synopsis LACP fallback mode
Context configure lag lag-interface lacp fallback mode keyword
Treemode

Description

This command configures the LACP fallback mode.

The static mode enables a single member to forward traffic during fallback.

Optionsstatic

Notes

This element is mandatory.

Introduced25.3.R2

Platforms

SAR Gen 2

timeout number
Synopsis LACP fallback timeout interval
Context configure lag lag-interface lacp fallback timeout number
Treetimeout

Description

This command configures the duration after which a link becomes active if no LACP PDUs are received within this timeout period.

Note: The user must first configure this command to a timeout interval of 90 before the configure lag lacp-xmit-interval command can change from fast to slow.

Range4 to 3600
Unitsseconds

Default

4

Introduced25.3.R2

Platforms

SAR Gen 2

mode keyword
Synopsis Mode in which LACP operates
Context configure lag lag-interface lacp mode keyword
Treemode
Optionspassive, active

Default

passive

Introduced 25.3.R2

Platforms

SAR Gen 2

system-id mac-address
Synopsis System ID
Contextconfigure lag lag-interface lacp system-id mac-address
Treesystem-id

Default

00:00:00:00:00:00

Introduced25.3.R2

Platforms

SAR Gen 2

system-priority number
Synopsis System priority value
Context configure lag lag-interface lacp system-priority number
Treesystem-priority
Range0 to 65535
Introduced25.3.R2

Platforms

SAR Gen 2

lacp-mux-control keyword

Warning:

Modifying this element toggles the admin-state of the parent element automatically for the new value to take effect.

SynopsisMUX machine control for LACP LAG in active/passive mode
Contextconfigure lag lag-interface lacp-mux-control keyword
Treelacp-mux-control
Optionscoupled, independent

Default

coupled

Introduced 25.3.R2

Platforms

SAR Gen 2

lacp-xmit-interval keyword

Synopsis Time for periodic transmission
Context configure lag lag-interface lacp-xmit-interval keyword
Treelacp-xmit-interval
Optionsslow, fast

Default

fast

Introduced25.3.R2

Platforms

SAR Gen 2

lacp-xmit-stdby boolean

Synopsis Allow LACP message transmission on standby links
Contextconfigure lag lag-interface lacp-xmit-stdby boolean
Treelacp-xmit-stdby

Default

true

Introduced25.3.R2

Platforms

SAR Gen 2

lldp-member-template

Synopsis Enter the lldp-member-template context
Contextconfigure lag lag-interface lldp-member-template
Treelldp-member-template
Introduced25.3.R2

Platforms

SAR Gen 2

dest-mac [mac-type] keyword
Synopsis Enter the dest-mac list instance
Contextconfigure lag lag-interface lldp-member-template dest-mac keyword
Treedest-mac
Introduced25.3.R2

Platforms

SAR Gen 2

[mac-type] keyword
Synopsis Destination MAC address type
Context configure lag lag-interface lldp-member-template dest-mac keyword
Treedest-mac
Options

nearest-bridge – Use the nearest bridge

nearest-non-tpmr – Use nearest non-Two-Port MAC Relay (TPMR)

nearest-customer – Use the nearest customer

Notes

This element is part of a list key.

Introduced25.3.R2

Platforms

SAR Gen 2

port-id-subtype keyword
Synopsis Encoding of the Port ID TLV transmitted to the peer
Contextconfigure lag lag-interface lldp-member-template dest-mac keyword port-id-subtype keyword
Treeport-id-subtype

Description

This command configures how to encode the Port ID TLV transmitted to the peer. The default setting tx-local (ifindex value) is required by some versions of the NSP NSM-P to properly build the Layer 2 topology map using LLDP. Changing this value to transmit the ifName (tx-if-name) or ifAlias (tx-if-alias) in place of the ifIndex (tx-local) may affect the ability of the NSP NFM-P to build the Layer 2 topology map using LLDP.

Options

tx-if-alias – Transmit the ifAlias String (subtype 1)

tx-if-name – Transmit the ifName string (subtype 5)

tx-local – Transmit the interface ifIndex value (subtype 7)

Default

tx-local

Introduced25.3.R2

Platforms

SAR Gen 2

tunnel-nearest-bridge boolean
Synopsis Enable nearest bridge tunneling
Context configure lag lag-interface lldp-member-template dest-mac keyword tunnel-nearest-bridge boolean
Treetunnel-nearest-bridge

Description

When configured to true, this command enables nearest bridge tunneling.

This command allows LLDP packets received on the port with the destination address of the nearest bridge to be tunneled without being intercepted on the local port. The dest-mac mac-type nearest-bridge must be disabled for tunneling to occur. This is applicable to NULL SAP Epipe and VPLS services only.

When configured to false, nearest bridge tunneling is disabled.

Default

false

Introduced25.3.R2

Platforms

SAR Gen 2

tunnel-nearest-customer boolean
Synopsis Enable nearest customer tunneling
Context configure lag lag-interface lldp-member-template dest-mac keyword tunnel-nearest-customer boolean
Treetunnel-nearest-customer

Description

When configured to true, the system allows LLDP packets received on the port with the destination address of the nearest customer to be tunneled without being intercepted on the local port.

When configured to false, the system disables nearest customer tunneling.

Default

true

Introduced25.3.R2

Platforms

SAR Gen 2

tunnel-nearest-non-tpmr boolean
Synopsis Enable the nearest non-TPMR tunneling
Contextconfigure lag lag-interface lldp-member-template dest-mac keyword tunnel-nearest-non-tpmr boolean
Treetunnel-nearest-non-tpmr

Description

When configured to true, the system allows LLDP packets received on the port with the destination address of the nearest non-TPMR to be tunneled without being intercepted on the local port.

When configured to false, the system disables nearest non-TPMR tunneling.

Default

true

Introduced25.3.R2

Platforms

SAR Gen 2

tx-mgmt-address [mgmt-address-system-type] keyword
Synopsis Enter the tx-mgmt-address list instance
Contextconfigure lag lag-interface lldp-member-template dest-mac keyword tx-mgmt-address keyword
Treetx-mgmt-address
Introduced25.3.R2

Platforms

SAR Gen 2

[mgmt-address-system-type] keyword
Synopsis Management address to transmit
Context configure lag lag-interface lldp-member-template dest-mac keyword tx-mgmt-address keyword
Treetx-mgmt-address

Description

This command configures the management address to transmit. The user can choose to send the following addresses, or any combination of these:

  • system IPv4 address

  • system IPv6 address

  • out-of-band IPv4 address

  • out-of-band IPv6 address

The system address is sent only once. The address must be configured for the specific version of the protocol to send the management address.

Options

oob – Transmit out-of-band IPv4 address for active CPM

system – Transmit the system IP address

system-ipv6 – Transmit the system IPv6 address

oob-ipv6 – Transmit the out-of-band IPv6 address for active CPM

Notes

This element is part of a list key.

Introduced25.3.R2

Platforms

SAR Gen 2

tx-tlvs
Synopsis Enter the tx-tlvs context
Context configure lag lag-interface lldp-member-template dest-mac keyword tx-tlvs
Treetx-tlvs

Description

Commands in this context configure which LLDP TLVs to transmit. The TX TLVs, defined as a bitmap, include the basic set of LLDP TLVs whose transmission is allowed on the local LLDP agent by network management. Each bit in the bitmap corresponds to a TLV type associated with a specific optional TLV. Organizationally-specific TLVs are excluded from this bitmap.

There is no bit reserved for the management address TLV type because transmission of management address TLVs are controlled by another object.

Introduced25.3.R2

Platforms

SAR Gen 2

mac-address mac-address

Synopsis MAC address of the LAG
Context configure lag lag-interface mac-address mac-address
Treemac-address

Default

00:00:00:00:00:00

Introduced25.3.R2

Platforms

SAR Gen 2

max-ports number

Warning:

Modifying this element recreates the parent element automatically for the new value to take effect.

SynopsisMaximum number of ports allowed in the LAG
Contextconfigure lag lag-interface max-ports number
Treemax-ports

Description

This command configures the maximum number of ports allowed in the LAG.

This command must be configured to 64 when the LAG name is a numeric identifier in the range of 1 to 64. If the LAG name is a numeric identifier in the range of 65 to 800, this command must be configured to 32.

Range32 | 64
Introduced25.3.R2

Platforms

SAR Gen 2

mode keyword

Warning:

Modifying this element toggles the admin-state of the parent element automatically for the new value to take effect.

Warning:

Modifying this element recreates the parent element automatically for the new value to take effect.

SynopsisOperation mode of the LAG
Contextconfigure lag lag-interface mode keyword
Treemode
Optionsaccess, network, hybrid

Default

network

Introduced25.3.R2

Platforms

SAR Gen 2

port [port-id] reference

Synopsis Enter the port list instance
Context configure lag lag-interface port reference
Treeport
Introduced25.3.R2

Platforms

SAR Gen 2

[port-id] reference
Synopsis Identifier to uniquely identify the port in the LAG
Contextconfigure lag lag-interface port reference
Treeport

Reference

configure port port

Notes

This element is part of a list key.

Introduced25.3.R2

Platforms

SAR Gen 2

hash-weight (number | keyword)
Synopsis Flow hashing distribution between LAG ports
Contextconfigure lag lag-interface port reference hash-weight (number | keyword)
Treehash-weight
Range1 to 100000
Optionsport-speed
Introduced25.3.R2

Platforms

SAR Gen 2

priority number
Synopsis Priority of the port in the LAG
Context configure lag lag-interface port reference priority number
Treepriority
Range1 to 65535

Default

32768

Introduced25.3.R2

Platforms

SAR Gen 2

sub-group (number | keyword)
Warning:

Modifying this element recreates the parent element automatically for the new value to take effect.

SynopsisSubgroup of the port in the LAG
Contextconfigure lag lag-interface port reference sub-group (number | keyword)
Treesub-group
Range1 to 8
Optionsauto-iom, auto-mda

Default

1

Introduced25.3.R2

Platforms

SAR Gen 2

port-threshold

Synopsis Enter the port-threshold context
Contextconfigure lag lag-interface port-threshold
Treeport-threshold
Introduced25.3.R2

Platforms

SAR Gen 2

action keyword
Synopsis Action when the active links are at or below threshold
Contextconfigure lag lag-interface port-threshold action keyword
Treeaction
Optionsdown, dynamic-cost, static-cost

Default

down

Introduced25.3.R2

Platforms

SAR Gen 2

cost number
Synopsis Static cost of the LAG
Context configure lag lag-interface port-threshold cost number
Treecost
Range1 to 16777215
Introduced25.3.R2

Platforms

SAR Gen 2

value number
Synopsis Active link threshold at which action is taken
Contextconfigure lag lag-interface port-threshold value number
Treevalue
Range0 to 63
Introduced25.3.R2

Platforms

SAR Gen 2

port-type keyword

Synopsis Port type of the LAG
Context configure lag lag-interface port-type keyword
Treeport-type
Optionsstandard, hs

Default

standard

Introduced 25.3.R2

Platforms

SAR Gen 2

ptp-timestamping

Synopsis Enable the ptp-timestamping context
Contextconfigure lag lag-interface ptp-timestamping
Treeptp-timestamping

Description

Commands in this context configure LAG filtering for the 1588 timestamping of PTP messages to match multiple PTP flows.

Introduced26.3.R1

Platforms

7705 SAR-Hx, 7705 SAR-Mx

admin-state keyword
Synopsis Administrative state of PTP timestamping
Contextconfigure lag lag-interface ptp-timestamping admin-state keyword
Treeadmin-state
Optionsenable, disable

Default

disable

Introduced 26.3.R1

Platforms

7705 SAR-Hx, 7705 SAR-Mx

ipv4-address ipv4-address
Synopsis IPv4 destination address for PTP messages into port
Contextconfigure lag lag-interface ptp-timestamping ipv4-address ipv4-address
Treeipv4-address

String format

'ipv4-address' must use only digits and dots (no %zone)

'ipv4-address' must be a.b.c.d with each octet 0-255 (no zone-id)

Introduced26.3.R1

Platforms

7705 SAR-Hx, 7705 SAR-Mx

ipv6-address ipv6-address
Synopsis IPv6 destination address for PTP messages into port
Contextconfigure lag lag-interface ptp-timestamping ipv6-address ipv6-address
Treeipv6-address
Introduced26.3.R1

Platforms

7705 SAR-Hx, 7705 SAR-Mx

selection-criteria

Synopsis Enter the selection-criteria context
Contextconfigure lag lag-interface selection-criteria
Treeselection-criteria
Introduced25.3.R2

Platforms

SAR Gen 2

mode keyword
Synopsis Criteria to select the active subgroup
Contextconfigure lag lag-interface selection-criteria mode keyword
Treemode
Optionshighest-count, highest-weight, best-port

Default

highest-count

Introduced25.3.R2

Platforms

SAR Gen 2

subgroup-hold-time (number | keyword)
Synopsis Delay time when switching to a new active subgroup
Contextconfigure lag lag-interface selection-criteria subgroup-hold-time (number | keyword)
Treesubgroup-hold-time
Range0 to 2000
Unitsdeciseconds
Options infinite

Default

0

Introduced25.3.R2

Platforms

SAR Gen 2

standby-signaling keyword

Synopsis Way of signaling a member port to the remote side
Contextconfigure lag lag-interface standby-signaling keyword
Treestandby-signaling
Optionslacp, power-off

Default

lacp

Introduced 25.3.R2

Platforms

SAR Gen 2