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
clock-mode 
mode keyword
timestamp-freq number
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
  Tree card
 

Description

Commands in this context cover attributes for specific chassis slots for physical cards.

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

  Introduced 16.0.R1
 

Platforms

All

[slot-number] number

  Synopsis Slot number within the chassis
  Context configure card number
 

Description

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

  Range 1 to 20
 

Notes

This element is part of a list key.

  Introduced 16.0.R1
 

Platforms

All

admin-state keyword

  Synopsis Administrative state of the card
  Context configure card number admin-state keyword
  Tree admin-state
  Default enable
  Options enable, disable
  Introduced 16.0.R1
 

Platforms

All

card-type keyword

WARNING:

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

  Synopsis Card type
  Context configure card number card-type keyword
  Tree card-type
  Options xcm-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, i24-800g-qsfpdd-1, imm36-800g-qsfpdd, i48-400g-qsfpdd-1, i40-200g-sfpdd+6-800g-qsfpdd-1, i80-200g-sfpdd+12-800g-qsfpdd-1x
  Introduced 16.0.R1
 

Platforms

All

fail-on-error boolean

  Synopsis Set operational state of the card to Failed upon error
  Context configure card number fail-on-error boolean
  Tree fail-on-error
  Default false
  Introduced 16.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.

  Synopsis Filter profile for the card
  Context configure card number filter-profile keyword
  Tree filter-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. 

  Default none
  Options none, profile-a
  Introduced 19.10.R1
 

Platforms

7750 SR-a

fp [fp-number] number

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

Description

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

  Introduced 16.0.R1
 

Platforms

All

[fp-number] number
  Synopsis Forwarding plane within the card
  Context configure card number fp number
  Range 1 to 12
 

Notes

This element is part of a list key.

  Introduced 16.0.R1
 

Platforms

All

egress
  Synopsis Enter the egress context
  Context configure card number fp number egress
  Tree egress
  Introduced 16.0.R1
 

Platforms

All

hs-fixed-high-thresh-delta number
  Synopsis High threshold delta on the forwarding plane
  Context configure card number fp number egress hs-fixed-high-thresh-delta number
  Tree hs-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.

  Range 0 to 65536
  Introduced 16.0.R1
 

Platforms

7750 SR-7/12/12e

hs-pool-policy reference
  Synopsis HS pool policy
  Context configure card number fp number egress hs-pool-policy reference
  Tree hs-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

  Introduced 16.0.R1
 

Platforms

7750 SR-7/12/12e

wred-queue-control
  Synopsis Enter the wred-queue-control context
  Context configure card number fp number egress wred-queue-control
  Tree wred-queue-control
 

Description

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

  Introduced 16.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
  Context configure card number fp number egress wred-queue-control admin-state keyword
  Tree admin-state
  Default disable
  Options enable, disable
  Introduced 16.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
  Context configure card number fp number egress wred-queue-control buffer-allocation decimal-number
  Tree buffer-allocation
 

Description

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

  Range 0.01 to 99.99
  Default 25.00
  Units percent
  Introduced 16.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
  Context configure card number fp number egress wred-queue-control reserved-cbs decimal-number
  Tree reserved-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.

  Range 0.01 to 99.99
  Default 25.00
  Units percent
  Introduced 16.0.R1
 

Platforms

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

slope-policy reference
  Synopsis Slope policy for the forwarding plane
  Context configure card number fp number egress wred-queue-control slope-policy reference
  Tree slope-policy
 

Reference

configure qos slope-policy string

  Introduced 16.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.

  Synopsis FP resource policy to manage resources on the FP4
  Context configure card number fp number fp-resource-policy reference
  Tree fp-resource-policy
 

Description

This command configures an FP resource policy used to manage resources on an FP4 forwarding plane.

The system creates a default policy that applies to all FP4 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.

The system supports a maximum of 15 FP resource policies.

 

Reference

configure qos fp-resource-policy string

  Introduced 20.2.R1
 

Platforms

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

hi-bw-mcast-src
  Synopsis Enable the hi-bw-mcast-src context
  Context configure card number fp number hi-bw-mcast-src
  Tree hi-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.

  Introduced 16.0.R1
 

Platforms

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

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

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.

  Default false
  Introduced 16.0.R1
 

Platforms

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

default-paths-only boolean
  Synopsis Allocate the default paths to dedicated MSFPs
  Context configure card number fp number hi-bw-mcast-src default-paths-only boolean
  Tree default-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.

  Default false
  Introduced 16.0.R1
 

Platforms

7450 ESS, 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
  Tree group
 

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.

  Range 0 to 32
  Default 0
  Introduced 16.0.R1
 

Platforms

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

ingress
  Synopsis Enter the ingress context
  Context configure card number fp number ingress
  Tree ingress
  Introduced 16.0.R1
 

Platforms

All

access
  Synopsis Enter the access context
  Context configure card number fp number ingress access
  Tree access
  Introduced 16.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
  Context configure card number fp number ingress access queue-group reference instance-id number
  Tree queue-group
 

Description

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

  Introduced 16.0.R1
 

Platforms

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

[queue-group-name] reference
  Synopsis Queue group name
  Context configure card number fp number ingress access queue-group reference instance-id number
 

Reference

configure qos queue-group-templates ingress queue-group string

 

Notes

This element is part of a list key.

  Introduced 16.0.R1
 

Platforms

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

instance-id number
  Synopsis Instance ID
  Context configure card number fp number ingress access queue-group reference instance-id number
  Range 1 to 65535
 

Notes

This element is part of a list key.

  Introduced 16.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
  Context configure card number fp number ingress access queue-group reference instance-id number accounting-policy reference
  Tree accounting-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

  Introduced 16.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
  Context configure card number fp number ingress access queue-group reference instance-id number collect-stats boolean
  Tree collect-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.

  Default false
  Introduced 16.0.R1
 

Platforms

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

description string
  Synopsis Text description
  Context configure card number fp number ingress access queue-group reference instance-id number description string
  Tree description
  String Length 1 to 80
  Introduced 16.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
  Context configure card number fp number ingress access queue-group reference instance-id number policer-control-policy
  Tree policer-control-policy
  Introduced 16.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
  Tree overrides
  Introduced 16.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)
  Tree max-rate
  Range 1 to 2000000000
  Units kilobps
  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
  Context configure card number fp number ingress access queue-group reference instance-id number policer-control-policy overrides priority-mbs-thresholds
  Tree priority-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.

  Introduced 16.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
  Context configure card number fp number ingress access queue-group reference instance-id number policer-control-policy overrides priority-mbs-thresholds min-threshold-separation (number | keyword)
  Tree min-threshold-separation
 

Description

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

  Range 0 to 16777216
  Units bytes
  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
  Context configure card number fp number ingress access queue-group reference instance-id number policer-control-policy overrides priority-mbs-thresholds priority number
  Tree priority
  Introduced 16.0.R1
 

Platforms

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

[level] number
  Synopsis Priority level, higher number is stricter
  Context configure card number fp number ingress access queue-group reference instance-id number policer-control-policy overrides priority-mbs-thresholds priority number
  Range 1 to 8
 

Notes

This element is part of a list key.

  Introduced 16.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)
  Tree mbs-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.

  Range 0 to 16777216
  Units bytes
  Options auto
  Introduced 16.0.R1
 

Platforms

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

policy-name reference
  Synopsis Policer control policy name
  Context configure card number fp number ingress access queue-group reference instance-id number policer-control-policy policy-name reference
  Tree policy-name
 

Reference

configure qos policer-control-policy string

  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
  Context configure card number fp number ingress access queue-group reference instance-id number policer-overrides
  Tree policer-overrides
 

Description

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

  Introduced 16.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
  Context configure card number fp number ingress access queue-group reference instance-id number policer-overrides policer reference
  Tree policer
 

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.

  Introduced 16.0.R1
 

Platforms

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

[policer-id] reference
  Synopsis Policer ID
  Context configure card number fp number ingress access queue-group reference instance-id number policer-overrides policer reference
 

Reference

configure qos queue-group-templates ingress queue-group string policer number

 

Notes

This element is part of a list key.

  Introduced 16.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)
  Tree cbs
 

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.

  Range 0 to 268435456
  Units bytes
  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
  Context configure card number fp number ingress access queue-group reference instance-id number policer-overrides policer reference mbs (number | keyword)
  Tree mbs
 

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.

  Range 0 to 268435456
  Units bytes
  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
  Tree packet-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
  Introduced 16.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
  Tree rate
 

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.

  Introduced 16.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)
  Tree cir
 

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.

  Range 0 to 2000000000
  Units kilobps
  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)
  Tree pir
 

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.

  Range 1 to 2000000000
  Units kilobps
  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
  Tree stat-mode
 

Description

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

  Options no-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
  Introduced 16.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
  Context configure card number fp number ingress dist-cpu-protection
  Tree dist-cpu-protection
 

Description

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

  Introduced 21.2.R1
 

Platforms

All

dynamic-enforcement-policer-pool number
  Synopsis Number of policers reserved as enforcement policers use
  Context configure card number fp number ingress dist-cpu-protection dynamic-enforcement-policer-pool number
  Tree dynamic-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).

  Range 1000 to 32000
  Introduced 21.2.R1
 

Platforms

All

mcast-path-management
  Synopsis Enter the mcast-path-management context
  Context configure card number fp number ingress mcast-path-management
  Tree mcast-path-management
 

Description

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

  Introduced 16.0.R1
 

Platforms

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

admin-state keyword
  Synopsis Administrative state of multicast path management
  Context configure card number fp number ingress mcast-path-management admin-state keyword
  Tree admin-state
  Default disable
  Options enable, disable
  Introduced 16.0.R1
 

Platforms

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

bandwidth-policy reference
  Synopsis Bandwidth policy for ingress multicast path management
  Context configure card number fp number ingress mcast-path-management bandwidth-policy reference
  Tree bandwidth-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

  Introduced 16.0.R1
 

Platforms

7450 ESS, 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
  Tree network
 

Description

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

  Introduced 16.0.R1
 

Platforms

All

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

Description

Commands in this context assign a buffer pool to all ingress network ports on a specific FP.

  Introduced 19.5.R1
 

Platforms

All

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

Notes

This element is part of a list key.

  Introduced 19.5.R1
 

Platforms

All

amber-alarm-threshold number
  Synopsis Amber alarm threshold allowed on oversubscription
  Context configure card number fp number ingress network pool string amber-alarm-threshold number
  Tree amber-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.

  Range 1 to 1000
  Units percent
  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
  Context configure card number fp number ingress network pool string red-alarm-threshold number
  Tree red-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.

  Range 1 to 1000
  Units percent
  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
  Tree resv-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.

  Introduced 19.5.R1
 

Platforms

All

amber-alarm-action
  Synopsis Enter the amber-alarm-action context
  Context configure card number fp number ingress network pool string resv-cbs amber-alarm-action
  Tree amber-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.

  Introduced 19.5.R1
 

Platforms

All

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

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.

  Range 1 to 100
  Units percent
  Introduced 19.5.R1
 

Platforms

All

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

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.

  Range 1 to 100
  Units percent
  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
  Tree cbs
 

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%.

  Range 0 to 100
  Units percent
  Introduced 19.5.R1
 

Platforms

All

slope-policy reference
  Synopsis Slope policy
  Context configure card number fp number ingress network pool string slope-policy reference
  Tree slope-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

  Introduced 19.5.R1
 

Platforms

All

queue-group [queue-group-name] reference instance-id number
  Synopsis Enter the queue-group list instance
  Context configure card number fp number ingress network queue-group reference instance-id number
  Tree queue-group
 

Description

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

  Introduced 16.0.R1
 

Platforms

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

[queue-group-name] reference
  Synopsis Queue group name
  Context configure card number fp number ingress network queue-group reference instance-id number
 

Reference

configure qos queue-group-templates ingress queue-group string

 

Notes

This element is part of a list key.

  Introduced 16.0.R1
 

Platforms

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

instance-id number
  Synopsis Instance ID
  Context configure card number fp number ingress network queue-group reference instance-id number
  Range 1 to 65535
 

Notes

This element is part of a list key.

  Introduced 16.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
  Context configure card number fp number ingress network queue-group reference instance-id number accounting-policy reference
  Tree accounting-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

  Introduced 16.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
  Context configure card number fp number ingress network queue-group reference instance-id number collect-stats boolean
  Tree collect-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.

  Default false
  Introduced 16.0.R1
 

Platforms

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

description string
  Synopsis Text description
  Context configure card number fp number ingress network queue-group reference instance-id number description string
  Tree description
  String Length 1 to 80
  Introduced 16.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
  Context configure card number fp number ingress network queue-group reference instance-id number policer-control-policy
  Tree policer-control-policy
 

Description

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

  Introduced 16.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
  Tree overrides
 

Description

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

  Introduced 16.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)
  Tree max-rate
  Range 1 to 2000000000
  Units kilobps
  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
  Context configure card number fp number ingress network queue-group reference instance-id number policer-control-policy overrides priority-mbs-thresholds
  Tree priority-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.

  Introduced 16.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
  Context configure card number fp number ingress network queue-group reference instance-id number policer-control-policy overrides priority-mbs-thresholds min-threshold-separation (number | keyword)
  Tree min-threshold-separation
 

Description

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

  Range 0 to 16777216
  Units bytes
  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
  Context configure card number fp number ingress network queue-group reference instance-id number policer-control-policy overrides priority-mbs-thresholds priority number
  Tree priority
 

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.

  Introduced 16.0.R1
 

Platforms

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

[level] number
  Synopsis Priority level, higher number is stricter
  Context configure card number fp number ingress network queue-group reference instance-id number policer-control-policy overrides priority-mbs-thresholds priority number
  Range 1 to 8
 

Notes

This element is part of a list key.

  Introduced 16.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)
  Tree mbs-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.

  Range 0 to 16777216
  Units bytes
  Options auto
  Introduced 16.0.R1
 

Platforms

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

policy-name reference
  Synopsis Policer control policy name
  Context configure card number fp number ingress network queue-group reference instance-id number policer-control-policy policy-name reference
  Tree policy-name
 

Reference

configure qos policer-control-policy string

  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
  Context configure card number fp number ingress network queue-group reference instance-id number policer-overrides
  Tree policer-overrides
 

Description

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

  Introduced 16.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
  Context configure card number fp number ingress network queue-group reference instance-id number policer-overrides policer reference
  Tree policer
 

Description

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

  Introduced 16.0.R1
 

Platforms

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

[policer-id] reference
  Synopsis Policer ID
  Context configure card number fp number ingress network queue-group reference instance-id number policer-overrides policer reference
 

Reference

configure qos queue-group-templates ingress queue-group string policer number

 

Notes

This element is part of a list key.

  Introduced 16.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)
  Tree cbs
 

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.

  Range 0 to 268435456
  Units bytes
  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
  Context configure card number fp number ingress network queue-group reference instance-id number policer-overrides policer reference mbs (number | keyword)
  Tree mbs
 

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.

  Range 0 to 268435456
  Units bytes
  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
  Tree packet-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
  Introduced 16.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
  Tree rate
 

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.

  Introduced 16.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)
  Tree cir
 

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.

  Range 0 to 2000000000
  Units kilobps
  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)
  Tree pir
 

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.

  Range 1 to 2000000000
  Units kilobps
  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
  Tree stat-mode
 

Description

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

  Options no-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
  Introduced 16.0.R1
 

Platforms

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

queue-policy reference
  Synopsis Network queue policy
  Context configure card number fp number ingress network queue-policy reference
  Tree queue-policy
 

Reference

configure qos network-queue string

  Introduced 19.5.R1
 

Platforms

All

policy-accounting
  Synopsis Enter the policy-accounting context
  Context configure card number fp number ingress policy-accounting
  Tree policy-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.

  Introduced 20.10.R1
 

Platforms

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

classes number
  Synopsis Number of accounting classes for the forwarding plane
  Context configure card number fp number ingress policy-accounting classes number
  Tree classes
 

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.

  Range 1000 to 128000
  Introduced 21.2.R1
 

Platforms

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

policers number
  Synopsis Number of policer resources for policy accounting
  Context configure card number fp number ingress policy-accounting policers number
  Tree policers
  Range 1 to 64000
  Introduced 20.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
  Context configure card number fp number ingress-buffer-allocation decimal-number
  Tree ingress-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.

  Range 20.00 to 80.00
  Default 50.00
  Units percent
  Introduced 16.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
  Context configure card number fp number init-extract-prio-mode keyword
  Tree init-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.

  Default uniform
  Options uniform, l3-classify
  Introduced 16.0.R1
 

Platforms

All

stable-pool-sizing boolean
  Synopsis Enable stable pool sizing for the forwarding plane
  Context configure card number fp number stable-pool-sizing boolean
  Tree stable-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.

  Default false
  Introduced 16.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.

  Synopsis License level of the card
  Context configure card number level keyword
  Tree level
 

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.

  Options unrestricted, 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+
  Introduced 16.0.R1
 

Platforms

7450 ESS, 7750 SR

mda [mda-slot] number

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

Description

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

  Introduced 16.0.R1
 

Platforms

All

[mda-slot] number
  Synopsis MDA or XMA slot
  Context configure card number mda number
  Range 1 to 6
 

Notes

This element is part of a list key.

  Introduced 16.0.R1
 

Platforms

All

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

Description

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

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

  Introduced 16.0.R1
 

Platforms

All

egress
  Synopsis Enter the egress context
  Context configure card number mda number access egress
  Tree egress
  Introduced 16.0.R1
 

Platforms

All

ingress
  Synopsis Enter the ingress context
  Context configure card number mda number access ingress
  Tree ingress
  Introduced 16.0.R1
 

Platforms

All

admin-state keyword
  Synopsis Administrative state of the MDA
  Context configure card number mda number admin-state keyword
  Tree admin-state
  Default enable
  Options enable, disable
  Introduced 16.0.R1
 

Platforms

All

clock-mode
  Synopsis Enter the clock-mode context
  Context configure card number mda number clock-mode
  Tree clock-mode
 

Description

Commands in this context define the clock mode on the MDA.

This context is supported only on CES MDAs.

  Introduced 16.0.R1
 

Platforms

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

mode keyword
  Synopsis Clock mode
  Context configure card number mda number clock-mode mode keyword
  Tree mode
  Options adaptive, differential
  Introduced 16.0.R1
 

Platforms

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

timestamp-freq number
  Synopsis Differential timestamp frequency
  Context configure card number mda number clock-mode timestamp-freq number
  Tree timestamp-freq
  Range 19440 | 77760 | 103680
  Introduced 16.0.R1
 

Platforms

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

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

Description

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

  Introduced 16.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
  Tree threshold
 

Description

This command configures the threshold for XPL errors. When the threshold is exceeded within the time interval specified by the window number command, the MDA is place in the Failed state.

  Range 1 to 1000000
  Default 1000
  Units xpl errors
  Introduced 16.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
  Context configure card number mda number egress-xpl window number
  Tree window
 

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 the specified time interval, the MDA is placed in the Failed state.

  Range 1 to 1440
  Default 60
  Units minutes
  Introduced 16.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
  Tree event
 

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.

  Introduced 19.7.R1
 

Platforms

All

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

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.

  Options soft-error, internal-frame-loss, memory-error, datapath-link-error
 

Notes

This element is part of a list key.

  Introduced 19.7.R1
 

Platforms

All

action keyword
  Synopsis Action when a specific hardware error event is raised
  Context configure card number mda number event keyword action keyword
  Tree action
 

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).

  Options none, 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
  Context configure card number mda number fail-on-error boolean
  Tree fail-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.

  Default false
  Introduced 16.0.R1
 

Platforms

All

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

Description

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

  Introduced 16.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
  Tree threshold
 

Description

This command configures the threshold for XPL errors. When the threshold is exceeded within the time interval specified by the window number command, the MDA is place in the Failed state.

  Range 1 to 1000000
  Default 1000
  Units xpl errors
  Introduced 16.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
  Context configure card number mda number ingress-xpl window number
  Tree window
 

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 the specified time interval, the MDA is placed in the Failed state.

  Range 1 to 1440
  Default 60
  Units minutes
  Introduced 16.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.

  Synopsis MDA card level
  Context configure card number mda number level keyword
  Tree level
  Options unrestricted, 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+
  Introduced 16.0.R1
 

Platforms

7750 SR-s, 7950 XRS

mda-type keyword
WARNING:

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

  Synopsis MDA type for the slot
  Context configure card number mda number mda-type keyword
  Tree mda-type
  Options x12-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, 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, m48-400g-qsfpdd-1, m80-200g-sfpdd+12-800g-qsfpdd-1x, m40-200g-sfpdd+6-800g-qsfpdd-1, m2-cfp2, me16-25gb-sfp28+2-100gb-qsfp-b
  Introduced 16.0.R1
 

Platforms

All

network
  Synopsis Enter the network context
  Context configure card number mda number network
  Tree network
 

Description

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

Network egress pools are only allocated on channelized MDAs.

  Introduced 16.0.R1
 

Platforms

All

egress
  Synopsis Enter the egress context
  Context configure card number mda number network egress
  Tree egress
  Introduced 16.0.R1
 

Platforms

All

ingress
  Synopsis Enter the ingress context
  Context configure card number mda number network ingress
  Tree ingress
  Introduced 16.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
  Tree power-priority-level
  Range 1 to 200
  Default 150
  Introduced 16.0.R1
 

Platforms

7750 SR-s, 7950 XRS

reset-on-recoverable-error boolean
  Synopsis Reset MDA for fatal memory parity error on a Q-chip
  Context configure card number mda number reset-on-recoverable-error boolean
  Tree reset-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.

  Default false
  Introduced 16.0.R1
 

Platforms

7750 SR-s, 7950 XRS

sync-e keyword
  Synopsis Synchronous Ethernet capability
  Context configure card number mda number sync-e keyword
  Tree sync-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 sync-if-timing configuration.

  Options true, false
  Introduced 16.0.R1
 

Platforms

All

upgrade [upgrade-index] number
  Synopsis Enter the upgrade list instance
  Context configure card number mda number upgrade number
  Tree upgrade
 

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.

  Introduced 16.0.R4
 

Platforms

7750 SR-s, 7950 XRS

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

Notes

This element is part of a list key.

  Introduced 16.0.R4
 

Platforms

7750 SR-s, 7950 XRS

path keyword
WARNING:

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

  Synopsis Upgrade path of the MDA for the slot
  Context configure card number mda number upgrade number path keyword
  Tree path
 

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.

  Options cr1200g-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+
 

Notes

This element is mandatory.

  Introduced 16.0.R4
 

Platforms

7750 SR-s, 7950 XRS

xconnect
  Synopsis Enter the xconnect context
  Context configure card number mda number xconnect
  Tree xconnect
  Introduced 21.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
  Tree mac
 

Description

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

  Introduced 21.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
  Range 1 to 12
 

Notes

This element is part of a list key.

  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 description string
  Tree description
  String Length 0 to 255
  Introduced 21.5.R1
 

Platforms

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

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

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).

  Introduced 21.5.R1
 

Platforms

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

[loopback-id] number
  Synopsis Loopback ID for the MDA cross-connect
  Context configure card number mda number xconnect mac number loopback number
  Range 1 to 2
 

Notes

This element is part of a list key.

  Introduced 21.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.

  Synopsis Maximum bandwidth for a Layer 2 rate for MAC loopback
  Context configure card number mda number xconnect mac number loopback number bandwidth number
  Tree bandwidth
  Range 10 | 25 | 40 | 100 | 400
  Default 100
  Units gigabps
  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
  Tree description
  String Length 0 to 255
  Introduced 21.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
  Context configure card number power-save boolean
  Tree power-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.

  Default false
  Introduced 19.5.R1
 

Platforms

7450 ESS, 7750 SR-7/12/12e, 7750 SR-a8, 7750 SR-2e, 7750 SR-3e, 7750 SR-2s, 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
  Context configure card number reset-on-recoverable-error boolean
  Tree reset-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.

  Default false
  Introduced 16.0.R1
 

Platforms

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

upgrade [upgrade-index] number

  Synopsis Enter the upgrade list instance
  Context configure card number upgrade number
  Tree upgrade
 

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.

  Introduced 16.0.R4
 

Platforms

7450 ESS, 7750 SR

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

Notes

This element is part of a list key.

  Introduced 16.0.R4
 

Platforms

7450 ESS, 7750 SR

path keyword
WARNING:

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

  Synopsis Upgrade path of the I/O module for the slot
  Context configure card number upgrade number path keyword
  Tree path
 

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.

  Options cr-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+
 

Notes

This element is mandatory.

  Introduced 16.0.R4
 

Platforms

7450 ESS, 7750 SR

virtual-scheduler-adjustment

  Synopsis Enter the virtual-scheduler-adjustment context
  Context configure card number virtual-scheduler-adjustment
  Tree virtual-scheduler-adjustment
 

Description

Commands in this context configure virtual scheduler parameters.

This is only applicable to queues and policers associated to a scheduler.

  Introduced 16.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
  Tree internal-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.

  Default auto
  Options auto, force-equal, offered-load, capped-offered-load
  Introduced 16.0.R1
 

Platforms

All

interval
  Synopsis Enter the interval context
  Context configure card number virtual-scheduler-adjustment interval
  Tree interval
  Introduced 16.0.R1
 

Platforms

All

rate-calculation-minimum
  Synopsis Enter the rate-calculation-minimum context
  Context configure card number virtual-scheduler-adjustment interval rate-calculation-minimum
  Tree rate-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.

  Introduced 16.0.R1
 

Platforms

All

fast-queue decimal-number
  Synopsis Minimum rate calculation time for fast queues
  Context configure card number virtual-scheduler-adjustment interval rate-calculation-minimum fast-queue decimal-number
  Tree fast-queue
  Range 0.01 to 1000.00
  Default 100.00
  Units percent
  Introduced 16.0.R1
 

Platforms

All

slow-queue decimal-number
  Synopsis Minimum rate calculation time for slow queues
  Context configure card number virtual-scheduler-adjustment interval rate-calculation-minimum slow-queue decimal-number
  Tree slow-queue
  Range 0.01 to 1000.00
  Default 100.00
  Units percent
  Introduced 16.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
  Tree scheduler-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.

  Range 0.01 to 1000.00
  Default 100.00
  Units percent
  Introduced 16.0.R1
 

Platforms

All

task-scheduling decimal-number
  Synopsis Task scheduling interval
  Context configure card number virtual-scheduler-adjustment interval task-scheduling decimal-number
  Tree task-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.

  Range 0.01 to 1000.00
  Default 100.00
  Units percent
  Introduced 16.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
  Tree slow-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.

  Range 0 to 1000000
  Default 1000
  Units kilobps
  Introduced 16.0.R1
 

Platforms

All

xiom [xiom-slot] string

  Synopsis Enter the xiom list instance
  Context configure card number xiom string
  Tree xiom
  Introduced 20.2.R1
 

Platforms

7750 SR-s

[xiom-slot] string
  Synopsis XIOM slot ID
  Context configure card number xiom string
  String Length 2
 

Notes

This element is part of a list key.

  Introduced 20.2.R1
 

Platforms

7750 SR-s

admin-state keyword
  Synopsis Administrative state of the XIOM
  Context configure card number xiom string admin-state keyword
  Tree admin-state
  Default enable
  Options enable, disable
  Introduced 20.2.R1
 

Platforms

7750 SR-s

fail-on-error boolean
  Synopsis Set operational state of the card to failed on error
  Context configure card number xiom string fail-on-error boolean
  Tree fail-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.

  Default false
  Introduced 20.2.R1
 

Platforms

7750 SR-s

level keyword
WARNING:

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

  Synopsis License level of the XIOM
  Context configure card number xiom string level keyword
  Tree level
 

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.

  Options unrestricted, he800g+, er800g+, cr800g+, he1500g+, er1500g+, cr1500g+, he1600g+, er1600g+, cr1600g+, he2400g+, er2400g+, cr2400g+, he3000g+, er3000g+, cr3000g+
  Introduced 20.2.R1
 

Platforms

7750 SR-s

mda [mda-slot] number
  Synopsis Enter the mda list instance
  Context configure card number xiom string mda number
  Tree mda
  Introduced 20.2.R1
 

Platforms

7750 SR-s

[mda-slot] number
  Synopsis MDA slot number
  Context configure card number xiom string mda number
  Range 1 to 2
 

Notes

This element is part of a list key.

  Introduced 20.2.R1
 

Platforms

7750 SR-s

admin-state keyword
  Synopsis Administrative state of the MDA
  Context configure card number xiom string mda number admin-state keyword
  Tree admin-state
  Default enable
  Options enable, disable
  Introduced 20.2.R1
 

Platforms

7750 SR-s

mda-type keyword
WARNING:

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

  Synopsis MDA-s type provisioned for the XIOM slot
  Context configure card number xiom string mda number mda-type keyword
  Tree mda-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. 

  Options ms6-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
  Introduced 20.2.R1
 

Platforms

7750 SR-s

power-priority-level number
  Synopsis Power priority level for the XIOM MDA-s
  Context configure card number xiom string mda number power-priority-level number
  Tree power-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.

  Range 1 to 200
  Default 150
  Introduced 20.2.R1
 

Platforms

7750 SR-s

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

Platforms

7750 SR-s

xconnect
  Synopsis Enter the xconnect context
  Context configure card number xiom string mda number xconnect
  Tree xconnect
  Introduced 21.5.R1
 

Platforms

7750 SR-s

mac [mac-id] number
  Synopsis Enter the mac list instance
  Context configure card number xiom string mda number xconnect mac number
  Tree mac
  Introduced 21.5.R1
 

Platforms

7750 SR-s

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

Notes

This element is part of a list key.

  Introduced 21.5.R1
 

Platforms

7750 SR-s

description string
  Synopsis Text description
  Context configure card number xiom string mda number xconnect mac number description string
  Tree description
  String Length 0 to 255
  Introduced 21.5.R1
 

Platforms

7750 SR-s

loopback [loopback-id] number
  Synopsis Enter the loopback list instance
  Context configure card number xiom string mda number xconnect mac number loopback number
  Tree loopback
 

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.

  Introduced 21.5.R1
 

Platforms

7750 SR-s

[loopback-id] number
  Synopsis Loopback ID for the MDA cross-connect
  Context configure card number xiom string mda number xconnect mac number loopback number
  Range 1 to 2
 

Notes

This element is part of a list key.

  Introduced 21.5.R1
 

Platforms

7750 SR-s

bandwidth number
WARNING:

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

  Synopsis Maximum bandwidth for a Layer 2 rate for MAC loopback
  Context configure card number xiom string mda number xconnect mac number loopback number bandwidth number
  Tree bandwidth
  Range 10 | 25 | 40 | 100 | 400
  Default 100
  Units gigabps
  Introduced 21.5.R1
 

Platforms

7750 SR-s

description string
  Synopsis Text description
  Context configure card number xiom string mda number xconnect mac number loopback number description string
  Tree description
  String Length 0 to 255
  Introduced 21.5.R1
 

Platforms

7750 SR-s

reset-on-recoverable-error boolean
  Synopsis Reset XIOM for fatal memory parity error on a Q-chip
  Context configure card number xiom string reset-on-recoverable-error boolean
  Tree reset-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.

  Default false
  Introduced 20.2.R1
 

Platforms

7750 SR-s

upgrade [upgrade-index] number
  Synopsis Enter the upgrade list instance
  Context configure card number xiom string upgrade number
  Tree upgrade
 

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.

  Introduced 20.2.R1
 

Platforms

7750 SR-s

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

Notes

This element is part of a list key.

  Introduced 20.2.R1
 

Platforms

7750 SR-s

path keyword
WARNING:

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

  Synopsis Upgrade name
  Context configure card number xiom string upgrade number path keyword
  Tree path
 

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.

  Options cr800g-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+
 

Notes

This element is mandatory.

  Introduced 20.2.R1
 

Platforms

7750 SR-s

xiom-type keyword
WARNING:

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

  Synopsis XIOM type
  Context configure card number xiom string xiom-type keyword
  Tree xiom-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.

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

Platforms

7750 SR-s