interface

interface name string
+  admin-state keyword
+  breakout-mode
   +  channel-speed keyword
   +  num-channels keyword
+  description string
+  ethernet
   +  aggregate-id reference
   +  auto-negotiate boolean
   +  duplex-mode keyword
   +  flow-control
      +  receive boolean
   -  hw-mac-address string
   +  lacp-port-priority number
   -  physical-medium keyword
   +  port-speed keyword
   +  reload-delay number
   -  reload-delay-expires string
   +  standby-signaling keyword
   -  statistics
      -  in-1024b-to-1518b-frames number
      -  in-128b-to-255b-frames number
      -  in-1519b-or-longer-frames number
      -  in-256b-to-511b-frames number
      -  in-512b-to-1023b-frames number
      -  in-64b-frames number
      -  in-65b-to-127b-frames number
      -  in-crc-error-frames number
      -  in-fragment-frames number
      -  in-jabber-frames number
      -  in-mac-pause-frames number
      -  in-oversize-frames number
      -  last-clear string
      -  out-1024b-to-1518b-frames number
      -  out-128b-to-255b-frames number
      -  out-1519b-or-longer-frames number
      -  out-256b-to-511b-frames number
      -  out-512b-to-1023b-frames number
      -  out-64b-frames number
      -  out-65b-to-127b-frames number
      -  out-mac-pause-frames number
   +  storm-control
      +  broadcast-rate number
      +  multicast-rate number
      -  operational-broadcast-rate number
      -  operational-multicast-rate number
      -  operational-unknown-unicast-rate number
      +  units keyword
      +  unknown-unicast-rate number
-  ifindex number
+  lag
   +  lacp
      +  admin-key number
      +  interval keyword
      +  lacp-mode keyword
      +  system-id-mac string
      +  system-priority number
   +  lacp-fallback-mode keyword
   +  lacp-fallback-timeout number
   -  lag-speed number
   +  lag-type keyword
   +  member-speed keyword
   -  members name reference
      -  activity keyword
      -  aggregatable boolean
      -  collecting boolean
      -  distributing boolean
      -  lacp-port-priority number
      -  last-change string
      -  microbfd-enabled boolean
      -  oper-down-reason keyword
      -  oper-key number
      -  oper-state keyword
      -  partner-id string
      -  partner-key number
      -  partner-port-num number
      -  port-num number
      -  statistics
         -  lacp-errors number
         -  lacp-in-pkts number
         -  lacp-out-pkts number
         -  lacp-rx-errors number
         -  lacp-tx-errors number
         -  lacp-unknown-errors number
      -  synchronization keyword
      -  system-id string
      -  timeout keyword
   +  min-links number
-  last-change string
+  loopback-mode boolean
+  mtu number
-  oper-down-reason keyword
-  oper-state keyword

+  qos
   +  output
      +  multicast-queue queue-id number
         -  forwarding-class keyword
         -  queue-depth
            -  last-high-threshold-time string
            -  maximum-burst-size number
         +  scheduling
            -  peak-rate-bps number
            +  peak-rate-percent number
            -  scheduler-node reference
         +  template reference
      +  scheduler
         +  tier level number
            +  node node-number number
               +  strict-priority boolean
               +  weight number
      +  unicast-queue queue-id number
         -  active-queue-management
            -  ecn-slope ecn-drop-probability keyword
               -  max-probability number
               -  max-threshold-bytes number
               -  min-threshold-bytes number
               -  slope-enabled boolean
            -  wred-slope traffic-type keyword drop-probability keyword
               -  max-probability number
               -  max-threshold-bytes number
               -  min-threshold-bytes number
               -  slope-enabled boolean
         -  forwarding-class keyword
         -  queue-depth
            -  high-threshold-bytes number
            -  last-high-threshold-time string
            -  maximum-burst-size number
         +  scheduling
            -  peak-rate-bps number
            +  peak-rate-percent number
            -  scheduler-node reference
            +  strict-priority boolean
            +  weight number
         +  template reference
         +  voq-template reference
-  queue-statistics
   -  multicast-queue queue-id number
      -  final-dropped-octets number
      -  final-dropped-packets number
      -  last-clear string
      -  transmitted-octets number
      -  transmitted-packets number
   -  unicast-queue queue-id number
      -  final-dropped-octets number
      -  final-dropped-packets number
      -  last-clear string
      -  transmitted-octets number
      -  transmitted-packets number
      -  virtual-output-queue slot number
         -  dropped-octets
            -  high-drop-probability number
            -  low-drop-probability number
            -  medium-drop-probability number
         -  dropped-packets
            -  high-drop-probability number
            -  low-drop-probability number
            -  medium-drop-probability number
         -  forwarded-octets
            -  high-drop-probability number
            -  low-drop-probability number
            -  medium-drop-probability number
         -  forwarded-packets
            -  high-drop-probability number
            -  low-drop-probability number
            -  medium-drop-probability number
         -  queue-depth
            -  high-threshold-bytes number
            -  last-high-threshold-time string
+  sflow
   +  admin-state keyword
-  statistics
   -  carrier-transitions number
   -  in-broadcast-packets number
   -  in-discarded-packets number
   -  in-error-packets number
   -  in-fcs-error-packets number
   -  in-multicast-packets number
   -  in-octets number
   -  in-unicast-packets number
   -  last-clear string
   -  out-broadcast-packets number
   -  out-discarded-packets number
   -  out-error-packets number
   -  out-mirror-octets number
   -  out-mirror-packets number
   -  out-multicast-packets number
   -  out-octets number
   -  out-unicast-packets number
+  subinterface index number
   +  acl
      +  input
         +  ipv4-filter reference
         +  ipv6-filter reference
      +  output
         +  ipv4-filter reference
         +  ipv6-filter reference
   +  admin-state keyword
   +  anycast-gw
      +  anycast-gw-mac string
      -  anycast-gw-mac-origin keyword
      +  virtual-router-id number
   +  bridge-table
      +  discard-unknown-src-mac boolean
      +  mac-duplication
         +  action keyword
         -  duplicate-entries
            -  mac address string
               -  dup-detect-time string
               -  hold-down-time-remaining (keyword | number)
      +  mac-learning
         +  admin-state keyword
         +  aging
            +  admin-state keyword
         -  learnt-entries
            -  mac address string
               -  aging (number | keyword)
               -  last-update string
      +  mac-limit
         +  maximum-entries number
         +  warning-threshold-pct number
      -  mac-table
         -  mac address string
            -  failed-slots number
            -  last-update string
            -  not-programmed-reason keyword
            -  type keyword
      -  statistics
         -  active-entries number
         -  failed-entries number
         -  mac-type type keyword
            -  active-entries number
            -  failed-entries number
            -  total-entries number
         -  total-entries number
   +  description string
   -  ethernet-segment-association
      -  designated-forwarder boolean
      -  es-managed boolean
      -  ethernet-segment string
   -  ifindex number
   +  ip-mtu number
   +  ipv4
      +  address ip-prefix string
         +  anycast-gw boolean
         -  origin keyword
         +  primary 
         -  status keyword
      +  allow-directed-broadcast boolean
      +  arp
         +  debug keyword
         +  duplicate-address-detection boolean
         +  evpn
            +  advertise route-type keyword
               +  admin-tag number
         +  host-route
            +  populate route-type keyword
               +  admin-tag number
         +  learn-unsolicited boolean
         +  neighbor ipv4-address string
            -  expiration-time string
            +  link-layer-address string
            -  origin keyword
         +  timeout number
      +  dhcp-client
         +  trace-options
            +  trace keyword
      +  dhcp-relay
         +  admin-state keyword
         +  gi-address string
         +  network-instance reference
         -  oper-down-reason keyword
         -  oper-state keyword
         +  option keyword
         +  server (ipv4-address | domain-name)
         -  statistics
            -  client-packets-discarded number
            -  client-packets-received number
            -  client-packets-relayed number
            -  server-packets-discarded number
            -  server-packets-received number
            -  server-packets-relayed number
         +  trace-options
            +  trace keyword
         +  use-gi-addr-as-src-ip-addr boolean
      +  dhcp-server
         +  admin-state keyword
         -  oper-state keyword
      -  statistics
         -  in-discarded-packets number
         -  in-error-packets number
         -  in-forwarded-octets number
         -  in-forwarded-packets number
         -  in-matched-ra-packets number
         -  in-octets number
         -  in-packets number
         -  in-terminated-octets number
         -  in-terminated-packets number
         -  last-clear string
         -  out-discarded-packets number
         -  out-error-packets number
         -  out-forwarded-octets number
         -  out-forwarded-packets number
         -  out-octets number
         -  out-originated-octets number
         -  out-originated-packets number
         -  out-packets number
   +  ipv6
      +  address ip-prefix string
         +  anycast-gw boolean
         -  origin keyword
         +  primary 
         -  status keyword
      +  dhcp-client
         +  trace-options
            +  trace keyword
      +  dhcp-relay
         +  admin-state keyword
         +  network-instance reference
         -  oper-down-reason keyword
         -  oper-state keyword
         +  option keyword
         +  server (ipv6-address | domain-name)
         +  source-address string
         -  statistics
            -  client-packets-discarded number
            -  client-packets-received number
            -  client-packets-relayed number
            -  server-packets-discarded number
            -  server-packets-received number
            -  server-packets-relayed number
         +  trace-options
            +  trace keyword
      +  dhcpv6-server
         +  admin-state keyword
         -  oper-state keyword
      +  neighbor-discovery
         +  debug keyword
         +  duplicate-address-detection boolean
         +  evpn
            +  advertise route-type keyword
               +  admin-tag number
         +  host-route
            +  populate route-type keyword
               +  admin-tag number
         +  learn-unsolicited keyword
         +  neighbor ipv6-address string
            -  current-state keyword
            -  is-router boolean
            +  link-layer-address string
            -  next-state-time string
            -  origin keyword
         +  reachable-time number
         +  stale-time number
      +  router-advertisement
         +  debug keyword
         +  router-role
            +  admin-state keyword
            +  current-hop-limit number
            +  ip-mtu number
            +  managed-configuration-flag boolean
            +  max-advertisement-interval number
            +  min-advertisement-interval number
            +  other-configuration-flag boolean
            +  prefix ipv6-prefix string
               +  autonomous-flag boolean
               +  on-link-flag boolean
               +  preferred-lifetime (keyword | number)
               +  valid-lifetime (keyword | number)
            +  reachable-time number
            +  retransmit-time number
            +  router-lifetime number
      -  statistics
         -  in-discarded-packets number
         -  in-error-packets number
         -  in-forwarded-octets number
         -  in-forwarded-packets number
         -  in-matched-ra-packets number
         -  in-octets number
         -  in-packets number
         -  in-terminated-octets number
         -  in-terminated-packets number
         -  last-clear string
         -  out-discarded-packets number
         -  out-error-packets number
         -  out-forwarded-octets number
         -  out-forwarded-packets number
         -  out-octets number
         -  out-originated-octets number
         -  out-originated-packets number
         -  out-packets number
   +  l2-mtu number
   -  last-change string
   +  local-mirror-destination
      +  admin-state keyword
      -  oper-state keyword
   -  mpls
      -  statistics
         -  in-discarded-packets number
         -  in-error-packets number
         -  in-forwarded-octets number
         -  in-forwarded-packets number
         -  in-octets number
         -  in-packets number
         -  last-clear string
         -  out-error-packets number
         -  out-forwarded-octets number
         -  out-forwarded-packets number
         -  out-octets number
         -  out-originated-octets number
         -  out-originated-packets number
         -  out-packets number
   +  mpls-mtu number
   -  name string
   -  oper-down-reason keyword
   -  oper-state keyword
   +  qos
      +  input
         +  classifiers
            +  dscp reference
            +  ipv4-dscp reference
            +  ipv6-dscp reference
            +  mpls-traffic-class reference
      +  output
         +  rewrite-rules
            +  dscp reference
            +  ipv4-dscp reference
            +  ipv6-dscp reference
            +  mpls-traffic-class reference
   +  ra-guard
      +  policy reference
      +  vlan-list vlan-id number
   -  statistics
      -  in-discarded-packets number
      -  in-error-packets number
      -  in-forwarded-octets number
      -  in-forwarded-packets number
      -  in-matched-ra-packets number
      -  in-octets number
      -  in-packets number
      -  in-terminated-octets number
      -  in-terminated-packets number
      -  last-clear string
      -  out-discarded-packets number
      -  out-error-packets number
      -  out-forwarded-octets number
      -  out-forwarded-packets number
      -  out-octets number
      -  out-originated-octets number
      -  out-originated-packets number
      -  out-packets number
   +  type identityref
   +  vlan
      +  encap
         +  single-tagged
            +  vlan-id (number | keyword)
         +  untagged
-  traffic-rate
   -  in-bps number
   -  out-bps number
+  transceiver
   -  channel index number
      -  input-power
         -  high-alarm-condition boolean
         -  high-alarm-threshold decimal-number
         -  high-warning-condition boolean
         -  high-warning-threshold decimal-number
         -  latest-value decimal-number
         -  low-alarm-condition boolean
         -  low-alarm-threshold decimal-number
         -  low-warning-condition boolean
         -  low-warning-threshold decimal-number
      -  laser-bias-current
         -  high-alarm-condition boolean
         -  high-alarm-threshold decimal-number
         -  high-warning-condition boolean
         -  high-warning-threshold decimal-number
         -  latest-value decimal-number
         -  low-alarm-condition boolean
         -  low-alarm-threshold decimal-number
         -  low-warning-condition boolean
         -  low-warning-threshold decimal-number
      -  output-power
         -  high-alarm-condition boolean
         -  high-alarm-threshold decimal-number
         -  high-warning-condition boolean
         -  high-warning-threshold decimal-number
         -  latest-value decimal-number
         -  low-alarm-condition boolean
         -  low-alarm-threshold decimal-number
         -  low-warning-condition boolean
         -  low-warning-threshold decimal-number
      -  wavelength decimal-number
   -  connector-type keyword
   -  date-code string
   +  ddm-events boolean
   -  ethernet-pmd string
   -  fault-condition boolean
   -  form-factor keyword
   +  forward-error-correction keyword
   -  input-power
      -  high-alarm-condition boolean
      -  high-alarm-threshold decimal-number
      -  high-warning-condition boolean
      -  high-warning-threshold decimal-number
      -  latest-value decimal-number
      -  low-alarm-condition boolean
      -  low-alarm-threshold decimal-number
      -  low-warning-condition boolean
      -  low-warning-threshold decimal-number
   -  laser-bias-current
      -  high-alarm-condition boolean
      -  high-alarm-threshold decimal-number
      -  high-warning-condition boolean
      -  high-warning-threshold decimal-number
      -  latest-value decimal-number
      -  low-alarm-condition boolean
      -  low-alarm-threshold decimal-number
      -  low-warning-condition boolean
      -  low-warning-threshold decimal-number
   -  oper-down-reason keyword
   -  oper-state keyword
   -  output-power
      -  high-alarm-condition boolean
      -  high-alarm-threshold decimal-number
      -  high-warning-condition boolean
      -  high-warning-threshold decimal-number
      -  latest-value decimal-number
      -  low-alarm-condition boolean
      -  low-alarm-threshold decimal-number
      -  low-warning-condition boolean
      -  low-warning-threshold decimal-number
   -  serial-number string
   -  temperature
      -  high-alarm-condition boolean
      -  high-alarm-threshold number
      -  high-warning-condition boolean
      -  high-warning-threshold number
      -  latest-value number
      -  low-alarm-condition boolean
      -  low-alarm-threshold number
      -  low-warning-condition boolean
      -  low-warning-threshold number
   +  tx-laser boolean
   -  vendor string
   -  vendor-part-number string
   -  vendor-revision string
   -  voltage
      -  high-alarm-condition boolean
      -  high-alarm-threshold decimal-number
      -  high-warning-condition boolean
      -  high-warning-threshold decimal-number
      -  latest-value decimal-number
      -  low-alarm-condition boolean
      -  low-alarm-threshold decimal-number
      -  low-warning-condition boolean
      -  low-warning-threshold decimal-number
   -  wavelength decimal-number

+  vlan-tagging boolean

interface Descriptions

interface name string

Description The list of named interfaces on the device.
Contextinterface name string
Treeinterface
ConfigurableTrue

name string

Description

The name of the interface

Valid options are: irb<N>, N=0..255 lag<N>, N=1..128 [note1] lo<N>, N=0..255 mgmt0 mgmt0-standby ethernet-<slot>/<port> ethernet-<slot>/<mda>/<port> system0

<slot>=slot number {1,2,3,..} <mda>=mda id {a,b,c,d} <port>=port id {1,2,3,..}

[note1] N=1..32 for 7220-D1, 7220-D2, 7220-D3. N=1..127 for 7220-H2, 7220-H3.

Contextinterface name string
String Length3 to 20
ConfigurableTrue

admin-state keyword

Description The configured, desired state of the interface
Contextinterface name string admin-state keyword
Treeadmin-state
Defaultenable
Options
  • enable

  • disable

Configurable True

breakout-mode

Note:

This command is available for the following platforms:

  • 7220 IXR-D3

  • 7220 IXR-D3L

DescriptionConfiguration of breakout options
Contextinterface name string breakout-mode
Treebreakout-mode
ConfigurableTrue

channel-speed keyword

Note:

This command is available for the following platforms:

  • 7220 IXR-D3

  • 7220 IXR-D3L

DescriptionThe speed of each channel (breakout port).
Contextinterface name string breakout-mode channel-speed keyword
Treechannel-speed
Options
  • 10G

  • 25G

Configurable True

num-channels keyword

Note:

This command is available for the following platforms:

  • 7220 IXR-D3

  • 7220 IXR-D3L

DescriptionThe number of channels (breakout ports) supported by this connector.
Contextinterface name string breakout-mode num-channels keyword
Treenum-channels
Options
  • 4

ConfigurableTrue

description string

Description A user-configured description of the interface
Contextinterface name string description string
Treedescription
String Length1 to 255
ConfigurableTrue

aggregate-id reference

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

  • 7220 IXR-D1

DescriptionLAG interface this interface is associated with.
Contextinterface name string ethernet aggregate-id reference
Treeaggregate-id
Reference

interface name string

ConfigurableTrue

auto-negotiate boolean

Note:

This command is available for the following platform:

7220 IXR-D1

Description

When set to true the interface uses auto-negotiation for speed, duplex and flow-control settings.

When set to false, the transmission parameters are specified manually.

Contextinterface name string ethernet auto-negotiate boolean
Treeauto-negotiate
ConfigurableTrue

duplex-mode keyword

Note:

This command is available for the following platform:

7220 IXR-D1

Description When auto-negotiate is true, this sets the duplex mode that will be advertised to the peer. When auto-negotiate is false, this directly sets the duplex mode of the interface.
Contextinterface name string ethernet duplex-mode keyword
Treeduplex-mode
Options
  • full

  • half

Configurable True

receive boolean

Description

When this is true PAUSE frames received on this interface are accepted and processed, and, if auto-negotiation is enabled it also causes the capability to receive PAUSE frames to be signaled to the peer (applicable only to ports 1-48 of the 7220 IXR-D1 and to mgmt0 and mgmt0-standby ports).

When this is false PAUSE frames received on this interface are ignored, and, if auto-negotiation is enabled it causes the capability to receive PAUSE frames to be signaled to the peer as non-support (applicable only to ports 1-48 of the 7220 IXR-D1 and to mgmt0 and mgmt0-standby ports)

Contextinterface name string ethernet flow-control receive boolean
Treereceive
ConfigurableTrue

lacp-port-priority number

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-D3

  • 7220 IXR-D1

DescriptionConfigure the port priority for LACP. This value is used to determine which port should be activated with LACP fallback mode. Lower values are more preferred.
Contextinterface name string ethernet lacp-port-priority number
Treelacp-port-priority
ConfigurableTrue

physical-medium keyword

Description

Indicates the PHY supported by the RJ45 port.

If the port is supported by a SFP, QSFP+, QSFP28 or QSFP-DD transceiver no value is populated in this leaf.

Contextinterface name string ethernet physical-medium keyword
Treephysical-medium
Options
  • 1000BASE-T

ConfigurableFalse

port-speed keyword

Description

The speed of the port or channel

The default speed of a port (when there is no configured value and auto-negotiation is disabled or unsupported) depends on the platform and port/connector number as follows:

mgmt0 and mgmt0-standby ports: 1G J2 IMM ports 1-32: 100G J2 IMM ports 33-36: 100G 7220-D1 ports 1-48: 1G 7220-D1 ports 49-52: 10G 7220-D2/D2L ports 1-48: 25G 7220-D2/D2L ports 49-56: 100G 7220-D2L ports 57-58: 10G 7220-D3 ports 1-2: 10G 7220-D3 ethernet-1/[3-34]: 100G 7220-D3 ethernet-1/[3-33]/n: 25G 7220-D3L ethernet-1/[1-32]: 100G 7220-D3L ethernet-1/[1-31]/n: 25G 7220-D3L ports 33-34: 10G 7220-D5 ports 1-32: 400G 7220-D5 ports 33-38: 10G 7220-H2 ports 1-128: 100G 7220-H3 ports 1-2: 10G 7220-H3 ports 3-34: 400G

Supported speeds: mgmt0 and mgmt0-standby ports: 1G J2 IMM ports 1-32: 40G, 100G [note1] J2 IMM ports 33-36: 40G, 100G, 400G 7220-D1 ports 1-48: 10M, 100M, 1G 7220-D1 ports 49-52: 10G 7220-D2/D2L ports 1-48: 1G, 10G, 25G [note2] 7220-D2/D2L ports 49-56: 40G, 100G 7220-D2L ports 57-58: 10G 7220-D3 ports 1-2: 10G 7220-D3 ethernet-1/[3-34]: 40G, 100G 7220-D3 ethernet-1/[3-33]/n: 10G, 25G 7220-D3L ethernet-1/[1-32]: 40G, 100G 7220-D3L ethernet-1/[1-31]/n: 10G, 25G 7220-D3L ports 33-34: 10G 7220-D5 ports 1-32: 40G, 100G, 400G 7220-D5 ports 33-38: 10G 7220-H2 ports 1-128: 100G 7220-H3 ports 1-2: 10G 7220-H3 ports 3-34: 40G, 100G, 400G

[note1] Ports 9-12 cannot operate at different port speeds (some at 40G and others at 100G). The required speed of ports 9-12 is based on the port-speed of the lowest-numbered configured port in this block; if any higher-numbered port in the block is configured with a different port speed that port will not come up.

[note2] On 7220-D2: if one port in each consecutive group of 4 ports (1-4, 5-8, .. , 45-48) is 25G the other 3 ports must also be 25G; if one port in each consecutive group of 4 ports (1-4, 5-8, .. , 45-48) is 1G or 10G the other 3 ports must also be 1G or 10G. On 7220-D2L: if one port in each consecutive group of 12 ports (1-12, 13-24, 25-36, 37-48) is 25G the other 11 ports must also be 25G; if one port in each consecutive group of 12 ports (1-12, 13-24, 25-36, 37-48) is 1G or 10G the other 11 ports must also be 1G or 10G.

7250 IXR details: If the interface corresponds to a connector that has no installed transceiver then the value is accepted without any checking or restriction, and info from state will display the configured value. Otherwise if the configured port-speed is NOT supported by the installed transceiver the port is forced operationally down.

Contextinterface name string ethernet port-speed keyword
Treeport-speed
Options
  • 10M

  • 100M

  • 1G

  • 10G

  • 25G

  • 40G

  • 50G

  • 100G

  • 200G

  • 400G

  • 1T

Configurable True

reload-delay number

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7220 IXR-D3

  • 7220 IXR-D3L

  • 7220 IXR-D2L

Description

Configure reload-delay timer for Ethernet interfaces.

The reload-delay timer starts when the associated XDP interface state is learned. While the timer is running, the interface transceiver laser is disabled to avoid attracting traffic from the connected device at the other end of the interface. The reload-delay timer should be used in multi-homing interfaces and be set to a value long enough to allow the system to recover all the network protocols upon reboot, before start attracting traffic from the multi-homed device.

Contextinterface name string ethernet reload-delay number
Treereload-delay
Range1 to 86400
Unitsseconds
ConfigurableTrue

reload-delay-expires string

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7220 IXR-D3

  • 7220 IXR-D3L

  • 7220 IXR-D2L

Description The remaining time until the reload-delay expires and the interface can go operationally up.
Contextinterface name string ethernet reload-delay-expires string
Treereload-delay-expires
String Length20 to 32
ConfigurableFalse

standby-signaling keyword

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7220 IXR-D3

  • 7220 IXR-D3L

  • 7220 IXR-D2L

Description

Indicates the standby-signaling used in the interface.

An application using a port-based redundancy mechanism will trigger the standby signaling on the ethernet interface if the interface is selected as standby.

Contextinterface name string ethernet standby-signaling keyword
Treestandby-signaling
Options
  • power-off

  • lacp

Configurable True

storm-control

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7220 IXR-D3

  • 7220 IXR-D3L

  • 7220 IXR-D2L

Description Enable the storm-control context
Context interface name string ethernet storm-control
Treestorm-control
ConfigurableTrue

broadcast-rate number

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7220 IXR-D3

  • 7220 IXR-D3L

  • 7220 IXR-D2L

Description The maximum rate allowed for ingress broadcast frames on the interface
Contextinterface name string ethernet storm-control broadcast-rate number
Treebroadcast-rate
Range0 to 100000000
ConfigurableTrue

multicast-rate number

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7220 IXR-D3

  • 7220 IXR-D3L

  • 7220 IXR-D2L

Description The maximum rate allowed for ingress multicast frames on the interface
Contextinterface name string ethernet storm-control multicast-rate number
Treemulticast-rate
Range0 to 100000000
ConfigurableTrue

units keyword

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7220 IXR-D3

  • 7220 IXR-D3L

  • 7220 IXR-D2L

Description Units of storm-control policer in kbps or percentage of the interface bandwidth
Contextinterface name string ethernet storm-control units keyword
Treeunits
Defaultpercentage
Options
  • kbps

  • percentage

Configurable True

ifindex number

Description System-wide persistent unique ifIndex assigned to the interface
Contextinterface name string ifindex number
Treeifindex
ConfigurableFalse

lag

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

  • 7220 IXR-D1

DescriptionContainer for options related to LAG
Contextinterface name string lag
Treelag
ConfigurableTrue

lacp

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

  • 7220 IXR-D1

DescriptionLACP parameters for the associated LAG
Contextinterface name string lag lacp
Treelacp
ConfigurableTrue

admin-key number

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

  • 7220 IXR-D1

DescriptionConfigure the LACP admin-key to be advertised by the local system. If this value is not specified a value starting from 32768 is automatically assigned by the system.
Contextinterface name string lag lacp admin-key number
Treeadmin-key
Range1 to 65535
ConfigurableTrue

interval keyword

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

  • 7220 IXR-D1

DescriptionSet the period between LACP messages -- uses the lacp-period-type enumeration.
Contextinterface name string lag lacp interval keyword
Treeinterval
DefaultSLOW
Options
  • FAST

    Send LACP packets every second

  • SLOW

    Send LACP packets every 30 seconds

ConfigurableTrue

lacp-mode keyword

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

  • 7220 IXR-D1

DescriptionACTIVE is to initiate the transmission of LACP packets. PASSIVE is to wait for peer to initiate the transmission of LACP packets.
Contextinterface name string lag lacp lacp-mode keyword
Treelacp-mode
DefaultACTIVE
Options
  • ACTIVE

    Interface is an active member, i.e., will detect and maintain aggregates

  • PASSIVE

    Interface is a passive member, i.e., it participates with an active partner

ConfigurableTrue

system-id-mac string

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

  • 7220 IXR-D1

DescriptionThe MAC address portion of the node's System ID. This is combined with the system priority to construct the 8-octet system-id. If not configured, the system-ID configured at the system/ level is used.
Contextinterface name string lag lacp system-id-mac string
Treesystem-id-mac
ConfigurableTrue

system-priority number

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

  • 7220 IXR-D1

DescriptionSystem priority used by the node on this LAG interface. Lower value is higher priority for determining which node is the controlling system. If not configured, the system-priority configured at the system/ level is used.
Contextinterface name string lag lacp system-priority number
Treesystem-priority
ConfigurableTrue

lacp-fallback-mode keyword

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

  • 7220 IXR-D1

DescriptionSpecifies lacp-fallback mode if enabled
Contextinterface name string lag lacp-fallback-mode keyword
Treelacp-fallback-mode
Options
  • static

    Set the LACP-fallback mode as static

ConfigurableTrue

lacp-fallback-timeout number

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

  • 7220 IXR-D1

DescriptionSpecifies the LACP-fallback timeout interval in seconds
Contextinterface name string lag lacp-fallback-timeout number
Treelacp-fallback-timeout
Range4 to 3600
ConfigurableTrue

lag-speed number

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

  • 7220 IXR-D1

DescriptionReports current aggregate bandwidth speed of the associated LAG
Contextinterface name string lag lag-speed number
Treelag-speed
UnitsMbps
ConfigurableFalse

lag-type keyword

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

  • 7220 IXR-D1

DescriptionSets the type of LAG, i.e., how it is configured / maintained
Contextinterface name string lag lag-type keyword
Treelag-type
Defaultstatic
Options
  • lacp

    LAG managed by LACP

  • static

    Statically configured bundle / LAG

ConfigurableTrue

member-speed keyword

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

  • 7220 IXR-D1

DescriptionSpecifies the link speed of allowed member-links
Contextinterface name string lag member-speed keyword
Treemember-speed
Options
  • 10M

    Indicates the the LAG member-links must be 10M to be active

  • 100M

    Indicates the the LAG member-links must be 100M to be active

  • 1G

    Indicates the the LAG member-links must be 1G to be active

  • 10G

    Indicates the the LAG member-links must be 10G to be active

  • 25G

    Indicates the the LAG member-links must be 25G to be active

  • 40G

    Indicates the the LAG member-links must be 40G to be active

  • 100G

    Indicates the the LAG member-links must be 100G to be active

  • 400G

    Indicates the the LAG member-links must be 400G to be active

ConfigurableTrue

members name reference

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

  • 7220 IXR-D1

DescriptionReports the list of interfaces associated with the LAG instance
Contextinterface name string lag members name reference
Treemembers
ConfigurableFalse

name reference

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

  • 7220 IXR-D1

DescriptionEnter the name context
Contextinterface name string lag members name reference
Reference

interface name string

ConfigurableFalse

activity keyword

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

  • 7220 IXR-D1

DescriptionIndicates participant is active or passive
Contextinterface name string lag members name reference activity keyword
Treeactivity
Options
  • ACTIVE

    Interface is an active member, i.e., will detect and maintain aggregates

  • PASSIVE

    Interface is a passive member, i.e., it participates with an active partner

ConfigurableFalse

aggregatable boolean

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

  • 7220 IXR-D1

DescriptionA true value indicates that the participant will allow the link to be used as part of the aggregate. A false value indicates the link should be used as an individual link
Contextinterface name string lag members name reference aggregatable boolean
Treeaggregatable
ConfigurableFalse

collecting boolean

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

  • 7220 IXR-D1

DescriptionIf true, the participant is collecting incoming frames on the link, otherwise false
Contextinterface name string lag members name reference collecting boolean
Treecollecting
ConfigurableFalse

distributing boolean

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

  • 7220 IXR-D1

DescriptionWhen true, the participant is distributing outgoing frames; when false, distribution is disabled
Contextinterface name string lag members name reference distributing boolean
Treedistributing
ConfigurableFalse

lacp-port-priority number

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-D3

  • 7220 IXR-D1

DescriptionConfigure the port priority for LACP. This value is used to determine which port should be activated with LACP fallback mode. Lower values are more preferred.
Contextinterface name string lag members name reference lacp-port-priority number
Treelacp-port-priority
ConfigurableFalse

last-change string

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

  • 7220 IXR-D1

DescriptionThe date and time of the most recent change to the LAG member-link state
Contextinterface name string lag members name reference last-change string
Treelast-change
String Length20 to 32
ConfigurableFalse

microbfd-enabled boolean

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

  • 7220 IXR-D1

DescriptionIndicates if microBFD is currently used in the determination of the member-link oper-status
Contextinterface name string lag members name reference microbfd-enabled boolean
Treemicrobfd-enabled
ConfigurableFalse

oper-down-reason keyword

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

  • 7220 IXR-D1

DescriptionReason for operational down state for the associated LAG
Contextinterface name string lag members name reference oper-down-reason keyword
Treeoper-down-reason
Options
  • port-disabled

  • port-oper-disabled

  • lag-admin-disabled

  • lacp-down

  • microBFD-down

  • lag-min-link-threshold

  • lag-speed-mismatch

  • other

ConfigurableFalse

oper-key number

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

  • 7220 IXR-D1

DescriptionCurrent operational value of the key for the aggregate interface
Contextinterface name string lag members name reference oper-key number
Treeoper-key
ConfigurableFalse

oper-state keyword

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

  • 7220 IXR-D1

DescriptionOperational state for the associated LAG
Contextinterface name string lag members name reference oper-state keyword
Treeoper-state
Options
  • up

    Component or process is operational

  • down

    Component or process is not operational

  • empty

    Component slot is empty

  • downloading

    Component is downloading image into memory

  • booting

    Component is booting downloaded image

  • starting

    Component image operational, application processes starting

  • failed

    Component or process has failed

  • synchronizing

    Component is currently being synchronized

  • upgrading

    Component is currently being upgraded

  • low-power

    Component is offline due to insufficient system power

  • degraded

    Component or process is in a degraded state

  • warm-reboot

    Component or process is currently warm rebooting

    Component or process is currently warm rebooting This state is set during a warm reboot immediately following initiation of the reboot, continuing after startup until the system has completed audit. In this state the system will not accept configuration changes.

ConfigurableFalse

partner-id string

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

  • 7220 IXR-D1

DescriptionMAC address representing the protocol partner's interface system ID
Contextinterface name string lag members name reference partner-id string
Treepartner-id
ConfigurableFalse

partner-key number

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

  • 7220 IXR-D1

DescriptionOperational value of the protocol partner's key
Contextinterface name string lag members name reference partner-key number
Treepartner-key
ConfigurableFalse

partner-port-num number

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

  • 7220 IXR-D1

DescriptionPort number of the partner (remote) port for this member port
Contextinterface name string lag members name reference partner-port-num number
Treepartner-port-num
ConfigurableFalse

port-num number

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

  • 7220 IXR-D1

DescriptionPort number of the local (actor) aggregation member
Contextinterface name string lag members name reference port-num number
Treeport-num
ConfigurableFalse

statistics

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

  • 7220 IXR-D1

DescriptionLACP protocol counters
Contextinterface name string lag members name reference statistics
Treestatistics
ConfigurableFalse

lacp-errors number

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

  • 7220 IXR-D1

DescriptionNumber of LACPDU illegal packet errors
Contextinterface name string lag members name reference statistics lacp-errors number
Treelacp-errors
Default0
ConfigurableFalse

lacp-in-pkts number

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

  • 7220 IXR-D1

DescriptionNumber of LACPDUs received
Contextinterface name string lag members name reference statistics lacp-in-pkts number
Treelacp-in-pkts
Default0
ConfigurableFalse

lacp-out-pkts number

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

  • 7220 IXR-D1

DescriptionNumber of LACPDUs transmitted
Contextinterface name string lag members name reference statistics lacp-out-pkts number
Treelacp-out-pkts
Default0
ConfigurableFalse

lacp-rx-errors number

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

  • 7220 IXR-D1

DescriptionNumber of LACPDU receive packet errors
Contextinterface name string lag members name reference statistics lacp-rx-errors number
Treelacp-rx-errors
Default0
ConfigurableFalse

lacp-tx-errors number

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

  • 7220 IXR-D1

DescriptionNumber of LACPDU transmit packet errors
Contextinterface name string lag members name reference statistics lacp-tx-errors number
Treelacp-tx-errors
Default0
ConfigurableFalse

lacp-unknown-errors number

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

  • 7220 IXR-D1

DescriptionNumber of LACPDU unknown packet errors
Contextinterface name string lag members name reference statistics lacp-unknown-errors number
Treelacp-unknown-errors
Default0
ConfigurableFalse

synchronization keyword

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

  • 7220 IXR-D1

DescriptionIndicates whether the participant is in-sync or out-of-sync
Contextinterface name string lag members name reference synchronization keyword
Treesynchronization
Options
  • IN_SYNC

    Participant is in sync with the system id and key transmitted

  • OUT_SYNC

    Participant is not in sync with the system id and key transmitted

ConfigurableFalse

system-id string

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

  • 7220 IXR-D1

DescriptionMAC address that defines the local system ID for the aggregate interface
Contextinterface name string lag members name reference system-id string
Treesystem-id
ConfigurableFalse

timeout keyword

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

  • 7220 IXR-D1

DescriptionThe timeout type (short or long) used by the participant
Contextinterface name string lag members name reference timeout keyword
Treetimeout
Options
  • LONG

    Participant wishes to use long timeouts to detect status of the aggregate, i.e., will expect less frequent transmissions. Long timeout is 90 seconds.

  • SHORT

    Participant wishes to use short timeouts, i.e., expects frequent transmissions to aggressively detect status changes. Short timeout is 3 seconds.

ConfigurableFalse

min-links number

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

  • 7220 IXR-D1

DescriptionSpecifies the mininum number of member interfaces that must be active for the aggregate interface to be available
Contextinterface name string lag min-links number
Treemin-links
Range1 to 64
Default1
ConfigurableTrue

last-change string

Description The date and time of the most recent change to the interface state
Contextinterface name string last-change string
Treelast-change
String Length20 to 32
ConfigurableFalse

loopback-mode boolean

Description When loopback-mode is set to true the port loops back packets that come in via the port
Contextinterface name string loopback-mode boolean
Treeloopback-mode
ConfigurableTrue

mtu number

Description

Port MTU in bytes including ethernet overhead but excluding 4-bytes FCS

If a transmitted packet exceeds this size it is dropped.

The default value for ethernet-x interfaces is taken from /system/mtu/default-port-mtu. For the mgmt0 and mgmt0-standby interfaces the default is 1514 bytes, but the value can be changed for each interface individually. Port MTU is not configurable for loopback interfaces.

The 7220 IXR-D1, 7220 IXR-D2, 7220 IXR-D3, 7220 IXR-H2, and 7220 IXR-H3 systems support a maximum port MTU of 9412 bytes.

Each 7250 IXR IMM supports a maximum of 8 different port MTU values. 7220 IXR systems do not have any limit on the maximum number of different port MTU values.

Contextinterface name string mtu number
Treemtu
Range1500 to 9500
Unitsbytes
ConfigurableTrue

oper-down-reason keyword

Description The first (and possibly only) reason for the port being operationally down
Contextinterface name string oper-down-reason keyword
Treeoper-down-reason
Options
  • port-admin-disabled

  • mda-admin-disabled

  • transceiver-oper-down

  • loopback

  • port-not-present

  • mda-not-present

  • phy-initializing

  • lower-layer-down

  • auto-negotiation-mismatch

  • port-mtu-resource-exceeded

  • unsupported-speed

  • unsupported-fec

  • other

  • fabric-availability

  • no-active-links

  • min-link-threshold

  • port-9-12-speed-mismatch

  • lag-resource-exceeded

  • lag-member-resource-exceeded

  • standby-signaling

  • interface-hold-time-up-active

  • interface-reload-timer-active

  • connector-down

ConfigurableFalse

oper-state keyword

Description The operational state of the interface
Contextinterface name string oper-state keyword
Treeoper-state
Options
  • up

  • down

Configurable False

qos

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

DescriptionEnable the qos context
Contextinterface name string qos
Treeqos
ConfigurableTrue

output

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

DescriptionContainer for QoS configuration that applies to outbound traffic through the port or LAG
Contextinterface name string qos output
Treeoutput
ConfigurableTrue

queue-id number

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

Description

The queue identifier

For J2 and TD3 there is a one-to-one mapping between queue-id and forwarding class. fc0 traffic always use queue-id 0, fc1 traffic always uses queue-id 1, etc.

For TH3 the multicast queue-id range is limited to 0-3 and the mapping is as follows: fc0+1 -> queue-id 0 fc2+3 -> queue-id 1 fc4+5 -> queue-id 2 fc6+7 -> queue-id 3

Contextinterface name string qos output multicast-queue queue-id number
Range0 to 7
ConfigurableTrue

forwarding-class keyword

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

DescriptionThe list of forwarding classes that map to this queue.
Contextinterface name string qos output multicast-queue queue-id number forwarding-class keyword
Treeforwarding-class
Options
  • fc0

  • fc1

  • fc2

  • fc3

  • fc4

  • fc5

  • fc6

  • fc7

ConfigurableFalse

scheduling

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

DescriptionContainer for queue scheduling parameters
Contextinterface name string qos output multicast-queue queue-id number scheduling
Treescheduling
ConfigurableTrue

peak-rate-percent number

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

DescriptionThe maximum percentage of port bandwidth that is available to the traffic in this multicast queue. The default is 100.
Contextinterface name string qos output multicast-queue queue-id number scheduling peak-rate-percent number
Treepeak-rate-percent
Range1 to 100
Default100
ConfigurableTrue

scheduler-node reference

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

Description

The scheduler node to which the multicast queue is connected. The mappings are fixed and not user-configurable.

J2: queue-id 0-7 -> node 0

TD3 (D2/D3): queue-id 0 -> node 0 queue-id 1 -> node 1 queue-id 2 -> node 2 queue-id 3 -> node 3 queue-id 4 -> node 4 queue-id 5 -> node 5 queue-id 6 -> node 6 queue-id 7 -> node 7

TH3: queue-id 4 -> node 0 queue-id 5 -> node 3 queue-id 6 -> node 6 queue-id 7 -> node 9

Contextinterface name string qos output multicast-queue queue-id number scheduling scheduler-node reference
Treescheduler-node
Reference

interface name string qos output scheduler tier level number node node-number number

ConfigurableFalse

template reference

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7220 IXR-D3

  • 7220 IXR-D3L

  • 7220 IXR-D2L

Description The name of a queue-template to apply to the multicast queue. The active-queue-management container must not be present in order to apply the template. Also the high-threshold-bytes configuration in this template is ignored.
Contextinterface name string qos output multicast-queue queue-id number template reference
Treetemplate
Reference

qosqueue-templatesqueue-template name string string

ConfigurableTrue

scheduler

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

DescriptionOutput traffic scheduler options
Contextinterface name string qos output scheduler
Treescheduler
ConfigurableTrue

tier level number

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

DescriptionList of output traffic scheduler tiers or levels
Contextinterface name string qos output scheduler tier level number
Treetier
ConfigurableTrue
Max. Elements1

level number

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

DescriptionEnter the level context
Contextinterface name string qos output scheduler tier level number
Range1 to 4
ConfigurableTrue

node node-number number

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

DescriptionList of scheduler nodes at the specified scheduler level
Contextinterface name string qos output scheduler tier level number node node-number number
Treenode
ConfigurableTrue
Max. Elements12

node-number number

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

DescriptionAn identifier of the scheduler node. Within a scheduler tier, higher-numbered nodes are served before lower-numbererd nodes.
Contextinterface name string qos output scheduler tier level number node node-number number
Range0 to 11
ConfigurableTrue

strict-priority boolean

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

DescriptionA true value configures the node for strict priority scheduling, whether or not a weight is also configured. When set to false the node is serviced using DWRR, even if the node does not have a configured weight; in this case the default weight value of 1 is used.
Contextinterface name string qos output scheduler tier level number node node-number number strict-priority boolean
Treestrict-priority
ConfigurableTrue

weight number

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

DescriptionThe DWRR weight assigned to the scheduler node
Contextinterface name string qos output scheduler tier level number node node-number number weight number
Treeweight
Range1 to 127
Default1
ConfigurableTrue

unicast-queue queue-id number

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

DescriptionList of unicast queues
Contextinterface name string qos output unicast-queue queue-id number
Treeunicast-queue
ConfigurableTrue

queue-id number

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

Description

The queue identifier

For unicast traffic on all platforms there is a one-to-one mapping between queue-id and forwarding class. fc0 traffic always use queue-id 0, fc1 traffic always uses queue-id 1, etc.

Contextinterface name string qos output unicast-queue queue-id number
Range0 to 7
ConfigurableTrue

ecn-drop-probability keyword

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

DescriptionThe drop probability to which the ECN slope applies.
Contextinterface name string qos output unicast-queue queue-id number active-queue-management ecn-slope ecn-drop-probability keyword
Options
  • low

    Traffic that should be dropped last when there is congestion. Internally this is traffic that is colored green.

  • medium

    Traffic that should be dropped before green traffic but after red traffic when there is congestion. Internally this is traffic that is colored yellow.

  • high

    Traffic that should be dropped first when there is congestion. Internally this is traffic that is colored red.

  • all

    All traffic, consisting of traffic marked low, medium and high drop-probability.

ConfigurableFalse

max-probability number

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

Description

The maximum probability of marking a packet (at or above the max-threshold).

On 7250 IXR systems there can be a significant difference between the configured value and the operational value.

Contextinterface name string qos output unicast-queue queue-id number active-queue-management ecn-slope ecn-drop-probability keyword max-probability number
Treemax-probability
Range0 to 100
ConfigurableFalse

traffic-type keyword

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

DescriptionThe traffic type to which the WRED slope applies.
Contextinterface name string qos output unicast-queue queue-id number active-queue-management wred-slope traffic-type keyword drop-probability keyword
Options
  • tcp

    Refers to IPv4/IPv6 packets with a protocol/next-header indicating a value of 6.

  • non-tcp

    Refers to all packets that are not IPv4/IPv6 packets with a protocol/next-header indicating a value of 6.

  • all

    Refers to all traffic, whether it is TCP or non-TCP.

ConfigurableFalse

drop-probability keyword

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

DescriptionThe drop probability to which the WRED slope applies.
Contextinterface name string qos output unicast-queue queue-id number active-queue-management wred-slope traffic-type keyword drop-probability keyword
Options
  • low

    Traffic that should be dropped last when there is congestion. Internally this is traffic that is colored green.

  • medium

    Traffic that should be dropped before green traffic but after red traffic when there is congestion. Internally this is traffic that is colored yellow.

  • high

    Traffic that should be dropped first when there is congestion. Internally this is traffic that is colored red.

ConfigurableFalse

max-probability number

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

Description

The maximum probability of dropping a packet (at or above the max-threshold).

On 7250 IXR systems there can be a significant difference between the configured value and the operational value.

Contextinterface name string qos output unicast-queue queue-id number active-queue-management wred-slope traffic-type keyword drop-probability keyword max-probability number
Treemax-probability
Range0 to 100
ConfigurableFalse

max-threshold-bytes number

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

DescriptionThe queue depth in bytes that corresponds to the WRED maximum threshold parameter.
Contextinterface name string qos output unicast-queue queue-id number active-queue-management wred-slope traffic-type keyword drop-probability keyword max-threshold-bytes number
Treemax-threshold-bytes
Unitsbytes
ConfigurableFalse

min-threshold-bytes number

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

DescriptionThe queue depth in bytes that corresponds to the WRED mininum threshold parameter.
Contextinterface name string qos output unicast-queue queue-id number active-queue-management wred-slope traffic-type keyword drop-probability keyword min-threshold-bytes number
Treemin-threshold-bytes
Unitsbytes
ConfigurableFalse

slope-enabled boolean

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

Description

Reads true if the slope is enabled.

A disabled slope has min-threshold-bytes = max-threshold-bytes = max-probability = 0

Contextinterface name string qos output unicast-queue queue-id number active-queue-management wred-slope traffic-type keyword drop-probability keyword slope-enabled boolean
Treeslope-enabled
ConfigurableFalse

forwarding-class keyword

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

DescriptionThe list of forwarding classes that map to this queue.
Contextinterface name string qos output unicast-queue queue-id number forwarding-class keyword
Treeforwarding-class
Options
  • fc0

  • fc1

  • fc2

  • fc3

  • fc4

  • fc5

  • fc6

  • fc7

ConfigurableFalse

scheduling

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

DescriptionContainer for queue scheduling parameters
Contextinterface name string qos output unicast-queue queue-id number scheduling
Treescheduling
ConfigurableTrue

peak-rate-percent number

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

DescriptionThe maximum percentage of port bandwidth that is available to the traffic in this unicast queue. The default is 100.
Contextinterface name string qos output unicast-queue queue-id number scheduling peak-rate-percent number
Treepeak-rate-percent
Range1 to 100
Default100
ConfigurableTrue

scheduler-node reference

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

Description

The scheduler node to which the unicast queue is connected. The mappings are fixed and not user-configurable.

J2: queue-id 0-7 -> node 1

TD3 (D2/D3): queue-id 0 -> node 0 queue-id 1 -> node 1 queue-id 2 -> node 2 queue-id 3 -> node 3 queue-id 4 -> node 4 queue-id 5 -> node 5 queue-id 6 -> node 6 queue-id 7 -> node 7

TH3: queue-id 0 -> node 1 queue-id 1 -> node 2 queue-id 2 -> node 4 queue-id 3 -> node 5 queue-id 4 -> node 7 queue-id 5 -> node 8 queue-id 6 -> node 10 queue-id 7 -> node 11

Contextinterface name string qos output unicast-queue queue-id number scheduling scheduler-node reference
Treescheduler-node
Reference

interface name string qos output scheduler tier level number node node-number number

ConfigurableFalse

strict-priority boolean

Note:

This command is available for the following platforms:

  • 7250 IXR-6

  • 7250 IXR-10

DescriptionWhen set to true the unicast queue is serviced as a strict priority queue, regardless of whether a weight is configured or its value. When set to false the unicast queue is serviced using WRR, even if the queue does not have a configured weight; in this case the default weight value of 1 is used.
Contextinterface name string qos output unicast-queue queue-id number scheduling strict-priority boolean
Treestrict-priority
Defaulttrue
ConfigurableTrue

template reference

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

Description

The name of a queue-template to apply to the unicast queue.

If a queue has no queue-template, the default queue-template is applied. The user cannot modify the default queue-template.

Contextinterface name string qos output unicast-queue queue-id number template reference
Treetemplate
Reference

qosqueue-templates queue-template name string string

ConfigurableTrue

queue-statistics

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

DescriptionEnter the queue-statistics context
Contextinterface name string queue-statistics
Treequeue-statistics
ConfigurableFalse

queue-id number

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

Description

The queue identifier

For J2 and TD3 there is a one-to-one mapping between queue-id and forwarding class. fc0 traffic always use queue-id 0, fc1 traffic always uses queue-id 1, etc.

For TH3 the multicast queue-id range is limited to 0-3 and the mapping is as follows: fc0+1 -> queue-id 0 fc2+3 -> queue-id 1 fc4+5 -> queue-id 2 fc6+7 -> queue-id 3

Contextinterface name string queue-statistics multicast-queue queue-id number
Range0 to 7
ConfigurableFalse

last-clear string

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

DescriptionTimestamp of the last time the statistics associated with this multicast queue were cleared
Contextinterface name string queue-statistics multicast-queue queue-id number last-clear string
Treelast-clear
String Length20 to 32
ConfigurableFalse

queue-id number

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

Description

The queue identifier

For unicast traffic on all platforms there is a one-to-one mapping between queue-id and forwarding class. fc0 traffic always use queue-id 0, fc1 traffic always uses queue-id 1, etc.

Contextinterface name string queue-statistics unicast-queue queue-id number
Range0 to 7
ConfigurableFalse

final-dropped-octets number

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

Description

Number of octets dropped by the unicast queue.

On 7250-IXR (Jericho2-based) systems unicast packet drops related to egress port congestion should show up in the VOQ stats and not in this statistic.

Contextinterface name string queue-statistics unicast-queue queue-id number final-dropped-octets number
Treefinal-dropped-octets
Default0
ConfigurableFalse

final-dropped-packets number

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

Description

Number of packets dropped by the unicast queue.

On 7250-IXR (Jericho2-based) systems unicast packet drops related to egress port congestion should show up in the VOQ stats and not in this statistic.

Contextinterface name string queue-statistics unicast-queue queue-id number final-dropped-packets number
Treefinal-dropped-packets
Default0
ConfigurableFalse

last-clear string

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

DescriptionTimestamp of the last time the statistics associated with this unicast queue were cleared
Contextinterface name string queue-statistics unicast-queue queue-id number last-clear string
Treelast-clear
String Length20 to 32
ConfigurableFalse

transmitted-packets number

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

DescriptionNumber of packets transmitted by the unicast queue, including transit traffic and locally originated traffic.
Contextinterface name string queue-statistics unicast-queue queue-id number transmitted-packets number
Treetransmitted-packets
Default0
ConfigurableFalse

high-drop-probability number

Note:

This command is available for the following platforms:

  • 7250 IXR-6

  • 7250 IXR-10

DescriptionThe number of octets in unicast packets dropped in the VOQ due to the congestion at the egress port/queue that were classified as high drop-probability. This reads 0 when the IMM associated with the VOQ is not inserted and it resets to 0 whenever the IMM associated with the VOQ is removed.
Contextinterface name string queue-statistics unicast-queue queue-id number virtual-output-queue slot number dropped-octets high-drop-probability number
Treehigh-drop-probability
Default0
ConfigurableFalse

low-drop-probability number

Note:

This command is available for the following platforms:

  • 7250 IXR-6

  • 7250 IXR-10

DescriptionThe number of octets in unicast packets dropped in the VOQ due to the congestion at the egress port/queue that were classified as low drop-probability. This reads 0 when the IMM associated with the VOQ is not inserted and it resets to 0 whenever the IMM associated with the VOQ is removed.
Contextinterface name string queue-statistics unicast-queue queue-id number virtual-output-queue slot number dropped-octets low-drop-probability number
Treelow-drop-probability
Default0
ConfigurableFalse

medium-drop-probability number

Note:

This command is available for the following platforms:

  • 7250 IXR-6

  • 7250 IXR-10

DescriptionThe number of octets in unicast packets dropped in the VOQ due to the congestion at the egress port/queue that were classified as medium drop-probability. This reads 0 when the IMM associated with the VOQ is not inserted and it resets to 0 whenever the IMM associated with the VOQ is removed.
Contextinterface name string queue-statistics unicast-queue queue-id number virtual-output-queue slot number dropped-octets medium-drop-probability number
Treemedium-drop-probability
Default0
ConfigurableFalse

high-drop-probability number

Note:

This command is available for the following platforms:

  • 7250 IXR-6

  • 7250 IXR-10

DescriptionThe number of unicast packets dropped in the VOQ due to the congestion at the egress port/queue that were classified as high drop-probability. This reads 0 when the IMM associated with the VOQ is not inserted and it resets to 0 whenever the IMM associated with the VOQ is removed.
Contextinterface name string queue-statistics unicast-queue queue-id number virtual-output-queue slot number dropped-packets high-drop-probability number
Treehigh-drop-probability
Default0
ConfigurableFalse

low-drop-probability number

Note:

This command is available for the following platforms:

  • 7250 IXR-6

  • 7250 IXR-10

DescriptionThe number of unicast packets dropped in the VOQ due to the congestion at the egress port/queue that were classified as low drop-probability. This reads 0 when the IMM associated with the VOQ is not inserted and it resets to 0 whenever the IMM associated with the VOQ is removed.
Contextinterface name string queue-statistics unicast-queue queue-id number virtual-output-queue slot number dropped-packets low-drop-probability number
Treelow-drop-probability
Default0
ConfigurableFalse

medium-drop-probability number

Note:

This command is available for the following platforms:

  • 7250 IXR-6

  • 7250 IXR-10

DescriptionThe number of unicast packets dropped in the VOQ due to the congestion at the egress port/queue that were classified as medium drop-probability. This reads 0 when the IMM associated with the VOQ is not inserted and it resets to 0 whenever the IMM associated with the VOQ is removed.
Contextinterface name string queue-statistics unicast-queue queue-id number virtual-output-queue slot number dropped-packets medium-drop-probability number
Treemedium-drop-probability
Default0
ConfigurableFalse

high-drop-probability number

Note:

This command is available for the following platforms:

  • 7250 IXR-6

  • 7250 IXR-10

DescriptionThe number of octets in unicast packets transmitted from the VOQ to the egress queue that were classified as high drop-probability. This reads 0 when the IMM associated with the VOQ is not inserted and it resets to 0 whenever the IMM associated with the VOQ is removed.
Contextinterface name string queue-statistics unicast-queue queue-id number virtual-output-queue slot number forwarded-octets high-drop-probability number
Treehigh-drop-probability
Default0
ConfigurableFalse

low-drop-probability number

Note:

This command is available for the following platforms:

  • 7250 IXR-6

  • 7250 IXR-10

DescriptionThe number of octets in unicast packets transmitted from the VOQ to the egress queue that were classified as low drop-probability. This reads 0 when the IMM associated with the VOQ is not inserted and it resets to 0 whenever the IMM associated with the VOQ is removed.
Contextinterface name string queue-statistics unicast-queue queue-id number virtual-output-queue slot number forwarded-octets low-drop-probability number
Treelow-drop-probability
Default0
ConfigurableFalse

medium-drop-probability number

Note:

This command is available for the following platforms:

  • 7250 IXR-6

  • 7250 IXR-10

DescriptionThe number of octets in unicast packets transmitted from the VOQ to the egress queue that were classified as medium drop-probability. This reads 0 when the IMM associated with the VOQ is not inserted and it resets to 0 whenever the IMM associated with the VOQ is removed.
Contextinterface name string queue-statistics unicast-queue queue-id number virtual-output-queue slot number forwarded-octets medium-drop-probability number
Treemedium-drop-probability
Default0
ConfigurableFalse

high-drop-probability number

Note:

This command is available for the following platforms:

  • 7250 IXR-6

  • 7250 IXR-10

DescriptionThe number of unicast packets transmitted from the VOQ to the egress queue that were classified as high drop-probability. This reads 0 when the IMM associated with the VOQ is not inserted and it resets to 0 whenever the IMM associated with the VOQ is removed.
Contextinterface name string queue-statistics unicast-queue queue-id number virtual-output-queue slot number forwarded-packets high-drop-probability number
Treehigh-drop-probability
Default0
ConfigurableFalse

low-drop-probability number

Note:

This command is available for the following platforms:

  • 7250 IXR-6

  • 7250 IXR-10

DescriptionThe number of unicast packets transmitted from the VOQ to the egress queue that were classified as low drop-probability. This reads 0 when the IMM associated with the VOQ is not inserted and it resets to 0 whenever the IMM associated with the VOQ is removed.
Contextinterface name string queue-statistics unicast-queue queue-id number virtual-output-queue slot number forwarded-packets low-drop-probability number
Treelow-drop-probability
Default0
ConfigurableFalse

medium-drop-probability number

Note:

This command is available for the following platforms:

  • 7250 IXR-6

  • 7250 IXR-10

DescriptionThe number of unicast packets transmitted from the VOQ to the egress queue that were classified as medium drop-probability. This reads 0 when the IMM associated with the VOQ is not inserted and it resets to 0 whenever the IMM associated with the VOQ is removed.
Contextinterface name string queue-statistics unicast-queue queue-id number virtual-output-queue slot number forwarded-packets medium-drop-probability number
Treemedium-drop-probability
Default0
ConfigurableFalse

sflow

Description Context to configure sFlow parameters
Contextinterface name string sflow
Treesflow
ConfigurableTrue

admin-state keyword

Description Administratively enable or disable sFlow on this interface
Contextinterface name string sflow admin-state keyword
Treeadmin-state
Options
  • enable

  • disable

Configurable True

in-discarded-packets number

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7220 IXR-D1

Description

Corresponds to ifInDiscards from the IFMIB.

This counts the number of IP packets discarded due to VLAN mismatch, unknown dest MAC or drop by system-filter drop action.

Contextinterface name string statistics in-discarded-packets number
Treein-discarded-packets
Default0
ConfigurableFalse

out-mirror-octets number

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7220 IXR-D3

  • 7220 IXR-D3L

  • 7220 IXR-D2L

Description This counts the number of outgoing mirrored octets
Contextinterface name string statistics out-mirror-octets number
Treeout-mirror-octets
Default0
ConfigurableFalse

out-mirror-packets number

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7220 IXR-D3

  • 7220 IXR-D3L

  • 7220 IXR-D2L

Description This counts the number of outgoing mirrored packets
Contextinterface name string statistics out-mirror-packets number
Treeout-mirror-packets
Default0
ConfigurableFalse

index number

Description The index of the subinterface, or logical interface number
Contextinterface name string subinterface index number
Range0 to 9999
ConfigurableTrue

anycast-gw

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-D3

  • 7220 IXR-D1

DescriptionEnable the anycast-gw context
Contextinterface name string subinterface index number anycast-gw
Treeanycast-gw
ConfigurableTrue

anycast-gw-mac string

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-D3

  • 7220 IXR-D1

Description

The MAC address of associated to the anycast-gw IP address.

If the anycast-gw MAC address is not configured, it will be auto-derived from the virtual-router-id value as per draft-ietf-bess-evpn-inter-subnet-forwarding following the format 00:00:5E:00:01:VRID.

Contextinterface name string subinterface index number anycast-gw anycast-gw-mac string
Treeanycast-gw-mac
ConfigurableTrue

anycast-gw-mac-origin keyword

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-D3

  • 7220 IXR-D1

Description

Origin of the active anycast-gateway MAC address.

If not configured, the anycast-gateway-mac will be auto-derived out of 00:00:5E:00:01:VRID, where VRID is the Virtual Router Identifier of the subinterface anycast-gw.

Contextinterface name string subinterface index number anycast-gw anycast-gw-mac-origin keyword
Treeanycast-gw-mac-origin
Options
  • configured

  • vrid-auto-derived

Configurable False

virtual-router-id number

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-D3

  • 7220 IXR-D1

DescriptionThe Virtual Router Identifier (VRID) value used to auto-derive the anycast-gw-mac in the format 00:00:5E:00:01:VRID.
Contextinterface name string subinterface index number anycast-gw virtual-router-id number
Treevirtual-router-id
Range1 to 255
Default1
ConfigurableTrue

bridge-table

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-D3

  • 7220 IXR-D1

DescriptionEnable the Bridge Table on the subinterface and configure associated parameters
Contextinterface name string subinterface index number bridge-table
Treebridge-table
ConfigurableTrue

discard-unknown-src-mac boolean

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-D3

  • 7220 IXR-D1

DescriptionDiscard frames with unknown source mac addresses. The source mac address of the discarded frame is never learned when this command is enabled.
Contextinterface name string subinterface index number bridge-table discard-unknown-src-mac boolean
Treediscard-unknown-src-mac
Defaultfalse
ConfigurableTrue

action keyword

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-D3

  • 7220 IXR-D1

Description

Action to take on the subinterface upon detecting at least one mac addresses as duplicate on the subinterface. In particular:

['use-net-instance-action: upon detecting a duplicate mac on the subinterface, the action on the subinterface will be inherited from the action configured under network-instance/bridge-table/mac-duplication/action.', 'oper-down: if configured, upon detecting a duplicate mac on the subinterface, the subinterface will be brought oper-down, with oper-down-reason mac-dup-detected. The duplicate macs on the interface will be kept in CPM though, and shown in the duplicate-entries state. In this case, arriving frames on a different subinterface with the duplicate mac as source mac are dropped. Arriving frames on a different subinterface with a destination mac matching the duplicate mac are dropped.', 'blackhole: upon detecting a duplicate mac on the subinterface, the mac will be blackholed. Any frame received on this or any other subinterface with source mac matching a blackhole mac will be discarded. Any frame received with destination mac matching the blackhole mac will be discarded, although still processed for source mac learning.', 'stop-learning: upon detecting a duplicate mac on the subinterface, existing macs are kept (and refreshed) but new macs are no longer learned on this subinterface. The duplicate mac will stay learned on the subinterface. Frames arriving to a different subinterface with a source mac matching the duplicate mac will be dropped. Frames arriving to a different subinterface with a destination mac matching the duplicate mac will be forwarded normally.']

Contextinterface name string subinterface index number bridge-table mac-duplication action keyword
Treeaction
Defaultuse-net-instance-action
Options
  • use-net-instance-action

  • stop-learning

  • blackhole

  • oper-down

ConfigurableTrue

admin-state keyword

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-D3

  • 7220 IXR-D1

DescriptionConfigurable state of the learning procedures for dynamic mac addresses. If disabled, the existing macs in the bridge-table will be kept (and refreshed if new frames arrive for them) but no new mac addresses will be learned. Frames with unknown mac addresses are not dropped, unless discard-unknown-src-mac is configured.
Contextinterface name string subinterface index number bridge-table mac-learning admin-state keyword
Treeadmin-state
Defaultenable
Options
  • enable

  • disable

Configurable True

admin-state keyword

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-D3

  • 7220 IXR-D1

DescriptionConfigurable state of the aging for the dynamic mac entries in the bridge table. If disabled, dynamically learned mac entries will be programmed in the bridge table until the network instance is disabled.
Contextinterface name string subinterface index number bridge-table mac-learning aging admin-state keyword
Treeadmin-state
Defaultenable
Options
  • enable

  • disable

Configurable True

warning-threshold-pct number

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-D3

  • 7220 IXR-D1

DescriptionPercentage of the configured max-number-macs over which a warning is triggered. The warning message is cleared when the percentage drops below the configured percentage minus 5%
Contextinterface name string subinterface index number bridge-table mac-limit warning-threshold-pct number
Treewarning-threshold-pct
Range6 to 100
Default95
ConfigurableTrue

type keyword

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-D3

  • 7220 IXR-D1

DescriptionThe type of the MAC installed in the fib.
Contextinterface name string subinterface index number bridge-table mac-table mac address string type keyword
Treetype
Options
  • static

  • duplicate

  • learnt

  • irb-interface

  • evpn

  • evpn-static

  • irb-interface-anycast

  • proxy-anti-spoof

  • reserved

  • eth-cfm

ConfigurableFalse

type keyword

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-D3

  • 7220 IXR-D1

DescriptionEnter the type context
Contextinterface name string subinterface index number bridge-table statistics mac-type type keyword
Options
  • static

  • duplicate

  • learnt

  • irb-interface

  • evpn

  • evpn-static

  • irb-interface-anycast

  • proxy-anti-spoof

  • reserved

  • eth-cfm

ConfigurableFalse

ip-mtu number

Description

IP MTU of the subinterface in bytes, including the IP header but excluding Ethernet encapsulation

IP MTU specifies the maximum sized IPv4 or IPv6 packet that can be transmitted on the subinterface. If an IPv4 or IPv6 packet exceeds this size it is dropped and this may result in the generation of an ICMP error message back to the source.

The default IP MTU for a subinterface is taken from /system/mtu/default-ip-mtu. For the mgmt0 and mgmt0-standby subinterfaces the default is the associated interface MTU minus the Ethernet encapsulation overhead.

The IP MTU is not configurable for subinterfaces of loopback interfaces.

The 7220 IXR-D1, 7220 IXR-D2, 7220 IXR-D3, 7220 IXR-H2, and 7220 IXR-H3 systems support a maximum IP MTU of 9398 bytes.

Each 7250 IXR IMM supports a maximum of 4 different IP MTU values. 7220 IXR systems do not have any limit on the maximum number of different IP MTU values.

Contextinterface name string subinterface index number ip-mtu number
Treeip-mtu
Range1280 to 9486
Unitsbytes
ConfigurableTrue

ipv4

Description

Enable IPv4 on the subinterface and configure associated parameters

When this is present in the running configuration, and even before an IPv4 address is configured, the subinterface starts to accept incoming packets with dest-ip 255.255.255.255, which is necessary to support dhcp-client functionality.

Contextinterface name string subinterface index number ipv4
Treeipv4
ConfigurableTrue

ip-prefix string

Description

The IPv4 address and prefix length in CIDR notation

Subnets on the same subinterface are allowed to overlap as long as the host bits are different. When a locally originated unicast packet is destined to a host covered by multiple subnets associated with a subinterface, the source address is chosen to be the numerically lowest IP address among all these subnets. For example, if the addresses 172.16.1.1/12, 172.16.1.2/12, and 172.16.1.3/12 are configured on the same interface, 172.16.1.1 would be used as a local address when you issue a ping 172.16.1.5 command

Contextinterface name string subinterface index number ipv4 address ip-prefix string
ConfigurableTrue

anycast-gw boolean

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-D3

  • 7220 IXR-D1

Description

This designates the associated IPv4 address as an anycast-gateway IPv4 address of the subinterface.

When this parameter is set to true:

['The IPv4 address is associated with the anycast-gw MAC address in the same subinterface. ARP Requests received for the anycast-gw IPv4 address will be replied using this anycast-gw MAC address.', 'The IPv4 address can have duplicate IPv4 addresses in other IRB subinterfaces of routers attached to the same broadcast domain. Because of that ARP duplicate-address-detection procedures do not apply to anycast-gw IP addresses.']

Contextinterface name string subinterface index number ipv4 address ip-prefix string anycast-gw boolean
Treeanycast-gw
ConfigurableTrue

primary

Description

One of the IPv4 prefixes assigned to the subinterface can be explicitly configured as primary by setting this leaf to true. This designates the associated IPv4 address as a primary IPv4 address of the subinterface. By default, the numerically lowest value IPv4 address is selected as the primary address.

The primary address is used as the source address for locally originated broadcast and multicast packets sent out the subinterface.

Contextinterface name string subinterface index number ipv4 address ip-prefix string primary
Treeprimary
ConfigurableTrue

allow-directed-broadcast boolean

Description

When this is set to true the software is allowed to re-broadcast targeted broadcast IPv4 packets on this subinterface

Detailed handling of subnet broadcast is as follows:

If a targeted broadcast packet is received on subinterface X that has the matching subnet then it is delivered to the CPM and CPM will reply to an ICMP echo.

If a targeted broadcast packet is received on subinterface X but the matching subnet is associated with subinterface Y, and subinterface Y is configured with allow-directed-broadcasts=false then it is delivered to the CPM and CPM replies to an ICMP echo per above, but it does not re-broadcast the packet on subinterface Y.

If a targeted broadcast packet is received on subinterface X but the matching subnet is associated with subinterface Y, and subinterface Y is configured with allow-directed-broadcasts=true then it is delivered to the CPM and CPM replies to an ICMP echo per above, and CPM also re-broadcasts the packet on subinterface Y.

Contextinterface name string subinterface index number ipv4 allow-directed-broadcast boolean
Treeallow-directed-broadcast
Defaultfalse
ConfigurableTrue

debug keyword

Description List of events to debug
Context interface name string subinterface index number ipv4 arp debug keyword
Treedebug
Options
  • messages

    Capture all arp-request and reply-messages sent and received by the subinterface

ConfigurableTrue

evpn

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7220 IXR-D3

  • 7220 IXR-D3L

  • 7220 IXR-D2L

Description Configure which types of ARP or ND entries will be advertised in EVPN MAC/IP routes.
Contextinterface name string subinterface index number ipv4 arp evpn
Treeevpn
ConfigurableTrue

route-type keyword

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7220 IXR-D3

  • 7220 IXR-D3L

  • 7220 IXR-D2L

Description Controls what type of ARP or ND entries to advertise.
Contextinterface name string subinterface index number ipv4 arp evpn advertise route-type keyword
Options
  • static

  • dynamic

Configurable True

ipv4-address string

Description

IPv4 address resolved by the ARP entry

To configure a static neighbor entry a value must be written into this leaf and the link-layer-address leaf.

Contextinterface name string subinterface index number ipv4 arp neighbor ipv4-address string
ConfigurableTrue

timeout number

Description

Duration of time that dynamic ARP entries remain in the ARP cache before they expire

A change to this value does not affect existing entries until they are refreshed.

Contextinterface name string subinterface index number ipv4 arp timeout number
Treetimeout
Range60 to 65535
Default14400
Unitsseconds
ConfigurableTrue

gi-address string

Description IPv4 address to be used as giaddr of the relayed packets towards DHCPv4 servers. This address can be any IPv4 address configured within the network-instance towards the DHCPv4 server
Contextinterface name string subinterface index number ipv4 dhcp-relay gi-address string
Treegi-address
ConfigurableTrue

oper-down-reason keyword

Description The reason causing the dhcp relay agent to go into operational down state
Contextinterface name string subinterface index number ipv4 dhcp-relay oper-down-reason keyword
Treeoper-down-reason
Options
  • dhcp-relay-admin-down

  • sub-interface-oper-down

  • all-dhcp-servers-unreachable-within-net-instance

  • gi-address-not-matching-relay-sub-interface-ipv4-addresses

  • no-valid-ipv4-address-on-sub-interface

ConfigurableFalse

oper-state keyword

Description The operational state of the dhcp relay agent
Contextinterface name string subinterface index number ipv4 dhcp-relay oper-state keyword
Treeoper-state
Options
  • up

    Component or process is operational

  • down

    Component or process is not operational

  • empty

    Component slot is empty

  • downloading

    Component is downloading image into memory

  • booting

    Component is booting downloaded image

  • starting

    Component image operational, application processes starting

  • failed

    Component or process has failed

  • synchronizing

    Component is currently being synchronized

  • upgrading

    Component is currently being upgraded

  • low-power

    Component is offline due to insufficient system power

  • degraded

    Component or process is in a degraded state

  • warm-reboot

    Component or process is currently warm rebooting

    Component or process is currently warm rebooting This state is set during a warm reboot immediately following initiation of the reboot, continuing after startup until the system has completed audit. In this state the system will not accept configuration changes.

ConfigurableFalse

option keyword

Description List of option82 suboptions to insert into relayed packet towards DHCPv4 server
Contextinterface name string subinterface index number ipv4 dhcp-relay option keyword
Treeoption
Options
  • circuit-id

    Enable option 82 suboption 1 circuit-id into relayed packet towards DHCPv4 server, format=system_name/VRF_instance/sub-interface_id:vlan_id

  • remote-id

    Enable option 82 suboption 2 remote-id into relayed packet towards DHCPv4 server, format=client MAC address

ConfigurableTrue

server (ipv4-address | domain-name)

Description List of the DHCPv4 servers that the DHCPv4 relay function will relay DHCPv4 packets to/from
Contextinterface name string subinterface index number ipv4 dhcp-relay server (ipv4-address | domain-name)
Treeserver
String Length1 to 253
ConfigurableTrue
Max. Elements8
Min. Elements1

dhcp-server

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

  • 7220 IXR-D1

DescriptionEnable the dhcp-server context
Contextinterface name string subinterface index number ipv4 dhcp-server
Treedhcp-server
ConfigurableTrue

admin-state keyword

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

  • 7220 IXR-D1

DescriptionEnables/Disables DHCP server function on subinterface
Contextinterface name string subinterface index number ipv4 dhcp-server admin-state keyword
Treeadmin-state
Defaultdisable
Options
  • enable

  • disable

Configurable True

oper-state keyword

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

  • 7220 IXR-D1

DescriptionDetails if the dhcp server is operationally available
Contextinterface name string subinterface index number ipv4 dhcp-server oper-state keyword
Treeoper-state
Options
  • up

    Component or process is operational

  • down

    Component or process is not operational

  • empty

    Component slot is empty

  • downloading

    Component is downloading image into memory

  • booting

    Component is booting downloaded image

  • starting

    Component image operational, application processes starting

  • failed

    Component or process has failed

  • synchronizing

    Component is currently being synchronized

  • upgrading

    Component is currently being upgraded

  • low-power

    Component is offline due to insufficient system power

  • degraded

    Component or process is in a degraded state

  • warm-reboot

    Component or process is currently warm rebooting

    Component or process is currently warm rebooting This state is set during a warm reboot immediately following initiation of the reboot, continuing after startup until the system has completed audit. In this state the system will not accept configuration changes.

ConfigurableFalse

in-discarded-packets number

Description

The total number of input IPv4 packets or IPv6 packets or both (transit and terminating traffic) that were dropped for any of the following reasons:

['ingress interface ACL drop action', 'CPM filter drop action', 'VOQ congestion discards (7250 IXR only)', 'unicast destination MAC address is not the MAC address of the subinterface', 'packet matched a route with a blackhole next-hop', 'packet was non-terminating and its TTL expired', 'packet matched a route with a next-hop via another subinterface but the next-hop address was not resolvable by ARP/ND', 'packet is a host address on another subinterface but the host address was not resolvable by ARP/ND']

This also includes IP/MPLS packets dropped by ingress interface ACL drop action or CPM filer drop action.

Contextinterface name string subinterface index number ipv4 statistics in-discarded-packets number
Treein-discarded-packets
Default0
ConfigurableFalse

in-error-packets number

Note:

This command is available for the following platforms:

  • 7250 IXR-6

  • 7250 IXR-10

Description

The total number of input IPv4 packets or IPv6 packets or both discarded due to errors, counting transit and terminating traffic

The sum of the following RFC 4293 counters: ipIfStatsInHdrErrors ipIfStatsInNoRoutes ipIfStatsInAddrErrors ipIfStatsInUnknownProtos ipIfStatsInTruncatedPkts

Contextinterface name string subinterface index number ipv4 statistics in-error-packets number
Treein-error-packets
Default0
ConfigurableFalse

in-forwarded-packets number

Description

The number of input IPv4 packets or IPv6 packets or both received on this subinterface for which the router was not the final destination and for which the router attempted to find a route to forward them to that final destination.

Note that non-terminating IPv4 packets with options and non-terminating IPv6 packets with extension headers are included in this count (and not dropped) as are packets that trigger ICMP/ICMPv6 redirect messages.

On 7220 IXR systems this also counts received traffic that is terminating.

Contextinterface name string subinterface index number ipv4 statistics in-forwarded-packets number
Treein-forwarded-packets
Default0
ConfigurableFalse

in-packets number

Description

The total number of input packets received, counting transit and terminating traffic

This equals the sum of: in-error-packets in-discarded-packets (also includes IP/MPLS packets) in-terminated-packets (also includes IP/MPLS packets) in-forwarded-packets

Contextinterface name string subinterface index number ipv4 statistics in-packets number
Treein-packets
Default0
ConfigurableFalse

in-terminated-octets number

Note:

This command is available for the following platforms:

  • 7250 IXR-6

  • 7250 IXR-10

DescriptionThe total number of octets in input IPv4 packets or IPv6 packets or both that were received on this subinterface and counted in in-terminated-packets
Contextinterface name string subinterface index number ipv4 statistics in-terminated-octets number
Treein-terminated-octets
Default0
ConfigurableFalse

in-terminated-packets number

Note:

This command is available for the following platforms:

  • 7250 IXR-6

  • 7250 IXR-10

Description

The total number of input IPv4 packets or IPv6 packets or both that were received on this subinterface and that have a destination IP address matching a local interface address or an IPv6 multicast address to which the interface belongs. The count includes packets eventually discarded by the CPM. Such discards include:

['packets with unsupported IP protocol numbers', 'packets destined to TCP/UDP ports that are not open/listening', 'IPv4 packets with any IP options', 'IPv6 packets with any extension headers']

This also includes terminating IP/MPLS packets.

Contextinterface name string subinterface index number ipv4 statistics in-terminated-packets number
Treein-terminated-packets
Default0
ConfigurableFalse

out-error-packets number

Note:

This command is available for the following platforms:

  • 7250 IXR-6

  • 7250 IXR-10

Description

The number of IPv4 packets or IPv6 packets or both, originating and transit, for which this router was successful in finding a path to their final destination through this subinterface but an error prevented their transmission.

On 7250 IXR systems this is incremented when the IPv4 packet size exceeds the IP MTU and fragmentation was not allowed or not supported

Contextinterface name string subinterface index number ipv4 statistics out-error-packets number
Treeout-error-packets
Default0
ConfigurableFalse

out-packets number

Description

The total number of IPv4 packets or IPv6 packets or both that this router supplied to the lower layers for transmission

This includes packets generated locally and those forwarded by this router. If there are no queue drops it is equal to: <out-forwarded-packets> + <out-originated-packets>

Contextinterface name string subinterface index number ipv4 statistics out-packets number
Treeout-packets
Default0
ConfigurableFalse

ipv6

Description

Enable IPv6 on the subinterface and configure associated parameters

When this is present in the running configuration, and even before a global unicast IPv6 address is configured, chassis manager assigns an IPv6 link-local address to the subinterface, which will appear as a read-only entry in the address list. At this stage, the subinterface can receive IPv6 packets with any of the following destinations:

['IPv6 link-local address', 'solicited-node multicast address for the link-local address', 'ff02::1 (all IPv6 devices)', 'ff02::2 (all IPv6 routers)']

Contextinterface name string subinterface index number ipv6
Treeipv6
ConfigurableTrue

ip-prefix string

Description

The IPv6 address and prefix-length in CIDR notation

Up to 16 global unicast IPv6 addresses can be assigned to each subinterface. Global unicast IPv6 address subnets on the same subinterface are allowed to overlap as long as the host bits are different. When a locally originated unicast packet is destined to a host covered by multiple subnets associated with a subinterface, the source address is chosen to be the numerically lowest IP address among all these subnets.

Contextinterface name string subinterface index number ipv6 address ip-prefix string
ConfigurableTrue

anycast-gw boolean

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-D3

  • 7220 IXR-D1

Description

This designates the associated IPv6 address as an anycast-gateway IPv6 address of the subinterface.

When this parameter is set to true:

['The IPv6 address is associated with the anycast-gw MAC address in the same subinterface. Neighbor Solicitations received for the anycast-gw IPv6 address will be replied using this anycast-gw MAC address.', 'The IPv6 address can have duplicate IPv6 addresses in other IRB subinterfaces of routers attached to the same broadcast domain. Because of that, ND duplicate-address-detection procedures do not apply to anycast-gw IP addresses.']

Contextinterface name string subinterface index number ipv6 address ip-prefix string anycast-gw boolean
Treeanycast-gw
ConfigurableTrue

primary

Description

One of the IPv6 prefixes assigned to the subinterface can be explicitly configured as primary by setting this leaf to true. This designates the associated IPv6 address as a primary IPv6 address of the subinterface. By default, the numerically lowest value IPv6 address is selected as the primary address.

The primary address is used as the source address for locally originated broadcast and multicast packets sent out the subinterface.

Contextinterface name string subinterface index number ipv6 address ip-prefix string primary
Treeprimary
ConfigurableTrue

oper-down-reason keyword

Description The reason causing the dhcp relay agent to go into operational down state
Contextinterface name string subinterface index number ipv6 dhcp-relay oper-down-reason keyword
Treeoper-down-reason
Options
  • dhcp-relay-admin-down

  • sub-interface-oper-down

  • all-dhcpv6-servers-unreachable-within-net-instance

  • source-address-not-matching-relay-sub-interface-ipv6-addresses

  • no-valid-ipv6-address-on-sub-interface

ConfigurableFalse

oper-state keyword

Description The operational state of the dhcp relay agent
Contextinterface name string subinterface index number ipv6 dhcp-relay oper-state keyword
Treeoper-state
Options
  • up

    Component or process is operational

  • down

    Component or process is not operational

  • empty

    Component slot is empty

  • downloading

    Component is downloading image into memory

  • booting

    Component is booting downloaded image

  • starting

    Component image operational, application processes starting

  • failed

    Component or process has failed

  • synchronizing

    Component is currently being synchronized

  • upgrading

    Component is currently being upgraded

  • low-power

    Component is offline due to insufficient system power

  • degraded

    Component or process is in a degraded state

  • warm-reboot

    Component or process is currently warm rebooting

    Component or process is currently warm rebooting This state is set during a warm reboot immediately following initiation of the reboot, continuing after startup until the system has completed audit. In this state the system will not accept configuration changes.

ConfigurableFalse

option keyword

Description List of options to insert into relayed packet towards DHCPv6 server
Contextinterface name string subinterface index number ipv6 dhcp-relay option keyword
Treeoption
Options
  • interface-id

    Enable option 18 Interface-Id into relayed packet towards DHCPv6 server, format=system_name/VRF_instance/sub-interface_id:vlan_id

  • remote-id

    Enable option 37 Remote Identifier into relayed packet towards DHCPv6 server, format=client MAC address

ConfigurableTrue

server (ipv6-address | domain-name)

Description List of the DHCPv6 servers that the DHCPv6 relay function will relay DHCPv6 packets to/from
Contextinterface name string subinterface index number ipv6 dhcp-relay server (ipv6-address | domain-name)
Treeserver
String Length1 to 253
ConfigurableTrue
Max. Elements8
Min. Elements1

dhcpv6-server

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

  • 7220 IXR-D1

DescriptionEnable the dhcpv6-server context
Contextinterface name string subinterface index number ipv6 dhcpv6-server
Treedhcpv6-server
ConfigurableTrue

admin-state keyword

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

  • 7220 IXR-D1

DescriptionEnables/Disables DHCPv6 server function on subinterface
Contextinterface name string subinterface index number ipv6 dhcpv6-server admin-state keyword
Treeadmin-state
Defaultdisable
Options
  • enable

  • disable

Configurable True

oper-state keyword

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

  • 7220 IXR-D1

DescriptionDetails if the dhcp server is operationally available
Contextinterface name string subinterface index number ipv6 dhcpv6-server oper-state keyword
Treeoper-state
Options
  • up

    Component or process is operational

  • down

    Component or process is not operational

  • empty

    Component slot is empty

  • downloading

    Component is downloading image into memory

  • booting

    Component is booting downloaded image

  • starting

    Component image operational, application processes starting

  • failed

    Component or process has failed

  • synchronizing

    Component is currently being synchronized

  • upgrading

    Component is currently being upgraded

  • low-power

    Component is offline due to insufficient system power

  • degraded

    Component or process is in a degraded state

  • warm-reboot

    Component or process is currently warm rebooting

    Component or process is currently warm rebooting This state is set during a warm reboot immediately following initiation of the reboot, continuing after startup until the system has completed audit. In this state the system will not accept configuration changes.

ConfigurableFalse

evpn

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7220 IXR-D3

  • 7220 IXR-D3L

  • 7220 IXR-D2L

Description Configure which types of ARP or ND entries will be advertised in EVPN MAC/IP routes.
Contextinterface name string subinterface index number ipv6 neighbor-discovery evpn
Treeevpn
ConfigurableTrue

stale-time number

Description

The maximum time that a dynamic IPv6 neighbor cache entry can remain in the STALE state before it is removed

This limit is reached only if no traffic is sent/queued towards the neighbor during the entire duration of the timer.

Contextinterface name string subinterface index number ipv6 neighbor-discovery stale-time number
Treestale-time
Range60 to 65535
Default14400
Unitsseconds
ConfigurableTrue

max-advertisement-interval number

Description

The maximum time between sending router advertisement messages to the all-nodes multicast address.

Each subinterface has its own timer. Whenever the timer fires the message is sent and then the timer is reset to a uniformly distributed random value between min-advertisement-interval and max-advertisement-interval. The RA message can be sent before timer expiry in response to a RS message.

Contextinterface name string subinterface index number ipv6 router-advertisement router-role max-advertisement-interval number
Treemax-advertisement-interval
Range4 to 1800
Default600
Unitsseconds
Configurable True

min-advertisement-interval number

Description

The minimum time between sending router advertisement messages to the all-nodes multicast address.

Each subinterface has its own timer. Whenever the timer fires the message is sent and then the timer is reset to a uniformly distributed random value between min-advertisement-interval and max-advertisement-interval. The RA message can be sent before timer expiry in response to a RS message.

Contextinterface name string subinterface index number ipv6 router-advertisement router-role min-advertisement-interval number
Treemin-advertisement-interval
Range3 to 1350
Default200
Unitsseconds
Configurable True

retransmit-time number

Description The time, in milliseconds, that is advertised as the retrans-timer in RA messages and that hosts use for address resolution and the Neighbor Unreachability Detection algorithm. It represents the time between retransmitted NS messages. A value of zero means unspecified by this router.
Contextinterface name string subinterface index number ipv6 router-advertisement router-role retransmit-time number
Treeretransmit-time
Range0 to 1800000
Default0
ConfigurableTrue

in-discarded-packets number

Description

The total number of input IPv4 packets or IPv6 packets or both (transit and terminating traffic) that were dropped for any of the following reasons:

['ingress interface ACL drop action', 'CPM filter drop action', 'VOQ congestion discards (7250 IXR only)', 'unicast destination MAC address is not the MAC address of the subinterface', 'packet matched a route with a blackhole next-hop', 'packet was non-terminating and its TTL expired', 'packet matched a route with a next-hop via another subinterface but the next-hop address was not resolvable by ARP/ND', 'packet is a host address on another subinterface but the host address was not resolvable by ARP/ND']

This also includes IP/MPLS packets dropped by ingress interface ACL drop action or CPM filer drop action.

Contextinterface name string subinterface index number ipv6 statistics in-discarded-packets number
Treein-discarded-packets
Default0
ConfigurableFalse

in-error-packets number

Note:

This command is available for the following platforms:

  • 7250 IXR-6

  • 7250 IXR-10

Description

The total number of input IPv4 packets or IPv6 packets or both discarded due to errors, counting transit and terminating traffic

The sum of the following RFC 4293 counters: ipIfStatsInHdrErrors ipIfStatsInNoRoutes ipIfStatsInAddrErrors ipIfStatsInUnknownProtos ipIfStatsInTruncatedPkts

Contextinterface name string subinterface index number ipv6 statistics in-error-packets number
Treein-error-packets
Default0
ConfigurableFalse

in-forwarded-packets number

Description

The number of input IPv4 packets or IPv6 packets or both received on this subinterface for which the router was not the final destination and for which the router attempted to find a route to forward them to that final destination.

Note that non-terminating IPv4 packets with options and non-terminating IPv6 packets with extension headers are included in this count (and not dropped) as are packets that trigger ICMP/ICMPv6 redirect messages.

On 7220 IXR systems this also counts received traffic that is terminating.

Contextinterface name string subinterface index number ipv6 statistics in-forwarded-packets number
Treein-forwarded-packets
Default0
ConfigurableFalse

in-packets number

Description

The total number of input packets received, counting transit and terminating traffic

This equals the sum of: in-error-packets in-discarded-packets (also includes IP/MPLS packets) in-terminated-packets (also includes IP/MPLS packets) in-forwarded-packets

Contextinterface name string subinterface index number ipv6 statistics in-packets number
Treein-packets
Default0
ConfigurableFalse

in-terminated-octets number

Note:

This command is available for the following platforms:

  • 7250 IXR-6

  • 7250 IXR-10

DescriptionThe total number of octets in input IPv4 packets or IPv6 packets or both that were received on this subinterface and counted in in-terminated-packets
Contextinterface name string subinterface index number ipv6 statistics in-terminated-octets number
Treein-terminated-octets
Default0
ConfigurableFalse

in-terminated-packets number

Description

The total number of input IPv4 packets or IPv6 packets or both that were received on this subinterface and that have a destination IP address matching a local interface address or an IPv6 multicast address to which the interface belongs. The count includes packets eventually discarded by the CPM. Such discards include:

['packets with unsupported IP protocol numbers', 'packets destined to TCP/UDP ports that are not open/listening', 'IPv4 packets with any IP options', 'IPv6 packets with any extension headers']

This also includes terminating IP/MPLS packets.

Contextinterface name string subinterface index number ipv6 statistics in-terminated-packets number
Treein-terminated-packets
Default0
ConfigurableFalse

out-error-packets number

Note:

This command is available for the following platforms:

  • 7250 IXR-6

  • 7250 IXR-10

Description

The number of IPv4 packets or IPv6 packets or both, originating and transit, for which this router was successful in finding a path to their final destination through this subinterface but an error prevented their transmission.

On 7250 IXR systems this is incremented when the IPv4 packet size exceeds the IP MTU and fragmentation was not allowed or not supported

Contextinterface name string subinterface index number ipv6 statistics out-error-packets number
Treeout-error-packets
Default0
ConfigurableFalse

out-packets number

Description

The total number of IPv4 packets or IPv6 packets or both that this router supplied to the lower layers for transmission

This includes packets generated locally and those forwarded by this router. If there are no queue drops it is equal to: <out-forwarded-packets> + <out-originated-packets>

Contextinterface name string subinterface index number ipv6 statistics out-packets number
Treeout-packets
Default0
ConfigurableFalse

l2-mtu number

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-D3

  • 7220 IXR-D1

Description

Layer-2 MTU of the subinterface in bytes, including the Ethernet header and VLAN tags, and excluding 4-bytes FCS.

L2 MTU specifies the maximum sized Ethernet frame that can be transmitted on the subinterface. If a frame exceeds this size it is discarded. If the l2-mtu of the subinterface exceeds the port-mtu of the associated interface, the subinterface will remain operationally down.

The default value for a subinterface is taken from /system/mtu/default-l2-mtu. The L2 MTU is only configurable for bridged subinterfaces.

The 7220 IXR-D1, 7220 IXR-D2, 7220 IXR-D3, 7220 IXR-H2, and 7220 IXR-H3 systems support a maximum L2 MTU of 9412 bytes.

Contextinterface name string subinterface index number l2-mtu number
Treel2-mtu
Range1500 to 9500
Unitsbytes
ConfigurableTrue

oper-state keyword

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7220 IXR-D3

  • 7220 IXR-D3L

  • 7220 IXR-D2L

Description The operational state of the local mirror destination
Contextinterface name string subinterface index number local-mirror-destination oper-state keyword
Treeoper-state
Options
  • up

    Component or process is operational

  • down

    Component or process is not operational

  • empty

    Component slot is empty

  • downloading

    Component is downloading image into memory

  • booting

    Component is booting downloaded image

  • starting

    Component image operational, application processes starting

  • failed

    Component or process has failed

  • synchronizing

    Component is currently being synchronized

  • upgrading

    Component is currently being upgraded

  • low-power

    Component is offline due to insufficient system power

  • degraded

    Component or process is in a degraded state

  • warm-reboot

    Component or process is currently warm rebooting

    Component or process is currently warm rebooting This state is set during a warm reboot immediately following initiation of the reboot, continuing after startup until the system has completed audit. In this state the system will not accept configuration changes.

ConfigurableFalse

mpls

Note:

This command is available for the following platforms:

  • 7250 IXR-6

  • 7250 IXR-10

DescriptionContainer for MPLS configuration and state at the subinterface level
Contextinterface name string subinterface index number mpls
Treempls
ConfigurableFalse

in-error-packets number

Note:

This command is available for the following platforms:

  • 7250 IXR-6

  • 7250 IXR-10

Description

The total number of MPLS packets that were dropped because they were received with errors that include:

['forwarded top label had an MPLS TTL value of 0', 'terminating top label had an MPLS TTL value of 0', 'the top label was unknown (no matching forwarding entry)']

Contextinterface name string subinterface index number mpls statistics in-error-packets number
Treein-error-packets
Default0
ConfigurableFalse

in-octets number

Note:

This command is available for the following platforms:

  • 7250 IXR-6

  • 7250 IXR-10

DescriptionThe total number of octets in input MPLS packets received, not counting MPLS packets discarded due to ACLs or IP/MPLS packets that terminated on this router.
Contextinterface name string subinterface index number mpls statistics in-octets number
Treein-octets
Default0
ConfigurableFalse

in-packets number

Note:

This command is available for the following platforms:

  • 7250 IXR-6

  • 7250 IXR-10

Description

The total number of input MPLS packets received, not counting MPLS packets discarded due to ACLs or IP/MPLS packets that terminated on this router.

This equals the sum of: in-error-packets in-discarded-packets in-forwarded-packets

Contextinterface name string subinterface index number mpls statistics in-packets number
Treein-packets
Default0
ConfigurableFalse

last-clear string

Note:

This command is available for the following platforms:

  • 7250 IXR-6

  • 7250 IXR-10

DescriptionTimestamp of the last time the subinterface MPLS counters were cleared.
Contextinterface name string subinterface index number mpls statistics last-clear string
Treelast-clear
String Length20 to 32
ConfigurableFalse

out-error-packets number

Note:

This command is available for the following platforms:

  • 7250 IXR-6

  • 7250 IXR-10

Description

The number of MPLS packets that could not be transmitted on this subinterface because of an error.

For now this only counts transmission errors that result from the MPLS packet size exceeding the MPLS MTU of the subinterface.

Contextinterface name string subinterface index number mpls statistics out-error-packets number
Treeout-error-packets
Default0
ConfigurableFalse

out-packets number

Note:

This command is available for the following platforms:

  • 7250 IXR-6

  • 7250 IXR-10

Description

The total number of output MPLS packets transmitted.

This equals out-originated-packets + out-forwarded-packets

Contextinterface name string subinterface index number mpls statistics out-packets number
Treeout-packets
Default0
ConfigurableFalse

mpls-mtu number

Note:

This command is available for the following platforms:

  • 7250 IXR-6

  • 7250 IXR-10

Description

MPLS MTU of the subinterface in bytes, including the transmitted label stack.

MPLS MTU specifies the maximum sized MPLS packet that can be transmitted on the subinterface. If an MPLS packet containing any payload exceeds this size then it is dropped. If the payload of the dropped packet is IPv4 or IPv6 then this may also result in the generation of an ICMP error message that is either tunneled or sent back to the source.

The default MPLS MTU for a subinterface is taken from /system/mtu/default-mpls-mtu.

The MPLS MTU is not configurable for subinterfaces of loopback interfaces.

Each 7250 IXR IMM supports a maximum of 4 different MPLS MTU values.

Contextinterface name string subinterface index number mpls-mtu number
Treempls-mtu
Range1284 to 9496
Unitsbytes
ConfigurableTrue

name string

Description The system assigned name of the subinterface. It is formed by taking the base interface name and appending a dot (.) and the subinterface index number. For example, ethernet-2/1.0
Contextinterface name string subinterface index number name string
Treename
ConfigurableFalse

oper-down-reason keyword

Description The first (and possibly only) reason for the subinterface being operationally down
Contextinterface name string subinterface index number oper-down-reason keyword
Treeoper-down-reason
Options
  • admin-disabled

  • port-down

  • ip-mtu-resource-exceeded

  • mpls-mtu-resource-exceeded

  • ip-mtu-too-large

  • mpls-mtu-too-large

  • l2-mtu-too-large

  • no-ip-config

  • ip-mtu-larger-than-oper-mac-vrf-mtu

  • irb-mac-address-not-programmed

  • missing-xdp-state

  • no-underlay-egress-next-hop-resources

  • other

ConfigurableFalse

qos

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

DescriptionEnter the qos context
Contextinterface name string subinterface index number qos
Treeqos
ConfigurableTrue

input

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

DescriptionEnter the input context
Contextinterface name string subinterface index number qos input
Treeinput
ConfigurableTrue

classifiers

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

DescriptionEnter the classifiers context
Contextinterface name string subinterface index number qos input classifiers
Treeclassifiers
ConfigurableTrue

output

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7250 IXR-10

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-H3

  • 7220 IXR-H2

  • 7220 IXR-D3

  • 7250 IXR-6

DescriptionEnter the output context
Contextinterface name string subinterface index number qos output
Treeoutput
ConfigurableTrue

ra-guard

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-D3

  • 7220 IXR-D1

DescriptionEnable the ra-guard context
Contextinterface name string subinterface index number ra-guard
Treera-guard
ConfigurableTrue

vlan-id number

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-D3

  • 7220 IXR-D1

DescriptionEnter the vlan-id context
Contextinterface name string subinterface index number ra-guard vlan-list vlan-id number
Range0 to 4095
ConfigurableTrue

in-discarded-packets number

Description

The total number of input IPv4 packets or IPv6 packets or both (transit and terminating traffic) that were dropped for any of the following reasons:

['ingress interface ACL drop action', 'CPM filter drop action', 'VOQ congestion discards (7250 IXR only)', 'unicast destination MAC address is not the MAC address of the subinterface', 'packet matched a route with a blackhole next-hop', 'packet was non-terminating and its TTL expired', 'packet matched a route with a next-hop via another subinterface but the next-hop address was not resolvable by ARP/ND', 'packet is a host address on another subinterface but the host address was not resolvable by ARP/ND']

This also includes IP/MPLS packets dropped by ingress interface ACL drop action or CPM filer drop action.

Contextinterface name string subinterface index number statistics in-discarded-packets number
Treein-discarded-packets
Default0
ConfigurableFalse

in-error-packets number

Note:

This command is available for the following platforms:

  • 7250 IXR-6

  • 7250 IXR-10

Description

The total number of input IPv4 packets or IPv6 packets or both discarded due to errors, counting transit and terminating traffic

The sum of the following RFC 4293 counters: ipIfStatsInHdrErrors ipIfStatsInNoRoutes ipIfStatsInAddrErrors ipIfStatsInUnknownProtos ipIfStatsInTruncatedPkts

Contextinterface name string subinterface index number statistics in-error-packets number
Treein-error-packets
Default0
ConfigurableFalse

in-forwarded-packets number

Description

The number of input IPv4 packets or IPv6 packets or both received on this subinterface for which the router was not the final destination and for which the router attempted to find a route to forward them to that final destination.

Note that non-terminating IPv4 packets with options and non-terminating IPv6 packets with extension headers are included in this count (and not dropped) as are packets that trigger ICMP/ICMPv6 redirect messages.

On 7220 IXR systems this also counts received traffic that is terminating.

Contextinterface name string subinterface index number statistics in-forwarded-packets number
Treein-forwarded-packets
Default0
ConfigurableFalse

in-packets number

Description

The total number of input packets received, counting transit and terminating traffic

This equals the sum of: in-error-packets in-discarded-packets (also includes IP/MPLS packets) in-terminated-packets (also includes IP/MPLS packets) in-forwarded-packets

Contextinterface name string subinterface index number statistics in-packets number
Treein-packets
Default0
ConfigurableFalse

in-terminated-octets number

Note:

This command is available for the following platforms:

  • 7250 IXR-6

  • 7250 IXR-10

DescriptionThe total number of octets in input IPv4 packets or IPv6 packets or both that were received on this subinterface and counted in in-terminated-packets
Contextinterface name string subinterface index number statistics in-terminated-octets number
Treein-terminated-octets
Default0
ConfigurableFalse

in-terminated-packets number

Note:

This command is available for the following platforms:

  • 7250 IXR-6

  • 7250 IXR-10

Description

The total number of input IPv4 packets or IPv6 packets or both that were received on this subinterface and that have a destination IP address matching a local interface address or an IPv6 multicast address to which the interface belongs. The count includes packets eventually discarded by the CPM. Such discards include:

['packets with unsupported IP protocol numbers', 'packets destined to TCP/UDP ports that are not open/listening', 'IPv4 packets with any IP options', 'IPv6 packets with any extension headers']

This also includes terminating IP/MPLS packets.

Contextinterface name string subinterface index number statistics in-terminated-packets number
Treein-terminated-packets
Default0
ConfigurableFalse

out-error-packets number

Note:

This command is available for the following platforms:

  • 7250 IXR-6

  • 7250 IXR-10

Description

The number of IPv4 packets or IPv6 packets or both, originating and transit, for which this router was successful in finding a path to their final destination through this subinterface but an error prevented their transmission.

On 7250 IXR systems this is incremented when the IPv4 packet size exceeds the IP MTU and fragmentation was not allowed or not supported

Contextinterface name string subinterface index number statistics out-error-packets number
Treeout-error-packets
Default0
ConfigurableFalse

out-packets number

Description

The total number of IPv4 packets or IPv6 packets or both that this router supplied to the lower layers for transmission

This includes packets generated locally and those forwarded by this router. If there are no queue drops it is equal to: <out-forwarded-packets> + <out-originated-packets>

Contextinterface name string subinterface index number statistics out-packets number
Treeout-packets
Default0
ConfigurableFalse

type identityref

Description The value of this leaf indicates the context in which the ethernet subinterface will be used in
Contextinterface name string subinterface index number type identityref
Treetype
Options
  • routed

    indicates subinterface is used in a routed context

  • bridged

    indicates subinterface is used in a bridged context

  • local-mirror-dest

    indicates subinterface is used in a mirroring destination SPAN context

ConfigurableTrue

single-tagged

Description When present, tagged frames with a specific, non-zero, outer VLAN ID are associated to the subinterface. (The outer VLAN-ID tag is considered service delimiting and it is stripped at ingress and restored/added on egress.).
Contextinterface name string subinterface index number vlan encap single-tagged
Treesingle-tagged
ConfigurableTrue

untagged

Note:

This command is available for the following platforms:

  • 7220 IXR-D2

  • 7220 IXR-D3L

  • 7220 IXR-D2L

  • 7220 IXR-D3

  • 7220 IXR-D1

DescriptionWhen present, untagged frames and VLAN ID 0 priority tagged frames are associated to the subinterface when it belongs to an interface with vlan-tagging enabled.
Contextinterface name string subinterface index number vlan encap untagged
Treeuntagged
ConfigurableTrue

connector-type keyword

Description Specifies the fiber connector type of the transceiver associated with the port.
Contextinterface name string transceiver connector-type keyword
Treeconnector-type
Options
  • SC

  • FC-STYLE1-COPPER

  • FC-STYLE2-COPPER

  • BNC-OR-TNC

  • FC-COAX

  • FIBER-JACK

  • LC

  • MT-RJ

  • MU

  • SG

  • OPTICAL-PIGTAIL

  • MPO-1x12

  • MPO-2x16

  • HSSDC

  • COPPER-PIGTAIL

  • RJ45

  • no-separable-connector

  • MXC-2x16

  • CS-OPTICAL-CONNECTOR

  • SN-OPTICAL-CONNECTOR

  • MPO-2x12

  • MPO-1x16

  • unknown

ConfigurableFalse

ddm-events boolean

Description

When set to true, log events and state related to the Digital Diagnostic Monitoring (DDM) capabilities of the transceiver are generated and populated.

When set to false, no DDM-related log events and state are generated and populated for this port/transceiver.

When read from state this leaf always returns false (even if the configured value is true) when the Ethernet port is a copper/RJ45 port.

Contextinterface name string transceiver ddm-events boolean
Treeddm-events
ConfigurableTrue

form-factor keyword

Description Specifies the transceiver form factor associated with the port.
Contextinterface name string transceiver form-factor keyword
Treeform-factor
Options
  • CFP2

  • CFP2-ACO

  • CFP4

  • QSFP

  • QSFPplus

  • QSFP28

  • QSFPDD

  • SFP

  • SFPplus

  • Non-pluggable

  • Other

  • SFP28

ConfigurableFalse

forward-error-correction keyword

Description

The forward error correction algorithm to use on the optical channel. The same FEC algorithm must be used at both ends of a link.

25G interfaces support disabled, base-r rs-108 and rs-528; configuring other (incompatible) options will bring the port down. The FEC requirement for a 25G interface depends on the cable type. A CA-N DAC cable has a loss specification that requires no FEC. A CA-S DAC cable requires base-r FEC at a minimum. A CA-L DAC cable requires the stronger rs-108 Reed Solomon FEC.

100G interfaces support disabled and rs-528; configuring other (incompatible) options will bring the port down.

400G interfaces require rs-544; configuring other (unsupported) options will bring the port down.

Contextinterface name string transceiver forward-error-correction keyword
Treeforward-error-correction
Options
  • disabled

  • rs-528

  • rs-544

  • base-r

    BASE-R FEC algorithm for 25GbE interfaces (also known as fire-code).

  • rs-108

    Reed Solomon FEC algorithm for 25GbE interfaces.

ConfigurableTrue

oper-down-reason keyword

Description The reason for the transceiver being operationally down.
Contextinterface name string transceiver oper-down-reason keyword
Treeoper-down-reason
Options
  • not-present

  • read-failure

  • checksum-failure

  • unknown-transceiver

  • tx-laser-disabled

  • unsupported-breakout

  • port-disabled

  • connector-transceiver-down

ConfigurableFalse

oper-state keyword

Description

The operational state of the transceiver.

The oper-state is always down when the Ethernet port is a copper/RJ45 port.

Contextinterface name string transceiver oper-state keyword
Treeoper-state
Options
  • up

  • down

Configurable False

tx-laser boolean

Description

Enable (true) or disable (false) the transmit laser of the transceiver.

When read from state this leaf always returns false (even if the configured value is true) when the Ethernet port is a copper/RJ45 port.

Default is true (for interfaces that support transceivers).

Contextinterface name string transceiver tx-laser boolean
Treetx-laser
ConfigurableTrue

vlan-tagging boolean

Description When set to true the interface is allowed to accept frames with one or more VLAN tags
Contextinterface name string vlan-tagging boolean
Treevlan-tagging
ConfigurableTrue