card commands

configure 
card number 
admin-state keyword
apply-groups reference
apply-groups-exclude reference
card-type keyword
fail-on-error boolean
filter-profile keyword
fp number 
apply-groups reference
apply-groups-exclude reference
egress 
hs-fixed-high-thresh-delta number
hs-pool-policy reference
wred-queue-control 
admin-state keyword
buffer-allocation decimal-number
reserved-cbs decimal-number
slope-policy reference
fp-resource-policy reference
hi-bw-mcast-src 
alarm boolean
default-paths-only boolean
group number
ingress 
access 
queue-group reference instance-id number 
accounting-policy reference
apply-groups reference
apply-groups-exclude reference
collect-stats boolean
description string
policer-control-policy 
overrides 
apply-groups reference
apply-groups-exclude reference
max-rate (number | keyword)
priority-mbs-thresholds 
min-threshold-separation (number | keyword)
priority number 
apply-groups reference
apply-groups-exclude reference
mbs-contribution (number | keyword)
policy-name reference
policer-overrides 
policer reference 
apply-groups reference
apply-groups-exclude reference
cbs (number | keyword)
mbs (number | keyword)
packet-byte-offset number
rate 
cir (number | keyword)
pir (number | keyword)
stat-mode keyword
dist-cpu-protection 
dynamic-enforcement-policer-pool number
mcast-path-management 
admin-state keyword
bandwidth-policy reference
network 
pool string 
amber-alarm-threshold number
apply-groups reference
apply-groups-exclude reference
red-alarm-threshold number
resv-cbs 
amber-alarm-action 
max number
step number
cbs number
slope-policy reference
queue-group reference instance-id number 
accounting-policy reference
apply-groups reference
apply-groups-exclude reference
collect-stats boolean
description string
policer-control-policy 
overrides 
apply-groups reference
apply-groups-exclude reference
max-rate (number | keyword)
priority-mbs-thresholds 
min-threshold-separation (number | keyword)
priority number 
apply-groups reference
apply-groups-exclude reference
mbs-contribution (number | keyword)
policy-name reference
policer-overrides 
policer reference 
apply-groups reference
apply-groups-exclude reference
cbs (number | keyword)
mbs (number | keyword)
packet-byte-offset number
rate 
cir (number | keyword)
pir (number | keyword)
stat-mode keyword
queue-policy reference
policy-accounting 
classes number
policers number
ingress-buffer-allocation decimal-number
init-extract-prio-mode keyword
stable-pool-sizing boolean
level keyword
mda number 
access 
apply-groups reference
apply-groups-exclude reference
egress 
apply-groups reference
apply-groups-exclude reference
ingress 
apply-groups reference
apply-groups-exclude reference
admin-state keyword
apply-groups reference
apply-groups-exclude reference
egress-xpl 
threshold number
window number
event keyword 
action keyword
apply-groups reference
apply-groups-exclude reference
fail-on-error boolean
ingress-xpl 
threshold number
window number
level keyword
mda-type keyword
network 
apply-groups reference
apply-groups-exclude reference
egress 
apply-groups reference
apply-groups-exclude reference
ingress 
apply-groups reference
apply-groups-exclude reference
power-priority-level number
reset-on-recoverable-error boolean
sync-e keyword
upgrade number 
apply-groups reference
apply-groups-exclude reference
path keyword
xconnect 
mac number 
apply-groups reference
apply-groups-exclude reference
description string
loopback number 
apply-groups reference
apply-groups-exclude reference
bandwidth number
description string
power-save boolean
reset-on-recoverable-error boolean
upgrade number 
apply-groups reference
apply-groups-exclude reference
path keyword
virtual-scheduler-adjustment 
apply-groups reference
apply-groups-exclude reference
internal-scheduler-weight-mode keyword
interval 
rate-calculation-minimum 
fast-queue decimal-number
slow-queue decimal-number
scheduler-run-minimum decimal-number
task-scheduling decimal-number
slow-queue-threshold-rate number
xiom string 
admin-state keyword
apply-groups reference
apply-groups-exclude reference
fail-on-error boolean
level keyword
mda number 
admin-state keyword
apply-groups reference
apply-groups-exclude reference
mda-type keyword
power-priority-level number
sync-e keyword
xconnect 
mac number 
apply-groups reference
apply-groups-exclude reference
description string
loopback number 
apply-groups reference
apply-groups-exclude reference
bandwidth number
description string
reset-on-recoverable-error boolean
upgrade number 
apply-groups reference
apply-groups-exclude reference
path keyword
xiom-type keyword

card command descriptions

card [slot-number] number

Synopsis Enter the card list instance
Context configure card number
Treecard

Description

Commands in this context cover attributes for specific chassis slots for physical cards. Cards include IOM, IMM, and XCM.

In SR OS, cards cover IOM, IMM, and XCM.

Introduced16.0.R1

Platforms

All

[slot-number] number

Synopsis Slot number within the chassis
Context configure card number
Treecard

Description

This command configures a unique value that identifies the card slot within a chassis in the system.

Range1 to 20

Notes

This element is part of a list key.

Introduced16.0.R1

Platforms

All

admin-state keyword

Synopsis Administrative state of the card
Context configure card number admin-state keyword
Treeadmin-state
Defaultenable
Optionsenable, disable
Introduced16.0.R1

Platforms

All

card-type keyword

WARNING:

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

SynopsisCard type
Contextconfigure card number card-type keyword
Treecard-type

Description

This command adds an IOM, IMM, XCM to the device configuration for the slot.

The card type can be pre-provisioned, meaning that the card does not need to be installed in the chassis.

A card must be provisioned before any contained object can be configured: MDA, XIOM, XMA, MDA-s, connector, or port. A card can only be provisioned in a slot if the card type is allowed in the slot. An error message is generated if an attempt is made to provision a card type that is not allowed.

If a card is inserted that does not match the configured card type for the slot, a log event and facility alarm is raised. The alarm is cleared when the correct card type is installed or the configuration is modified. A log event and facility alarm are raised if an administratively enabled card is removed from the chassis. The alarm is cleared when the correct card type is installed or the configuration is modified. A log event is issued when a card is removed that is administratively disabled.

Because IMMs do not have the capability to install separate MDAs, the configuration of the MDAs is automatic. This configuration only includes the default options such as default buffer policies. Commands to manage the MDA remain in the MDA configuration context.

Some card hardware can support two different firmware loads. One load includes the base Ethernet functionality, including 10G WAN mode, but does not include 1588 port-based timestamping. The second load includes the base Ethernet functionality and 1588 port-based timestamping, but does not include 10G WAN mode. These are identified as two card types that are the same, except for a “-ptp” suffix to indicate the second loadset. A hard reset of the card occurs when switching between the two provisioned types.

An appropriate alarm is raised if a partial or complete card failure is detected. The alarm is cleared when the error condition ceases.

Optionsxcm-x20, imm40-10gb-sfp, imm4-100gb-cxp, iom4-e, iom-a, imm-1pac-fp3, imm-2pac-fp3, iom4-e-hs, imm4-100gb-cfp4, iom-e, iom-v, iom4-e-b, iom-sar-hm, xcm2-x20, iom-1, xcm-14s, imm40-10gb-sfp-ptp, iom-ixr-r6, imm36-100g-qsfp28, imm48-sfp+2-qsfp28, iom5-e, xcm-7s, imm48-sfp++6-qsfp28, xcm-1s, xcm-2s, imm24-sfp++8-sfp28+2-qsfp28, iom-sar-hmc, imm14-10g-sfp++4-1g-tx, iom-ixr-r4, imm6-qsfpdd+48-sfp56, imm32-qsfp28+4-qsfpdd, i48-800g-qsfpdd-1x, imm36-qsfpdd, imm4-1g-tx+20-1g-sfp+6-10g-sfp+, iom-ixr-r6d, xcm2-7s, i24-800g-qsfpdd-1, imm36-800g-qsfpdd, xcm2-14s, i48-400g-qsfpdd-1, i80-200g-sfpdd+12-400g-qsfpdd-1, i40-200g-sfpdd+6-800g-qsfpdd-1, i80-200g-sfpdd+12-800g-qsfpdd-1x, xcm-2se, xcm-14s-b, xcm-7s-b
Introduced 16.0.R1

Platforms

All

fail-on-error boolean

Synopsis Set operational state of the card to Failed upon error
Contextconfigure card number fail-on-error boolean
Treefail-on-error

Description

When configured to true, this command controls the behavior of the card when any one of a specific set of card level errors is encountered in the system.

When the this command is set to true, and any one (or more) of the specific errors is detected, the operational state of the card is set to failed. This failed state persists until the clear card command is issued (reset) or the card is removed and reinserted (reseated). If the condition persists after reseating the card, contact Nokia support to investigate more.

Nokia only recommends configuring this command to true when the network is designed to be able to route traffic around a failed card (redundant cards, nodes, or other paths exist).

The list of specific errors includes the following:

CHASSIS event ID# 2063 - tmnxEqCardPChipMemoryEvent

CHASSIS event ID# 2076 - tmnxEqCardPChipCamEvent

CHASSIS event ID# 2059 - tmnxEqCardPChipError (for ingress Ethernet only)

CHASSIS event ID# 2098 - tmnxEqCardQChipBufMemoryEvent

CHASSIS event ID# 2099 - tmnxEqCardQChipStatsMemoryEvent

CHASSIS event ID# 2101 - tmnxEqCardQChipIntMemoryEvent

CHASSIS event ID# 2103 - tmnxEqCardChipIfCellEvent

On platforms with integrated CPM and IOM, IMM, or XCM, the node is rebooted if this command is set to true and one of the card level errors is encountered. The tmnxEqCardPChipError is only considered as a trigger for this command for ingress FCS errors (not egress FCS errors).

Note: On the detection of the event or error in the system, the reporting of the event (logs) and the fail-on-error behavior of the card are independent. Log event control configuration determines whether the events are reported in logs (or SNMP traps, and so on) and the fail-on-error configuration determines the behavior of the card. This implies that the card can be configured to fail-on-error even if the events are suppressed (some may be suppressed in the system by default). To facilitate post-failure analysis, Nokia recommends reporting the specific events or errors and that configure log log-events be enabled when this command is set to true.

Defaultfalse
Introduced16.0.R1

Platforms

All

filter-profile keyword

WARNING:

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

SynopsisFilter profile for the card
Contextconfigure card number filter-profile keyword
Treefilter-profile

Description

This command controls the resources allocated to ingress and egress IPv4 and IPv6 filters on a per-line card basis on the SR-a platform. 

Defaultnone
Optionsnone, profile-a
Introduced19.10.R1

Platforms

7750 SR-a

fp [fp-number] number

Synopsis Enter the fp list instance
Context configure card number fp number
Treefp

Description

Commands in this context configure forwarding plane (FP) specific options on the card.

Introduced16.0.R1

Platforms

All

[fp-number] number
Synopsis Forwarding plane within the card
Context configure card number fp number
Treefp
Range1 to 12

Notes

This element is part of a list key.

Introduced16.0.R1

Platforms

All

egress
Synopsis Enter the egress context
Context configure card number fp number egress
Treeegress
Introduced16.0.R1

Platforms

All

hs-fixed-high-thresh-delta number
Synopsis High threshold delta on the forwarding plane
Contextconfigure card number fp number egress hs-fixed-high-thresh-delta number
Treehs-fixed-high-thresh-delta

Description

This command specifies the egress aggregate shaper high burst limit threshold delta for this HSQ IOM FP.

An aggregate rate can be applied to each egress HSQ queue group, HS secondary shaper, and (for subscribers configured with HS SLA expanded mode) primary shaper that manages the maximum burst limit over a specified shaping rate. Each aggregate shaper supports two thresholds that are used in conjunction with the low burst class setting. The system uses the lowest value attainable for each low threshold aggregate burst limit without causing shaper under run conditions.

The high burst limit threshold is determined by adding the configured value of this command to the aggregate low burst limit threshold value. An operator must set this configured value to at least two times the maximum frame size to prevent lower threshold class forwarding from also affecting the higher threshold classes when forwarding larger packet sizes. An insufficiently high threshold delta defeats the intended purpose of mapping classes to the higher threshold.

Range0 to 65536
Introduced16.0.R1

Platforms

7750 SR-7/12/12e

hs-pool-policy reference
Synopsis HS pool policy
Contextconfigure card number fp number egress hs-pool-policy reference
Treehs-pool-policy

Description

This command specifies the HS pool policy for the FP.

An HS pool policy contains the required parameters to create and size root and mid-tier buffer pools on an HSQ IOM, and applies a slope policy to each. A single HS pool policy is supported per port FP.

This command is only applicable to the HSQ IOM (iom4-e-hs) and fails if configured on other card types.

Reference

configure qos hs-pool-policy string

Introduced16.0.R1

Platforms

7750 SR-7/12/12e

wred-queue-control
Synopsis Enter the wred-queue-control context
Contextconfigure card number fp number egress wred-queue-control
Treewred-queue-control

Description

Commands in this context configure the aggregate Weighted Random Early Detection (WRED) queue options for all WRED queues on an egress forwarding plane.

Introduced16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS

admin-state keyword
Synopsis Administrative state of the WRED queue control function
Contextconfigure card number fp number egress wred-queue-control admin-state keyword
Treeadmin-state
Defaultdisable
Optionsenable, disable
Introduced16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS

buffer-allocation decimal-number
Synopsis Buffer allocation for WRED queue buffer pools
Contextconfigure card number fp number egress wred-queue-control buffer-allocation decimal-number
Treebuffer-allocation

Description

This command defines the percentage of buffers to set aside for WRED queue buffer pools.

Range0.01 to 99.99
Default25.00
Units percent
Introduced16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS

reserved-cbs decimal-number
Synopsis Buffers for queues operating within CBS thresholds
Contextconfigure card number fp number egress wred-queue-control reserved-cbs decimal-number
Treereserved-cbs

Description

This command specifies the percentage of buffers within the WRED mega-pool to set aside for WRED queues operating within the configured CBS thresholds. The forwarding plane protects against WRED queue buffer starvation by setting aside a portion of the buffers within the WRED mega-pool.

This threshold defines when a WRED queue requests buffers from the reserved portion of the WRED mega-pool and when it starts requesting buffers from the shared portion of the mega-pool. With proper oversubscription provisioning, a seldom active queue is not denied a buffer from the mega-pool when the shared portion of the mega-pool is congested.

Range0.01 to 99.99
Default25.00
Units percent
Introduced16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS

fp-resource-policy reference
WARNING:

Modifying this element resets the associated cards/XIOMs/MDAs for the new value to take effect. On the 7750 SR-1, the configuration must be saved and the router must be rebooted for the new value to take effect.

SynopsisResource policy to manage resources on the FP
Contextconfigure card number fp number fp-resource-policy reference
Treefp-resource-policy

Description

This command configures an FP resource policy used to manage resources on a forwarding plane that is FP4-based and later.

The system creates a default policy that applies to all FP4 and later FPs. If an FP resource policy is removed from an FP, the system automatically applies the default policy to that FP. The system prevents the modification or deletion of the default policy, and the deletion of any user-created policy that is applied to an FP.

Reference

configure qos fp-resource-policy string

Introduced20.2.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-s, 7950 XRS

hi-bw-mcast-src
Synopsis Enable the hi-bw-mcast-src context
Contextconfigure card number fp number hi-bw-mcast-src
Treehi-bw-mcast-src

Description

Commands in this context configure the attributes to designate the FP as a high-bandwidth IP multicast source, expecting the ingress traffic to include high-bandwidth IP multicast traffic.

When configured, the system attempts to allocate a dedicated multicast switch fabric plane (MSFP) to the forwarding plane. When a group is specified, all FPs in the group share the same MSFP.

Introduced16.0.R1

Platforms

7450 ESS, 7750 SR-1x-48D, 7750 SR-1x-92S, 7750 SR-7/12/12e, 7750 SR-s, 7950 XRS

alarm boolean
Synopsis Raise an alarm when multiple traffic taps share a plane
Contextconfigure card number fp number hi-bw-mcast-src alarm boolean
Treealarm

Description

When configured to true, the router generates an event if the MDA must share an MSFP with another MDA in a different group. MDAs within the same group that share an MSFP do not generate an event. Additionally, if a failure occurs during normal operation or resources are removed, the system generates an event if it cannot maintain separation of MSFPs for the MDAs.

When configured to false, the router does not generate events.

Defaultfalse
Introduced16.0.R1

Platforms

7450 ESS, 7750 SR-1x-48D, 7750 SR-1x-92S, 7750 SR-7/12/12e, 7750 SR-s, 7950 XRS

default-paths-only boolean
Synopsis Allocate the default paths to dedicated MSFPs
Contextconfigure card number fp number hi-bw-mcast-src default-paths-only boolean
Treedefault-paths-only

Description

When configured to true, the system only attempts to allocate the two default paths (one high priority and one low priority) to dedicated MSFPs.

When configured to false, the default path allocation is disabled.

Defaultfalse
Introduced16.0.R1

Platforms

7450 ESS, 7750 SR-1x-48D, 7750 SR-1x-92S, 7750 SR-7/12/12e, 7750 SR-s, 7950 XRS

group number
Synopsis Logical MSFP group for the MDA
Context configure card number fp number hi-bw-mcast-src group number
Treegroup

Description

This command specifies the logical MSFP group for the MDA.

If a group is specified, all FPs in the group share the same MSFP.

Range0 to 32
Default0
Introduced 16.0.R1

Platforms

7450 ESS, 7750 SR-1x-48D, 7750 SR-1x-92S, 7750 SR-7/12/12e, 7750 SR-s, 7950 XRS

ingress
Synopsis Enter the ingress context
Context configure card number fp number ingress
Treeingress
Introduced16.0.R1

Platforms

All

access
Synopsis Enter the access context
Context configure card number fp number ingress access
Treeaccess
Introduced16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, 7950 XRS, VSR

queue-group [queue-group-name] reference instance-id number
Synopsis Enter the queue-group list instance
Contextconfigure card number fp number ingress access queue-group reference instance-id number
Treequeue-group

Description

Commands in this context create a named queue group template on the ingress forwarding plane of an IOM or IMM.

Introduced16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, 7950 XRS, VSR

instance-id number
Synopsis Instance ID
Contextconfigure card number fp number ingress access queue-group reference instance-id number
Treequeue-group
Range1 to 65535

Notes

This element is part of a list key.

Introduced16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, 7950 XRS, VSR

accounting-policy reference
Synopsis Accounting policy for the FP ingress queue group
Contextconfigure card number fp number ingress access queue-group reference instance-id number accounting-policy reference
Treeaccounting-policy

Description

This command configures an accounting policy for the FP ingress queue group. You can only apply accounting policies associated with service billing to SAPs. Only associate the accounting policy with one interface at a time.

Reference

configure log accounting-policy number

Introduced16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, 7950 XRS, VSR

collect-stats boolean
Synopsis Collect statistics on FP ingress queue group
Contextconfigure card number fp number ingress access queue-group reference instance-id number collect-stats boolean
Treecollect-stats

Description

When configured to true, the system collects accounting and statistical data for the queue group on the FP.

When configured to false, the system still accumulates the statistics; however, the CPU does not obtain the results and write them to the billing file. 

If this command is set to true (after it had previously been set to false), the counters written to the billing file include the traffic collected when the command was set to false.

Defaultfalse
Introduced16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, 7950 XRS, VSR

policer-control-policy
Synopsis Enter the policer-control-policy context
Contextconfigure card number fp number ingress access queue-group reference instance-id number policer-control-policy
Treepolicer-control-policy
Introduced16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, 7950 XRS, VSR

overrides
Synopsis Enable the overrides context
Context configure card number fp number ingress access queue-group reference instance-id number policer-control-policy overrides
Treeoverrides
Introduced16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, 7950 XRS, VSR

max-rate (number | keyword)
Synopsis Maximum rate override
Context configure card number fp number ingress access queue-group reference instance-id number policer-control-policy overrides max-rate (number | keyword)
Treemax-rate

Description

This command defines the PIR leaky bucket decrement rate of the parent policer. Each time you apply the policer control policy to a SAP or subscriber instance a parent policer is created. Packets not discarded by the child policer associated with the SAP or subscriber instance are evaluated against the leaky bucket of the parent policer.

For each packet, the system first decrements the bucket by the correct amount based on the decrement rate to derive the current bucket depth. The system compares the current depth to one of two discard thresholds associated with the packet. The first discard threshold is applied if the Fair Information Rate (FIR) leaky bucket of the child policer is in the confirming state. The second discard threshold is applied if the FIR leaky bucket of the child policer is in the exceed state.

Only one of the two thresholds is applied per packet. If the current depth of the parent policer PIR bucket is less than the threshold value, the parent PIR bucket is in the conform state for that particular packet. If the depth is equal to or greater than the applied threshold, the bucket is in the violate state for the packet.

If the result is conform, the bucket depth is increased by the size of the packet (plus or minus the per-packet offset setting in the child policer) and the parent policer does not discard the packet. If the result is violate, the bucket depth is not increased and the parent policer discards the packet. When the parent policer discards a packet, the bucket depth increases (PIR, CIR, and FIR) in the parent policer are canceled. This prevents packets that the parent policer discards from consuming the PIR, CIR, and FIR bandwidth of the child policers.

Range1 to 2000000000
Unitskilobps
Options max
Introduced 16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, 7950 XRS, VSR

priority-mbs-thresholds
Synopsis Enter the priority-mbs-thresholds context
Contextconfigure card number fp number ingress access queue-group reference instance-id number policer-control-policy overrides priority-mbs-thresholds
Treepriority-mbs-thresholds

Description

Commands in this context configure the derivative for the shared portion and fair portion for each priority level.

The system uses the shared portion and fair portion values to calculate the discard-unfair and discard-all MBS thresholds that enforce priority-sensitive rate-based discards within the root arbiter parent policer.

Introduced16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, 7950 XRS, VSR

min-threshold-separation (number | keyword)
Synopsis Minimum separation between any two active thresholds
Contextconfigure card number fp number ingress access queue-group reference instance-id number policer-control-policy overrides priority-mbs-thresholds min-threshold-separation (number | keyword)
Treemin-threshold-separation

Description

This command configures the minimum separation between any two active thresholds in the parent policer.

Range0 to 16777216
Unitsbytes
Options auto
Introduced 16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, 7950 XRS, VSR

priority [level] number
Synopsis Enter the priority list instance
Contextconfigure card number fp number ingress access queue-group reference instance-id number policer-control-policy overrides priority-mbs-thresholds priority number
Treepriority
Introduced16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, 7950 XRS, VSR

mbs-contribution (number | keyword)
Synopsis MBS contribution size override
Context configure card number fp number ingress access queue-group reference instance-id number policer-control-policy overrides priority-mbs-thresholds priority number mbs-contribution (number | keyword)
Treembs-contribution

Description

This command specifies the packet burst capacity required at the parent policer for a specified priority level with at least one child, and where the total capacity also includes the capacity of all lower thresholds.

Range0 to 16777216
Unitsbytes
Options auto
Introduced 16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, 7950 XRS, VSR

policer-overrides
Synopsis Enter the policer-overrides context
Contextconfigure card number fp number ingress access queue-group reference instance-id number policer-overrides
Treepolicer-overrides

Description

Commands in this context configure specific overrides to one or more policers created on the SAP through SAP ingress QoS policies.

Introduced16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, 7950 XRS, VSR

policer [policer-id] reference
Synopsis Enter the policer list instance
Contextconfigure card number fp number ingress access queue-group reference instance-id number policer-overrides policer reference
Treepolicer

Description

Commands in this context create, modify, or delete a policer. Policers are created and used in a similar manner to queues. Unlike queues that have dedicated counters, policers allow various stat-mode settings that define the counters to be associated with the policer. Packet byte offset provides a policer with the ability to modify the size of each packet based on a defined number of bytes. All policers must be created within the QoS policies.

After a policer is created, it cannot be deleted from the QoS policy unless all forwarding classes mapped to the policer are first moved to other policers or queues.

The system allows a policer to be created on a SAP QoS policy regardless of the ability to support policers on objects where the policy is currently applied. The system only scans the current objects for policer support and sufficient resources to create the policer when a forwarding class is first mapped to the policer ID. If the policer cannot be created because one or more instances of the policy do not support policing or have insufficient resources to create the policer, the forwarding class mapping fails.

Introduced16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, 7950 XRS, VSR

cbs (number | keyword)
Synopsis CBS tolerance allowed by the policer
Context configure card number fp number ingress access queue-group reference instance-id number policer-overrides policer reference cbs (number | keyword)
Treecbs

Description

This command configures the CIR leaky bucket exceed threshold of the policer.

If the forwarding rate of the policer is equal to or less than the defined CIR, the CIR bucket depth hovers around the 0 depth, with spikes up to the maximum packet size in the offered load. If the forwarding rate increases beyond the profiling rate, the threshold caps the amount of data allowed to be in-profile above the rate.

Range0 to 268435456
Unitsbytes
Options auto
Introduced 16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, 7950 XRS, VSR

mbs (number | keyword)
Synopsis Maximum burst tolerance allowed by the policer
Contextconfigure card number fp number ingress access queue-group reference instance-id number policer-overrides policer reference mbs (number | keyword)
Treembs

Description

This command configures the PIR leaky bucket violate threshold of the policer.

Ingress, trusted in-profile packets and untrusted high priority packets use the high priority violate threshold and trusted out-of-profile. Untrusted low priority packets use the low priority violate threshold.

If the offered rate of the policer is equal to or less than the defined rate, the PIR bucket depth hovers around the 0 depth, with spikes up to the maximum packet size in the offered load. If the offered rate increases beyond the metering rate, the threshold caps the amount of data allowed above the rate.

The low priority violate threshold provides a smaller burst size for the lower priority traffic associated with the policer. Because all lower priority traffic is discarded at the lower burst tolerance size, the remaining burst tolerance is available for higher priority traffic.

Range0 to 268435456
Unitsbytes
Options auto
Introduced 16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, 7950 XRS, VSR

packet-byte-offset number
Synopsis Packet size adjustment
Context configure card number fp number ingress access queue-group reference instance-id number policer-overrides policer reference packet-byte-offset number
Treepacket-byte-offset

Description

This command modifies the size of each packet handled by the policer by adding or subtracting a number of bytes. The actual packet size is not modified; only the size used to determine the bucket depth impact is changed.

Use this command to add downstream frame encapsulation or remove portions of packet headers.

When child policers add to or subtract from the packet size, the minimum threshold separation value of the parent policer must be modified by the same amount.

Range-32 to 31
Introduced16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, 7950 XRS, VSR

rate
Synopsis Enter the rate context
Context configure card number fp number ingress access queue-group reference instance-id number policer-overrides policer reference rate
Treerate

Description

Commands in this context configure the metering and optional profiling rates of the policer.

The metering rate is used by the system to configure the PIR leaky bucket decrement rate and the profiling rate configures the CIR leaky bucket decrement rate. The decrement function empties the bucket; packets applied to the bucket attempt to fill it based on its packet size. If the bucket fills faster than the rate that it empties, the bucket depth eventually reaches its exceeded (CIR) or violate (PIR) threshold.

Introduced16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, 7950 XRS, VSR

cir (number | keyword)
Synopsis CIR for the policer
Context configure card number fp number ingress access queue-group reference instance-id number policer-overrides policer reference rate cir (number | keyword)
Treecir

Description

This command overrides the default CIR rate of the policer.

When the policer is first created, the profiling rate defaults to 0 kb/s.

When max is configured, the maximum policer rate used is equal to the maximum capacity of the card that the policer is configured for. If the policer rate is set to a value larger than the maximum rate possible for the card, the CIR used is equivalent to maximum.

Range0 to 2000000000
Unitskilobps
Options max
Introduced 16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, 7950 XRS, VSR

pir (number | keyword)
Synopsis PIR for the policer
Context configure card number fp number ingress access queue-group reference instance-id number policer-overrides policer reference rate pir (number | keyword)
Treepir

Description

This command configures the metering rate of the policer for the PIR leaky bucket.

When the policer is first created, the metering rate defaults to max.

When max is configured, the maximum policer rate used is equal to the maximum capacity of the card that the policer is configured for. If the policer rate is set to a value larger than the maximum rate possible for the card, the PIR used is equivalent to maximum.

Range1 to 2000000000
Unitskilobps
Options max
Introduced 16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, 7950 XRS, VSR

stat-mode keyword
Synopsis Stat mode for the policer
Context configure card number fp number ingress access queue-group reference instance-id number policer-overrides policer reference stat-mode keyword
Treestat-mode

Description

This command specifies the forwarding plane counters that allow offered, output, and discard accounting to occur for the policer.

Optionsno-stats, minimal, offered-profile-no-cir, offered-total-cir, offered-priority-no-cir, offered-profile-cir, offered-priority-cir, offered-limited-profile-cir, offered-profile-capped-cir, offered-limited-capped-cir
Introduced16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, 7950 XRS, VSR

dist-cpu-protection
Synopsis Enter the dist-cpu-protection context
Contextconfigure card number fp number ingress dist-cpu-protection
Treedist-cpu-protection

Description

Commands in this context configure the distributed CPU protection forwarding plane settings.

Introduced21.2.R1

Platforms

All

dynamic-enforcement-policer-pool number
Synopsis Number of policers reserved as enforcement policers use
Contextconfigure card number fp number ingress dist-cpu-protection dynamic-enforcement-policer-pool number
Treedynamic-enforcement-policer-pool

Description

This command reserves a set of policers for use as dynamic enforcement policers for the Distributed CPU Protection (DCP) feature. Policers are allocated from this pool and instantiated as per-object per-protocol dynamic enforcement policers after a local monitor is triggered for an object, such as a SAP or network interface.

A change to this configured value automatically clears the high water mark, timestamp, and failed allocation count.

If the command is configured to a value below the currently used or allocated number, all dynamic policers are returned to the free pool (and traffic returns to the local monitors).

Range1000 to 32000
Introduced21.2.R1

Platforms

All

mcast-path-management
Synopsis Enter the mcast-path-management context
Contextconfigure card number fp number ingress mcast-path-management
Treemcast-path-management

Description

Commands in this context configure the IOM ingress multicast path management forwarding plane settings.

Introduced16.0.R1

Platforms

7450 ESS, 7750 SR-1x-48D, 7750 SR-1x-92S, 7750 SR-7/12/12e, 7750 SR-s, 7950 XRS, VSR

admin-state keyword
Synopsis Administrative state of multicast path management
Contextconfigure card number fp number ingress mcast-path-management admin-state keyword
Treeadmin-state
Defaultdisable
Optionsenable, disable
Introduced16.0.R1

Platforms

7450 ESS, 7750 SR-1x-48D, 7750 SR-1x-92S, 7750 SR-7/12/12e, 7750 SR-s, 7950 XRS, VSR

bandwidth-policy reference
Synopsis Bandwidth policy for ingress multicast path management
Contextconfigure card number fp number ingress mcast-path-management bandwidth-policy reference
Treebandwidth-policy

Description

This command specifies the bandwidth policy associated with the forwarding plane.

The bandwidth policy defines the dynamic rate table and the multicast paths bandwidth and queuing parameters.

If a bandwidth policy is not explicitly associated with a forwarding plane, the default bandwidth policy is used with ingress multicast path management.

Reference

configure multicast-management bandwidth-policy string

Introduced16.0.R1

Platforms

7450 ESS, 7750 SR-1x-48D, 7750 SR-1x-92S, 7750 SR-7/12/12e, 7750 SR-s, 7950 XRS, VSR

network
Synopsis Enter the network context
Context configure card number fp number ingress network
Treenetwork

Description

Commands in this context configure the IOM ingress network forwarding plane settings.

Introduced16.0.R1

Platforms

All

pool [name] string
Synopsis Enter the pool list instance
Context configure card number fp number ingress network pool string
Treepool

Description

Commands in this context configure the list of forwarding plane ingress network pool settings.

Introduced19.5.R1

Platforms

All

[name] string
Synopsis Network ingress pool name for the FP
Context configure card number fp number ingress network pool string
Treepool
String Length1 to 32

Notes

This element is part of a list key.

Introduced19.5.R1

Platforms

All

amber-alarm-threshold number
Synopsis Amber alarm threshold allowed on oversubscription
Contextconfigure card number fp number ingress network pool string amber-alarm-threshold number
Treeamber-alarm-threshold

Description

This command configures the threshold for the amber alarm on oversubscription. 

If both amber and red alarm thresholds are configured, the amber alarm threshold must be equal to or less than the red alarm threshold.

Range1 to 1000
Unitspercent
Introduced 19.5.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS

red-alarm-threshold number
Synopsis Red alarm threshold allowed on oversubscription
Contextconfigure card number fp number ingress network pool string red-alarm-threshold number
Treered-alarm-threshold

Description

This command configures the threshold for the red alarm on oversubscription. 

If both amber and red alarm thresholds are configured, the red alarm threshold must be equal to or exceed the amber alarm threshold.

Range1 to 1000
Unitspercent
Introduced 19.5.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS

resv-cbs
Synopsis Enter the resv-cbs context
Context configure card number fp number ingress network pool string resv-cbs
Treeresv-cbs

Description

Commands in this context specify the pool buffer settings.

The commands do not set aside buffers within the buffer pool for CBS reservation. The CBS value per queue only determines the point at which enqueuing packets are subject to a RED slope. CBS oversubscription can result in a queue operating within its CBS configuration and still being unable to enqueue a packet due to unavailable buffers.

Introduced19.5.R1

Platforms

All

amber-alarm-action
Synopsis Enter the amber-alarm-action context
Contextconfigure card number fp number ingress network pool string resv-cbs amber-alarm-action
Treeamber-alarm-action

Description

Commands in this context specify settings for the reserved Committed Burst Size (CBS) and step change when the amber alert threshold is exceeded. 

The reserved CBS defines the amount of buffer space within the pool that is not considered shared.

Introduced19.5.R1

Platforms

All

max number
Synopsis Maximum reserved CBS size of the pool
Contextconfigure card number fp number ingress network pool string resv-cbs amber-alarm-action max number
Treemax

Description

This command configures the maximum reserved CBS size of the pool.

To enable adaptive CBS sizing, this command and the step command must be configured. 

The value for this command must not be more than the configure card fp ingress network pool resv-cbs cbs command.

When the configure card fp ingress network pool resv-cbs cbs command is set to a value of zero (0), adaptive CBS sizing is disabled.

Range1 to 100
Unitspercent
Introduced 19.5.R1

Platforms

All

step number
Synopsis Step-size percentage for reserved CBS size of the pool
Contextconfigure card number fp number ingress network pool string resv-cbs amber-alarm-action step number
Treestep

Description

This command configures the step-size percentage for the reserved CBS size of the pool.

To enable adaptive CBS sizing, this command and the max command must be configured. 

When the configure card fp ingress network pool resv-cbs cbs command is set to a value of zero (0), adaptive CBS sizing is disabled.

Range1 to 100
Unitspercent
Introduced 19.5.R1

Platforms

All

cbs number
Synopsis Pool size reserved for CBS
Context configure card number fp number ingress network pool string resv-cbs cbs number
Treecbs

Description

This command configures the percentage of pool size reserved for CBS.

For network, the default value is computed as the sum of the CBS request by the entities using the pool. For access, the default value is 30%.

Range0 to 100
Unitspercent
Introduced 19.5.R1

Platforms

All

slope-policy reference
Synopsis Slope policy
Contextconfigure card number fp number ingress network pool string slope-policy reference
Treeslope-policy

Description

This command specifies the slope policy that defines the high and low priority RED slope parameters and the time average factor.

Reference

configure qos slope-policy string

Introduced19.5.R1

Platforms

All

queue-group [queue-group-name] reference instance-id number
Synopsis Enter the queue-group list instance
Contextconfigure card number fp number ingress network queue-group reference instance-id number
Treequeue-group

Description

Commands in this context configure IOM ingress network forwarding plane queue-group settings.

Introduced16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, 7950 XRS, VSR

instance-id number
Synopsis Instance ID
Contextconfigure card number fp number ingress network queue-group reference instance-id number
Treequeue-group
Range1 to 65535

Notes

This element is part of a list key.

Introduced16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, 7950 XRS, VSR

accounting-policy reference
Synopsis Accounting policy for the FP ingress queue group
Contextconfigure card number fp number ingress network queue-group reference instance-id number accounting-policy reference
Treeaccounting-policy

Description

This command configures an accounting policy for the FP ingress queue group. You can only apply accounting policies associated with service billing to SAPs. Only associate the accounting policy with one interface at a time.

Reference

configure log accounting-policy number

Introduced16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, 7950 XRS, VSR

collect-stats boolean
Synopsis Collect statistics on FP ingress queue group
Contextconfigure card number fp number ingress network queue-group reference instance-id number collect-stats boolean
Treecollect-stats

Description

When configured to true, the system collects accounting and statistical data for the queue group on the FP.

When configured to false, the system still accumulates the statistics; however, the CPU does not obtain the results and write them to the billing file. 

If this command is set to true (after it had previously been set to false), the counters written to the billing file include the traffic collected when the command was set to false.

Defaultfalse
Introduced16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, 7950 XRS, VSR

policer-control-policy
Synopsis Enter the policer-control-policy context
Contextconfigure card number fp number ingress network queue-group reference instance-id number policer-control-policy
Treepolicer-control-policy

Description

Commands in this context configure the IOM ingress network forwarding plane queue-group policer control policy settings.

Introduced16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, 7950 XRS, VSR

overrides
Synopsis Enable the overrides context
Context configure card number fp number ingress network queue-group reference instance-id number policer-control-policy overrides
Treeoverrides

Description

Commands in this context configure the IOM ingress network forwarding plane queue-group policer control policy override settings.

Introduced16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, 7950 XRS, VSR

max-rate (number | keyword)
Synopsis Maximum rate override
Context configure card number fp number ingress network queue-group reference instance-id number policer-control-policy overrides max-rate (number | keyword)
Treemax-rate

Description

This command defines the PIR leaky bucket decrement rate of the parent policer. Each time you apply the policer control policy to a SAP or subscriber instance a parent policer is created. Packets not discarded by the child policer associated with the SAP or subscriber instance are evaluated against the leaky bucket of the parent policer.

For each packet, the system first decrements the bucket by the correct amount based on the decrement rate to derive the current bucket depth. The system compares the current depth to one of two discard thresholds associated with the packet. The first discard threshold is applied if the Fair Information Rate (FIR) leaky bucket of the child policer is in the confirming state. The second discard threshold is applied if the FIR leaky bucket of the child policer is in the exceed state.

Only one of the two thresholds is applied per packet. If the current depth of the parent policer PIR bucket is less than the threshold value, the parent PIR bucket is in the conform state for that particular packet. If the depth is equal to or greater than the applied threshold, the bucket is in the violate state for the packet.

If the result is conform, the bucket depth is increased by the size of the packet (plus or minus the per-packet offset setting in the child policer) and the parent policer does not discard the packet. If the result is violate, the bucket depth is not increased and the parent policer discards the packet. When the parent policer discards a packet, the bucket depth increases (PIR, CIR, and FIR) in the parent policer are canceled. This prevents packets that the parent policer discards from consuming the PIR, CIR, and FIR bandwidth of the child policers.

Range1 to 2000000000
Unitskilobps
Options max
Introduced 16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, 7950 XRS, VSR

priority-mbs-thresholds
Synopsis Enter the priority-mbs-thresholds context
Contextconfigure card number fp number ingress network queue-group reference instance-id number policer-control-policy overrides priority-mbs-thresholds
Treepriority-mbs-thresholds

Description

Commands in this context configure settings to derive the shared portion and fair portion for each priority level.

The system uses the shared portion and fair portion values to calculate the discard-unfair and discard-all MBS thresholds that enforce priority-sensitive rate-based discards within the root arbiter parent policer.

Introduced16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, 7950 XRS, VSR

min-threshold-separation (number | keyword)
Synopsis Minimum separation between any two active thresholds
Contextconfigure card number fp number ingress network queue-group reference instance-id number policer-control-policy overrides priority-mbs-thresholds min-threshold-separation (number | keyword)
Treemin-threshold-separation

Description

This command configures the minimum separation between any two active thresholds in the parent policer.

Range0 to 16777216
Unitsbytes
Options auto
Introduced 16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, 7950 XRS, VSR

priority [level] number
Synopsis Enter the priority list instance
Contextconfigure card number fp number ingress network queue-group reference instance-id number policer-control-policy overrides priority-mbs-thresholds priority number
Treepriority

Description

Commands in this context configure the list of priority MBS threshold priority settings for IOM ingress network forwarding plane queue-group policer control policy overrides.

Introduced16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, 7950 XRS, VSR

mbs-contribution (number | keyword)
Synopsis MBS contribution size override
Context configure card number fp number ingress network queue-group reference instance-id number policer-control-policy overrides priority-mbs-thresholds priority number mbs-contribution (number | keyword)
Treembs-contribution

Description

This command specifies the packet burst capacity required at the parent policer for a specified priority level with at least one child, and where the total capacity also includes the capacity of all lower thresholds.

Range0 to 16777216
Unitsbytes
Options auto
Introduced 16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, 7950 XRS, VSR

policer-overrides
Synopsis Enter the policer-overrides context
Contextconfigure card number fp number ingress network queue-group reference instance-id number policer-overrides
Treepolicer-overrides

Description

Commands in this context configure the policer overrides for the IOM ingress network forwarding plane queue-groups.

Introduced16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, 7950 XRS, VSR

policer [policer-id] reference
Synopsis Enter the policer list instance
Contextconfigure card number fp number ingress network queue-group reference instance-id number policer-overrides policer reference
Treepolicer

Description

Commands in this context configure the list of policer override parameters for IOM ingress network forwarding plane queue-groups.

Introduced16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, 7950 XRS, VSR

cbs (number | keyword)
Synopsis CBS tolerance allowed by the policer
Context configure card number fp number ingress network queue-group reference instance-id number policer-overrides policer reference cbs (number | keyword)
Treecbs

Description

This command configures the CIR leaky bucket exceed threshold of the policer.

If the forwarding rate of the policer is equal to or less than the defined CIR, the CIR bucket depth hovers around the 0 depth, with spikes up to the maximum packet size in the offered load. If the forwarding rate increases beyond the profiling rate, the threshold caps the amount of data allowed to be in-profile above the rate.

Range0 to 268435456
Unitsbytes
Options auto
Introduced 16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, 7950 XRS, VSR

mbs (number | keyword)
Synopsis Maximum burst tolerance allowed by the policer
Contextconfigure card number fp number ingress network queue-group reference instance-id number policer-overrides policer reference mbs (number | keyword)
Treembs

Description

This command configures the PIR leaky bucket violate threshold of the policer.

Ingress, trusted in-profile packets and untrusted high priority packets use the high priority violate threshold and trusted out-of-profile. Untrusted low priority packets use the low priority violate threshold.

If the offered rate of the policer is equal to or less than the defined rate, the PIR bucket depth hovers around the 0 depth, with spikes up to the maximum packet size in the offered load. If the offered rate increases beyond the metering rate, the threshold caps the amount of data allowed above the rate.

The low priority violate threshold provides a smaller burst size for the lower priority traffic associated with the policer. Because all lower priority traffic is discarded at the lower burst tolerance size, the remaining burst tolerance is available for higher priority traffic.

Range0 to 268435456
Unitsbytes
Options auto
Introduced 16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, 7950 XRS, VSR

packet-byte-offset number
Synopsis Packet size adjustment
Context configure card number fp number ingress network queue-group reference instance-id number policer-overrides policer reference packet-byte-offset number
Treepacket-byte-offset

Description

This command modifies the size of each packet handled by the policer by adding or subtracting a number of bytes. The actual packet size is not modified; only the size used to determine the bucket depth impact is changed.

Use this command to add downstream frame encapsulation or remove portions of packet headers.

When child policers add to or subtract from the packet size, the minimum threshold separation value of the parent policer must be modified by the same amount.

Range-32 to 31
Introduced16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, 7950 XRS, VSR

rate
Synopsis Enter the rate context
Context configure card number fp number ingress network queue-group reference instance-id number policer-overrides policer reference rate
Treerate

Description

Commands in this context configure the metering and optional profiling rates of the policer.

The metering rate is used by the system to configure the PIR leaky bucket decrement rate and the profiling rate configures the CIR leaky bucket decrement rate. The decrement function empties the bucket; packets applied to the bucket attempt to fill it based on its packet size. If the bucket fills faster than the rate that it empties, the bucket depth eventually reaches its exceeded (CIR) or violate (PIR) threshold.

Introduced16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, 7950 XRS, VSR

cir (number | keyword)
Synopsis CIR for the policer
Context configure card number fp number ingress network queue-group reference instance-id number policer-overrides policer reference rate cir (number | keyword)
Treecir

Description

This command overrides the default CIR rate of the policer.

When the policer is first created, the profiling rate defaults to 0 kb/s.

When max is configured, the maximum policer rate used is equal to the maximum capacity of the card that the policer is configured for. If the policer rate is set to a value larger than the maximum rate possible for the card, the CIR used is equivalent to maximum.

Range0 to 2000000000
Unitskilobps
Options max
Introduced 16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, 7950 XRS, VSR

pir (number | keyword)
Synopsis PIR for the policer
Context configure card number fp number ingress network queue-group reference instance-id number policer-overrides policer reference rate pir (number | keyword)
Treepir

Description

This command configures the metering rate of the policer for the PIR leaky bucket.

When the policer is first created, the metering rate defaults to max.

When max is configured, the maximum policer rate used is equal to the maximum capacity of the card that the policer is configured for. If the policer rate is set to a value larger than the maximum rate possible for the card, the PIR used is equivalent to maximum.

Range1 to 2000000000
Unitskilobps
Options max
Introduced 16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, 7950 XRS, VSR

stat-mode keyword
Synopsis Stat mode for the policer
Context configure card number fp number ingress network queue-group reference instance-id number policer-overrides policer reference stat-mode keyword
Treestat-mode

Description

This command specifies the forwarding plane counters that allow offered, output, and discard accounting to occur for the policer.

Optionsno-stats, minimal, offered-profile-no-cir, offered-total-cir, offered-priority-no-cir, offered-profile-cir, offered-priority-cir, offered-limited-profile-cir, offered-profile-capped-cir, offered-limited-capped-cir
Introduced16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, 7950 XRS, VSR

policy-accounting
Synopsis Enter the policy-accounting context
Contextconfigure card number fp number ingress policy-accounting
Treepolicy-accounting

Description

Commands in this context configure policy accounting.

Use policy accounting to collect statistics about the amount of traffic matching particular routes or to police traffic associated with certain routes as destinations of the traffic.

Introduced20.10.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-s, 7950 XRS

classes number
Synopsis Number of accounting classes for the forwarding plane
Contextconfigure card number fp number ingress policy-accounting classes number
Treeclasses

Description

This command specifies the maximum number of source and destination classes that can be instantiated for accounting purposes on the interfaces of a specific card or FP.

When unconfigured, resources are not reserved for source or destination classes.

Range1000 to 128000
Introduced21.2.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-s, 7950 XRS

policers number
Synopsis Number of policer resources for policy accounting
Contextconfigure card number fp number ingress policy-accounting policers number
Treepolicers
Range1 to 64000
Introduced20.10.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-s, 7950 XRS

ingress-buffer-allocation decimal-number
Synopsis Ingress buffer pool allocation for the forwarding plane
Contextconfigure card number fp number ingress-buffer-allocation decimal-number
Treeingress-buffer-allocation

Description

This command configures an ingress buffer allocation for the FP.

Ingress buffer allocation applies to user-accessible buffers (total buffers less those reserved for system use). The ingress buffer allocation determines how much of the user-accessible buffers are available for ingress purposes. The remaining buffers are available for egress purposes.

Range20.00 to 80.00
Default50.00
Units percent
Introduced16.0.R1

Platforms

7450 ESS, 7750 SR-7/12/12e, 7750 SR-a, 7750 SR-e, 7950 XRS

init-extract-prio-mode keyword
Synopsis Initial drop priority mode of extracted traffic
Contextconfigure card number fp number init-extract-prio-mode keyword
Treeinit-extract-prio-mode

Description

This command specifies the scheme to select the initial drop priority of extracted control plane traffic.

The initial drop priority of extracted packets can be either low or high priority. The drop priority can be altered subsequently by mechanisms such as CPU protection. 

High priority traffic receives preferential treatment in control plane congestion situations over low priority traffic.

Defaultuniform
Optionsuniform, l3-classify
Introduced16.0.R1

Platforms

All

stable-pool-sizing boolean
Synopsis Enable stable pool sizing for the forwarding plane
Contextconfigure card number fp number stable-pool-sizing boolean
Treestable-pool-sizing

Description

When configured to true, the router provides a stable buffer pool allocation environment for all default port buffer pools on the forwarding plane. This stable environment is provided at the expense of optimal buffer allocation between the various port buffer pools.

When configured to false, the router disables stable pool sizing on the forwarding plane. Existing buffer pools are resized according to normal pool sizing behavior.

Defaultfalse
Introduced16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS

level keyword

WARNING:

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

SynopsisLicense level of the card
Contextconfigure card number level keyword
Treelevel

Description

This command configures the license level of the card.

New generations of cards include variants controlled by hardware and software licensing. For these cards, the license level must be provisioned in addition to the card type. A card cannot become operational unless the provisioned license level matches the license level of the card installed into the slot.The set of license levels varies by card type.

The provisioned level controls aspects related to connector provisioning and the consumption of hardware egress user queues and egress policers. Changes to the provisioned license level may be blocked if configuration exists that would not be permitted with the new target license level.

If the license level is not specified, the level is set to the highest license level for that card.

Optionsunrestricted, he, er, cr, he1200g+, er1200g+, cr1200g+, he400g, er400g, cr400g, he400g+, er400g+, cr400g+, he800g+, er800g+, cr800g+, he4800g+, er4800g+, cr4800g+, he4800g, er4800g, cr4800g, he2400g+, er2400g+, cr2400g+, he2400g, er2400g, cr2400g, he9600g, er9600g, cr9600g, he14400g, er14400g, cr14400g, he14400g+, er14400g+, cr14400g+, he2800g+, er2800g+, cr2800g+, he6000g+, er6000g+, cr6000g+, he18000g+, er18000g+, cr18000g+, he19200g, er19200g, cr19200g
Introduced 16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-1se

mda [mda-slot] number

Synopsis Enter the mda list instance
Context configure card number mda number
Treemda

Description

Commands in this context cover attributes for specific MDA and XMA.

Introduced16.0.R1

Platforms

All

[mda-slot] number
Synopsis MDA or XMA slot
Context configure card number mda number
Treemda
Range1 to 6

Notes

This element is part of a list key.

Introduced16.0.R1

Platforms

All

access
Synopsis Enter the access context
Context configure card number mda number access
Treeaccess

Description

Commands in this context configure egress and ingress pool policy parameters.

Access egress and ingress pools are only allocated on channelized MDAs.

Introduced16.0.R1

Platforms

All

egress
Synopsis Enter the egress context
Context configure card number mda number access egress
Treeegress
Introduced16.0.R1

Platforms

All

ingress
Synopsis Enter the ingress context
Context configure card number mda number access ingress
Treeingress
Introduced16.0.R1

Platforms

All

admin-state keyword
Synopsis Administrative state of the MDA
Context configure card number mda number admin-state keyword
Treeadmin-state
Defaultenable
Optionsenable, disable
Introduced16.0.R1

Platforms

All

egress-xpl
Synopsis Enter the egress-xpl context
Context configure card number mda number egress-xpl
Treeegress-xpl

Description

Commands in this context specify settings for the fail-on-error feature.

Introduced16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS

threshold number
Synopsis Threshold value for XPL errors
Context configure card number mda number egress-xpl threshold number
Treethreshold

Description

This command configures the threshold for XPL errors. If the number of XPL errors exceeds the threshold value defined by the window value command, the MDA is placed in the failed state.

Range1 to 1000000
Default1000
Units xpl errors
Introduced16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS

window number
Synopsis Time interval to measure XPL error frequency
Contextconfigure card number mda number egress-xpl window number
Treewindow

Description

This command configures the time interval used to measure the frequency of XPL errors for the fail-on-error feature. If the number of XPL errors exceeds the threshold value in defined by this command, the MDA is placed in the Failed state.

Range1 to 1440
Default60
Units minutes
Introduced16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS

event [type] keyword
Synopsis Enter the event list instance
Context configure card number mda number event keyword
Treeevent

Description

Commands in this context allow the user to control the action taken when a specific hardware error event is raised against the target MDA. If no event action has been created for a specific event type, the management plane of the router ignores the hardware errors related to that event type.

Introduced19.7.R1

Platforms

All

[type] keyword
Synopsis MDA event type being monitored
Context configure card number mda number event keyword
Treeevent

Description

This command configures the type of event to be acted upon.

  • soft-error — Defines the action to take when soft errors are detected on the MDA.

  • internal-frame-loss — Provides system detected frame loss in the traffic transiting the MDA.

  • memory-error — Provides the user options to handle MDA memory error events on MDAs. This feature is supported on FP2- and FP3-based Ethernet MDAs and IMMs.

  • data-link-error — Provides the user options to handle datapath link errors on an MDA.

Optionssoft-error, internal-frame-loss, memory-error, datapath-link-error

Notes

This element is part of a list key.

Introduced19.7.R1

Platforms

All

action keyword
Synopsis Action when a specific hardware error event is raised
Contextconfigure card number mda number event keyword action keyword
Treeaction

Description

This command defines the action taken when a specific hardware error event is detected on the target MDA.

When no event action is specified for an event type, the hardware errors related to the event type are ignored by the management plane of the router.

Actions include the following:

  • log-only — Pass the log event to log management. No other action is taken.

  • reset-mda — Reset the MDA.

  • fail-mda — Set the operational state of the MDA to Failed. This Failed state persists until the clear mda command is issued (reset) or the MDA is removed and reinserted (re-seated).

Optionsnone, log-only, reset, fail
Introduced 19.7.R1

Platforms

All

fail-on-error boolean
Synopsis Set operational state to Failed if an error is detected
Contextconfigure card number mda number fail-on-error boolean
Treefail-on-error

Description

When configured to true, the fail-on-error feature is enabled on the MDA. When a defined rate of egress or ingress XPL errors occur on an MDA within a specified time interval, the MDA is placed in the Failed state. This can force an APS switchover or traffic to be rerouted.

The purpose of this feature is to avoid situations where traffic is forced to use a physical link that suffers from errors but is still technically operational. The feature uses values configured in the configure card mda egress-xpl and configure card mda ingress-xpl contexts.

See "Fail-on-error overview" in the 7450 ESS, 7750 SR, 7950 XRS, and VSR Troubleshooting Guide for more information.

Defaultfalse
Introduced16.0.R1

Platforms

All

ingress-xpl
Synopsis Enter the ingress-xpl context
Context configure card number mda number ingress-xpl
Treeingress-xpl

Description

Commands in this context specify settings for ingress XPL error occurrences.

Introduced16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS

threshold number
Synopsis Threshold value for XPL errors
Context configure card number mda number ingress-xpl threshold number
Treethreshold

Description

This command configures the threshold for XPL errors. If the number of XPL errors exceeds the threshold value defined by the window value command, the MDA is placed in the failed state.

Range1 to 1000000
Default1000
Units xpl errors
Introduced16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS

window number
Synopsis Time interval to measure XPL error frequency
Contextconfigure card number mda number ingress-xpl window number
Treewindow

Description

This command configures the time interval used to measure the frequency of XPL errors for the fail-on-error feature. If the number of XPL errors exceeds the threshold value in defined by this command, the MDA is placed in the Failed state.

Range1 to 1440
Default60
Units minutes
Introduced16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS

level keyword
WARNING:

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

SynopsisMDA card level
Contextconfigure card number mda number level keyword
Treelevel
Optionsunrestricted, he2400g, he1600g, he1200g, er2400g, er1600g, er1200g, cr2400g, cr1600g, cr1200g, he2400g+, er2400g+, cr2400g+, he3600g, er3600g, cr3600g, he3600gdd, er3600gdd, cr3600gdd, he4800g, er4800g, cr4800g, he4800g+, er4800g+, cr4800g+, he600g, er600g, cr600g, he1200g+, er1200g+, cr1200g+, he2400g+4t, er2400g+4t, cr2400g+4t, he9600g, er9600g, cr9600g, he9600g+, er9600g+, cr9600g+, he14400g, er14400g, cr14400g, he14400g+, er14400g+, cr14400g+, he12000g+, er12000g+, cr12000g+, he18000g+, er18000g+, cr18000g+
Introduced 16.0.R1

Platforms

7750 SR-1s, 7750 SR-2s, 7750 SR-2se, 7750 SR-7s, 7750 SR-14s, 7950 XRS

mda-type keyword
WARNING:

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

SynopsisMDA type for the slot
Contextconfigure card number mda number mda-type keyword
Treemda-type

Description

This command provisions a specific MDA type to the device configuration for the slot. The MDA can be pre-provisioned and an MDA must be provisioned before connectors or ports can be configured.

A maximum of two MDAs can be provisioned on an IOM or XCM. XMAs are provisioned using MDA commands.

A medium severity alarm is generated if an MDA is inserted that does not match the MDA type configured for the slot. This alarm is cleared when the correct MDA is inserted or the configuration is modified. A high severity alarm is raised when an administratively enabled MDA is removed from the chassis. This alarm is cleared if either the correct MDA type is inserted or the configuration is modified. A low severity alarm is issued if an MDA is removed that is administratively disabled.

An MDA can only be provisioned in a slot if the MDA type is allowed in the MDA slot. An error message is generated when an MDA is provisioned in a slot where it is not allowed

Some MDA hardware can support two different firmware loads. One load includes the base Ethernet functionality, including 10G WAN mode, but does not include 1588 port-based timestamping. The second load includes the base Ethernet functionality and 1588 port-based timestamping, but does not include 10G WAN mode. These are identified as two MDA types that are the same, except for a “-ptp” suffix to indicate the second loadset. A hard reset of the MDA occurs when switching between the two provisioned types.

An alarm is raised if partial or complete MDA failure is detected. The alarm is cleared when the error condition ceases.

New generations of XMAs include variants controlled through hardware and software licensing. For these XMAs, the license level must be provisioned in addition to the MDA type. An XMA cannot become operational unless the provisioned license level matches the license level of the XMA installed into the slot.

The set of license levels varies by MDA type. The provisioned level controls aspects related to connector provisioning and the consumption of hardware egress queues and egress policers. Changes to the provisioned license level may be blocked if configuration that would not be permitted with the new target license level exists. If the license level is not specified, the level is set to the highest license level for that XMA.

Optionsx12-400g-qsfpdd, x6-200g-cfp2-dco, cx20-10g-sfp, cx2-100g-cfp, p10-10g-sfp, p1-100g-cfp, p3-40g-qsfp, p6-10g-sfp, x40-10g-sfp, m40-10g-sfp, x4-100g-cxp, cx6-40g-qsfp, m4-100g-cxp, p20-1gb-sfp, s36-100gb-qsfp28-3.6t, p-isa2-ms, p-isa2-ms-e, isa2-aa, isa2-tunnel, isa2-bb, x4-100g-cfp2, cx72-1g-csfp, maxp1-100gb-cfp, ma4-10gb-sfp+, maxp10-10gb-sfp+, me10-10gb-sfp+, ma2-10gb-sfp+12-1gb-sfp, maxp6-10gb-sfp+1-40gb-qsfp+, ma44-1gb-csfp, ma20-1gb-tx, m20-10g-sfp+, me1-100gb-cfp2, m4-100g-cfp4, p1-100g-tun-b, maxp1-100gb-cfp2, maxp1-100gb-cfp4, isa-ms-v, isa-aa-v, isa-tunnel-v, isa-bb-v, m20-v, me-isa2-ms, me-isa2-ms-e, me40-1gb-csfp, m4-1g-tx+20-1g-sfp+6-10g-sfp+, me2-100gb-cfp4, me6-10gb-sfp+, isa2-video, me2-100gb-qsfp28, i6-10/100eth-tx, x2-100g-tun, i2-sdi, i2-cellular, me12-10/1gb-sfp+, me16-25gb-sfp28+2-100gb-qsfp28, me6-100gb-qsfp28, x6-400g-cfp8, me2-100gb-ms-qsfp28, s18-100gb-qsfp28, x40-10g-sfp-ptp, m40-10g-sfp-ptp, m36-100g-qsfp28, m48-sfp+2-qsfp28, m10-10g-sfp+, m20-1g-csfp, m6-10g-sfp++1-100g-qsfp28, me3-200gb-cfp2-dco, x24-100g-qsfp28, me12-100gb-qsfp28, i1-wlan, s36-400gb-qsfpdd, m24-sfp++8-sfp28+2-qsfp28, s36-100gb-qsfp28, a32-chds1v2, m48-sfp++6-qsfp28, maxp10-10/1gb-msec-sfp+, m4-10g-sfp++1-100g-cfp2, i3-10/100eth-tx, me3-400gb-qsfpdd, m18-25g-sfp28, m14-10g-sfp++4-1g-tx, m6-10g-sfp++4-25g-sfp28, me6-400gb-qsfpdd, me8-10/25gb-sfp28, m10-1g-sfp+2-10g-sfp+, m6-qsfpdd+48-sfp56, m32-qsfp28+4-qsfpdd, m36-qsfpdd, m1-400g-qsfpdd+1-100g-qsfp28, m5-100g-qsfp28, m48-800g-qsfpdd-1x, m24-800g-qsfpdd-1, ms36-800g-qsfpdd, x2-s36-800g-qsfpdd-18.0t, m48-400g-qsfpdd-1, m80-200g-sfpdd+12-800g-qsfpdd-1x, m40-200g-sfpdd+6-800g-qsfpdd-1, m80-200g-sfpdd+12-400g-qsfpdd-1, m46-10g-sfp+, m2-cfp2, x2-s36-800g-qsfpdd-12.0t, me16-25gb-sfp28+2-100gb-qsfp-b, m10-50g-sfp56
Introduced16.0.R1

Platforms

All

network
Synopsis Enter the network context
Context configure card number mda number network
Treenetwork
Introduced16.0.R1

Platforms

All

egress
Synopsis Enter the egress context
Context configure card number mda number network egress
Treeegress
Introduced16.0.R1

Platforms

All

ingress
Synopsis Enter the ingress context
Context configure card number mda number network ingress
Treeingress
Introduced16.0.R1

Platforms

All

power-priority-level number
Synopsis Power priority level for the MDA
Context configure card number mda number power-priority-level number
Treepower-priority-level
Range1 to 200
Default150
Introduced 16.0.R1

Platforms

7750 SR-1s, 7750 SR-2s, 7750 SR-2se, 7750 SR-7s, 7750 SR-14s, 7950 XRS

reset-on-recoverable-error boolean
Synopsis Reset MDA for fatal memory parity error on a Q-chip
Contextconfigure card number mda number reset-on-recoverable-error boolean
Treereset-on-recoverable-error

Description

When configured to true, the MDA resets when a fatal memory parity error is detected on a Q-chip of the MDA, regardless of the setting of the fail-on-error configuration for the MDA.

When configured to false, the recovery action is taken instead of resetting the MDA.

Defaultfalse
Introduced16.0.R1

Platforms

7750 SR-1s, 7750 SR-2s, 7750 SR-2se, 7750 SR-7s, 7750 SR-14s, 7950 XRS

sync-e keyword
Synopsis Synchronous Ethernet capability
Context configure card number mda number sync-e keyword
Treesync-e

Description

This command enables synchronous Ethernet on the MDA. When enabled, any port on the MDA can be used as a source port in the central frequency clock configuration, under the configure system central-frequency-clock context.

Optionstrue, false
Introduced 16.0.R1

Platforms

All

upgrade [upgrade-index] number
Synopsis Enter the upgrade list instance
Contextconfigure card number mda number upgrade number
Treeupgrade

Description

Commands in this context configure the license level upgrade for the MDA. You can apply multiple upgrades to an MDA. The first upgrade must use index 1, then index 2, and so on. When removing upgrades, remove the largest index first, followed by the next largest, and so on.

Some upgrades require a hard reset of the MDA to take effect. In general, this is required when the full duplex bandwidth changes as a result of the upgrade.

Introduced16.0.R4

Platforms

7750 SR-1s, 7750 SR-2s, 7750 SR-2se, 7750 SR-7s, 7750 SR-14s, 7950 XRS

[upgrade-index] number
Synopsis Order of the upgrade instance
Context configure card number mda number upgrade number
Treeupgrade
Range1 to 6

Notes

This element is part of a list key.

Introduced16.0.R4

Platforms

7750 SR-1s, 7750 SR-2s, 7750 SR-2se, 7750 SR-7s, 7750 SR-14s, 7950 XRS

path keyword
WARNING:

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

SynopsisUpgrade path of the MDA for the slot
Contextconfigure card number mda number upgrade number path keyword
Treepath

Description

This command configures the upgrade path for the MDA in the slot. The path indicates the starting level and the new level that is applied due to the upgrade.

Optionscr1200g-cr1600g, cr1600g-cr2400g, er1200g-er1600g, er1600g-er2400g, he1200g-he1600g, he1600g-he2400g, cr1200g-er1200g, er1200g-he1200g, cr1600g-er1600g, er1600g-he1600g, cr2400g-er2400g, er2400g-he2400g, any2400g-2400g+, cr3600g-cr4800g, er3600g-er4800g, he3600g-he4800g, cr3600g-er3600g, er3600g-he3600g, cr4800g-er4800g, er4800g-he4800g, any3600g-3600gdd, any4800g-4800g+, cr600g-cr1200g, er600g-er1200g, he600g-he1200g, cr600g-er600g, er600g-he600g, any1200g-1200g+, any2400g-2400g+4t, cr-er9600g, er-he9600g, any9600g-9600g+, cr-er14400g, er-he14400g, any14400g-14400g+, he9600g-he12000g+, er9600g-er12000g+, cr9600g-cr12000g+, he14400g-he18000g+, er14400g-er18000g+, cr14400g-cr18000g+, cr-er12000g+, er-he12000g+, cr-er18000g+, er-he18000g+

Notes

This element is mandatory.

Introduced16.0.R4

Platforms

7750 SR-1s, 7750 SR-2s, 7750 SR-2se, 7750 SR-7s, 7750 SR-14s, 7950 XRS

xconnect
Synopsis Enter the xconnect context
Context configure card number mda number xconnect
Treexconnect
Introduced21.5.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-s, 7950 XRS

mac [mac-id] number
Synopsis Enter the mac list instance
Context configure card number mda number xconnect mac number
Treemac

Description

Commands in this context configure the attributes of the MDA loopback (cross-connect) in the MAC chip.

Introduced21.5.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-s, 7950 XRS

[mac-id] number
Synopsis MAC ID for the MDA cross-connect
Context configure card number mda number xconnect mac number
Treemac
Range1 to 12

Notes

This element is part of a list key.

Introduced21.5.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-s, 7950 XRS

description string
Synopsis Text description
Context configure card number mda number xconnect mac number description string
Treedescription
String Length0 to 255
Introduced21.5.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-s, 7950 XRS

loopback [loopback-id] number
Synopsis Enter the loopback list instance
Contextconfigure card number mda number xconnect mac number loopback number
Treeloopback

Description

Commands in this context configure the attributes of the loopback on a MAC chip. The system and services can start using the loopback only when a port is associated with it (for example, port 1/1/m1/1, where m1 represents the MAC ID).

Introduced21.5.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-s, 7950 XRS

[loopback-id] number
Synopsis Loopback ID for the MDA cross-connect
Contextconfigure card number mda number xconnect mac number loopback number
Treeloopback
Range1 to 2

Notes

This element is part of a list key.

Introduced21.5.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-s, 7950 XRS

bandwidth number
WARNING:

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

SynopsisMaximum bandwidth for a Layer 2 rate for MAC loopback
Contextconfigure card number mda number xconnect mac number loopback number bandwidth number
Treebandwidth
Range10 | 25 | 40 | 100 | 400
Default100
Unitsgigabps
Introduced 21.5.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-s, 7950 XRS

description string
Synopsis Text description
Context configure card number mda number xconnect mac number loopback number description string
Treedescription
String Length0 to 255
Introduced21.5.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-s, 7950 XRS

power-save boolean

Synopsis Place card in power-save mode when not in use
Contextconfigure card number power-save boolean
Treepower-save

Description

When configured to true, this command enables the power-save mode on the card when it is not in use. The power-save mode allows the card to be installed and configured in a platform for future use, while having minimal impact on the overall power consumption.

A card placed in the power-save mode is reset, forced into an idle state, and consumes minimal power. In power save mode, the download of a software image to the card is not allowed. The card must be administratively disabled before it is placed in the power-save mode.

Cards in the power save mode do not count in the intelligent power management budget and they also do not pass traffic.

When configured to false, this command removes the card from power-save mode.

Defaultfalse
Introduced19.5.R1

Platforms

7450 ESS, 7750 SR-7/12/12e, 7750 SR-a8, 7750 SR-2e, 7750 SR-3e, 7750 SR-2s, 7750 SR-2se, 7750 SR-7s, 7750 SR-14s, 7950 XRS

reset-on-recoverable-error boolean

Synopsis Reset card for fatal memory parity error on a Q-chip
Contextconfigure card number reset-on-recoverable-error boolean
Treereset-on-recoverable-error

Description

When configured to true, the card is reset when a fatal memory parity error is detected on a Q-chip of the card, regardless of the setting of the fail-on-error configuration for the card.

When configured to false, the recovery action is taken instead of resetting the card.

Defaultfalse
Introduced16.0.R1

Platforms

7450 ESS, 7750 SR-7/12/12e

upgrade [upgrade-index] number

Synopsis Enter the upgrade list instance
Contextconfigure card number upgrade number
Treeupgrade

Description

Commands in this context assign a license level upgrade to the card, XIOM, or XMA. There can be multiple upgrades applied to a card, XIOM, or XMA. The first upgrade must use index 1, and then next index 2, and so on. Also, when removing upgrades, the largest index must be removed first, and then the next largest removed, and so on.

The path indicates the starting level and the new level that will apply due to the upgrade. For example, "cr1200g-cr1600g" can be applied to an XMA that is currently at the cr1200g level and after application of the upgrade, the operational level of the XMA will be cr1600g.

There must be an upgrade license available for the path specified. Available upgrades can be checked using the show licensing entitlements command.

Some upgrades require a hard reset of the card or MDA to take effect. In general, this is required when the Full Duplex bandwidth is being changed.

Introduced16.0.R4

Platforms

7450 ESS, 7750 SR, 7750 SR-1se

[upgrade-index] number
Synopsis Order of the upgrade value
Context configure card number upgrade number
Treeupgrade
Range1 to 6

Notes

This element is part of a list key.

Introduced16.0.R4

Platforms

7450 ESS, 7750 SR, 7750 SR-1se

path keyword
WARNING:

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

SynopsisUpgrade path of the target module for the slot
Contextconfigure card number upgrade number path keyword
Treepath

Description

This command configures the upgrade path associated with the upgrade instance for the target module in the slot. The path indicates the starting level and the new level that applies during the upgrade.

Optionscr-er, er-he, cr400g-cr1200g+, er400g-er1200g+, he400g-he1200g+, cr-er1200g+, er-he1200g+, cr-er400g+, er-he400g+, cr-er800g+, er-he800g+, cr400g-cr800g+, er400g-er800g+, he400g-he800g+, cr800g-cr1200g+, er800g-er1200g+, he800g-he1200g+, cr-er2400g, er-he2400g, any2400g-2400g+, cr-er4800g, er-he4800g, any4800g-4800g+, cr-er9600g, er-he9600g, cr-er14400g, er-he14400g, he9600g-he14400g, er9600g-er14400g, cr9600g-cr14400g, any14400g-14400g+, any2400g-2800g+, any4800g-6000g+, any14400g-18000g+, he2400g-he2800g+, er2400g-er2800g+, cr2400g-cr2800g+, he4800g-he6000g+, er4800g-er6000g+, cr4800g-cr6000g+, he14400g-he19200g, er14400g-er19200g, cr14400g-cr19200g, cr-er2800g+, er-he2800g+, cr-er6000g+, er-he6000g+, cr-er19200g, er-he19200g

Notes

This element is mandatory.

Introduced16.0.R4

Platforms

7450 ESS, 7750 SR, 7750 SR-1se

virtual-scheduler-adjustment

Synopsis Enter the virtual-scheduler-adjustment context
Contextconfigure card number virtual-scheduler-adjustment
Treevirtual-scheduler-adjustment
Introduced16.0.R1

Platforms

All

internal-scheduler-weight-mode keyword
Synopsis Internal scheduler weight mode
Context configure card number virtual-scheduler-adjustment internal-scheduler-weight-mode keyword
Treeinternal-scheduler-weight-mode

Description

This command specifies the internal scheduler (tier 0) weight mode for all ingress queues on a LAG on the card on which it is applied.

Defaultauto
Optionsauto, force-equal, offered-load, capped-offered-load
Introduced16.0.R1

Platforms

All

interval
Synopsis Enter the interval context
Context configure card number virtual-scheduler-adjustment interval
Treeinterval
Introduced16.0.R1

Platforms

All

rate-calculation-minimum
Synopsis Enter the rate-calculation-minimum context
Contextconfigure card number virtual-scheduler-adjustment interval rate-calculation-minimum
Treerate-calculation-minimum

Description

Commands in this context override the default minimum time that must elapse before a policer or queue’s offered rate can be recalculated. A minimum time between offered rate calculations is enforced to both prevent inaccurate estimation of the offered rate and excessive input to the virtual scheduler process.

To smooth out rapidly fluctuating offered rates, the system averages the measured offered rate with a window of previously measured offered traffic statistics and knowledge of the time between the samples.

Introduced16.0.R1

Platforms

All

scheduler-run-minimum decimal-number
Synopsis Minimum time of the scheduler run
Context configure card number virtual-scheduler-adjustment interval scheduler-run-minimum decimal-number
Treescheduler-run-minimum

Description

This command overrides the default minimum time that must elapse before a virtual scheduler can redistribute bandwidth based on changes to the offered rates of member policers or queues.

A minimum run interval is enforced to manage the number of batched queue changes before reacting to the changed rates. Because the periodic function of determining policer or queue offered rates is performed sequentially, the interval allows the policer and queue rates to be determined before the bandwidth distribution to the policers and queues.

Range0.01 to 1000.00
Default100.00
Units percent
Introduced16.0.R1

Platforms

All

task-scheduling decimal-number
Synopsis Task scheduling interval
Context configure card number virtual-scheduler-adjustment interval task-scheduling decimal-number
Treetask-scheduling

Description

This command overrides the system default time interval for scheduling the hierarchical virtual scheduler task.

By default, the system wakes the virtual scheduler task every 50 ms which is equivalent to five 10 ms timer ticks.

Range0.01 to 1000.00
Default100.00
Units percent
Introduced16.0.R1

Platforms

All

slow-queue-threshold-rate number
Synopsis Slow queue threshold rate
Context configure card number virtual-scheduler-adjustment slow-queue-threshold-rate number
Treeslow-queue-threshold-rate

Description

This command overrides the system default threshold rate used to place policers and queues in the slow queue category. Slow rate policers and queues use a different minimum rate calculation interval time than fast rate queues. 

The fast rate threshold is derived by multiplying the adjusted slow rate threshold by a factor of 1.5.

Configuring a value of zero (0) forces all policers and queues to be treated as fast rate queues.

Range0 to 1000000
Default1000
Units kilobps
Introduced16.0.R1

Platforms

All

xiom [xiom-slot] string

Synopsis Enter the xiom list instance
Context configure card number xiom string
Treexiom
Introduced20.2.R1

Platforms

7750 SR-1s, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

[xiom-slot] string
Synopsis XIOM slot ID
Contextconfigure card number xiom string
Treexiom
String Length2

Notes

This element is part of a list key.

Introduced20.2.R1

Platforms

7750 SR-1s, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

admin-state keyword
Synopsis Administrative state of the XIOM
Context configure card number xiom string admin-state keyword
Treeadmin-state
Defaultenable
Optionsenable, disable
Introduced20.2.R1

Platforms

7750 SR-1s, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

fail-on-error boolean
Synopsis Set operational state of the card to failed on error
Contextconfigure card number xiom string fail-on-error boolean
Treefail-on-error

Description

When configured to true, the operational state of the card is set to failed when at least one of a specific set of card-level errors is detected. The failed state persists until the operator reseats the card or resets it using the clear command.

Defaultfalse
Introduced20.2.R1

Platforms

7750 SR-1s, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

level keyword
WARNING:

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

SynopsisLicense level of the XIOM
Contextconfigure card number xiom string level keyword
Treelevel

Description

This command provisions the license level of the XIOM, which controls aspects related to connector provisioning and consumption of hardware egress queues and policers.

An XIOM only becomes operational if the provisioned license level matches the license level of the card installed into the slot.

The set of license levels varies by XIOM type. Changes to the provisioned license level may be blocked if a configuration exists that is not permitted with the new target license level. 

If the license level is not specified, the level is set to the highest license level for the XIOM.

Optionsunrestricted, he800g+, er800g+, cr800g+, he1500g+, er1500g+, cr1500g+, he1600g+, er1600g+, cr1600g+, he2400g+, er2400g+, cr2400g+, he3000g+, er3000g+, cr3000g+, he2400g, er2400g, cr2400g, he4800g, er4800g, cr4800g, he6000g+, er6000g+, cr6000g+
Introduced20.2.R1

Platforms

7750 SR-1s, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

mda [mda-slot] number
Synopsis Enter the mda list instance
Context configure card number xiom string mda number
Treemda
Introduced20.2.R1

Platforms

7750 SR-1s, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

[mda-slot] number
Synopsis MDA slot number
Context configure card number xiom string mda number
Treemda
Range1 to 2

Notes

This element is part of a list key.

Introduced20.2.R1

Platforms

7750 SR-1s, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

admin-state keyword
Synopsis Administrative state of the MDA
Context configure card number xiom string mda number admin-state keyword
Treeadmin-state
Defaultenable
Optionsenable, disable
Introduced20.2.R1

Platforms

7750 SR-1s, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

mda-type keyword
WARNING:

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

SynopsisMDA-s type provisioned for the XIOM slot
Contextconfigure card number xiom string mda number mda-type keyword
Treemda-type

Description

This command provisions the MDA-s type for the XIOM slot.

The MDA-s type can be preprovisioned, which means that the MDA-s does not have to be installed in the chassis. 

You can preprovision the MDA type before you install the MDA in the chassis. An MDA-s can only be provisioned in a slot that is vacant. No other MDA-s can be provisioned (configured) for that particular slot. An error message or log event is generated if the wrong MDA type is provisioned or inserted. 

Optionsms6-200gb-cfp2-dco, ms3-200gb-cfp2-dco, ms16-100gb-sfpdd+4-100gb-qsfp28, ms18-100gb-qsfp28, ms4-400gb-qsfpdd+4-100gb-qsfp28, ms24-10/100gb-sfpdd, ms2-400gb-qsfpdd+2-100gb-qsfp28, ms8-100gb-sfpdd+2-100gb-qsfp28, ms16-sdd+4-qsfp28-b, ms8-sdd+2-qsfp28-b
Introduced20.2.R1

Platforms

7750 SR-1s, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

power-priority-level number
Synopsis Power priority level for the XIOM MDA-s
Contextconfigure card number xiom string mda number power-priority-level number
Treepower-priority-level

Description

This command configures the power-priority level for the XIOM MDA-s.

Consider the following suggestions when configuring the power-priority level:

  • The lowest number has the highest priority.

  • Use the priority numbers from 1 to 100 for modules that are essential for system operation.

  • Use the priority numbers from 101 to 200 for non-essential modules.

Range1 to 200
Default150
Introduced 20.2.R1

Platforms

7750 SR-1s, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

sync-e keyword
Synopsis Synchronous Ethernet capability
Context configure card number xiom string mda number sync-e keyword
Treesync-e
Optionstrue, false
Introduced 20.2.R1

Platforms

7750 SR-1s, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

xconnect
Synopsis Enter the xconnect context
Context configure card number xiom string mda number xconnect
Treexconnect
Introduced21.5.R1

Platforms

7750 SR-1s, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

mac [mac-id] number
Synopsis Enter the mac list instance
Context configure card number xiom string mda number xconnect mac number
Treemac
Introduced21.5.R1

Platforms

7750 SR-1s, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

[mac-id] number
Synopsis MAC ID for the MDA cross-connect
Context configure card number xiom string mda number xconnect mac number
Treemac
Range1 to 12

Notes

This element is part of a list key.

Introduced21.5.R1

Platforms

7750 SR-1s, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

description string
Synopsis Text description
Context configure card number xiom string mda number xconnect mac number description string
Treedescription
String Length0 to 255
Introduced21.5.R1

Platforms

7750 SR-1s, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

loopback [loopback-id] number
Synopsis Enter the loopback list instance
Contextconfigure card number xiom string mda number xconnect mac number loopback number
Treeloopback

Description

Commands in this context configure a MAC loopback on a MAC chip. The system and services only start using the loopback when a port is associated with it. For example, port 1/1/m1/1, where m1 represents the MAC ID.

Introduced21.5.R1

Platforms

7750 SR-1s, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

[loopback-id] number
Synopsis Loopback ID for the MDA cross-connect
Contextconfigure card number xiom string mda number xconnect mac number loopback number
Treeloopback
Range1 to 2

Notes

This element is part of a list key.

Introduced21.5.R1

Platforms

7750 SR-1s, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

bandwidth number
WARNING:

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

SynopsisMaximum bandwidth for a Layer 2 rate for MAC loopback
Contextconfigure card number xiom string mda number xconnect mac number loopback number bandwidth number
Treebandwidth
Range10 | 25 | 40 | 100 | 400
Default100
Unitsgigabps
Introduced 21.5.R1

Platforms

7750 SR-1s, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

description string
Synopsis Text description
Context configure card number xiom string mda number xconnect mac number loopback number description string
Treedescription
String Length0 to 255
Introduced21.5.R1

Platforms

7750 SR-1s, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

reset-on-recoverable-error boolean
Synopsis Reset XIOM for fatal memory parity error on a Q-chip
Contextconfigure card number xiom string reset-on-recoverable-error boolean
Treereset-on-recoverable-error

Description

When configured to true, the XIOM is reset when a fatal memory parity error is detected on a Q-chip of the XIOM, regardless of the setting of the fail-on-error configuration for the XIOM.

When configured to false, the recovery action is taken instead of resetting the XIOM.

Defaultfalse
Introduced20.2.R1

Platforms

7750 SR-1s, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

upgrade [upgrade-index] number
Synopsis Enter the upgrade list instance
Contextconfigure card number xiom string upgrade number
Treeupgrade

Description

Commands in this context assign a license level upgrade to the XIOM. Multiple upgrades can be applied to an XIOM. The first upgrade must use index 1, then index 2, and so on. When removing upgrades, the largest index must be removed first, followed by the next largest, and so on.

Some upgrades require a hard reset of the XIOM to take effect. In general, this is required when the Full Duplex bandwidth is changed as a result of the upgrade.

Introduced20.2.R1

Platforms

7750 SR-1s, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

[upgrade-index] number
Synopsis Order of the upgrade value
Context configure card number xiom string upgrade number
Treeupgrade
Range1 to 6

Notes

This element is part of a list key.

Introduced20.2.R1

Platforms

7750 SR-1s, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

path keyword
WARNING:

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

SynopsisUpgrade name
Contextconfigure card number xiom string upgrade number path keyword
Treepath

Description

This command specifies the upgrade name. An upgrade license must be available for the specified path.

Available upgrades can be checked using the show licensing entitlements command.

Optionscr800g-cr1500g+, er800g-er1500g+, he800g-he1500g+, cr1600g-cr2400g+, er1600g-er2400g+, he1600g-he2400g+, cr2400g-cr3000g+, er2400g-er3000g+, he2400g-he3000g+, cr-er800g+, er-he800g+, cr-er1500g+, er-he1500g+, cr-er1600g+, er-he1600g+, cr-er2400g+, er-he2400g+, cr-er3000g+, er-he3000g+, cr4800g-cr6000g+, er4800g-er6000g+, he4800g-he6000g+, cr-er2400g, er-he2400g, cr-er4800g, er-he4800g, cr-er6000g+, er-he6000g+

Notes

This element is mandatory.

Introduced20.2.R1

Platforms

7750 SR-1s, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

xiom-type keyword
WARNING:

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

SynopsisXIOM type
Contextconfigure card number xiom string xiom-type keyword
Treexiom-type

Description

This command associates the XIOM type with the slot.

The XIOM type can be preprovisioned, which means that the XIOM does not have to be installed in the chassis. 

An XIOM must be provisioned before an MDA-s, a connector, or a port can be configured. An XIOM can only be provisioned in a slot that is vacant. After an XIOM is provisioned in the slot, no other XIOM can be provisioned (configured) for the slot. 

An XIOM can only be provisioned in a slot if the XIOM type is allowed in the slot. An error message is generated if an attempt is made to provision an XIOM type that is not allowed.

If an XIOM is inserted that does not match the configured XIOM type for the slot, then a log event and a facility alarm are raised. The alarm is cleared when the correct XIOM type is installed or the configuration is modified. 

A log event and a facility alarm are raised if an administratively enabled XIOM is removed from the chassis. The alarm is cleared when the correct XIOM type is installed or the configuration is modified. A log event is issued when an XIOM is removed that is administratively disabled.

XIOMs are controlled by hardware and software licensing. In addition to the XIOM type, the license level must be provisioned using the level command.

Optionsiom-s-3.0t, iom-s-1.5t
Introduced 20.2.R1

Platforms

7750 SR-1s, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s