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
[lag-name] lag-interface
| Synopsis | LAG name | |
| Context | configure lag lag-interface | |
| Tree | lag | |
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 length | 1 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. | |
| Introduced | 25.3.R2 | |
Platforms | SAR Gen 2 |
access
adapt-qos
include-egr-hash-cfg boolean
| Synopsis | Factor egress hashing into buffer and rate distribution | |
| Context | configure lag lag-interface access adapt-qos include-egr-hash-cfg boolean | |
| Tree | include-egr-hash-cfg | |
Default | false | |
| Introduced | 25.3.R2 | |
Platforms | SAR Gen 2 |
mode keyword
bandwidth number
booking-factor number
| Synopsis | Booking factor against the administrative bandwidth | |
| Context | configure lag lag-interface access booking-factor number | |
| Tree | booking-factor | |
| Range | 1 to 1000 | |
Default | 100 | |
| Introduced | 25.3.R2 | |
|
Platforms | SAR Gen 2 |
admin-state keyword
| Synopsis | Administrative state of the LAG | |
| Context | configure lag lag-interface admin-state keyword | |
| Tree | admin-state | |
| Options | ||
|
Default | disable | |
| Introduced | 25.3.R2 | |
Platforms |
SAR Gen 2 |
bandwidth-threshold
| Synopsis | Enter the bandwidth-threshold context | |
| Context | configure lag lag-interface bandwidth-threshold | |
| Tree | bandwidth-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. | |
| Introduced | 26.7.R1 | |
Platforms | SAR Gen 2 |
action keyword
| Synopsis | Action to be taken when LAG operational state changes | |
| Context | configure lag lag-interface bandwidth-threshold action keyword | |
| Tree | action | |
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 | |
| Introduced | 26.7.R1 | |
Platforms | SAR Gen 2 |
cost number
| Synopsis | Static cost of the LAG | |
| Context | configure lag lag-interface bandwidth-threshold cost number | |
| Tree | cost | |
Description | This command specifies the decimal integer static cost of the LAG. | |
| Range | 1 to 16777215 | |
| Introduced | 26.7.R1 | |
Platforms | SAR Gen 2 |
value number
| Synopsis | Integer bandwidth threshold value | |
| Context | configure lag lag-interface bandwidth-threshold value number | |
| Tree | value | |
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. | |
| Range | 1 to 100 | |
| Introduced | 26.7.R1 | |
|
Platforms | SAR Gen 2 |
description very-long-description
| Synopsis | Text description | |
| Context | configure lag lag-interface description very-long-description | |
| Tree | description | |
| String length | 1 to 255 | |
| String format | 'string-not-all-spaces' must contain at least one non-space character | |
| Introduced | 25.3.R2 | |
Platforms | SAR Gen 2 |
dynamic-cost boolean
| Synopsis | Allow LAG costing using operational aggregate bandwidth | |
| Context | configure lag lag-interface dynamic-cost boolean | |
| Tree | dynamic-cost | |
Default | false | |
| Introduced | 25.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. | ||
| Synopsis | Encapsulation type | |
| Context | configure lag lag-interface encap-type keyword | |
| Tree | encap-type | |
| Options | ||
| Introduced | 25.3.R2 | |
Platforms | SAR Gen 2 | |
hash-weight-threshold
| Synopsis | Enter the hash-weight-threshold context | |
| Context | configure lag lag-interface hash-weight-threshold | |
| Tree | hash-weight-threshold | |
| Introduced | 25.3.R2 | |
Platforms | SAR Gen 2 |
action keyword
| Synopsis | Action when the sum of the hash weight is not exceeded | |
| Context | configure lag lag-interface hash-weight-threshold action keyword | |
| Tree | action | |
| Options | ||
Default | down | |
| Introduced | 25.3.R2 | |
Platforms | SAR Gen 2 |
cost number
| Synopsis | Static cost of the LAG | |
| Context | configure lag lag-interface hash-weight-threshold cost number | |
| Tree | cost | |
| Range | 1 to 16777215 | |
| Introduced | 25.3.R2 | |
Platforms | SAR Gen 2 |
value number
| Synopsis | Sum of the hash weight values of all active LAG ports | |
| Context | configure lag lag-interface hash-weight-threshold value number | |
| Tree | value | |
| Range | 1 to 6400000 | |
| Introduced | 25.3.R2 | |
Platforms | SAR Gen 2 |
hold-time-down number
| Synopsis | Delay time for reporting the LAG is down | |
| Context | configure lag lag-interface hold-time-down number | |
| Tree | hold-time-down | |
| Range | 1 to 2000 | |
| Units | deciseconds | |
| Introduced | 25.3.R2 | |
Platforms |
SAR Gen 2 |
lacp
administrative-key number
| Synopsis | Key to identify the channel group on each LACP port | |
| Context | configure lag lag-interface lacp administrative-key number | |
| Tree | administrative-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. | |
| Range | 1 to 65535 | |
Notes | This element is mandatory. | |
| Introduced | 25.3.R2 | |
Platforms | SAR Gen 2 |
fallback
| Synopsis | Enable the fallback context | |
| Context | configure lag lag-interface lacp fallback | |
| Tree | fallback | |
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. | |
| Introduced | 25.3.R2 | |
Platforms | SAR Gen 2 |
mode keyword
| Synopsis | LACP fallback mode | |
| Context | configure lag lag-interface lacp fallback mode keyword | |
| Tree | mode | |
Description | This command configures the LACP fallback mode. The static mode enables a single member to forward traffic during fallback. | |
| Options | ||
Notes | This element is mandatory. | |
| Introduced | 25.3.R2 | |
Platforms | SAR Gen 2 |
timeout number
| Synopsis | LACP fallback timeout interval | |
| Context | configure lag lag-interface lacp fallback timeout number | |
| Tree | timeout | |
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. | |
| Range | 4 to 3600 | |
| Units | seconds | |
Default |
4 | |
| Introduced | 25.3.R2 | |
Platforms | SAR Gen 2 |
mode keyword
system-id mac-address
system-priority number
| Synopsis | System priority value | |
| Context | configure lag lag-interface lacp system-priority number | |
| Tree | system-priority | |
| Range | 0 to 65535 | |
| Introduced | 25.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. | ||
| Synopsis | MUX machine control for LACP LAG in active/passive mode | |
| Context | configure lag lag-interface lacp-mux-control keyword | |
| Tree | lacp-mux-control | |
| Options | ||
|
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 | |
| Tree | lacp-xmit-interval | |
| Options | ||
Default |
fast | |
| Introduced | 25.3.R2 | |
Platforms | SAR Gen 2 |
lacp-xmit-stdby boolean
| Synopsis | Allow LACP message transmission on standby links | |
| Context | configure lag lag-interface lacp-xmit-stdby boolean | |
| Tree | lacp-xmit-stdby | |
Default | true | |
| Introduced | 25.3.R2 | |
Platforms | SAR Gen 2 |
lldp-member-template
| Synopsis | Enter the lldp-member-template context | |
| Context | configure lag lag-interface lldp-member-template | |
| Tree | lldp-member-template | |
| Introduced | 25.3.R2 | |
Platforms | SAR Gen 2 |
dest-mac [mac-type] keyword
| Synopsis | Enter the dest-mac list instance | |
| Context | configure lag lag-interface lldp-member-template dest-mac keyword | |
| Tree | dest-mac | |
| Introduced | 25.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 | |
| Tree | dest-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. | |
| Introduced | 25.3.R2 | |
Platforms | SAR Gen 2 |
notification boolean
| Synopsis | Enable LLDP notifications | |
| Context | configure lag lag-interface lldp-member-template dest-mac keyword notification boolean | |
| Tree | notification | |
Default | false | |
| Introduced | 25.3.R2 | |
Platforms | SAR Gen 2 |
port-id-subtype keyword
| Synopsis | Encoding of the Port ID TLV transmitted to the peer | |
| Context | configure lag lag-interface lldp-member-template dest-mac keyword port-id-subtype keyword | |
| Tree | port-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 | |
| Introduced | 25.3.R2 | |
Platforms | SAR Gen 2 |
receive boolean
| Synopsis | Enable LLDP received frame handling | |
| Context | configure lag lag-interface lldp-member-template dest-mac keyword receive boolean | |
| Tree | receive | |
Default | false | |
| Introduced | 25.3.R2 | |
Platforms | SAR Gen 2 |
transmit boolean
| Synopsis | Enable LLDP transmitted frame handling | |
| Context | configure lag lag-interface lldp-member-template dest-mac keyword transmit boolean | |
| Tree | transmit | |
Default | false | |
| Introduced | 25.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 | |
| Tree | tunnel-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 | |
| Introduced | 25.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 | |
| Tree | tunnel-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 | |
| Introduced | 25.3.R2 | |
Platforms | SAR Gen 2 |
tunnel-nearest-non-tpmr boolean
| Synopsis | Enable the nearest non-TPMR tunneling | |
| Context | configure lag lag-interface lldp-member-template dest-mac keyword tunnel-nearest-non-tpmr boolean | |
| Tree | tunnel-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 | |
| Introduced | 25.3.R2 | |
Platforms | SAR Gen 2 |
tx-mgmt-address [mgmt-address-system-type] keyword
| Synopsis | Enter the tx-mgmt-address list instance | |
| Context | configure lag lag-interface lldp-member-template dest-mac keyword tx-mgmt-address keyword | |
| Tree | tx-mgmt-address | |
| Introduced | 25.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 | |
| Tree | tx-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:
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. | |
| Introduced | 25.3.R2 | |
Platforms | SAR Gen 2 |
admin-state keyword
| Synopsis | Administrative state of management address transmission | |
| Context | configure lag lag-interface lldp-member-template dest-mac keyword tx-mgmt-address keyword admin-state keyword | |
| Tree | admin-state | |
| Options | ||
|
Default | disable | |
| Introduced | 25.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 | |
| Tree | tx-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. | |
| Introduced | 25.3.R2 | |
Platforms | SAR Gen 2 |
port-desc boolean
sys-cap boolean
sys-desc boolean
sys-name boolean
mac-address mac-address
| Synopsis | MAC address of the LAG | |
| Context | configure lag lag-interface mac-address mac-address | |
| Tree | mac-address | |
Default | 00:00:00:00:00:00 | |
| Introduced | 25.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. | ||
| Synopsis | Maximum number of ports allowed in the LAG | |
| Context | configure lag lag-interface max-ports number | |
| Tree | max-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. | |
| Range | 32 | 64 | |
| Introduced | 25.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. | ||
| Synopsis | Operation mode of the LAG | |
| Context | configure lag lag-interface mode keyword | |
| Tree | mode | |
| Options | ||
Default | network | |
| Introduced | 25.3.R2 | |
Platforms | SAR Gen 2 | |
monitor-oper-group reference
| Synopsis | Operational group to monitor | |
| Context | configure lag lag-interface monitor-oper-group reference | |
| Tree | monitor-oper-group | |
Reference | configure service oper-group named-item | |
| Introduced | 25.3.R2 | |
Platforms | SAR Gen 2 |
port [port-id] reference
[port-id] reference
hash-weight (number | keyword)
| Synopsis | Flow hashing distribution between LAG ports | |
| Context | configure lag lag-interface port reference hash-weight (number | keyword) | |
| Tree | hash-weight | |
| Range | 1 to 100000 | |
| Options | ||
| Introduced | 25.3.R2 | |
Platforms | SAR Gen 2 |
priority number
sub-group (number | keyword)
|
Warning: Modifying this element recreates the parent element automatically for the new value to take effect. | ||
| Synopsis | Subgroup of the port in the LAG | |
| Context | configure lag lag-interface port reference sub-group (number | keyword) | |
| Tree | sub-group | |
| Range | 1 to 8 | |
| Options | ||
Default | 1 | |
| Introduced | 25.3.R2 | |
Platforms | SAR Gen 2 | |
port-threshold
| Synopsis | Enter the port-threshold context | |
| Context | configure lag lag-interface port-threshold | |
| Tree | port-threshold | |
| Introduced | 25.3.R2 | |
Platforms | SAR Gen 2 |
action keyword
| Synopsis | Action when the active links are at or below threshold | |
| Context | configure lag lag-interface port-threshold action keyword | |
| Tree | action | |
| Options | ||
Default | down | |
| Introduced | 25.3.R2 | |
Platforms | SAR Gen 2 |
cost number
| Synopsis | Static cost of the LAG | |
| Context | configure lag lag-interface port-threshold cost number | |
| Tree | cost | |
| Range | 1 to 16777215 | |
| Introduced | 25.3.R2 | |
Platforms | SAR Gen 2 |
value number
| Synopsis | Active link threshold at which action is taken | |
| Context | configure lag lag-interface port-threshold value number | |
| Tree | value | |
| Range | 0 to 63 | |
| Introduced | 25.3.R2 | |
|
Platforms | SAR Gen 2 |
port-type keyword
ptp-timestamping
| Synopsis | Enable the ptp-timestamping context | |
| Context | configure lag lag-interface ptp-timestamping | |
| Tree | ptp-timestamping | |
Description | Commands in this context configure LAG filtering for the 1588 timestamping of PTP messages to match multiple PTP flows. | |
| Introduced | 26.3.R1 | |
Platforms | 7705 SAR-Hx, 7705 SAR-Mx |
admin-state keyword
| Synopsis | Administrative state of PTP timestamping | |
| Context | configure lag lag-interface ptp-timestamping admin-state keyword | |
| Tree | admin-state | |
| Options | ||
|
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 | |
| Context | configure lag lag-interface ptp-timestamping ipv4-address ipv4-address | |
| Tree | ipv4-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) | |
| Introduced | 26.3.R1 | |
Platforms | 7705 SAR-Hx, 7705 SAR-Mx |
ipv6-address ipv6-address
| Synopsis | IPv6 destination address for PTP messages into port | |
| Context | configure lag lag-interface ptp-timestamping ipv6-address ipv6-address | |
| Tree | ipv6-address | |
| Introduced | 26.3.R1 | |
Platforms | 7705 SAR-Hx, 7705 SAR-Mx |
selection-criteria
| Synopsis | Enter the selection-criteria context | |
| Context | configure lag lag-interface selection-criteria | |
| Tree | selection-criteria | |
| Introduced | 25.3.R2 | |
Platforms | SAR Gen 2 |
mode keyword
| Synopsis | Criteria to select the active subgroup | |
| Context | configure lag lag-interface selection-criteria mode keyword | |
| Tree | mode | |
| Options | ||
Default | highest-count | |
| Introduced | 25.3.R2 | |
Platforms | SAR Gen 2 |
slave-to-partner boolean
| Synopsis | Use slave-to-partner for selection criteria | |
| Context | configure lag lag-interface selection-criteria slave-to-partner boolean | |
| Tree | slave-to-partner | |
Default | false | |
| Introduced | 25.3.R2 | |
Platforms | SAR Gen 2 |
subgroup-hold-time (number | keyword)
| Synopsis | Delay time when switching to a new active subgroup | |
| Context | configure lag lag-interface selection-criteria subgroup-hold-time (number | keyword) | |
| Tree | subgroup-hold-time | |
| Range | 0 to 2000 | |
| Units | deciseconds | |
| Options | ||
Default | 0 | |
| Introduced | 25.3.R2 | |
|
Platforms | SAR Gen 2 |
standby-signaling keyword
| Synopsis | Way of signaling a member port to the remote side | |
| Context | configure lag lag-interface standby-signaling keyword | |
| Tree | standby-signaling | |
| Options | ||
|
Default | lacp | |
| Introduced | 25.3.R2 | |
Platforms |
SAR Gen 2 |