r Commands – Part II

redirects

redirects

Syntax

redirects [number seconds]

no redirects

Context

[Tree] (config>service>vprn>if redirects)

[Tree] (config>service>vprn>if>icmp redirects)

[Tree] (config>service>ies>if>icmp redirects)

[Tree] (config>service>ies>sub-if>grp-if>icmp redirects)

[Tree] (config>service>ies>if>ipv6>icmp6 redirects)

[Tree] (config>service>vprn>if>ipv6>icmp6 redirects)

[Tree] (config>service>vprn>nw-if>icmp redirects)

Full Context

configure service vprn interface redirects

configure service vprn interface icmp redirects

configure service ies interface icmp redirects

configure service ies subscriber-interface group-interface icmp redirects

configure service ies interface ipv6 icmp6 redirects

configure service vprn interface ipv6 icmp6 redirects

configure service vprn network-interface icmp redirects

Description

This command configures the rate for Internet Control Message Protocol (ICMP) redirect messages issued on the router interface.

When routes are not optimal on this router and another router on the same subnetwork has a better route, the router can issue an ICMP redirect to alert the sending node that a better route is available.

The redirects command enables the generation of ICMP redirects on the router interface. The rate at which ICMP redirects is issued can be controlled with the optional number and seconds parameters by indicating the maximum number of redirect messages that can be issued on the interface for a given time interval.

The no form of this command disables the generation of ICMP redirects on the router interface.

Default

redirects 100 10

Parameters

number

Specifies the maximum number of ICMP redirect messages to send. This parameter must be specified with the second parameter.

Values

10 to 1000

seconds

Specifies the time frame in seconds used to limit the number of ICMP redirect messages that can be issued.

Values

1 to 60

Platforms

All

  • configure service vprn interface redirects
  • configure service ies interface ipv6 icmp6 redirects
  • configure service ies interface icmp redirects
  • configure service vprn interface icmp redirects
  • configure service vprn network-interface icmp redirects
  • configure service vprn interface ipv6 icmp6 redirects

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

  • configure service ies subscriber-interface group-interface icmp redirects

redirects

Syntax

redirects [number number] [seconds seconds]

no redirects

Context

[Tree] (config>subscr-mgmt>git>ipv4>icmp redirects)

Full Context

configure subscriber-mgmt group-interface-template ipv4 icmp redirects

Description

This command configures the ICMPv4 redirect messages that are generated when routes are not optimal on the router and the node needs to be alerted that another router on the same subnetwork has a better route available.

When disabled, ICMPv4 redirects are not generated.

The no form of this command disables generation of redirect messages.

Default

redirects number 100 seconds 10

Parameters

number

Specifies the number of ICMPv4 redirects that are issued in the time frame specified by the seconds parameter.

Values

10 to 1000

Default

100

seconds

Specifies the time, in seconds, that is used to limit the number of ICMPv4 redirects issued.

Values

1 to 60

Default

10

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

redirects

Syntax

redirects [number seconds]

no redirects

Context

[Tree] (config>router>if>icmp redirects)

Full Context

configure router interface icmp redirects

Description

This command enables and configures the rate for ICMP redirect messages issued on the router interface.

When routes are not optimal on this router, and another router on the same subnetwork has a better route, the router can issue an ICMP redirect to alert the sending node that a better route is available.

The redirects command enables the generation of ICMP redirects on the router interface. The rate at which ICMP redirects are issued can be controlled with the optional number and time parameters by indicating the maximum number of redirect messages that can be issued on the interface for a given time interval.

By default, generation of ICMP redirect messages is enabled at a maximum rate of 100 per 10 second time interval.

The no form of this command disables the generation of ICMP redirects on the router interface.

Default

redirects 100 10 — Maximum of 100 redirect messages in 10 seconds.

Parameters

number

The maximum number of ICMP redirect messages to send, expressed as a decimal integer. This parameter must be specified with the time parameter.

Values

10 to 1000

seconds

The time frame, in seconds, used to limit the number of ICMP redirect messages that can be issued, expressed as a decimal integer.

Values

1 to 60

Platforms

All

redirects

Syntax

redirects [number seconds]

no redirects

Context

[Tree] (config>router>if>ipv6>icmp6 redirects)

Full Context

configure router interface ipv6 icmp6 redirects

Description

This command configures the rate for ICMPv6 redirect messages. When configured, ICMPv6 redirects are generated when routes are not optimal on the router and another router on the same subnetwork has a better route to alert that node that a better route is available.

The no form of this command disables ICMPv6 redirects.

Default

redirects 100 10 (when IPv6 is enabled on the interface)

Parameters

number

Limits the number of redirects issued per the time frame specified in seconds parameter.

Values

10 to 1000

seconds

Determines the time frame, in seconds, that is used to limit the number of redirects issued per time frame.

Values

1 to 60

Platforms

All

redistribute-delay

redistribute-delay

Syntax

redistribute-delay redistribute-delay

no redistribute-delay

Context

[Tree] (config>router>ospf3>timers redistribute-delay)

[Tree] (config>router>ospf>timers redistribute-delay)

Full Context

configure router ospf3 timers redistribute-delay

configure router ospf timers redistribute-delay

Description

This command sets the internal OSPF hold down timer for external routes being redistributed into OSPF.

Shorting this delay can speed up the advertisement of external routes into OSPF but can result in additional OSPF messages if that source route is not yet stable.

The no form of this command resets the timer value back to the default value.

Note:

The timer granularity is 10 ms if the value is less than 500 ms, and 100 ms if the value is greater than or equal to 500 ms. Timer values are rounded down to the nearest granularity, for example a configured value of 550 ms is internally rounded down to 500 ms.

Default

redistribute-delay 1000

Parameters

redistribute-delay

Specifies the OSPF redistribution hold down time in milliseconds for external routes being advertised into OSPF.

Values

0 to 1000

Platforms

All

redistribute-external

redistribute-external

Syntax

[no] redistribute-external

Context

[Tree] (config>service>vprn>ospf>area>nssa redistribute-external)

[Tree] (config>service>vprn>ospf3>area>nssa redistribute-external)

Full Context

configure service vprn ospf area nssa redistribute-external

configure service vprn ospf3 area nssa redistribute-external

Description

This command enables the redistribution of external routes into the Not So Stubby Area (NSSA) or an NSSA area border router (ABR) that is exporting the routes into non-NSSA areas.

NSSA or Not So Stubby Areas are similar to stub areas in that no external routes are imported into the area from other OSPF areas. The major difference between a stub area and an NSSA is that the NSSA has the capability to flood external routes that it learns (providing it is an ASBR) throughout its area and via an ABR to the entire OSPF domain.

The no form of this command disables the default behavior to automatically redistribute external routes into the NSSA area from the NSSA ABR.

Default

redistribute-external — External routes are redistributed into the NSSA.

Platforms

All

redistribute-external

Syntax

[no] redistribute-external

Context

[Tree] (config>router>ospf>area>nssa redistribute-external)

[Tree] (config>router>ospf3>area>nssa redistribute-external)

Full Context

configure router ospf area nssa redistribute-external

configure router ospf3 area nssa redistribute-external

Description

This command enables the redistribution of external routes into the Not So Stubby Area (NSSA) or an NSSA area border router (ABR) that is exporting the routes into non-NSSA areas.

NSSA or Not So Stubby Areas are similar to stub areas in that no external routes are imported into the area from other OSPF or OSPF3 areas. The major difference between a stub area and an NSSA is that the NSSA has the capability to flood external routes that it learns (providing it is an ASBR) throughout its area and via an Area Border Router to the entire OSPF or OSPF3 domain.

The no form of this command disables the default behavior to automatically redistribute external routes into the NSSA area from the NSSA ABR.

Default

redistribute-external

Platforms

All

redo

redo

Syntax

redo [count]

Context

[Tree] (candidate redo)

Full Context

candidate redo

Description

This command reapplies the changes to the candidate that were removed using a previous undo. All undo or redo history is lost when the operator exits edit-cfg mode.

A redo command is blocked if another user has made changes in the same CLI branches that would be impacted during the redo.

Parameters

count

Specifies the number of previous changes to reapply.

Values

1 to 50

Default

1

Platforms

All

reduced-prompt

reduced-prompt

Syntax

reduced-prompt [no-of-nodes-in-prompt]

no reduced-prompt

Context

[Tree] (environment reduced-prompt)

Full Context

environment reduced-prompt

Description

This command configures the maximum number of higher CLI context levels to display in the CLI prompt for the current CLI session. This command is useful when configuring features that are several node levels deep, causing the CLI prompt to become too long. By default, the CLI prompt displays the system name and the complete context in the CLI.

The number of nodes specified indicates the number of higher-level contexts that can be displayed in the prompt. For example, if reduced prompt is set to 2, the two highest contexts from the present working context are displayed by name with the hidden (reduced) contexts compressed into a ellipsis ("…”).

A:ALA-1>environment# reduced-prompt 2
A:ALA-1>config>router# interface to-103
A:ALA-1>...router>if#

The setting is not saved in the configuration. It must be reset for each CLI session or stored in an exec script file.

The no form of the command reverts to the default.

Default

no reduced-prompt

Parameters

no-of-nodes-in-prompt

Specifies the maximum number of higher-level nodes displayed by name in the prompt, expressed as a decimal integer.

Values

0 to 15

Default

2

Platforms

All

redundancy

redundancy

Syntax

redundancy

Context

[Tree] (config redundancy)

Full Context

configure redundancy

Description

This command allows the user to perform redundancy operations.

Associated commands include the following in the admin>redundancy context:

  • force-switchover - Forces a switchover to the standby CPM card.

  • now - Switch to standby CPM.

    Switching to the standby displays the following message.

    WARNING: Configuration and/or Boot options may have changed since the last save.

    Are you sure you want to switchover (y/n)?

  • synchronize - Synchronizes the secondary CPM.

Platforms

All

redundancy

Syntax

redundancy

Context

[Tree] (admin redundancy)

Full Context

admin redundancy

Description

Commands in this context allow the user to perform redundancy operations.

Platforms

All

redundancy

Syntax

redundancy

Context

[Tree] (config>service>ies>sub-if>wlan-gw redundancy)

Full Context

configure service ies subscriber-interface wlan-gw redundancy

Description

Commands in this context configure WLAN-GW redundancy-related parameters.

Platforms

7750 SR, 7750 SR-e, 7750 SR-s, VSR

redundancy

Syntax

redundancy

Context

[Tree] (config>service>vprn>nat>inside redundancy)

[Tree] (config>service>vprn>nat>outside>pool redundancy)

[Tree] (config>router>nat>inside redundancy)

Full Context

configure service vprn nat inside redundancy

configure service vprn nat outside pool redundancy

configure router nat inside redundancy

Description

Commands in this context configure redundancy parameters.

Platforms

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

redundancy

Syntax

redundancy {active-active | active-standby | l2aware-bypass}

no redundancy

Context

[Tree] (config>isa>nat-group redundancy)

Full Context

configure isa nat-group redundancy

Description

This command configures intra-chassis redundancy mode for the NAT group.

Default

redundancy active-standby

Parameters

active-active

Specifies the mode in which all MS-ISAs in a NAT group are active. If one or two MS-ISAs in the system fail, the remaining active MS-ISA accepts the load from the failed MS-ISAs.

active-standby

Specifies the mode in which one or more MS-ISAs in the NAT group are in standby mode. While in standby mode, MS-ISAs do not process traffic. Traffic is diverted to the standby MS-ISA only when the active MS-ISA fails, at which point the standby becomes active.

l2-aware-bypass

Specifies that when an ISA MDA fails, NAT reroutes its traffic based on the regular destination address lookup. This resiliency mode is applicable only to L2-Aware NAT. When the MS-ISA fails, its traffic is routed via regular routing (destination-based lookup). The assumption is that traffic is sent to an external NAT device that serves as a backup NAT device.

Platforms

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

redundancy

Syntax

redundancy

Context

[Tree] (config>router>nat>outside>pool redundancy)

Full Context

configure router nat outside pool redundancy

Description

Commands in this context configure NAT pool redundancy parameters.

Platforms

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

redundancy

Syntax

redundancy

Context

[Tree] (config>eth-cfm redundancy)

Full Context

configure eth-cfm redundancy

Description

Commands in this context configure the ETH-CFM redundancy parameters.

Platforms

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

redundant-interface

redundant-interface

Syntax

redundant-interface red-ip-int-name

no redundant-interface

Context

[Tree] (config>service>ies>sub-if>grp-if redundant-interface)

[Tree] (config>service>vprn>sub-if>grp-if redundant-interface)

Full Context

configure service ies subscriber-interface group-interface redundant-interface

configure service vprn subscriber-interface group-interface redundant-interface

Description

This command configures a redundant interface used for dual homing.

Parameters

red-ip-int-name

Specifies the redundant IP interface name.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

redundant-interface

Syntax

redundant-interface ip-int-name [create]

no redundant-interface ip-int-name

Context

[Tree] (config>service>ies redundant-interface)

[Tree] (config>service>vprn redundant-interface)

Full Context

configure service ies redundant-interface

configure service vprn redundant-interface

Description

This command configures a redundant interface.

Parameters

ip-int-name

Specifies the name of the IP interface. Interface names can be from 1 to 32 alphanumeric characters. If the string contains special characters (#, ?, space), the entire string must be enclosed within double quotes.

create

Keyword used to create a redundant interface.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

redundant-interface

Syntax

redundant-interface service service-id name interface-name

no redundant-interface

Context

[Tree] (config>subscr-mgmt>up-resiliency>fsg-template redundant-interface)

Full Context

configure subscriber-mgmt up-resiliency fate-sharing-group-template redundant-interface

Description

This command configures downstream traffic shunting from a standby BNG-UP to an active BNG-UP. Downstream traffic that is received for standby sessions is sent over the redundant interface to the active BNG-UP. This requires the configuration of the multi-chassis-shunt-id command in the service that receives the session traffic.

The noform of the command removes the configuration.

Parameters

service-id

Specifies the name of the VPRN or IES service that contains the redundant interface, up to 64 characters. This can be different from the service where session traffic is terminated.

interface-name

Specifies the redundant interface name, up to 32 characters. It must exist within the configured service-id.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

redundant-mcast-capacity

redundant-mcast-capacity

Syntax

redundant-mcast-capacity primary-percentage secondary secondary-percentage

no redundant-mcast-capacity

Context

[Tree] (config>mcast-mgmt>chassis-level>plane-capacity redundant-mcast-capacity)

Full Context

configure mcast-management chassis-level per-mcast-plane-capacity redundant-mcast-capacity

Description

This command configures the primary and secondary multicast plane capacities used when the full complement of possible switch fabrics in the system are up. The rates are defined as a percentage of the total multicast plane capacity which is configured using the total-capacity command.

The no form of this command reverts to the default values.

Default

redundant-mcast-capacity 87.50 secondary 87.50

Parameters

primary-percentage

Specifies the percentage of the total multicast plane capacity to be used for primary multicast planes.

Values

0.01 to 100

secondary-percentage

Specifies the percentage of the total multicast plane capacity to be used for secondary multicast planes.

Values

0.01 to 100

Platforms

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

redundant-multicast

redundant-multicast

Syntax

[no] redundant-multicast

Context

[Tree] (config>router>igmp>if redundant-multicast)

Full Context

configure router igmp interface redundant-multicast

Description

This command configures the interface as a member of a redundant pair for multicast traffic.

The no form of the command removes the configuration.

Platforms

All

ref-aa-specific-counter

ref-aa-specific-counter

Syntax

ref-aa-specific-counter any

no ref-aa-specific-counter

Context

[Tree] (config>log>acct-policy>cr ref-aa-specific-counter)

Full Context

configure log accounting-policy custom-record ref-aa-specific-counter

Description

This command enables the use of significant-change so only those aa-specific records which have changed in the last accounting interval are written.

The no form of this command disables the use of significant-change so all aa-specific records are written whether or not they have changed within the last accounting interval.

Parameters

any

Indicates that a record is collected as long as any field records activity when non-zero significant-change value is configured.

Platforms

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

ref-order

ref-order

Syntax

ref-order first second [third [fourth][fifth]]]

no ref-order

Context

[Tree] (config>system>sync-if-timing ref-order)

Full Context

configure system sync-if-timing ref-order

Description

The synchronous equipment timing subsystem can lock to different timing reference inputs, those specified in the ref1, ref2, bits, synce, and ptp command configuration. This command organizes the priority order of the timing references.

If a reference source is disabled, then the clock from the next reference source as defined by ref-order is used. If all reference sources are disabled, then clocking is derived from a local oscillator.

If a sync-if-timing reference is linked to a source port that is operationally down, the port is no longer qualified as a valid reference.

For 7450 ESS and 7750 SR systems with two CPM modules, the system distinguishes between the BITS inputs on the active and standby CPMs. The active CPM will use its BITS input port providing that port is qualified. If the local port is not qualified, then the active CPM will use the BITS input port from the standby CPM as the next priority reference. For example, the normal ref-order of bits ref1 ref2 will actually be bits (active CPM), followed by bits (standby CPM), followed by ref1, followed by ref2.

For 7950 XRS systems with two CPMs and two CCMs, the system distinguishes between the BITS inputs on the CCMs associated with the active and standby CPMs. The active CPM will use the BITS input port on the associated CCM, provided that the port is qualified. If the local port is not qualified, then the active CPM will use the BITS input port from the CCM associated with the standby CPM as the next priority reference. For example, the normal ref-order of bits ref1 ref2 will actually be bits (active CCM), followed by bits (standby CCM), followed by ref1, followed by ref2.

The no form of the command resets the reference order to the default values.

The SyncE/1588 port of the CPM or CCM can be used as a frequency input reference. It shares internal resources with the BITS input ports and so only one can be used at a time. The BITS port shall have priority, if BITS input is enabled, then the SyncE port cannot be enabled.

Similar to the BITS input ports, when the synce reference is enabled and in the ref-order, the system distinguishes between the synce inputs on the active and standby CPM/CCMs. The active CPM/CCM uses its synce input port if that port is qualified. If the local port is not qualified, the active CPM uses the synce input port from the standby CPM/CCM as the next priority reference. For example, the ref-order of synce ref1 ref2 will actually be synce (active CPM/CCM), followed by synce (standby CPM/CCM), followed by ref1, followed by ref2.

Default

bits synce ref1 ref2 ptp (7750 SR-7/12/12e with CPM-5, 7950 XRS-20/20e, SR-7s/14s, and 7450 ESS-7/12)

bits ref1 ref2 ptp (7750 SR-a4/8, SR-1e/2e/3e, SR-1, SR-1s/2s)

Parameters

first

Specifies the first timing reference to use in the reference order sequence.

Values

bits, synce, ref1, ref2, ptp

second

Specifies the second timing reference to use in the reference order sequence.

Values

bits, synce, ref1, ref2, ptp

third

Specifies the third timing reference to use in the reference order sequence.

Values

bits, synce, ref1, ref2, ptp

fourth

Specifies the fourth timing reference to use in the reference order sequence.

Values

bits, synce, ref1, ref2, ptp

fifth

Specifies the fifth timing reference to use in the reference order sequence.

Values

bits, synce, ref1, ref2, ptp

Platforms

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

ref-policer

ref-policer

Syntax

ref-policer policer-id

ref-policer all

no ref-policer

Context

[Tree] (config>log>acct-policy>cr ref-policer)

Full Context

configure log accounting-policy custom-record ref-policer

Description

This command creates a policer context to configure reference policer counters for significant change only reporting. The custom record is only generated when the change in the sum of all queue and policer reference counters equals or exceeds the configured (non-zero) significant change value.

The no form of this command deletes all policer reference counters.

Default

no ref-policer

Parameters

policer-id

Specifies the policer for which reference counters are configured and to which significant-change is applied.

Values

1 to 63

all

Applies the significant-change to the specified counters for all policers.

Platforms

All

ref-queue

ref-queue

Syntax

ref-queue queue-id

ref-queue all

no ref-queue

Context

[Tree] (config>subscr-mgmt>acct-plcy>cr ref-queue)

Full Context

configure subscriber-mgmt radius-accounting-policy custom-record ref-queue

Description

This command configures a reference queue.

The no form of this command reverts to the default value.

Parameters

queue-id

Specifies the reference queue ID.

Values

1 to 32

all

Includes all reference queue IDs.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

ref-queue

Syntax

ref-queue queue-id

ref-queue all

no ref-queue

Context

[Tree] (config>log>acct-policy>cr ref-queue)

Full Context

configure log accounting-policy custom-record ref-queue

Description

This command creates a queue context to configure reference queue counters for significant change only reporting. The custom record is only generated when the change in the sum of all queue and policer reference counters equals or exceeds the configured (non-zero) significant change value.

The no form of this command deletes all queue reference counters.

Default

no ref-queue

Parameters

queue-id

Specifies the queue for which reference counters are configured and to which the significant-change is applied.

Values

1 to 32

all

Applies the significant-change to the specified counters for all queues.

Platforms

All

ref1

ref1

Syntax

ref1

Context

[Tree] (config>system>sync-if-timing ref1)

Full Context

configure system sync-if-timing ref1

Description

Commands in this context configure parameters for the first timing reference.

The restrictions on the location for the source port or source bits for ref1 and ref2 are listed in the 7450 ESS, 7750 SR, 7950 XRS, and VSR Basic System Configuration Guide.

Platforms

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

ref1

Syntax

ref1

Context

[Tree] (conf>sys>sat>eth-sat>sync-if-timing ref1)

Full Context

configure system satellite eth-sat sync-if-timing ref1

Description

Commands in this context configure parameters for the first timing reference used in the ethernet satellite.

The source ports for ref1 can be either uplinks or client ports.

Platforms

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

ref2

ref2

Syntax

ref2

Context

[Tree] (config>system>sync-if-timing ref2)

Full Context

configure system sync-if-timing ref2

Description

Commands in this context configure parameters for the second timing reference. There are restrictions on the source-port and source-bits locations for ref2 based on the platform. The restrictions on the location for the source-port or source-bits for ref1 and ref2 are listed in the 7450 ESS, 7750 SR, 7950 XRS, and VSR Basic System Configuration Guide.

Platforms

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

ref2

Syntax

ref2

Context

[Tree] (conf>sys>sat>eth-sat>sync-if-timing ref2)

Full Context

configure system satellite eth-sat sync-if-timing ref2

Description

Commands in this context configure parameters for the second timing reference used in the ethernet satellite.

The source ports for ref2 can be either uplinks or client ports.

Platforms

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

reference-bandwidth

reference-bandwidth

Syntax

reference-bandwidth bandwidth-in-kbps

reference-bandwidth [zbps Zetta-bps] [ebps Exa-bps] [pbps Peta-bps] [tbps Tera-bps] [gbps Giga-bps] [mbps Mega-bps] [kbps Kilo-bps]

no reference-bandwidth

Context

[Tree] (config>service>vprn>isis reference-bandwidth)

Full Context

configure service vprn isis reference-bandwidth

Description

This command configures the reference bandwidth that provides the basis of bandwidth relative costing.

In order to calculate the lowest cost to reach a specific destination, each configured level on each interface must have a cost. If the reference bandwidth is defined, then the cost is calculated using the following formula:

cost = reference – bandwidth  bandwidth

If the reference bandwidth is configured as 10 Gigabits (10,000,000,000), a 100 M/bps interface has a default metric of 100. In order for metrics in excess of 63 to be configured, wide metrics must be deployed. (See wide-metrics-only in the config>router>isis context.)

If the reference bandwidth is not configured, all interfaces have a default metric of 10.

The no form of this command reverts to the default value.

Default

no reference-bandwidth — No reference bandwidth is defined. All interfaces have a metric of 10.

Parameters

Zetta-bps

Specifies the reference bandwidth in zettabits per second, expressed as a decimal integer.

Values

1 to 18

Exa-bps

Specifies the reference bandwidth in exabits per second, expressed as a decimal integer.

Values

1 to 999

Peta-bps

Specifies the reference bandwidth in petabits per second, expressed as a decimal integer.

Values

1 to 999

bandwidth-in-kbps

Specifies the reference bandwidth in kilobits per second, expressed as a decimal integer.

Values

1 to 18446744073709551615

Tera-bps

Specifies the reference bandwidth in terabits per second, expressed as a decimal integer.

Values

1 to 999

Giga-bps

Specifies the reference bandwidth in gigabits per second, expressed as a decimal integer.

Values

1 to 999

Mega-bps

Specifies the reference bandwidth in megabits per second, expressed as a decimal integer.

Values

1 to 999

Kilo-bps

Specifies the reference bandwidth in kilobits per second, expressed as a decimal integer.

Values

1 to 999

Platforms

All

reference-bandwidth

Syntax

reference-bandwidth bandwidth-inkbps

reference-bandwidth [zbps Zetta-bps] [ebps Exa-bps] [pbps Peta-bps] [tbps Tera-bps] [gbps Giga-bps] [mbps Mega-bps] [kbps Kilo-bps]

no reference-bandwidth

Context

[Tree] (config>service>vprn>ospf reference-bandwidth)

[Tree] (config>service>vprn>ospf3 reference-bandwidth)

Full Context

configure service vprn ospf reference-bandwidth

configure service vprn ospf3 reference-bandwidth

Description

This command configures the reference bandwidth in kilobits per second (kb/s) that provides the reference for the default costing of interfaces based on their underlying link speed.

The default interface cost is calculated as follows:

cost = reference–bandwidth  bandwidth

The default reference-bandwidth is 100,000,000 kb/s or 100 Gb/s, so the default auto-cost metrics for various link speeds are as follows:

  • 10 Mb/s link default cost of 10000

  • 100 Mb/s link default cost of 1000

  • 1 Gb/s link default cost of 100

  • 10 Gb/s link default cost of 10

  • 40 Gb/s link default cost of 2

  • 100 Gb/s link default cost of 1

  • 400 Gb/s link default cost of 1

Note:

The default reference-bandwidth value must be manually configured to a higher value if interface speeds are greater than 100 Gb/s, and metrics based on link speed are used. When the default reference-bandwidth value is used, a metric of 1 is set on all interface speeds ≥ 100 Gb/s. For example, 100 GE, 100 GE LAG, 400 GE, and 400 GE LAG interfaces will all have a metric of 1.

If the reference bandwidth is configured as 10 Gb (reference-bandwidth 10000000000), a 100 Mb/s interface has a default metric of 100.

When a very large reference bandwidth value is configured, a metric calculation may result in a value higher than the supported protocol cost value. If this occurs, OSPF automatically reverts to the maximum configurable cost metric.

The reference-bandwidth command assigns a default cost to the interface based on the interface speed. To override this default cost on a particular interface, use the metric metric command configured in the config>router>ospf>area>if ip-int-name context.

The no form of this command reverts the reference bandwidth to the default value.

Default

reference-bandwidth 100000000

Parameters

bandwidth-in-kbps

Specifies the reference bandwidth in kilobits per second expressed as a decimal integer.

Values

1 to 4000000000

tbps Tera-bps

Specifies the reference bandwidth in terabits per second expressed as a decimal integer.

Values

1 to 4

gbps Giga-bps

Specifies the reference bandwidth in gigabits per second expressed as a decimal integer.

Values

1 to 999

mbps Mega-bps

Specifies the reference bandwidth in megabits per second expressed as a decimal integer.

Values

1 to 999

kbps Kilo-bps

Specifies the reference bandwidth in kilobits per second expressed as a decimal integer.

Values

1 to 999

Platforms

All

reference-bandwidth

Syntax

reference-bandwidth bandwidth-in-kbps

reference-bandwidth [zbps Zetta-bps] [ebps Exa-bps] [pbps Peta-bps] [tbps Tera-bps] [gbps Giga-bps] [mbps Mega-bps] [kbps Kilo-bps]

no reference-bandwidth

Context

[Tree] (config>router>isis reference-bandwidth)

Full Context

configure router isis reference-bandwidth

Description

This command configures the reference bandwidth that provides the basis of bandwidth relative costing.

To calculate the lowest cost to reach a specific destination, each configured level on each interface must have a cost. If the reference bandwidth is defined, then the cost is calculated using the following formula:

cost = reference-bandwidth  bandwidth

If the reference bandwidth is configured as 10 Gb (reference-bandwidth 10000000000), a 100 Mb/s interface has a default metric of 100. To configure metrics in excess of 63, wide metrics must be deployed (see wide-metrics-only in the config>router>isis context).

When a large reference-bandwidth value is configured, a metric calculation may result in a value higher than the supported protocol cost value. If this occurs, IS-IS automatically reverts to the maximum configurable cost metric.

If the reference bandwidth is not configured, then all interfaces have a default metric of 10.

The no form of this command reverts to the default value.

Default

no reference-bandwidth

Parameters

bandwidth-in-kbps

Specifies the reference bandwidth in kilobits per second, expressed as a decimal integer.

Values

1 to 18446744073709551615

Zetta-bps

Specifies the reference bandwidth in zettabits per second, expressed as a decimal integer.

Values

1 to 18

Exa-bps

Specifies the reference bandwidth in exabits per second, expressed as a decimal integer.

Values

1 to 999

Peta-bps

Specifies the reference bandwidth in petabits per second, expressed as a decimal integer.

Values

1 to 999

Tera-bps

Specifies the reference bandwidth in terabits per second, expressed as a decimal integer.

Values

1 to 999

Giga-bps

Specifies the reference bandwidth in gigabits per second, expressed as a decimal integer.

Values

1 to 999

Mega-bps

Specifies the reference bandwidth in megabits per second, expressed as a decimal integer.

Values

1 to 999

Kilo-bps

Specifies the reference bandwidth in kilobits per second, expressed as a decimal integer.

Values

1 to 999

Platforms

All

reference-bandwidth

Syntax

reference-bandwidth bandwidth-in-kbps

reference-bandwidth [zbps Zetta-bps] [ebps Exa-bps] [pbps Peta-bps] [tbps Tera-bps] [gbps Giga-bps] [mbps Mega-bps] [kbps Kilo-bps]

no reference-bandwidth

Context

[Tree] (config>router>ospf3 reference-bandwidth)

[Tree] (config>router>ospf reference-bandwidth)

Full Context

configure router ospf3 reference-bandwidth

configure router ospf reference-bandwidth

Description

This command configures the reference bandwidth in kilobits per second (kb/s) that provides the reference for the default costing of interfaces based on their underlying link speed.

The default interface cost is calculated as follows:

cost = reference-bandwidth  bandwidth

The default reference-bandwidth is 100,000,000 kb/s or 100 Gb/s, the default auto-cost metrics for various link speeds are as follows:

  • 10 Mb/s link default cost of 10000

  • 100 Mb/s link default cost of 1000

  • 1 Gb/s link default cost of 100

  • 10 Gb/s link default cost of 10

  • 100 Gb/s link default cost of 1

  • 400 Gb/s link default cost of 1

Note:

The default reference-bandwidth must be manually configured to a higher value if interface speeds are greater than 100 Gb/s, and metrics based on link speed are used. When the default reference-bandwidth is used, a metric of 1 is set on all interface speeds ≥ 100 Gb/s. For example, 100 GE, 100 GE LAG, 400 GE, and 400 GE LAG interfaces will all have a metric of 1.

If the reference bandwidth is configured as 10 Gb (reference-bandwidth 10000000000), a 100 Mb/s interface has a default metric of 100.

When a very large reference bandwidth value is configured, a metric calculation may result in a value higher than the supported protocol cost value. If this occurs, OSPF automatically reverts to the maximum configurable cost metric.

The reference-bandwidth command assigns a default cost to the interface based on the interface speed. To override this default cost on a particular interface, use the metric metric command configured in the config>router>ospf>area>interface ip-int-name context.

The no form of this command reverts to the default value.

Default

reference-bandwidth 100000000

Parameters

bandwidth-in-kbps

Specifies the reference bandwidth in kilobits per second, expressed as a decimal integer.

Values

1 to 18446744073709551615

Zetta-bps

Specifies the reference bandwidth in zettabits per second, expressed as a decimal integer.

Values

1 to 18

Exa-bps

Specifies the reference bandwidth in exabits per second, expressed as a decimal integer.

Values

1 to 999

Peta-bps

Specifies the reference bandwidth in petabits per second, expressed as a decimal integer.

Values

1 to 999

Tera-bps

Specifies the reference bandwidth in terabits per second, expressed as a decimal integer.

Values

1 to 999

Giga-bps

Specifies the reference bandwidth in gigabits per second, expressed as a decimal integer.

Values

1 to 999

Mega-bps

Specifies the reference bandwidth in megabits per second, expressed as a decimal integer.

Values

1 to 999

Kilo-bps

Specifies the reference bandwidth in kilobits per second, expressed as a decimal integer.

Values

1 to 999

Platforms

All

reflect-pad

reflect-pad

Syntax

[no] reflect-pad

Context

[Tree] (config>oam-pm>session>mpls>dm reflect-pad)

Full Context

configure oam-pm session mpls dm reflect-pad

Description

This command enables copying the padding in each MPLS-DM query to the response.

When padding is included in the DM frame the option exists to reflect the padding back in the direction of the source or remove the padding. The removal of the pad-tlv is good practice when using unidirectional tunnels such as RSVP.

This command uses the mandatory TLV type 0, instructing the responder to include the pad TLV from the response. The no form of this command uses the optional TVL type 128, instructing the responder to remove the pad TLV from the response.

The no form of this command disables copying the padding in each MPLS-DM query to the response.

Platforms

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

reflector

reflector

Syntax

reflector [udp-port udp-port-number] [create]

no reflector

Context

[Tree] (config>router>twamp-light reflector)

[Tree] (config>service>vprn>twamp-light reflector)

Full Context

configure router twamp-light reflector

configure service vprn twamp-light reflector

Description

This command configures a TWAMP Light session reflector parameters and to enable TWAMP Light functionality with the no shutdown command. The udp-port keyword and value must be specified with the create keyword. An error message is generated if the specific UDP port is unavailable.

Parameters

udp-port-number

Specifies the UDP port number. A strictly enforced restricted range has been introduced. The TWAMP Light session reflector must be brought in line with this new restriction prior upgrading or rebooting from any previous release if there is an active TWAMP Light session reflector configured. Failure to do so prevents an ISSU operation from proceeding and fails to activate any reflector outside of the enforced range.

Note that in the Two-Way Active Measurement Protocol Light (TWAMP Light) section for a complete description. This parameter is required and specifies the destination udp-port that the session reflector uses to listen for TWAMP Light packets. The session controller launching the TWAMP Light packets must be configured with the same destination UDP port as part of the TWAMP Light test. The IES service uses the destination UDP port that is configured under the router context. Only one UDP port can be configured per unique context.

Values

862, 64364 to 64373

Platforms

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

reflector

Syntax

[no] reflector reflector-name

Context

[Tree] (config>bfd>seamless-bfd reflector)

Full Context

configure bfd seamless-bfd reflector

Description

This command specifies the seamless BFD reflector.

The no form of this command removes the context.

Parameters

reflector-name

Specifies the reflector name, up to 32 characters.

Platforms

All

refresh-reduction

refresh-reduction

Syntax

[no] refresh-reduction

Context

[Tree] (config>router>rsvp>interface refresh-reduction)

Full Context

configure router rsvp interface refresh-reduction

Description

This command enables the use of the RSVP overhead refresh reduction capabilities on this RSVP interface.

When this option is enabled, a node will enable support for three capabilities. It will accept bundles RSVP messages from its peer over this interface, it will attempt to perform reliable RSVP message delivery to its peer, and will use summary refresh messages to refresh path and resv states. The reliable message delivery must be explicitly enabled by the user after refresh reduction is enabled. The other two capabilities are enabled immediately.

A bundle message is intended to reduce overall message handling load. A bundle message consists of a bundle header followed by one or more bundle sub-messages. A sub-message can be any regular RSVP message except another bundle message. A node will only process received bundled RSVP messages but will not generate them.

When reliable message delivery is supported by both the node and its peer over the RSVP interface, an RSVP message is sent with a message_id object. A message_id object can be added to any RSVP message when sent individually or as a sub-message of a bundled message.

if the sender sets the ack_desired flag in the message_id object, the receiver acknowledges the receipt of the RSVP message by piggy-backing a message_ack object to the next RSVP message it sends to its peer. Alternatively, an ACK message can also be used to send the message_ack object. In both cases, one or many message_ack objects could be included in the same message.

The router supports the sending of separate ACK messages only but is capable of processing received message_ack objects piggy-backed to hop-by-hop RSVP messages, such as path and resv.

The router sets the ack_desired flag only in non-refresh RSVP messages and in refresh messages which contain new state information.

A retransmission mechanism based on an exponential backoff timer is supported in order to handle unacknowledged message_id objects. The RSVP message with the same message_id is retransmitted every 2 * rapid-retransmit-time interval of time. The rapid-retransmit-time is referred to as the rapid retransmission interval as it must be smaller than the regular refresh interval configured in the config>router>rsvp>refresh-time context. There is also a maximum number of retransmissions of an unacknowledged RSVP message rapid-retry-limit. The node will stop retransmission of unacknowledged RSVP messages whenever the updated backoff interval exceeds the value of the regular refresh interval or the number of retransmissions reaches the value of the rapid-retry-limit parameter, whichever comes first. These two parameters are configurable globally on a system in the config>router>rsvp context.

Refresh summary consists of sending a summary refresh message containing a message_id list object. The fields of this object are populated each with the value of the message_identifier field in the message_id object of a previously sent individual path or resv message. The summary refresh message is sent every refresh regular interval as configured by the user using the refresh-time command in the config>router>rsvp context. The receiver checks each message_id object against the saved path and resv states. If a match is found, the state is updated as if a regular path or resv refresh message was received from the peer. If a specific message_identifier field does not match, then the node sends a message_id_nack object to the originator of the message.

The above capabilities are referred to collectively as "refresh overhead reduction extensions”. When the refresh-reduction is enabled on an RSVP interface, the node indicates this to its peer by setting a "refresh-reduction-capable” bit in the flags field of the common RSVP header. If both peers of an RSVP interface set this bit, all the above three capabilities can be used. Furthermore, the node monitors the settings of this bit in received RSVP messages from the peer on the interface. As soon as this bit is cleared, the router stops sending summary refresh messages. If a peer did not set the "refresh-reduction-capable” bit, a node does not attempt to send summary refresh messages.

However, if the peer did not set the "refresh-reduction-capable” bit, a node, with refresh reduction enabled and reliable message delivery enabled, will still attempt to perform reliable message delivery with this peer. If the peer does not support the message_id object, it returns an error message "unknown object class”. In this case, the node retransmits the RSVP message without the message_id object and reverts to using this method for future messages destined to this peer. The RSVP Overhead Refresh Reduction is supported with both RSVP P2P LSP path and the S2L path of an RSVP P2MP LSP instance over the same RSVP instance.

The no form of this command reverts to the default value.

Default

no refresh-reduction

Platforms

All

refresh-reduction-over-bypass

refresh-reduction-over-bypass

Syntax

refresh-reduction-over-bypass [enable | disable]

Context

[Tree] (config>router>rsvp refresh-reduction-over-bypass)

Full Context

configure router rsvp refresh-reduction-over-bypass

Description

This command enables the refresh reduction capabilities over all bypass tunnels originating on this PLR node or terminating on this Merge Point (MP) node.

By default, this is disabled. Since a bypass tunnel may merge with the primary LSP path in a node downstream of the next-hop, there is no direct interface between the PLR and the MP node and it is possible the latter will not accept summary refresh messages received over the bypass.

When disabled, the node as a PLR or MP will not set the "Refresh-Reduction-Capable” bit on RSVP messages pertaining to LSP paths tunneled over the bypass. It will also not send Message-ID in RSVP messages. This effectively disables summary refresh.

Default

refresh-reduction-over-bypass disable

Platforms

All

refresh-time

refresh-time

Syntax

refresh-time seconds

no refresh-time

Context

[Tree] (config>router>rsvp refresh-time)

Full Context

configure router rsvp refresh-time

Description

The refresh-time controls the interval (in s), between the successive Path and Resv refresh messages. RSVP declares the session down after it misses keep-multiplier number consecutive refresh messages.

The no form of this command reverts to the default value.

Default

refresh-time 30

Parameters

seconds

The refresh time in s.

Values

1 to 65535

Platforms

All

refresh-time

Syntax

refresh-time seconds hold-time seconds

no refresh-time

Context

[Tree] (config>router>origin-validation>rpki-session refresh-time)

Full Context

configure router origin-validation rpki-session refresh-time

Description

This command is used to configure the refresh-time and hold-time intervals that are used for liveness detection of the RPKI-Router session. The refresh-time defaults to 300 seconds and is reset whenever a Reset Query PDU or Serial Query PDU is sent to the cache server. When the timer expires, a new Serial Query PDU is sent with the last known serial number.

The hold-time specifies the length of time in seconds that the session is to be considered UP without any indication that the cache server is alive and reachable. The timer defaults to 600 seconds and must be at least 2x the refresh-time (otherwise the CLI command is not accepted). Reception of any PDU from the cache server resets the hold timer. When the hold-time expires, the session is considered to be DOWN and the stale timer is started.

Default

no refresh-time

Parameters

seconds

Specifies a time in seconds.

Values

30 to 32767

seconds

Specifies a time in seconds.

Values

60 to 65535

Platforms

All

refresh-timer

refresh-timer

Syntax

refresh-timer value

no refresh-timer

Context

[Tree] (config>service>cpipe>spoke-sdp>control-channel-status refresh-timer)

[Tree] (config>service>epipe>spoke-sdp>control-channel-status refresh-timer)

[Tree] (config>service>vpls>spoke-sdp>control-channel-status refresh-timer)

Full Context

configure service cpipe spoke-sdp control-channel-status refresh-timer

configure service epipe spoke-sdp control-channel-status refresh-timer

configure service vpls spoke-sdp control-channel-status refresh-timer

Description

This command configures the refresh timer for control channel status signaling packets. By default, no refresh packets are sent.

Default

no refresh-timer

Parameters

value

Specifies the refresh timer value, in seconds.

Values

10 to 65535

Default

0 (off)

Platforms

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

  • configure service cpipe spoke-sdp control-channel-status refresh-timer

All

  • configure service epipe spoke-sdp control-channel-status refresh-timer
  • configure service vpls spoke-sdp control-channel-status refresh-timer

refresh-timer

Syntax

refresh-timer value

no refresh-timer

Context

[Tree] (config>service>ies>if>spoke-sdp>control-channel-status refresh-timer)

Full Context

configure service ies interface spoke-sdp control-channel-status refresh-timer

Description

This command configures the refresh timer for control channel status signaling packets. By default, no refresh packets are sent.

Default

no refresh-timer

Parameters

value

Specifies the refresh timer value.

Values

10 to 65535 seconds

Default

0 (off)

Platforms

All

refresh-timer

Syntax

refresh-timer value

no refresh-timer

Context

[Tree] (config>service>vprn>if>spoke-sdp>control-channel-status refresh-timer)

[Tree] (config>service>vprn>red-if>spoke-sdp>control-channel-status refresh-timer)

Full Context

configure service vprn interface spoke-sdp control-channel-status refresh-timer

configure service vprn redundant-interface spoke-sdp control-channel-status refresh-timer

Description

This command configures the refresh timer for control channel status signaling packets. By default, no refresh packets are sent.

Default

no refresh-timer

Parameters

value

Specifies the refresh timer value.

Values

10 to 65535 seconds

Default

0 (off)

Platforms

All

  • configure service vprn interface spoke-sdp control-channel-status refresh-timer

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

  • configure service vprn redundant-interface spoke-sdp control-channel-status refresh-timer

refresh-timer

Syntax

refresh-timer seconds

no refresh-timer

Context

[Tree] (config>mirror>mirror-dest>remote-src>spoke-sdp>control-channel-status refresh-timer)

[Tree] (config>mirror>mirror-dest>spoke-sdp>control-channel-status refresh-timer)

Full Context

configure mirror mirror-dest remote-source spoke-sdp control-channel-status refresh-timer

configure mirror mirror-dest spoke-sdp control-channel-status refresh-timer

Description

This command configures the refresh timer for control channel status signaling packets. By default, no refresh packets are sent.

Parameters

seconds

Specifies the refresh timer value.

Values

10 to 65535

Platforms

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

register

register

Syntax

register [group grp-ip-address] [source ip-address] [detail]

no register

Context

[Tree] (debug>router>pim register)

Full Context

debug router pim register

Description

This command enables debugging for PIM register mechanism.

The no form of this command disables debugging for PIM register mechanism.

Parameters

grp-ip-address

Debugs information associated with the specified PIM register.

Values

multicast group address (ipv4, ipv6)

ip-address

Debugs information associated with the specified PIM register.

Values

source address (ipv4, ipv6)

detail

Debugs detailed register information.

Platforms

All

register-message

register-message

Syntax

[no] register-message {ip-address | ipv6-address}

Context

[Tree] (config>service>vprn>pim>src-address register-message)

[Tree] (config>router>pim>src-address register-message)

Full Context

configure service vprn pim source-address register-message

configure router pim source-address register-message

Description

This command configures the source IP address for PIM register messages. The IP address can be set to any unicast address, regardless of whether it resides on the node. Ensure that the specified IP address is configured on the router as a loopback or interface IP address.

The no form of this command removes the IP address. By default, when no IP address is specified for the PIM instance, the source IP address for register messages is selected by choosing the smallest IP address from available interfaces on the node.

Parameters

ip-address | ipv6-address

Specifies the source IPv4 or IPv6 address, up to 64 characters.

Platforms

All

registrant-sm

registrant-sm

Syntax

[no] registrant-sm

Context

[Tree] (debug>service>id>mrp registrant-sm)

Full Context

debug service id mrp registrant-sm

Description

This command enables debugging of the registrant state machine.

The no form of this command disables debugging of the registrant state machine.

Platforms

All

reinit-delay

reinit-delay

Syntax

reinit-delay time

no reinit-delay

Context

[Tree] (config>system>lldp reinit-delay)

Full Context

configure system lldp reinit-delay

Description

This command configures the time before re-initializing LLDP on a port.

The no form of this command reverts to the default value.

Default

no reinit-delay

Parameters

time

Specifies the time, in seconds, before re-initializing LLDP on a port.

Values

1 to 10

Default

2

Platforms

All

reject-disabled-ncp

reject-disabled-ncp

Syntax

[no] reject-disabled-ncp

Context

[Tree] (config>router>l2tp>group>tunnel>ppp reject-disabled-ncp)

[Tree] (config>service>vprn>l2tp>group>ppp reject-disabled-ncp)

[Tree] (config>router>l2tp>group>ppp reject-disabled-ncp)

[Tree] (config>service>vprn>l2tp>group>tunnel>ppp reject-disabled-ncp)

Full Context

configure router l2tp group tunnel ppp reject-disabled-ncp

configure service vprn l2tp group ppp reject-disabled-ncp

configure router l2tp group ppp reject-disabled-ncp

configure service vprn l2tp group tunnel ppp reject-disabled-ncp

Description

This command forces an LCP Protocol Reject when receiving an IPv6CP Configure Request message whenIPv6 is not configured.

By default, an IPv6CP Configure Request message is silently ignored when IPv6 is not configured.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

reject-disabled-ncp

Syntax

[no] reject-disabled-ncp

Context

[Tree] (config>subscr-mgmt>ppp-policy reject-disabled-ncp)

Full Context

configure subscriber-mgmt ppp-policy reject-disabled-ncp

Description

This command forces an LCP Protocol Reject when receiving an IPv6CP Configure Request message while IPv6 is not configured or when receiving an IPv4CP Configure Request message and no local IPv4 address is assigned.

By default, an IPv4CP/IPv6CP Configure Request message is silently ignored when IPv4/IPv6 is not configured.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

relative

relative

Syntax

relative percent

no relative

Context

[Tree] (config>test-oam>link-meas>template>sw>thr relative)

[Tree] (config>test-oam>link-meas>template>asw>thr relative)

Full Context

configure test-oam link-measurement measurement-template sample-window threshold relative

configure test-oam link-measurement measurement-template aggregate-sample-window threshold relative

Description

This command configures the percentage value of change, positive or negative, compared to the previously reported measurement. If this percentage value is reached in either direction, the new value is conveyed to the routing engine for further handling and stored as the delay measurement last reported. If the percentage value is not configured, this threshold is disabled.

The no form of this command reverts to the default value.

Default

relative 0

Parameters

percent

Specifies the percentage of change.

A value of 0 (zero) indicates no relative thresholding is performed when considering report to the routing engine.

Values

0 to 100

Platforms

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

relay

relay

Syntax

[no] relay

Context

[Tree] (config>service>ies>sub-if>grp-if>ipv6>dhcp6 relay)

[Tree] (config>service>ies>sub-if>ipv6>dhcp6 relay)

[Tree] (config>service>vprn>sub-if>ipv6>dhcp6 relay)

[Tree] (config>service>vprn>sub-if>grp-if>ipv6>dhcp6 relay)

Full Context

configure service ies subscriber-interface group-interface ipv6 dhcp6 relay

configure service ies subscriber-interface ipv6 dhcp6 relay

configure service vprn subscriber-interface ipv6 dhcp6 relay

configure service vprn subscriber-interface group-interface ipv6 dhcp6 relay

Description

Commands in this context configure DHCPv6 relay parameters for this interface.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

relay-plain-bootp

relay-plain-bootp

Syntax

[no] relay-plain-bootp

Context

[Tree] (config>service>ies>if>dhcp relay-plain-bootp)

[Tree] (config>service>vprn>if>dhcp relay-plain-bootp)

Full Context

configure service ies interface dhcp relay-plain-bootp

configure service vprn interface dhcp relay-plain-bootp

Description

This command enables the relaying of plain BOOTP packets.

The no form of this command disables the relaying of plain BOOTP packets.

Platforms

All

relay-plain-bootp

Syntax

[no] relay-plain-bootp

Context

[Tree] (config>router>if>dhcp relay-plain-bootp)

Full Context

configure router interface dhcp relay-plain-bootp

Description

This command enables the relaying of plain BOOTP packets.

The no form of this command disables the relaying of plain BOOTP packets.

Default

no relay-plain-bootp

Platforms

All

relay-proxy

relay-proxy

Syntax

relay-proxy [release-update-src-ip] [siaddr-override ip-address]

no relay-proxy

Context

[Tree] (config>service>vprn>sub-if>grp-if>dhcp relay-proxy)

[Tree] (config>service>ies>if>dhcp relay-proxy)

[Tree] (config>service>ies>sub-if>grp-if>dhcp relay-proxy)

[Tree] (config>service>vprn>sub-if>dhcp relay-proxy)

[Tree] (config>service>vprn>if>dhcp relay-proxy)

[Tree] (config>service>ies>sub-if>dhcp relay-proxy)

Full Context

configure service vprn subscriber-interface group-interface dhcp relay-proxy

configure service ies interface dhcp relay-proxy

configure service ies subscriber-interface group-interface dhcp relay-proxy

configure service vprn subscriber-interface dhcp relay-proxy

configure service vprn interface dhcp relay-proxy

configure service ies subscriber-interface dhcp relay-proxy

Description

This command enables the DHCPv4 relay proxy function on the interface. The command has no effect when no dhcp servers are configured (DHCPv4 relay not configured). By default, unicast DHCPv4 release messages are forwarded transparently.

A relay proxy enhances the relay such that it also relays unicast client DHCPv4 REQUEST messages (lease renewals).

  • In the upstream direction, update the source IP address and add the gateway IP address (gi-address) field before sending the message to the intended DHCP server (the message is not broadcasted to all configured DHCP servers.

  • In the downstream direction, remove the gi-address and update the destination IP address to the address of the yiaddr (your IP address) field.

The optional release-update-src-ip parameter updates the source IP address of a DHCP RELEASE message with the address used for relayed DHCPv4 messages.

The optional siaddr-override ip-address parameter enables DHCP server IP address hiding towards the client. This parameter requires that lease-populate is enabled on the interface. The DHCP server ip address is required for the address hiding function and is stored in the lease state record. The client interacts with the relay proxy as if it is the DHCP server. In all DHCP messages to the client, the value of following header fields and DHCP options containing the DHCP server IP address is replaced with the configured <ip-address>:

  • the "source IP address” field in the IP DHCPv4 packet header

  • the "siaddr” field in the DHCPv4 header if not equal to zero in the message received from the server

  • the Server Identification option (DHCPv4 option 54) if present in the original server message

  • the source IP address field in the IP packet header

DHCP OFFER selection during initial binding is done in the relay-proxy. Only the first DHCP OFFER message is forwarded to the client. Subsequent DHCP OFFER messages from different servers are silently dropped.

Parameters

release-update-src-ip

Updates the source IP address of a DHCP RELEASE message with the address used for relayed DHCPv4 messages.

ip-address

Enables DHCPv4 server address hiding towards the DHCPv4 client and activates DHCPv4 OFFER selection in case multiple DHCP servers are configured. The ip-address can be any local address in the same routing instance. If DHCP relay lease-split is enabled, siaddr-override ip-address has priority over the emulated-server ip-address configured in the proxy-server and is used as the source IP address.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

  • configure service vprn subscriber-interface dhcp relay-proxy
  • configure service vprn subscriber-interface group-interface dhcp relay-proxy
  • configure service ies subscriber-interface group-interface dhcp relay-proxy
  • configure service ies subscriber-interface dhcp relay-proxy

All

  • configure service ies interface dhcp relay-proxy
  • configure service vprn interface dhcp relay-proxy

relay-unsolicited-cfg-attribute

relay-unsolicited-cfg-attribute

Syntax

relay-unsolicited-cfg-attribute

Context

[Tree] (config>ipsec>ike-policy relay-unsolicited-cfg-attribute)

Full Context

configure ipsec ike-policy relay-unsolicited-cfg-attribute

Description

This command enters relay unsolicited configuration attributes context. With this configuration, the configured attributes returned from source (such as a RADIUS server) will be returned to IKEv2 remote-access tunnel client regardless if the client has requested it in the CFG_REQUEST payload.

Platforms

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

release-reason

release-reason

Syntax

[no] release-reason

Context

[Tree] (config>aaa>isa-radius-plcy>acct-include-attributes release-reason)

Full Context

configure aaa isa-radius-policy acct-include-attributes release-reason

Description

This command enables the inclusion of the release reason attributes.

The no form of the command excludes release reason attributes.

Default

no release-reason

Platforms

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

release-timeout

release-timeout

Syntax

release-timeout seconds

no release-timeout

Context

[Tree] (config>subscr-mgmt>pfcp-association release-timeout)

Full Context

configure subscriber-mgmt pfcp-association release-timeout

Description

This command configures the time to wait to clean up the PFCP association after administratively disabling it and requesting a shutdown to the BNG CPF. If the BNG CPF does not gracefully remove the PFCP association before the timer expires, the full association and all related sessions are forcefully removed.

The no form of this command reverts to the default.

Default

release-timeout 3600

Parameters

seconds

Specifies the wait time, in seconds, for cleanup of the PFCP association.

Values

30 to 3600

Note:

The PFCP protocol encoding does not allow the full range of configured values. The system automatically rounds up the configured value to the nearest value allowed by the protocol. For more information about the protocol encoding, see 3GPP TS 29.244 8.2.78.1.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

reliable-delivery

reliable-delivery

Syntax

[no] reliable-delivery

Context

[Tree] (config>router>rsvp>if>refresh-reduction reliable-delivery)

Full Context

configure router rsvp interface refresh-reduction reliable-delivery

Description

This command enables reliable delivery of RSVP messages over the RSVP interface. When refresh-reduction is enabled on an interface and reliable-delivery is disabled, the router will send a message_id and not set ACK desired in the RSVP messages over the interface. The router does not expect an ACK and but will accept it if received. The node will also accept message ID and reply with an ACK when requested. In this case, if the neighbor set the "refresh-reduction-capable” bit in the flags field of the common RSVP header, the node will enter summary refresh for a specific message_id it sent regardless if it received an ACK or not to this message from the neighbor.

Finally, when 'reliable-delivery’ option is enabled on any interface, RSVP message pacing is disabled on all RSVP interfaces of the system, for example, the user cannot enable the msg-pacing option in the config>router>rsvp context, and error message is returned in CLI. Conversely, when the msg-pacing option is enabled, the user cannot enable the reliable delivery option on any interface on this system. An error message is also generated in CLI after such an attempt.

The no form of this command reverts to the default value.

Default

no reliable-delivery

Platforms

All

reload

reload

Syntax

reload type {cert | key | cert-key-pair} filename protocol protocol [key-file filename]

Context

[Tree] (admin>certificate reload)

Full Context

admin certificate reload

Description

This command reloads imported certificate or key file or both at the same time. This command is typically used to update certificate or key file without shutting down ipsec-tunnel/ipsec-gw/cert-profile/ca-profile. Note that type cert and type key is deprecated in a future release. Use type cert-key-pair instead. Instead of type cert use type key instead.

  • If the new file exists and valid, then for each tunnel using it:

    • If the key matches the certificate, then the new file is downloaded to the MS-ISA to be used the next time. Tunnels currently up are not affected.

    • If the key does not match the certificate:

      • If cert and key configuration is used instead of cert-profile then the tunnel is brought down.

      • If cert-profile is used, then cert-profile is brought down. The next authentication fails while the established tunnels are not affected.

If the new file does not exists or somehow invalid (bad format, does not contain right extension, and so on), then this command will abort.

In the case of type cert-key-pair, if the new file does not exist or is invalid or cert and key do not match, then this command aborts with an error message.

Parameters

type

Specifies what item will be reloaded.

cert

Specifies that a certificate cache will be reloaded.

key

Specifies that a key cache will be reloaded.

cert-key-pair

Specifies that a paired certificate and key cache will be reloaded.

filename

Up to 95 characters.

protocol

Specifies which protocol the certificate will be reloaded for.

Values

ipsec, tls

Platforms

All

rem-router-id

rem-router-id

Syntax

rem-router-id ip-addr

no rem-router-id

Context

[Tree] (config>service>vprn>l2tp>group>l2tpv3 rem-router-id)

Full Context

configure service vprn l2tp group l2tpv3 rem-router-id

Description

This command configures the IP address that should be used within the Remote Router-ID AVP.

The no form of this command removes the configured IP address.

Default

no rem-router-id

Parameters

ip-addr

Specifies an IP address to be used within the Remote Router-ID AVP.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

remark

remark

Syntax

remark

Context

[Tree] (config>app-assure>group>policy>aqp>entry>action remark)

Full Context

configure application-assurance group policy app-qos-policy entry action remark

Description

This command configures remark action on flows matching this AQP entry.

Platforms

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

remark

Syntax

remark dscp dscp-name

Context

[Tree] (config>filter>ip-filter>entry>action remark)

[Tree] (config>filter>ipv6-filter>entry>action remark)

[Tree] (config>filter>ip-filter>entry>action>extended-action remark)

[Tree] (config>filter>ipv6-filter>entry>action>extended-action remark)

Full Context

configure filter ip-filter entry action remark

configure filter ipv6-filter entry action remark

configure filter ip-filter entry action extended-action remark

configure filter ipv6-filter entry action extended-action remark

Description

This command enables and configures the remarking of the DiffServ Code Points of packets matching the criteria of the IPv4/IPv6 filter policy entry, in conjunction with a PBR action. Packets are remarked regardless of QoS-based in-profile or out-of-profile classification. QoS-based DSCP remarking is overridden. If the status of the PBR target is tracked and it is down, the extended action will not be executed; otherwise, the extended action will be performed.

Parameters

dscp-name

Specifies the DSCP value to write.

Values

be, ef, cp1, cp2, cp3, cp4, cp5, cp6, cp7, cp9, cs1, cs2, cs3, cs4, cs5, nc1, nc2, af11, af12, af13, af21, af22, af23, af31, af32, af33, af41, af42, af43, cp11, cp13, cp15, cp17, cp19, cp21, cp23, cp25, cp27, cp29, cp31, cp33, cp35, cp37, cp39, cp41, cp42, cp43, cp44, cp45, cp47, cp49, cp50, cp51, cp52, cp53, cp54, cp55, cp57, cp58, cp59, cp60, cp61, cp62, cp63

Platforms

All

remarking

remarking

Syntax

remarking [force]

no remarking

Context

[Tree] (config>qos>network>egress remarking)

Full Context

configure qos network egress remarking

Description

This command remarks both customer traffic and egress network IP interface traffic; VPRN customer traffic is not remarked. The remarking is based on the forwarding class to DSCP and LSP EXP bit mapping defined under the egress node of the network QoS policy.

Normally, packets that ingress on network ports have either the DSCP or, for MPLS packets, LSP EXP bit set by an upstream router. The packets are placed in the appropriate forwarding class based on the DSCP-to-forwarding class mapping or the LSP EXP-to-forwarding class mapping. The DSCP or LSP EXP bits of such packets are not altered as the packets egress this router, unless remarking is enabled.

Remarking can be required if this router is connected to a different DiffServ domain where the DSCP-to-forwarding class mapping is different.

Normally, no remarking is necessary when all router devices are in the same DiffServ domain.

The network QoS policy supports an egress flag that forces remarking of packets that were received on trusted IES and network IP interfaces. This provides the capability of remarking without regard to the ingress state of the IP interface on which a packet was received. The effect of the egress network remark trusted state on each type of ingress IP interface and trust state is listed in Ingress IP Interface Type and Trust State Effect on Egress Network Remarking.

The remark trusted state has no effect on packets received on an ingress VPRN IP interface.

Table 1. Ingress IP Interface Type and Trust State Effect on Egress Network Remarking

Ingress IP Interface Type and Trust State

Egress Network IP Interface Trust Remark Disabled (Default)

Egress Network IP Interface Trust Remark Enabled

IES Non-Trusted (Default)

Egress Remarked

Egress Remarked

IES Trusted

Egress Not Remarked

Egress Remarked

VPRN Non-Trusted

Egress Remarked

Egress Remarked

VPRN Trusted (Default)

Egress Not Remarked

Egress Not Remarked

Network Non-Trusted

Egress Remarked

Egress Remarked

Network Trusted (Default)

Egress Not Remarked

Egress Remarked

The no form of this command resets the configuration to the default behavior.

Default

no remarking — Remarking disabled in the Network QoS policy.

Parameters

force

Specifies that all IP routed traffic egressing the associated network interface will have its EXP, DSCP, P-bit, and DE bit setting remarked as defined in the associated QoS policy. Only bit fields configured in the QoS policy will be remarked; all others will be left untouched or set based on the default if the fields were not present at ingress.

Platforms

All

remote

remote

Syntax

remote

Context

[Tree] (config>ipsec>ts-list remote)

Full Context

configure ipsec ts-list remote

Description

Commands in this context configure remote TS-list parameters. The TS-list is the traffic selector of the local system, such as TSi, when the system acts as an IKEv2 responder.

Platforms

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

remote-address

remote-address

Syntax

remote-address ip-address

no remote-address

Context

[Tree] (config>subscr-mgmt>wlan-gw>tunnel-query remote-address)

Full Context

configure subscriber-mgmt wlan-gw tunnel-query remote-address

Description

This command enables matching only on the tunnel that uses the specified source IP address.

The no form of this command disables matching on a tunnel’s source IP address.

Default

no remote-address

Parameters

ip-address

Specifies the IPv4 or IPv6 remote address.

Values

ipv4-address

a.b.c.d

ipv6-address

x:x:x:x:x:x:x:x (eight 16-bit pieces)

x:x:x:x:x:x:d.d.d.d

x: [0 to FFFF]H

d: [0 to 255]D

Platforms

7750 SR, 7750 SR-e, 7750 SR-s, VSR

remote-age

remote-age

Syntax

remote-age aging-timer

no remote-age [aging-timer]

Context

[Tree] (config>service>template>vpls-template remote-age)

[Tree] (config>service>vpls remote-age)

Full Context

configure service template vpls-template remote-age

configure service vpls remote-age

Description

This command specifies the aging time for remotely learned MAC addresses in the forwarding database (FDB) for the Virtual Private LAN Service (VPLS) instance.

In a VPLS service, MAC addresses are associated with a Service Access Point (SAP) or with a service destination point (SDP). MACs associated with a SAP are classified as local MACs, and MACs associated with an SDP are remote MACs.

Like in a Layer 2 switch, learned MACs can be aged out if no packets are sourced from the MAC address for a period of time (the aging time). In each VPLS service instance, there are independent aging timers for local learned MAC and remote learned MAC entries in the FDB. The remote-age timer specifies the aging time for remote learned MAC addresses. To reduce the amount of signaling required between switches configure this timer larger than the local-age timer.

The no form of this command returns the remote aging timer to the default value.

Default

remote-age 900

Parameters

seconds

Specifies the aging time for remote MACs expressed in seconds

Values

60 to 86400

Platforms

All

remote-attachment-circuit

remote-attachment-circuit

Syntax

remote-attachment-circuit ac-name [endpoint endpoint-name] [create]

no remote-attachment-circuit ac-name

Context

[Tree] (config>service>epipe>bgp-evpn remote-attachment-circuit)

Full Context

configure service epipe bgp-evpn remote-attachment-circuit

Description

This command configures the remote attachment circuit.

The no form of this command disables the context.

Default

no remote-attachment-circuit

Parameters

ac-name

Specifies the name of the remote attachment circuit, up to 32 characters.

endpoint-name

Specifies the name of the endpoint, up to 32 characters.

create

Keyword used to create the remote AC.

Platforms

All

remote-ecid

remote-ecid

Syntax

remote-ecid emulated circuit identifier

no remote-ecid

Context

[Tree] (config>service>epipe>sap>cem remote-ecid)

Full Context

configure service epipe sap cem remote-ecid

Description

This command defines the Emulated Circuit Identifiers (ECID) to be used for the remote (destination) end of the circuit emulation service.

Parameters

emulated circuit identifier

Specifies the value to be used as the remote (destination) ECID for the circuit emulation service. Upon CES packet reception, the ECID in the packet will be compared to the configured local-ecid value. These must match for the packet payload to be used for the TDM circuit. The remote-ecid value is inserted into the MEF-8 CES packet to be transmitted.

Values

0 to 1048575

Platforms

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

remote-gateway-address

remote-gateway-address

Syntax

remote-gateway-address [ip-address | ipv6-address]

no remote-gateway-address

Context

[Tree] (config>router>if>ipsec>ipsec-tunnel remote-gateway-address)

Full Context

configure router interface ipsec ipsec-tunnel remote-gateway-address

Description

This command configures the remote IPsec tunnel endpoint address.

Parameters

ip-address

Specifies a remote unicast IPv4 address, up to 64 characters.

ipv6-address

Specifies a remote unicast global unicast IPv6 address, up to 64 characters.

Platforms

VSR

remote-id

remote-id

Syntax

remote-id hex hex-string

remote-id string ascii-string

no remote-id

Context

[Tree] (config>subscr-mgmt>loc-user-db>ppp>host>host-ident remote-id)

[Tree] (config>subscr-mgmt>loc-user-db>ipoe>host>host-ident remote-id)

Full Context

configure subscriber-mgmt local-user-db ppp host host-identification remote-id

configure subscriber-mgmt local-user-db ipoe host host-identification remote-id

Description

This command specifies the remote ID to match for a host lookup. When the LUDB is accessed using a DHCPv4 server, the SAP-ID is matched against DHCP option 82.

Note:

This command is used only when remote-id is configured as one of the match-list parameters.

The no form of this command removes the remote ID from the configuration.

Parameters

hex-string

Specifies the hexadecimal format for the remote ID.

Values

0x0 to 0xFFFFFFFF (maximum 254 hex nibbles)

ascii-string

Specifies the string format for the remote ID, up to 255 characters.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

remote-id

Syntax

remote-id mac

remote-id string ASCII string

no remote-id

Context

[Tree] (config>subscr-mgmt>loc-user-db>ppp>host>ali remote-id)

Full Context

configure subscriber-mgmt local-user-db ppp host access-loop-information remote-id

Description

This command specifies a remote-id for PPPoE hosts. A remote-id received in PPPoE tags has precedence over the LUDB specified remote ID.

The no form of this command reverts to the default.

Parameters

mac

Specifies MAC address of the PPPoE session as the remote ID.

ASCII string

Specifies the circuit ID as a string, up to 63 characters.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

remote-id

Syntax

remote-id

remote-id mac

remote-id string [string]

no remote-id

Context

[Tree] (config>service>vprn>if>ipv6>dhcp6>option remote-id)

[Tree] (config>service>vprn>sub-if>grp-if>ipv6>dhcp6>option remote-id)

[Tree] (config>service>ies>if>ipv6>dhcp6>option remote-id)

Full Context

configure service vprn interface ipv6 dhcp6-relay option remote-id

configure service vprn subscriber-interface group-interface ipv6 dhcp6 option remote-id

configure service ies interface ipv6 dhcp6-relay option remote-id

Description

This command enables the sending of remote ID option in the DHCPv6 relay packet.

The client DHCP Unique Identifier (DUID) is used as the remote ID.

The no form of this command disables the sending of remote ID option in the DHCPv6 relay packet.

Platforms

All

  • configure service vprn interface ipv6 dhcp6-relay option remote-id
  • configure service ies interface ipv6 dhcp6-relay option remote-id

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

  • configure service vprn subscriber-interface group-interface ipv6 dhcp6 option remote-id

remote-id

Syntax

remote-id

remote-id hex [hex-string]

remote-id {mac | string string}

no remote-id

Context

[Tree] (config>service>ies>sub-if>grp-if>dhcp>option remote-id)

[Tree] (config>subscr-mgmt>msap-policy>vpls-only>dhcp>option remote-id)

[Tree] (config>service>ies>if>dhcp>option remote-id)

[Tree] (config>service>vpls>sap>dhcp>option remote-id)

[Tree] (config>service>vprn>if>dhcp>option remote-id)

[Tree] (config>service>vprn>sub-if>grp-if>dhcp>option remote-id)

Full Context

configure service ies subscriber-interface group-interface dhcp option remote-id

configure subscriber-mgmt msap-policy vpls-only-sap-parameters dhcp option remote-id

configure service ies interface dhcp option remote-id

configure service vpls sap dhcp option remote-id

configure service vprn interface dhcp option remote-id

configure service vprn subscriber-interface group-interface dhcp option remote-id

Description

This command specifies what information goes into the remote-id sub-option in the DHCP relay packet.

If disabled, the remote-id sub-option of the DHCP packet is left empty. When the command is configured without any parameters, it equals to the remote-id mac option.

The no form of this command reverts to the default.

Parameters

string

Specifies the remote-id, up to 32 characters.

hex-string

Specifies the hex value of this option.

Values

0x0 to 0xFFFFFFFF...(up to 64 hex nibbles)

mac

Specifies that the MAC address of the remote end is encoded in the sub-option.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

  • configure service vprn subscriber-interface group-interface dhcp option remote-id
  • configure subscriber-mgmt msap-policy vpls-only-sap-parameters dhcp option remote-id
  • configure service ies subscriber-interface group-interface dhcp option remote-id

All

  • configure service vprn interface dhcp option remote-id
  • configure service vpls sap dhcp option remote-id
  • configure service ies interface dhcp option remote-id

remote-id

Syntax

[no] remote-id

Context

[Tree] (config>subscr-mgmt>acct-plcy>include-radius-attribute remote-id)

[Tree] (config>subscr-mgmt>auth-policy>include-radius-attribute remote-id)

Full Context

configure subscriber-mgmt radius-accounting-policy include-radius-attribute remote-id

configure subscriber-mgmt authentication-policy include-radius-attribute remote-id

Description

This command enables the generation of the Broad Band Forum Agent-Remote-Id VSA in RADIUS request messages.

The no form of this command disables the generation of the Broad Band Forum Agent-Remote-Id VSA.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

remote-id

Syntax

[no] remote-id

Context

[Tree] (config>subscr-mgmt>diam-appl-plcy>nasreq>include-avp remote-id)

Full Context

configure subscriber-mgmt diameter-application-policy nasreq include-avp remote-id

Description

This command enables the generation of the Broad Band Forum Agent-Remote-Id Vendor Specific AVP in Diameter NASREQ AAR messages.

The no form of this command reverts to the default.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

remote-id

Syntax

[no] remote-id remote-id

Context

[Tree] (debug>service>id>ppp remote-id)

Full Context

debug service id ppp remote-id

Description

This command enable PPP debug for the specified remote-id.

Multiple remote-id filters can be specified in the same debug command.

Parameters

remote-id

Specifies the remote-id in PADI.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

remote-id

Syntax

[no] remote-id

Context

[Tree] (config>aaa>isa-radius-plcy>acct-include-attributes remote-id)

[Tree] (config>aaa>isa-radius-plcy>auth-include-attributes remote-id)

Full Context

configure aaa isa-radius-policy acct-include-attributes remote-id

configure aaa isa-radius-policy auth-include-attributes remote-id

Description

This command enables the sending of remote ID option. The client DHCP Unique Identifier (DUID) is used as the remote ID.

The no form of the command disables the sending of remote ID option relay packet.

Default

no remote-id

Platforms

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

remote-id

Syntax

remote-id [{mac | string string}]

no remote-id

Context

[Tree] (config>router>if>dhcp>option remote-id)

Full Context

configure router interface dhcp option remote-id

Description

When enabled, the router sends the MAC address of the remote end (typically the DHCP client) in the remote-id suboption of the DHCP packet. This command identifies the host at the other end of the circuit. If disabled, the remote-id suboption of the DHCP packet will be left empty.

The no form of this command returns the system to the default.

Default

no remote-id

Parameters

mac

This keyword specifies the MAC address of the remote end is encoded in the suboption.

string

Specifies the remote ID.

Platforms

All

remote-id

Syntax

remote-id mac

remote-id string <string>

no remote-id

Context

[Tree] (config>service>vpls>sap>dhcp6>ldra>options remote-id)

Full Context

configure service vpls sap dhcp6 ldra options remote-id

Description

This command configures the information for the remote ID suboption in the DHCP6 LDRA.

The no form of this command reverts to the default.

Default

no remote-id

Parameters

mac

Sets the enterprise number field of the Relay Agent remote ID to 6527 and configures the DHCPv6 client source MAC address as six hexadecimal numbers.

string

Sets the enterprise number field of the Relay-Agent remote ID to 6527 and configures the ASCII-encoded string using up to 32 characters.

Platforms

All

remote-ip

remote-ip

Syntax

remote-ip ip-address

no remote-ip

Context

[Tree] (config>service>ies>if>sap>ip-tunnel remote-ip)

Full Context

configure service ies interface sap ip-tunnel remote-ip

Description

This command configures the primary destination IPv4 or IPv6 address to use for an IP tunnel. This configuration applies to the outer IP header of the encapsulated packets. The source address, remote-ip address and backup-remote-ip address of a tunnel must all belong to the same address family (IPv4 or IPv6). When the remote-ip address contains an IPv6 address it must be a global unicast address.

Default

no remote-ip

Parameters

ip-address

An IPv4 address or an IPv6 address.

Platforms

All

remote-ip

Syntax

remote-ip ip-address

no remote-ip

Context

[Tree] (config>service>vprn>if>sap>ip-tunnel remote-ip)

Full Context

configure service vprn interface sap ip-tunnel remote-ip

Description

This command sets the primary destination IPv4 address of GRE encapsulated packets associated with a particular GRE tunnel. If this address is reachable in the delivery service (there is a route) then this is the destination IPv4 address of GRE encapsulated packets sent by the delivery service.

The no form of this command deletes the destination address from the GRE tunnel configuration.

Parameters

ip-address

Specifies the destination IPv4 address of the GRE tunnel.

Values

1.0.0.0 to 223.255.255.255

Platforms

All

remote-ip

Syntax

remote-ip {ip-prefix/prefix-length | ip-prefix netmask | any}

Context

[Tree] (config>router>ipsec>sec-plcy>entry remote-ip)

[Tree] (config>service>vprn>ipsec>sec-plcy>entry remote-ip)

Full Context

configure router ipsec security-policy entry remote-ip

configure service vprn ipsec security-policy entry remote-ip

Description

This command configures the remote (from the tunnel) IP prefix/mask for the policy parameter entry.

Only one entry is necessary to describe a potential flow. The local-ip and remote-ip commands can be defined only once. The system evaluates:

  • the local IP as the source IP when traffic is examined in the direction of the flows from private to public and as the destination IP when traffic flows from public to private

  • the remote IP as the source IP when traffic flows public to private and as the destination IP when traffic flows from private to public

Parameters

ip-prefix

Specifies the destination address of the aggregate route in dotted decimal notation.

Values

a.b.c.d (host bits must be 0)

prefix-length 1 to 32

netmask

Specifies the subnet mask in dotted decimal notation.

any

keyword to specify that it can be any address.

Platforms

VSR

  • configure router ipsec security-policy entry remote-ip

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

  • configure service vprn ipsec security-policy entry remote-ip

remote-ip-address

remote-ip-address

Syntax

remote-ip-address ip-address

no remote-ip-address

Context

[Tree] (config>lag>bfd>family remote-ip-address)

Full Context

configure lag bfd family remote-ip-address

Description

This command specifies the IPv4 or IPv6 address of the BFD destination.

The no form of this command removes this address from the configuration.

Default

no remote-ip-address

Parameters

ip-address

Specifies the IP address.

Values

ipv4-address:

a.b.c.d

ipv6-address:

x:x:x:x:x:x:x:x (eight 16-bit pieces)

x:x:x:x:x:x:d.d.d.d

x:-[0 to FFFF]H

d: [0 to 255]D

Platforms

All

remote-ip-range-start

remote-ip-range-start

Syntax

remote-ip-range-start ip-address

no remote-ip-range-start

Context

[Tree] (config>isa>nat-group>inter-chassis-redundancy remote-ip-range-start)

Full Context

configure isa nat-group inter-chassis-redundancy remote-ip-range-start

Description

This command configures the first IPv4 address that is assigned to a first member ISA on the remote node. The remaining member ISAs on the remote node are assigned the consecutive IP addresses starting from the first IP address. These IP addresses are used to communicate between the ISAs on redundant nodes for the purpose of flow synchronization. Traffic from the first local IP address (member ISA), is sent to the first IP address from the remote IP range.

The no form of this command removes the ip-address from the configuration.

Default

no remote-ip-range-start

Parameters

ip-address

Specifies the first IPv4 address, in the a.b.c.d format, from the range assigned to the first member ISA on the remote node.

Platforms

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

remote-lfa

remote-lfa

Syntax

remote-lfa [max-pq-cost value]

no remote-lfa

Context

[Tree] (config>router>isis>loopfree-alternates remote-lfa)

Full Context

configure router isis loopfree-alternates remote-lfa

Description

This command enables the use of the Remote LFA algorithm in the LFA SPF calculation for this ISIS instance.

The no form of this command disables the use of the Remote LFA algorithm in the LFA SPF calculation for this ISIS instance.

Default

no remote-lfa

Parameters

value

Specifies the integer used to limit the search of candidate P and Q nodes in the remote LFA by setting the maximum IGP cost from the router performing the remote LFA calculation to the candidate P or Q node.

Values

0 to 4294967295

Default

4261412864

Platforms

All

remote-lfa

Syntax

remote-lfa [max-pq-cost value]

no remote-lfa

Context

[Tree] (config>router>ospf3>loopfree-alternates remote-lfa)

[Tree] (config>router>ospf>loopfree-alternates remote-lfa)

Full Context

configure router ospf3 loopfree-alternates remote-lfa

configure router ospf loopfree-alternates remote-lfa

Description

This command enables the use of the Remote LFA algorithm in the LFA SPF calculation in this OSPF or OSPF3 instance.

The no form of this command disables the use of the Remote LFA algorithm in the LFA SPF calculation in this OSPF or OSPF3 instance.

Default

no remote-lfa

Parameters

max-pq-cost value

Specifies the integer used to limit the search of candidate P and Q nodes in the remote LFA by setting the maximum IGP cost from the router performing the remote LFA calculation to the candidate P or Q node.

Values

0 to 4294967295

Default

4261412864

Platforms

All

remote-loop-respond

remote-loop-respond

Syntax

[no] remote-loop-respond

Context

[Tree] (config>port>tdm>ds1 remote-loop-respond)

Full Context

configure port tdm ds1 remote-loop-respond

Description

When enabled, the channel responds to requests for remote loopbacks.

Default

no remote-loop-respond — The port will not respond.

Platforms

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

remote-mac

remote-mac

Syntax

remote-mac ieee-address

no remote-mac

Context

[Tree] (config>service>epipe>sap>cem remote-mac)

Full Context

configure service epipe sap cem remote-mac

Description

This command defines the destination IEEE MAC address to be used to reach the remote end of the circuit emulation service.

Default

remote-mac 00:00:00:00:00:00

Parameters

ieee-address

Specifies the 48-bit MAC address in the form aa:bb:cc:dd:ee:ff or aa-bb-cc-dd-ee-ff where aa, bb, cc, dd, ee and ff are hexadecimal numbers. Allowed values are any non-broadcast, non-multicast MAC and non-IEEE reserved MAC addresses.

Platforms

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

remote-management

remote-management

Syntax

remote-management

Context

[Tree] (config>system>management-interface remote-management)

Full Context

configure system management-interface remote-management

Description

Commands in this context configure the SR OS node to use the remote management service. Configuring remote management enables the SR OS node to report itself to a remote manager service running on a remote server, so that it is included in the dynamic list of available nodes. The manager service streamlines the management of multiple SR OS nodes running different SR OS versions using the same client application providing a similar shell to the MD-CLI.

Platforms

All

remote-management

Syntax

remote-management

no remote-management

remote-management manager [manager-name]

no remote-management manager [manager-name]

Context

[Tree] (debug>system>management-interface remote-management)

Full Context

debug system management-interface remote-management

Description

This command configures the management interface to debug the remote-management managers.

The no form of this command removes the configuration.

Parameters

manager manager-name

Specifies the name of the manager, up to 64 characters. If the parameter is not specified, all configured managers are debugged.

Platforms

All

remote-max-checkpoints

remote-max-checkpoints

Syntax

remote-max-checkpoints [number-of-files]

no remote-max-checkpoints

Context

[Tree] (config>system>rollback remote-max-checkpoints)

Full Context

configure system rollback remote-max-checkpoints

Description

This command configures the maximum number of rollback checkpoint files when the rollback-location is remote (for example, ftp).

Default

no remote-max-checkpoints

Parameters

number of files

Specifies the maximum rollback files saved at a remote location.

Values

1 to 200

Platforms

All

remote-mepid

remote-mepid

Syntax

remote-mepid mep-id remote-mac {unicast-da | default}

no remote-mepid mep-id

Context

[Tree] (config>eth-cfm>domain>assoc remote-mepid)

Full Context

configure eth-cfm domain association remote-mepid

Description

This command configures the remote MEP ID. Optionally, the operator may configure a unicast MAC address associated with the remote MEP. This unicast value replaces the default Layer 2 class 1 multicast address that is typically associated with ETH-CC packets.

Note:

This command is not supported with sub second CCM intervals. The unicast-da parameter may only be configured when a single remote MEP exists in the association.

The no form of this command removes the peer information.

Parameters

mep-id

Specifies the peer MEP ID.

Values

1 to 8191

unicast-da

Specifies the unicast MAC destination address.

Values

xx:xx:xx:xx:xx:xx or xx-xx-xx-xx-xx-xx or default

default — Removes the remote MAC unicast address and reverts back to class 1 multicast address.

Platforms

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

remote-mepid

Syntax

remote-mepid mep-id

no remote-mepid

Context

[Tree] (config>oam-pm>session>ethernet remote-mepid)

Full Context

configure oam-pm session ethernet remote-mepid

Description

This command specifies the remote MEP ID as an alternative to the static dest-mac ieee-address. When the remote-mepid option is configured as an alternative to the dest-mac, the domain and association information of the source mep within the session is used to check for a locally-stored unicast MAC address for the peer. The local MEP must be administratively enabled. Peer MEP MAC addresses are learned and maintained by the ETH-CC protocol.

The no form of this command removes this session parameter.

Parameters

mep-id

Specifies the remote MEP ID of the peer within the association.

Values

1 to 8191

Platforms

All

remote-name

remote-name

Syntax

remote-name host-name

no remote-name

Context

[Tree] (config>service>vprn>l2tp>group>tunnel remote-name)

[Tree] (config>router>l2tp>group>tunnel remote-name)

Full Context

configure service vprn l2tp group tunnel remote-name

configure router l2tp group tunnel remote-name

Description

This command configures a string to be compared to the host name used by the tunnel peer during the authentication phase of tunnel establishment.

Default

no remote-name

Parameters

host-name

Specifies a remote host name for the tunnel, up to 64 characters.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

remote-proxy-arp

remote-proxy-arp

Syntax

[no] remote-proxy-arp

Context

[Tree] (config>service>ies>if remote-proxy-arp)

[Tree] (config>service>vprn>sub-if>grp-if remote-proxy-arp)

[Tree] (config>service>vprn>if remote-proxy-arp)

[Tree] (config>service>ies>sub-if>grp-if remote-proxy-arp)

[Tree] (config>service>vprn>nw-if remote-proxy-arp)

Full Context

configure service ies interface remote-proxy-arp

configure service vprn subscriber-interface group-interface remote-proxy-arp

configure service vprn interface remote-proxy-arp

configure service ies subscriber-interface group-interface remote-proxy-arp

configure service vprn nw-if remote-proxy-arp

Description

This command enables remote proxy ARP on the interface.

Remote proxy ARP is similar to proxy ARP. It allows the router to answer an ARP request on an interface for a subnet that is not provisioned on that interface. This allows the router to forward to the other subnet on behalf of the requester. To distinguish remote proxy ARP from local proxy ARP, local proxy ARP performs a similar function but only when the requested IP is on the receiving interface.

The no form of this command reverts to the default.

Platforms

All

  • configure service vprn interface remote-proxy-arp
  • configure service ies interface remote-proxy-arp

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

  • configure service vprn subscriber-interface group-interface remote-proxy-arp
  • configure service ies subscriber-interface group-interface remote-proxy-arp

remote-proxy-arp

Syntax

[no] remote-proxy-arp

Context

[Tree] (config>subscr-mgmt>git>ipv4 remote-proxy-arp)

Full Context

configure subscriber-mgmt group-interface-template ipv4 remote-proxy-arp

Description

This command enables remote proxy ARP on the interface.

Remote proxy ARP is similar to proxy ARP. It allows the router to answer an ARP request on an interface for a subnet that is not provisioned on that interface. This allows the router to forward to the other subnet on behalf of the requester. To distinguish remote proxy ARP from local proxy ARP, local proxy ARP performs a similar function but only when the requested IP address is on the receiving interface.

The no form of this command disables remote proxy ARP on the interface.

Default

no remote-proxy-arp

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

remote-proxy-arp

Syntax

[no] remote-proxy-arp

Context

[Tree] (config>router>if remote-proxy-arp)

Full Context

configure router interface remote-proxy-arp

Description

This command enables remote proxy ARP on the interface.

Default

no remote-proxy-arp

Platforms

All

remote-servers

remote-servers

Syntax

remote-servers

Context

[Tree] (config>service>vprn>aaa remote-servers)

Full Context

configure service vprn aaa remote-servers

Description

Commands in this context configure AAA remote servers on the VPRN.

Platforms

All

remote-source

remote-source

Syntax

[no] remote-source

Context

[Tree] (config>mirror>mirror-dest remote-source)

Full Context

configure mirror mirror-dest remote-source

Description

This command is used on a destination router in a remote mirroring solution. The mirroring (packet copy) is performed on the source router and sent via an SDP to the destination router. Remote mirroring requires remote source configuration on the destination router.

Remote mirroring allows a destination router to terminate SDPs from multiple remote source routers. This allows consolidation of packet sniffers or analyzers at a single or small set of points in a network (for example, a sniffer or analyze farm, or lawful interception gateway).

A remote-source entry must be configured on the destination router for each source router from which mirrored traffic is being sent via SDPs.

A mirror destination service that is configured for a destination router must not be configured as for a source router.

The emote source configuration is not applicable when routable LI encapsulation is being used on the mirror source router. The remote source configuration is only used when a source router is sending mirrored traffic to a destination router via SDPs.

Two types of remote-source entries can be configured:

  • far end

  • spoke SDP

Certain remote source types are applicable with certain SDP types. For descriptions of the command usage in the mirror-dest context, see the far-end and spoke-sdp commands.

The no form of this command removes all remote-source entries.

Platforms

All

remote-v6-ip

remote-v6-ip

Syntax

remote-v6-ip any

remote-v6-ip ipv6-prefix/prefix-length

no remote-v6-ip

Context

[Tree] (config>router>ipsec>sec-plcy>entry remote-v6-ip)

[Tree] (config>service>vprn>ipsec>sec-plcy>entry remote-v6-ip)

Full Context

configure router ipsec security-policy entry remote-v6-ip

configure service vprn ipsec security-policy entry remote-v6-ip

Description

This command specifies the remote v6 prefix for the security-policy entry.

Parameters

ipv6-prefix/prefix-length

Specifies the local v6 prefix and length.

Values

ipv6-address/prefix: ipv6-address

x:x:x:x:x:x:x:x (eight 16-bit pieces)

x:x:x:x:x:x:d.d.d.d

x [0 to FFFF]H

d [0 to 255]D

host bits must be 0

:: not allowed

prefix-length [1 to 28]

any

A keyword to specify that any address can be used.

Platforms

VSR

  • configure router ipsec security-policy entry remote-v6-ip

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

  • configure service vprn ipsec security-policy entry remote-v6-ip

remote-ve-name

remote-ve-name

Syntax

[no] remote-ve-name name

Context

[Tree] (config>service>epipe>bgp-vpws remote-ve-name)

Full Context

configure service epipe bgp-vpws remote-ve-name

Description

This command creates or edits a remote-ve-name. A single remote-ve-name can be created per BGP VPWS instance if the service is single-homed or uses a single pseudowire to connect to a pair of dual-homed systems. When the service requires active/standby pseudowires to be created to remote dual-homed systems then two remote-ve-names must be configured.

This context defines the remote PE to which a pseudowire will be signaled.

remote-ve-name commands can be added even if bgp-vpws is not shutdown.

The no form of this command removes the configured remote-ve-name from the bgp vpws node. It can be used when the BGP VPWS status is either shutdown or "no shutdown”.

Parameters

name

Specifies a site name up to 32 characters in length.

Platforms

All

remove

remove

Syntax

[no] remove

Context

[Tree] (config>service>vprn>bgp>attribute-set remove)

Full Context

configure service vprn bgp attribute-set remove

Description

This command configures BGP to ignore and silently discard ATTR_SETs in BGP routes received from PE-CE peers of the VPRN. The discarded ATTR_SETs do not affect BGP best-path selection in the VPRN, and they do not appear in the VPN-IP routes that result from the VRF export of the BGP routes. Nokia recommends enabling this command in most deployments.

The no form of this command configures BGP to ignore ATTR_SETs in BGP routes received from PE-CE peers of the VPRN without discarding them. This allows the ATTR_SETs to propagate between CE devices connected to the VPRN and to other PE devices when the BGP routes are exported as VPN-IP routes.

Note: If the configuration of this command is changed, ROUTE_REFRESH messages are sent to all PE-CE peers of the VPRN.

Default

no remove

Platforms

All

remove-oldest

remove-oldest

Syntax

[no] remove-oldest

Context

[Tree] (config>subscr-mgmt>sla-profile>host-limits remove-oldest)

Full Context

configure subscriber-mgmt sla-profile host-limits remove-oldest

Description

This command removes the oldest subscriber host when the host limit is reached.

The no form of this command maintains the oldest subscriber host when the host limit is reached.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

remove-private

remove-private

Syntax

[no] remove-private

Context

[Tree] (config>subscr-mgmt>bgp-prng-plcy remove-private)

Full Context

configure subscriber-mgmt bgp-peering-policy remove-private

Description

This command allows private AS numbers to be removed from the AS path before advertising them to BGP peers.

The OS software recognizes the set of AS numbers that are defined by IANA as private. These are AS numbers in the range 64512 through 65535, inclusive.

The no form of this command used at the global level reverts to default value.

Private AS numbers are included in the AS path attribute.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

remove-private

Syntax

remove-private [limited] [skip-peer-as] [replace]

no remove-private

Context

[Tree] (config>service>vprn>bgp>group remove-private)

[Tree] (config>service>vprn>bgp>group>neighbor remove-private)

[Tree] (config>service>vprn>bgp remove-private)

Full Context

configure service vprn bgp group remove-private

configure service vprn bgp group neighbor remove-private

configure service vprn bgp remove-private

Description

When this command is configured private AS numbers are removed or replaced when they are found inside the AS path of BGP routes advertised to peers within the scope of the command.

The set of AS numbers that are defined by IANA as private are in the range of 64512 to 65534, and 4200000000 to 4294967294, inclusive. In SR OS, this command also removes ASN 65535 and ASN 4294967295, which are reserved values.

The no form of this command (at the BGP instance level) implements the default behavior, private AS numbers are allowed without restriction or modification in routes advertised to peers.

Default

no remove-private

Parameters

limited

This keyword instructs BGP to process private ASNs only up to the first public ASN encountered. Private ASNs beyond that first public AS will not be stripped or replaced.

skip-peer-as

This keyword instructs BGP to not strip or replace a private ASN from the AS-Path if that ASN is the same as the BGP peer AS number.

replace

When this keyword is configured, private ASNs are not stripped. Each occurrence is replaced by the ASN of the advertising BGP router (the ASN the router advertised to its peer in its OPEN message). When the replace keyword is not configured, private ASNs are stripped, subject to influence by the other keyword options. This generally results in a shortening of AS_PATH length.

Platforms

All

remove-private

Syntax

remove-private [limited] [skip-peer-as] [replace]

no remove-private

Context

[Tree] (config>router>bgp>group>neighbor remove-private)

[Tree] (config>router>bgp remove-private)

[Tree] (config>router>bgp>group remove-private)

Full Context

configure router bgp group neighbor remove-private

configure router bgp remove-private

configure router bgp group remove-private

Description

When this command is configured private AS numbers are removed or replaced when they are found inside the AS path of BGP routes advertised to peers within the scope of the command.

The set of AS numbers that are defined by IANA as private are in the range of 64512 to 65534, and 4200000000 to 4294967294, inclusive. In SR OS, this command also removes ASN 65535 and ASN 4294967295, which are reserved values.

The no form of this command (at the BGP instance level) implements the default behavior, private AS numbers are allowed without restriction or modification in routes advertised to peers.

Default

no remove-private

Parameters

limited

This keyword instructs BGP to process private ASNs only up to the first public ASN encountered. Private ASNs beyond that first public AS will not be stripped or replaced.

skip-peer-as

This keyword instructs BGP to not strip or replace a private ASN from the AS-Path if that ASN is the same as the BGP peer AS number.

replace

When this keyword is configured, private ASNs are not stripped. Each occurrence is replaced by the ASN of the advertising BGP router (the ASN the router advertised to its peer in its OPEN message). When the replace keyword is not configured, private ASNs are stripped, subject to influence by the other keyword options. This generally results in a shortening of AS_PATH length.

Platforms

All

renew

renew

Syntax

renew est-profile name cert cert-filename key key-filename [hash-alg hash-algorithm] output output-cert-filename [validate-cert-chain] [force]

Context

[Tree] (admin>certificate>est renew)

Full Context

admin certificate est renew

Description

This command renews an imported certificate (specified by the cert cert-filename) with a Certificate Authority (CA) using the EST protocol specified by the est-profile name, with an imported private key specified the key parameter. The key can be either the key of the certificate to be renewed or a new key.

The authentication between system and EST server is specified by the est-profile.

The hash-alg hash-alorithm parameter is used to generate the CSR (Certificate Signing Request) in the EST request message.

Parameters

name

Specifies EST profile name, up to 32 characters

cert-filename

Specifies the certificate file name, up to 95 characters

key-filename

Specifies the file name of a key, up to 95 characters

hash-algorithm

Specifies the hash algorithm to be used in a certificate request.

Values

sha1, sha224, sha256, sha384, sha512

output-cert-filename

Specifies the output cert file name, up to 200 characters

validate-cert-chain

Specifies that the the system validates the certificate chain of the result certificate before importing it

force

Specifies the system to overwrite the existing file with same output output-cert-filename

Platforms

All

renew-timer

renew-timer

Syntax

renew-timer [days days] [hrs hours] [min minutes] [sec seconds]

no renew-timer

Context

[Tree] (config>service>vprn>sub-if>grp-if>ipv6>dhcp6>proxy renew-timer)

[Tree] (config>service>ies>sub-if>grp-if>ipv6>dhcp6>proxy-server renew-timer)

[Tree] (config>subscr-mgmt>loc-user-db>ppp>host>ipv6-lease-times renew-timer)

[Tree] (config>router>dhcp6>server>pool>prefix renew-timer)

[Tree] (config>subscr-mgmt>loc-user-db>ipoe>host>ipv6-lease-times renew-timer)

[Tree] (config>service>vprn>dhcp6>server>pool>prefix renew-timer)

Full Context

configure service vprn subscriber-interface group-interface ipv6 dhcp6 proxy-server renew-timer

configure service ies subscriber-interface group-interface ipv6 dhcp6 proxy-server renew-timer

configure subscriber-mgmt local-user-db ppp host ipv6-lease-times renew-timer

configure router dhcp6 local-dhcp-server pool prefix renew-timer

configure subscriber-mgmt local-user-db ipoe host ipv6-lease-times renew-timer

configure service vprn dhcp6 local-dhcp-server pool prefix renew-timer

Description

This command configures the lease renew time (T1) via LUDB.

The T1 is the time at which the client contacts the addressing authority to extend the lifetimes of the DHCPv6 leases (addresses or prefixes). T1 is a time duration relative to the current time expressed in units of seconds.

The IP addressing authority controls the time at which the client contacts the addressing authority to extend the lifetimes on assigned addresses through the T1 and T2 parameters assigned to an IA. At time T1 for an IA, the client initiates a Renew/Reply message exchange to extend the lifetimes on any addresses in the IA. The client includes an IA option with all addresses currently assigned to the IA in its Renew message. Recommended values for T1 and T2 are .5 and .8 times the shortest preferred lifetime of the addresses in the IA that the addressing authority is willing to extend, respectively.

The configured renew timer should always be smaller than or equal to the rebind timer.

The T1 and T2 are carried in the IPv6 address option that is within the IA.

The no form of this command reverts to the default.

Default

renew-timer min 30

Parameters

renew-timer

Specifies the preferred lifetime.

Values

days days

0 to 7

hrs hours

0 to 23

min minutes

0 to 59

sec seconds

0 to 59

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

renew-timer

Syntax

renew-timer [days days] [hrs hours] [min minutes] [sec seconds]

no renew-timer

Context

[Tree] (config>router>dhcp6>server>defaults renew-timer)

Full Context

configure router dhcp6 local-dhcp-server defaults renew-timer

Description

This command configures the default renew timer.

The no form of this command reverts to the default.

Default

renew-timer min 30

Parameters

renew-timer

Specifies the timer after which the lease is renewed.

Values

days:

0 to 7

hours:

0 to 23

minutes:

0 to 59

seconds

0 to 59

Platforms

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

renotify

renotify

Syntax

renotify value

no renotify

Context

[Tree] (config>service>vpls>mac-notification renotify)

Full Context

configure service vpls mac-notification renotify

Description

This command controls the periodic interval at which sets of MAC notification messages are sent. At each expiration of the renotify timer, a new burst of notification messages is sent, specifically <count> frames at <interval> deci-seconds.

Default

no renotify

Parameters

value

Specifies the time interval between re-notification, in seconds

Values

240 to 840

Platforms

All

renum

renum

Syntax

renum src-entry-id to dst-entry-id

Context

[Tree] (config>service>mrp>mrp-policy renum)

Full Context

configure service mrp mrp-policy renum

Description

This command renumbers existing MRP policy entries to properly sequence policy entries. This may be required in some cases since the implementation exits when the first match is found and executes the actions according to the accompanying action command. This requires that entries be sequenced correctly from most to least explicit.

Parameters

src-entry-id

Specifies the entry number of an existing entry.

Values

1 to 65535

new-entry-id

Specifies the new entry number to be assigned to the old entry. If the new entry exists, an error message is generated.

Values

1 to 65535

Platforms

All

renum

Syntax

renum old-entry-id new-entry-id

Context

[Tree] (config>qos>sap-egress>ip-criteria renum)

[Tree] (config>qos>sap-egress>ipv6-criteria renum)

[Tree] (config>qos>sap-ingress>ipv6-criteria renum)

[Tree] (config>qos>sap-ingress>mac-criteria renum)

[Tree] (config>qos>sap-ingress>ip-criteria renum)

Full Context

configure qos sap-egress ip-criteria renum

configure qos sap-egress ipv6-criteria renum

configure qos sap-ingress ipv6-criteria renum

configure qos sap-ingress mac-criteria renum

configure qos sap-ingress ip-criteria renum

Description

This command renumbers existing QoS policy criteria entries to properly sequence policy entries.

This can be required in some cases since the router exits when the first match is found and executes the actions in accordance with the accompanying action command. This requires that entries be sequenced correctly from most to least explicit.

Parameters

old-entry-id

Enter the entry number of an existing entry.

Values

1 to 65535

new-entry-id

Enter the new entry number to be assigned to the old entry.

Values

1 to 65535

Platforms

All

renum

Syntax

renum old-entry-number new-entry-number

Context

[Tree] (config>qos>network>egress>ipv6-criteria renum)

[Tree] (config>qos>network>ingress>ipv6-criteria renum)

[Tree] (config>qos>network>egress>ip-criteria renum)

[Tree] (config>qos>network>ingress>ip-criteria renum)

Full Context

configure qos network egress ipv6-criteria renum

configure qos network ingress ipv6-criteria renum

configure qos network egress ip-criteria renum

configure qos network ingress ip-criteria renum

Description

This command renumbers existing QoS policy criteria entries to properly sequence policy entries.

This can be required in some cases since the router exits when the first match is found and executes the actions in accordance with the accompanying action command. This requires that entries be sequenced correctly from most to least explicit.

Parameters

old-entry-number

Enter the entry number of an existing entry.

Values

1 to 65535

new-entry-number

Enter the new entry number to be assigned to the old entry.

Values

1 to 65535

Platforms

All

renum

Syntax

renum old-entry-id new-entry-id

Context

[Tree] (config>filter>mac-filter renum)

[Tree] (config>filter>ip-exception renum)

[Tree] (config>filter>ipv6-exception renum)

[Tree] (config>filter>ipv6-filter renum)

[Tree] (config>filter>ip-filter renum)

Full Context

configure filter mac-filter renum

configure filter ip-exception renum

configure filter ipv6-exception renum

configure filter ipv6-filter renum

configure filter ip-filter renum

Description

This command renumbers existing MAC, IPv4/IPv6, IP exception filter, or IPv6 exception filter entries to properly sequence filter entries.

This may be required in some cases since the OS exits when the first match is found and executes the actions according to the accompanying action command. This requires that entries be sequenced correctly from most to least explicit.

Parameters

old-entry-id

Specifies the entry number of an existing entry, as a decimal integer.

Values

1 to 2097151

new-entry-id

Specifies the new entry-number to be assigned to the old entry, as a decimal integer.

Values

1 to 2097151

Platforms

All

  • configure filter mac-filter renum
  • configure filter ip-filter renum
  • configure filter ipv6-filter renum

VSR

  • configure filter ip-exception renum
  • configure filter ipv6-exception renum

renum

Syntax

renum old-entry-number new-entry-number

Context

[Tree] (config>system>security>mgmt-access-filter>ipv6-filter renum)

[Tree] (config>system>security>mgmt-access-filter>ip-filter renum)

[Tree] (config>system>security>mgmt-access-filter>mac-filter renum)

Full Context

configure system security management-access-filter ipv6-filter renum

configure system security management-access-filter ip-filter renum

configure system security management-access-filter mac-filter renum

Description

This command renumbers existing management access filter entries for an IP(v4), IPv6, or MAC filter to re-sequence filter entries.

The exits on the first match found and executes the actions in accordance with the accompanying action command. This may require some entries to be re-numbered differently from most to least explicit.

Parameters

old-entry-number

Specifies the entry number of the existing entry.

Values

1 to 9999

new-entry-number

Specifies the new entry number that will replace the old entry number.

Values

1 to 9999

Platforms

All

renum

Syntax

renum old-entry-id new-entry-id

Context

[Tree] (config>sys>sec>cpm>ip-filter renum)

[Tree] (config>sys>sec>cpm>mac-filter renum)

[Tree] (config>sys>sec>cpm>ipv6-filter renum)

Full Context

configure system security cpm-filter ip-filter renum

configure system security cpm-filter mac-filter renum

configure system security cpm-filter ipv6-filter renum

Description

This command renumbers existing IP(IPv4), IPv6, or MAC filter entries to re-sequence filter entries.

This may be required in some cases since the OS exits when the first match is found and execute the actions according to the accompanying action command. This requires that entries be sequenced correctly from most to least explicit.

Parameters

old-entry-id

Specifies the entry number of an existing entry.

Values

1 to 6144 for ip-filter and ipv6-filter

1 to 2048 for mac-filter

new-entry-id

Specifies the new entry number to be assigned to the old entry.

Values

1 to 6144 for ip-filter and ipv6-filter

1 to 2048 for mac-filter

Platforms

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

renum

Syntax

renum old-entry-number new-entry-number

Context

[Tree] (config>system>security>profile renum)

Full Context

configure system security profile renum

Description

This command renumbers profile entries to re-sequence the entries.

Since the OS exits when the first match is found and executes the actions according to accompanying action command, re-numbering is useful to rearrange the entries from most explicit to least explicit.

Parameters

old-entry-number

Enter the entry number of an existing entry.

Values

1 to 9999

new-entry-number

Enter the new entry number.

Values

1 to 9999

Platforms

All

renumber

renumber

Syntax

renumber from entry-id to entry-id

Context

[Tree] (config>router>policy-options>policy-statement renumber)

Full Context

configure router policy-options policy-statement renumber

Description

This command allows the operator to renumber the existing entry ID to a new entry ID. When performing the renumbering action, the two entry IDs must be different. The existing (from) entry-id must exist. The new (to) entry-id must not exist.

Renumbering is not saved in the configuration because it is a performing action.

Parameters

from entry-id

Specifies the existing entry ID to be renumbered.

Values

1 to 4294967295

to entry-id

Specifies the new entry ID to be assigned.

Values

1 to 4294967295

Platforms

All

reorder-audio

reorder-audio

Syntax

reorder-audio time

no reorder-audio

Context

[Tree] (config>mcast-mgmt>mcast-info-plcy>bundle>video reorder-audio)

[Tree] (config>mcast-mgmt>mcast-info-plcy>bundle>channel>video reorder-audio)

Full Context

configure mcast-management multicast-info-policy bundle video reorder-audio

configure mcast-management multicast-info-policy bundle channel video reorder-audio

Description

This command configures the time, in milliseconds, by which the audio packets are reordered in the ad stream.

Configuring this parameter depends on what is configured on the A Server and the GOP sizes of the network stream. Typically, this configuration should match the A Server configuration.

The no form of the command removes the time value from the configuration.

Default

no reorder-audio

Parameters

time

Specifies the audio reorder time, in milliseconds.

Values

100 to 1000

Platforms

7450 ESS, 7750 SR, 7750 SR-s

repair

repair

Syntax

repair [cflash-id]

Context

[Tree] (file repair)

Full Context

file repair

Description

This command checks a compact flash device for errors and repairs any errors found.

Parameters

cflash-id

Specifies the compact flash slot ID to be repaired. When a specific cflash-id is specified, that drive is repaired. If no flash-id is specified, the drive referred to by the current working directory is assumed. If a slot number is not specified, the active CPM is assumed.

Values

cf1:, cf1-A:, cf1-B:, cf2:, cf2-A:, cf2-B:, cf3:, cf3-A:, cf3-B:

Default

the current compact flash device

Platforms

All

repeat

repeat

Syntax

repeat padding

Context

[Tree] (config>test-oam>sath>svc-test>svc-stream>frm-payl>patt repeat)

Full Context

configure test-oam service-activation-testhead service-test service-stream frame-payload data-pattern repeat

Description

This command configures the data pattern padding bytes for the frames launched for the service stream.

The specified data pattern value is repeated as many times as required to fill the remaining length of the payload for the highest level of the specified PDU. If only the Ethernet and ETH-CFM information is added, the data pattern is included in the data TLV of the ETH-CFM frame.

Default

repeat 0

Parameters

padding

Specifies the data pattern to populate the payload data.

Values

0 to 4294967295

Platforms

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

repeated-characters

repeated-characters

Syntax

repeated-characters count

no repeated-characters

Context

[Tree] (config>system>security>password>complexity-rules repeated-characters)

Full Context

configure system security password complexity-rules repeated-characters

Description

The number of times a characters can be repeated consecutively.

The no form of this command resets to default.

Default

no repeated-characters

Parameters

count

Specifies the minimum count of consecutively repeated characters.

Values

2 to 8

Platforms

All

replace

replace

Syntax

replace [line]

Context

[Tree] (candidate replace)

Full Context

candidate replace

Description

This command displays the specified line (a single line only) and allows it to be changed.

Parameters

line

Indicates which line to replace starting at the point indicated by the following options.

Values

line, offset, first, edit-point, last

line

absolute line number

offset

relative line number to current edit point. Prefixed with '+' or '-'

first

keyword - first line

edit-point

keyword - current edit point

last

keyword - last line that is not 'exit'

Platforms

All

replace-result-code

replace-result-code

Syntax

replace-result-code code [code]

no replace-result-code

Context

[Tree] (config>router>l2tp replace-result-code)

[Tree] (config>service>vprn>l2tp replace-result-code)

Full Context

configure router l2tp replace-result-code

configure service vprn l2tp replace-result-code

Description

This command replaces CDN Result-Code 4, 5 and 6 on LNS with the Result Code 2. This is needed for interoperability with some implementation of LAC which only takes action based on CDN Result-Code 2 while ignoring CDN Result-Code 4, 5 and 6.

Default

no replace-result-code

Parameters

code

Specifies the L2TP Result codes that need to be replaced. Up to three codes can be specified.

Values

cdn-tmp-no-facilities — CDN Result-Code 4 on LNS are replaced with the result code 2 before it is sent to LAC.

cdn-prem-no-facilities — CDN Result-Code 5 on LNS are replaced with the result code 2 before it is sent to LAC.

cdn-inv-dest — CDN Result-Code 6 on LNS are replaced with the result code 2 before it is sent to LAC.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

replay-protection

replay-protection

Syntax

[no] replay-protection

Context

[Tree] (config>macsec>connectivity-association replay-protection)

Full Context

configure macsec connectivity-association replay-protection

Description

Specifies the size of the replay protection window.

This command must be configured to force packet discard when it has detected a packet that is not within the replay-window-size.

When replay protection is enabled, the sequence of the ID number of the received packets are checked. If the packet arrives out of sequence and the difference between the packet numbers exceeds the replay window size, the packet is counted by the receiving port and then discarded. For example, if the replay protection window size is set to five and a packet assigned the ID of 1006 arrives on the receiving link immediately after the packet assigned the ID of 1000, the packet that is assigned the ID of 1006 is counted and discarded because it falls outside the parameters of the replay window size.

Replay protection is especially useful for fighting man-in-the-middle attacks. A packet that is replayed by a man-in-the-middle attacker on the Ethernet link will arrive on the receiving link out of sequence, so replay protection helps ensure the replayed packet is dropped instead of forwarded through the network.

Replay protection should not be enabled in cases where packets are expected to arrive out of order.

Default

no replay-protection

Platforms

All

replay-window

replay-window

Syntax

replay-window replay-window-size

no replay-window

Context

[Tree] (config>service>ies>if>ipsec>ipsec-tunnel replay-window)

[Tree] (config>service>vprn>if>sap>ipsec-tunnel replay-window)

[Tree] (config>ipsec>tnl-temp replay-window)

[Tree] (config>service>vprn>if>ipsec>ipsec-tunnel replay-window)

[Tree] (config>ipsec>trans-mode-prof replay-window)

Full Context

configure service ies interface ipsec ipsec-tunnel replay-window

configure service vprn interface sap ipsec-tunnel replay-window

configure ipsec tunnel-template replay-window

configure service vprn interface ipsec ipsec-tunnel replay-window

configure ipsec ipsec-transport-mode-profile replay-window

Description

This command specifies the size of the anti-replay window. The anti-replay window protocol further secures IPsec against an entity that can inject a recorded message in a message stream from a source to a destination computer on the Internet.

Default

no replay-window

Parameters

replay-window-size

Specifies the size of the SA anti-replay window.

Values

32, 64, 128, 256, 512

Platforms

VSR

  • configure service ies interface ipsec ipsec-tunnel replay-window
  • configure service vprn interface ipsec ipsec-tunnel replay-window

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

  • configure service vprn interface sap ipsec-tunnel replay-window
  • configure ipsec tunnel-template replay-window
  • configure ipsec ipsec-transport-mode-profile replay-window

replay-window-size

replay-window-size

Syntax

replay-window-size number-of-packets

no replay-window-size

Context

[Tree] (config>macsec>connectivity-association replay-window-size)

Full Context

configure macsec connectivity-association replay-window-size

Description

This command specifies the size of the replay protection window.

This command must be configured to enable replay protection. When replay protection is enabled, the sequence of the ID number of received packets are checked. If the packet arrives out of sequence and the difference between the packet numbers exceeds the replay protection window size, the packet is dropped by the receiving port. For example, if the replay protection window size is set to five and a packet assigned the ID of 1006 arrives on the receiving link immediately after the packet assigned the ID of 1000, the packet that is assigned the ID of 1006 is dropped because it falls outside the parameters of the replay protection window.

Replay protection is especially useful for fighting man-in-the-middle attacks. A packet that is replayed by a man-in-the-middle attacker on the Ethernet link will arrive on the receiving link out of sequence, so replay protection helps ensure the replayed packet is dropped instead of forwarded through the network.

Replay protection should not be enabled in cases where packets are expected to arrive out of order.

When the number-of-packets variable is set to 0, all packets that arrive out-of-order are dropped.

The no form of this command reverts to the default value.

Default

replay-window-size 0

Parameters

number-of-packets

Specifies the window for which the packets can arrive out of order.

Values

0 to 4294967294

Platforms

All

replication-segment

replication-segment

Syntax

[no] replication-segment policy-name

Context

[Tree] (config>router>p2mp-sr-tree replication-segment)

Full Context

configure router p2mp-sr-tree replication-segment

Description

This command creates a P2MP SR tree replication segment entry for the P2MP LSP.

The no form of this command deletes the replication segment entry.

Parameters

policy-name

Specifies the P2MP policy name, up to 32 characters, associated with the forwarding instructions contained in the replication segment.

Platforms

All

replication-sid

replication-sid

Syntax

replication-sid label [label]

no replication-sid

Context

[Tree] (config>router>p2mp-sr-tree>replication-segment>sr-mpls>downstream-nodes replication-sid)

Full Context

configure router p2mp-sr-tree replication-segment segment-routing-mpls downstream-nodes replication-sid

Description

This command configures the replication SID or a SID list for the next hop of the P2MP SR tree replication segment.

When a SID list is configured, the replication SID is at the bottom of the stack and the unicast node or the adjacency SID is at the top of the stack. The SID at the top of the stack must be configured first in the list and the replication SID at the bottom of the list must be configured last in the list.

The no form of this command removes the replication SID.

Default

no replication-sid

Parameters

label

Specifies the label of the replication SID; up to a maximum of 11 labels.

Values

3, 16 to 1048575, 4294967295

Platforms

All

replication-threshold

replication-threshold

Syntax

replication-threshold seconds

no replication-threshold

Context

[Tree] (config>isa>nat-group>inter-chassis-redundancy replication-threshold)

Full Context

configure isa nat-group inter-chassis-redundancy replication-threshold

Description

This command configures the minimum duration of the flow that needs to be met before it is synchronized to the standby node. This way, flow synchronization and statefulness in a multi-chassis environment are limited only to long-lived flows.

The no form of this command reverts to the default values.

Default

replication-threshold 20

Parameters

seconds

Specifies the minimum flow existence time before it is synchronized.

Values

0 to 300

Platforms

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

reply-on-padt

reply-on-padt

Syntax

[no] reply-on-padt

Context

[Tree] (config>subscr-mgmt>ppp-policy reply-on-padt)

Full Context

configure subscriber-mgmt ppp-policy reply-on-padt

Description

This command enables replying to PPPoE Active Discovery Terminate (PADT) packets. Some of the PPPoE clients expect reply on PADT message before the context of the session is cleared up. To support such client, a command enabling reply to PADT is provided.

The no form of this command reverts to the default.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

report-alarm

report-alarm

Syntax

[no] report-alarm [ais] [los] [ oof] [rai] [looped]

Context

[Tree] (config>port>tdm>e3 report-alarm)

[Tree] (config>port>tdm>ds3 report-alarm)

Full Context

configure port tdm e3 report-alarm

configure port tdm ds3 report-alarm

Description

This command enables logging of DS-3 and E-3 alarms for a DS-3/E-3 port or channel.

The no form of this command disables logging of the specified alarms.

Parameters

ais

Reports alarm indication signal errors. When configured, ais alarms are not raised and cleared.

Default

ais alarms are issued

los

Reports loss of signal errors. When configured, los traps are not raised and cleared.

Default

los traps are issued

oof

Reports out-of-frame errors. When configured, oof alarms are not raised and cleared.

Default

oof alarms are not issued

rai

Reports resource availability indicator events. When configured, rai events are not raised and cleared.

Default

rai alarms are not issued

looped

Reports looped packets errors.

Default

looped alarms are not issued

Platforms

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

report-alarm

Syntax

[no] report-alarm [signal-fail] [remote] [ local] [no-frame-lock] [ high-ber] [no-block-lock] [ no-am-lock] [duplicate-lane]

Context

[Tree] (config>port>ethernet report-alarm)

Full Context

configure port ethernet report-alarm

Description

This command specifies when and if to generate alarms and alarm clear notifications for this port.

Note:

For some DWDM transceivers, if the configure port dwdm coherent rx-los-reaction squelch command is disabled the signal-fail and no-am-lock alarm conditions are not reported when the media side of the transceiver has an RX LOS condition.

Parameters

signal-fail

Reports an Ethernet signal lost alarm.

remote

Reports remote faults.

local

Reports local faults.

no-frame-lock

Reports a 'not locked on the Ethernet framing sequence' alarm.

high-ber

Reports High Bit Error Rate.

no-block-lock

Reports 40G/100G PCS Lanes Not Block Locked.

no-am-lock

Reports 40G/100G PCS Alignment Marker Loss of Lock.

duplicate-lane

Reports 40G/100G PCS Duplicate Lane Marker.

Platforms

All

report-alarm

Syntax

[no] report-alarm [loc] [lais] [ lrdi] [ss1f] [lb2er-sd] [lb2er-sf] [slof] [ slos] [lrei]

Context

[Tree] (config>port>sonet-sdh report-alarm)

Full Context

configure port sonet-sdh report-alarm

Description

This command enables logging of SONET (SDH) line and section alarms for a SONET-SDH port. Only line and section alarms can be configured in the SONET/SDH context, for path alarms see the sonet-sdh>path context.

The no form of this command disables logging of the specified alarms.

This command is supported on TDM satellites.

Parameters

loc

Reports a loss of clock which causes the operational state of the port to be shut down.

Default

loc alarms are issued

lais

Reports line alarm indication signal errors. When configured, lais alarms are raised and cleared.

Default

lais alarms are not issued

lrdi

Reports line remote defect indication errors. LRDI's are caused by remote LOF, LOC, LOS. When configured, lrdi alarms are raised and cleared.

Default

lrdi alarms are issued

ss1f

Reports section synchronization failure which is detected when the S1 byte is not consistent for 8 consecutive frames. When configured, ss1f alarms are raised and cleared.

Default

ss1f alarms are not issued

lb2er-sd

Reports line signal degradation BER (bit interleaved parity) errors. Use the threshold command to set the error rate(s) that when crossed determine signal degradation and signal failure. When configured, lb2er-sd alarms are raised and cleared.

Default

lb2er-sd alarms are not issued

lb2er-sf

Reports line signal failure BER errors. Use the threshold command to set the error rate(s) that when crossed determine signal degradation and signal failure. When configured, lb2er-sf alarms are raised and cleared.

Default

lb2er-sf alarms are issued

slof

Reports section loss of frame errors. When configured, slof alarms are raised and cleared.

Default

slof alarms are issued

slos

Reports a section loss of signal error on the transmit side. When configured, slos alarms are raised and cleared.

Default

slos alarms are issued

lrei

Reports a line error condition raised by the remote as a result of b1 errors received from this node. When configured, lrei traps are raised but not cleared.

Default

lrei traps are not issued

Platforms

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

report-alarm

Syntax

[no] report-alarm {pais | plop | prdi | pplm | prei}

Context

[Tree] (config>port>sonet-sdh>path report-alarm)

Full Context

configure port sonet-sdh path report-alarm

Description

This command enables logging of SONET (SDH) path alarms for a SONET-SDH port. Only path alarms can be configured in the channel context.

The no form of this command disables logging of the specified alarms.

Parameters

pais

Reports path alarm indication signal errors. When configured, pais alarms are raised and cleared.

Default

pais alarms are not issued

plop

Reports path loss of pointer (per tributary) errors. When configured, plop traps are raised but not cleared.

Default

plop traps are issued

prdi

Reports path remote defect indication errors. When configured, prdi alarms are raised and cleared.

Default

prdi alarms are not issued

pplm

Reports a path payload mismatch, as a result the channel will be brought down. When configured, pplm traps are raised but not cleared.

Default

pplm traps are issued

prei

Reports a path error condition raised by the remote as a result of b3 errors received from this node. When configured, prei traps are raised but not cleared.

Default

prei traps are not issued

Platforms

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

report-alarm

Syntax

[no] report-alarm [ais] [los] [ oof] [rai] [looped] [ber-sd] [ber-sf]

Context

[Tree] (config>port>tdm>e1 report-alarm)

[Tree] (config>port>tdm>ds1 report-alarm)

Full Context

configure port tdm e1 report-alarm

configure port tdm ds1 report-alarm

Description

This command enables logging of DS-1/DS-3 or E-1/E-3 alarms for DS-1/DS-3 or E-1/E-3 ports or channels.

The no form of this command disables logging of the specified alarms.

Parameters

ais

Reports alarm indication signal errors. When configured, ais alarms are not raised and cleared.

Default

ais alarms are issued

los

Reports loss of signal errors. When configured, los traps are not raised and cleared.

Default

los traps are issued.

oof

Reports out-of-frame errors. When configured, oof alarms are not raised and cleared.

Default

oof alarms are not issued.

rai

Reports resource availability indicator events. When configured, rai events are not raised and cleared.

Default

rai alarms are not issued

looped

Reports looped packets errors.

looped alarms are not issuedlof

Reports loss of frame errors. When configured, lof traps are not raised and cleared.

Default

lof traps are issued

ber-sd

Specifies the BER that specifies signal degradation.

ber-sf

Specifies the BER that specifies signal failure.

Platforms

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

report-alarm

Syntax

[no] report-alarm [stray] [malformed] [pktloss] [overrun] [underrun] [rpktloss] [rfault] [rrdi]

Context

[Tree] (config>service>epipe>sap>cem report-alarm)

[Tree] (config>service>cpipe>sap>cem report-alarm)

Full Context

configure service epipe sap cem report-alarm

configure service cpipe sap cem report-alarm

Description

This command indicates the type of CEM SAP alarm.

The no form of this command removes the parameter from the configuration.

Default

On: stray, malformed, pktloss and overrun

Off: rpktloss, rfault, rrdi

Parameters

stray

Reports the reception of packets not destined for this CES circuit.

malformed

Reports the reception of packet not properly formatted as CES packets.

pktloss

Reports the lack of reception of CES packets.

overrun

Reports the reception of too many CES packets resulting in a overrun of the receive jitter buffer.

underrun

Reports the reception of too few CES packets resulting in a overrun of the receive jitter buffer.

rpktloss

Reports that the remote peer is currently in packet loss status.

rfault

Reports that the remote TDM interface is currently not in service.

rrdi

Reports that the remote TDM interface is currently in RDI status.

Platforms

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

  • configure service epipe sap cem report-alarm

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

  • configure service cpipe sap cem report-alarm

report-alarm

Syntax

report-alarm severity {tnc | qos | poa}

no report-alarm

Context

[Tree] (config>mcast-mgmt>mcast-info-plcy>bundle>channel>video>analyzer>alarms report-alarm)

[Tree] (config>mcast-mgmt>mcast-info-plcy>bundle>channel>source-override>video>analyzer>alarms report-alarm)

[Tree] (config>mcast-mgmt>mcast-info-plcy>bundle>video>analyzer>alarms report-alarm)

Full Context

configure mcast-management multicast-info-policy bundle channel video analyzer alarms report-alarm

configure mcast-management multicast-info-policy bundle channel source-override video analyzer alarms report-alarm

configure mcast-management multicast-info-policy bundle video analyzer alarms report-alarm

Description

This command configures the type of alarm to monitor and raise through SNMP. The severity of alarms increases from TNC, to QoS, and then to POA. For example, if QoS alarms are configured, the analyzer only raises alarms and events related to QoS. The analyzer may raise alarms for POA events if they occur, but alarms for TNC are not sent.

Default

no report-alarm

Parameters

severity

Keyword to configure the type of alarm.

tnc

Specifies to monitor and raise alarms for TNC events.

qos

Specifies to monitor and raise alarms for QoS events.

poa

Specifies to monitor and raise alarms for POA events.

Platforms

7450 ESS, 7750 SR, 7750 SR-s

report-alarms

report-alarms

Syntax

[no] report-alarms [modflt] [mod] [ netrx] [nettx] [hosttx]

Context

[Tree] (config>port>dwdm>coherent report-alarms)

Full Context

configure port dwdm coherent report-alarms

Description

This command configures the alarms that will be reported for the coherent module.

Default

modflt mod netrx nettx hosttx

Parameters

modflt

Reports module fault alarm.

mod

Reports module alarm.

netrx

Reports network (optical side) receive alarm.

nettx

Reports network (optical side) transmit alarm.

hosttx

Reports host (electrical side) transmit alarm.

Platforms

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

report-alarms

Syntax

[no] report-alarms [loc] [los] [ lof] [lom] [otu-ais] [otu-ber-sf] [otu-ber-sd] [otu-bdi] [otu-tim] [ otu-iae] [otu-biae] [fec-sf] [fec-sd] [fec-fail] [ fec-uncorr] [odu-ais] [odu-oci] [odu-lck] [odu-bdi] [odu-tim] [opu-plm]

Context

[Tree] (config>port>otu report-alarms)

Full Context

configure port otu report-alarms

Description

This command enables OTU alarms. Specify specific alarms to add to the list of reported alarms.

The no form of this command disables OTU alarm reporting.

Default

loc, los, lof, lom, otu-ber-sf, otu-bdi, fec-sf

Parameters

alarms

Refer to Alarm Descriptions for alarm descriptions.

Table 2. Alarm Descriptions

Alarm

Description

loc

Loss of clock.

lof

Loss of OTU framing.

lom

Loss of Multi-frame.

los

Loss of signal transitions on the data.

otu-ais

OTU Alarm Indication Signal (all 1s, overwrites all OTU overhead, even framing bytes).

otu-ber-sf

SM Signal Fail (based on BPI8).

otu-ber-sd

SM Signal Degrade (based on BPI8).

otu-bdi

SM Backward defect indication.

otu-tim

SM Trace Id Mismatch.

otu-iae

SM Incoming Alignment Error.

otu-biae

SM Backward Incoming Alignment Error.

fec-sf

Signal Fail (based on FEC corrected bits).

fec-sd

Signal Degrade (based on FEC corrected bits).

fec-fail

FEC Mode mismatch (EFEC-GFEC) or High Uncorrectable rate (>10E-2).

fec-uncorr

One or More Uncorrectable FEC errors.

odu-ais

ODU Alarm Indication Signal.

odu-oci

ODU Open connection Indication.

odu-lck

ODU Locked.

odu-bdi

PM Backward Defect indication.

odu-tim

PM Trace Id Mismatch.

opu-plm

OPU PSI Payload Type Mismatch.

Platforms

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

report-ip-address-event

report-ip-address-event

Syntax

[no] report-ip-address-event

Context

[Tree] (config>subscr-mgmt>diam-appl-plcy>gx report-ip-address-event)

Full Context

configure subscriber-mgmt diameter-application-policy gx report-ip-address-event

Description

This command enables triggered CCR-u messages based on IP address allocation or de-allocation for the subscriber host.

If the requests for both IP address families (IPv4 and IPv6) arrive at approximately the same time, a single CCR-i is sent containing the IP addresses from both address families, IPv4 and IPv6 (NA, PD, or SLAAC). When the requests for IP addresses are not nearly simultaneous, the CCR-i contains only the IP address that was allocated first (the one that triggered the session creation). The request for the second IP address family, depending on configuration, triggers an additional CCR-u that will carry the IP address allocation update to the PCRF along with the UE_IP_ADDRESS_ALLOCATE (18) event. The CCR-u content mirrors the content of the CCR-i with the exception of already allocated IP address(es).

When this command is disabled, IP address-triggered CCR-u messages are not sent.

The no form of this command disables the command.

Default

report-ip-address-event

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

report-local-routes

report-local-routes

Syntax

[no] report-local-routes

Context

[Tree] (config>bmp>station report-local-routes)

Full Context

configure bmp station report-local-routes

Description

This command enables local route reporting to the BMP monitoring station.

The no form of this command disables the local route reporting.

Platforms

All

report-path-constraints

report-path-constraints

Syntax

report-path-constraints

no report-path-constraints

Context

[Tree] (config>router>pcep>pcc report-path-constraints)

Full Context

configure router pcep pcc report-path-constraints

Description

This command enables the inclusion of LSP path constraints in the PCE report messages sent from the PCC to a PCE.

In order for the PCE to know about the original constraints for an LSP which is delegated, but for which there is no prior state in its LSP database, such as if no PCReq message was sent for the same PLSP-ID, the following proprietary behavior is observed:

  • PCC appends a duplicate of each of the LSPA, METRIC, and BANDWIDTH objects in the PCRpt message. The only difference between two objects of the same type is that the P-flag is set in the common header of the duplicate object to indicate that it is a mandatory object for processing by PCE.

  • The value of the metric or bandwidth in the duplicate object contains the original constraint value, while the first object contains the operational value. This is applicable to hop metrics in the METRIC and BANDWIDTH objects only. The SR OS PCC does not support configuring a boundary on the path computation IGP or TE metrics.

  • The path computation on the PCE must use the first set of objects when updating a path if the PCRpt contained a single set. If the PCRpt contained a duplicate set, PCE path computation must use the constraints in the duplicate set.

The no form of the command disables the above behavior in case of interoperability issues with third-party PCE implementations.

Default

report-path-constraints

Platforms

All

report-rate

report-rate

Syntax

report-rate agg-rate-limit

report-rate scheduler scheduler-name

report-rate pppoe-actual-rate

report-rate policer policer-id

report-rate rfc5515-actual-rate

no report-rate

Context

[Tree] (config>subscr-mgmt>sla-prof>egress report-rate)

[Tree] (config>subscr-mgmt>sla-prof>ingress report-rate)

Full Context

configure subscriber-mgmt sla-profile egress report-rate

configure subscriber-mgmt sla-profile ingress report-rate

Description

This command configures the source for Tx and Rx connect speeds in AVP 38 (Rx Connect Speed) and AVP 24 (Tx Connect Speed) of an L2TP session established on a LAC.

The no form of this command reverts to the default.

Parameters

agg-rate-limit

Specifies that the rate (egress only) is taken from:

  1. the agg-rate RADIUS override (RADIUS VSA "Alc-Subscriber-QoS-Override” in a RADIUS Access-Accept message) if present

  2. the configured agg-rate-limit in the config>subscr-mgmt>sub-prof>egr context

  3. fall back to the default (no report-rate)

scheduler-name

Specifies the rate taken from the scheduler scheduler-name up to 32 characters. If the scheduler scheduler-name is not present in the scheduler-policy configured in the config>subscr-mgmt>sub-prof>egr context, fall back to the default (no report-rate).

pppoe-actual-rate

Specifies rates taken from the DSL Line characteristics PPPoE tags (Actual Data Rate Upstream/Downstream) if present; otherwise fall back to the default (no report-rate).

policer-id

Specifies the rate taken from the policer with the specified ID.

Values

1 to 63

rfc5515-actual-rate

Puts the same value as the transmitted Actual-Data-Rate-Upstream AVP in the Rx-Connect-Speed AVP, and the same value as the transmitted Actual-Data-Rate-Downstream AVP in the Tx-Connect-Speed AVP

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

report-src-ip

report-src-ip

Syntax

report-src-ip ip-address

no report-src-ip

Context

[Tree] (config>service>vpls>igmp-snooping report-src-ip)

Full Context

configure service vpls igmp-snooping report-src-ip

Description

This command configures the source IPv4 address used when generating IGMP reports. According the IGMPv3 standard, a zero source address is allowed in sending IGMP reports. However, for interoperability with some multicast routers, the source IP address of IGMP group reports can be configured using this command.

Default

report-src-ip 0.0.0.0

Parameters

ip-address

Specifies the source IPv4 address in transmitted IGMP reports.

Values

a.b.c.d

Platforms

All

report-src-ip

Syntax

report-src-ip ipv6-address

no report-src-ip

Context

[Tree] (config>service>vpls>mld-snooping report-src-ip)

Full Context

configure service vpls mld-snooping report-src-ip

Description

This command configures the source IPv6 address used when generating MLD reports. A zero source address is allowed in sending MLD reports. However, for interoperability with some multicast routers, the source IP address of MLD reports can be configured using this command.

Default

report-src-ip 0:0:0:0:0:0:0:0

Parameters

ipv6-address

Specifies the source IPv6 address in transmitted MLD reports.

Values

x:x:x:x:x:x:x:x (eight 16-bit pieces)

Platforms

All

report-wlan-location

report-wlan-location

Syntax

[no] report-wlan-location

Context

[Tree] (config>subscr-mgmt>gtp>peer-profile report-wlan-location)

Full Context

configure subscriber-mgmt gtp peer-profile report-wlan-location

Description

This command enables reporting the WLAN location or cellular location of the UE in the signaling interface (S2a or Gn) between the WLAN GW and the mobile gateway (PGW or GGSN).

The no form of this command disables location reporting.

Default

no report-wlan-location

Platforms

7750 SR, 7750 SR-e, 7750 SR-s, VSR

reporting

reporting

Syntax

[no] reporting

Context

[Tree] (config>subscr-mgmt>diam-appl-plcy>gy>efh>interim-c reporting)

Full Context

configure subscriber-mgmt diameter-application-policy gy extended-failure-handling interim-credit reporting

Description

This command enables reporting of the used interim credit for each rating group when a new Diameter Gy session is successfully established with the Online Charging Server (OCS). When enabled, the used interim credit report includes:

  • the unreported used credit assigned via the initial Diameter Gy session when Extended Failure Handling (EFH) became active

  • the used interim credits during EFH

  • the used credits assigned via the new established Diameter Gy session

The no form of this command disables interim credit reporting. Only credit assigned via the new established Diameter Gy session is reported.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

reporting

Syntax

[no] reporting

Context

[Tree] (config>test-oam>link-meas>template reporting)

Full Context

configure test-oam link-measurement measurement-template reporting

Description

This command specifies whether values that reach a configured threshold are reported to the routing engine. Reaching a configured sample-window or aggregate-sample-window indicates a value of interest.

When this command is disabled, values reaching thresholds are not reported to the routing engine. In both enabled and disabled cases, the sample-window and aggregate-sample-window information and computed values are stored on the node until overwriting occurs.

Default

reporting

Platforms

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

request

request

Syntax

request seconds

Context

[Tree] (config>li>x-interfaces>x3>timeouts request)

[Tree] (config>li>x-interfaces>x2>timeouts request)

Full Context

configure li x-interfaces x3 timeouts request

configure li x-interfaces x2 timeouts request

Description

This command configures the X2 and X3 keep-alive timeout.

Parameters

seconds

Specifies the maximum time to wait for a LIC reply to a request. The system retries up to three more times, and if no reply is received, the system initiates a connection release and logs the failure event.

Values

5 to 30

Default

5

Platforms

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

request-format

request-format

Syntax

request-format

Context

[Tree] (config>system>security>tacplus request-format)

[Tree] (config>service>vprn>aaa>rmt-srv>tacplus request-format)

Full Context

configure system security tacplus request-format

configure service vprn aaa remote-servers tacplus request-format

Description

Commands in this context configure access operations that are sent to the TACACS+ server during authorization.

Platforms

All

request-script-policy

request-script-policy

Syntax

request-script-policy script-policy

no request-script-policy

Context

[Tree] (config>aaa>l2tp-accounting-policy request-script-policy)

[Tree] (config>aaa>radius-srv-plcy request-script-policy)

Full Context

configure aaa l2tp-accounting-policy request-script-policy

configure aaa radius-server-policy request-script-policy

Description

This command configures a RADIUS script policy to modify Access-Request.

The no form of this command removes the policy-name from the configuration.

Parameters

script-policy

Specifies the name of the Python script used to modify Access-Request messages.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

request-script-policy

Syntax

request-script-policy policy-name

no request-script-policy

Context

[Tree] (config>subscr-mgmt>auth-plcy request-script-policy)

Full Context

configure subscriber-mgmt authentication-policy request-script-policy

Description

This command configures the RADIUS script policy used to change the RADIUS attributes of the outgoing Access-Request messages.

The no form of this command removes the policy name from the configuration.

Parameters

policy-name

Specifies the name of the Python script to modify Access-Request messages.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

request-timer

request-timer

Syntax

request-timer timer1 retry-timer timer2 timeout-multiplier multiplier

no request-timer

Context

[Tree] (config>service>vpls>spoke-sdp>control-channel-status request-timer)

[Tree] (config>service>epipe>spoke-sdp>control-channel-status request-timer)

[Tree] (config>service>cpipe>spoke-sdp>control-channel-status request-timer)

Full Context

configure service vpls spoke-sdp control-channel-status request-timer

configure service epipe spoke-sdp control-channel-status request-timer

configure service cpipe spoke-sdp control-channel-status request-timer

Description

This command configures the control channel status request mechanism. When it is configured, control channel status request procedures are used. These augment the procedures for control channel status messaging from RFC 6478. This command cannot be used with a non-zero refresh-timer value.

Parameters

timer1

Specifies the interval, in seconds, at which pseudowire status messages, including a reliable delivery TLV with the "request” bit set, are sent.

Values

10 to 65535

timer2

specifies the timeout interval, in seconds, if no response to a pseudowire status request is received. This parameter must be configured. A value of zero (0) disables retries.

Values

0, 3 to 60

multiplier

If a requesting node does not receive a valid response to a pseudowire status request within a number of seconds equal to the retry timer multiplied by this multiplier, then it will assume the pseudowire is down. This parameter is optional.

Values

3 to 20

Platforms

All

  • configure service vpls spoke-sdp control-channel-status request-timer
  • configure service epipe spoke-sdp control-channel-status request-timer

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

  • configure service cpipe spoke-sdp control-channel-status request-timer

request-timer

Syntax

request-timer request-timer-secs retry-timer retry-timer-secs timeout-multiplier multiplier

no request-timer

Context

[Tree] (config>service>vpls>spoke-sdp>control-channel-status request-timer)

Full Context

configure service vpls spoke-sdp control-channel-status request-timer

Description

This command configures the control channel status request mechanism. When it is configured, control channel status request procedures are used. These augment the procedures for control channel status messaging from RFC 6478, Pseudowire Status for Static Pseudowires. This command cannot be used with a non-zero refresh-timer value.

Parameters

request-timer-secs

Specifies the interval, in seconds, at which pseudowire status messages, including a reliable delivery TLV with the "request” bit set, are sent.

Values

10 to 65535

retry-timer-secs

specifies the timeout interval, in seconds, if no response to a pseudowire status request is received. This parameter must be configured. A value of zero (0) disables retries.

Values

0, 3 to 60

multiplier

If a requesting node does not receive a valid response to a pseudowire status request within a number of seconds equal to the retry timer multiplied by this multiplier, then it will assume the pseudowire is down. This parameter is optional.

Values

3 to 20

Platforms

All

request-timer

Syntax

request-timer timer1 retry-timer timer2 timeout-multiplier multiplier

no request-timer

Context

[Tree] (config>service>ies>if>spoke-sdp>control-channel-status request-timer)

Full Context

configure service ies interface spoke-sdp control-channel-status request-timer

Description

This command configures the control channel status request mechanism. When it is configured, control channel status request procedures are used. These augment the procedures for control channel status messaging from RFC 6478. This command is mutually exclusive with a non-zero refresh-timer value.

Parameters

timer1

Specifies the interval at which pseudowire status messages, including a reliable delivery TLV, with the "request” bit set, are sent.

Values

10 to 65535 seconds

retry-timer timer2

Specifies the timeout interval if no response to a pseudowire status request is received. This parameter must be configured. A value of zero (0) disables retries.

Values

0, 3 to 60 seconds

timeout-multiplier multiplier

If a requesting node does not receive a valid response to a pseudowire status request within this multiplier times the retry timer, then it will assume the pseudowire is down. This parameter is optional.

Values

3 to 20 seconds

Platforms

All

request-timer

Syntax

request-timer request-timer-secs retry-timer retry-timer-secs timeout-multiplier multiplier

no request-timer

Context

[Tree] (config>service>vprn>red-if>spoke-sdp>control-channel-status request-timer)

[Tree] (config>service>vprn>if>spoke-sdp>control-channel-status request-timer)

Full Context

configure service vprn redundant-interface spoke-sdp control-channel-status request-timer

configure service vprn interface spoke-sdp control-channel-status request-timer

Description

This command configures the control channel status request mechanism. When it is configured, control channel status request procedures are used. These augment the procedures for control channel status messaging from RFC 6478. This command is mutually exclusive with a non-zero refresh-timer value.

Parameters

request-timer-secs

Specifies the interval, in seconds, at which pseudowire status messages, including a reliable delivery TLV, with the "request” bit set, are sent.

Values

10 to 65535

retry-timer retry-timer-secs

Specifies the timeout interval, in seconds, if no response to a pseudowire status request is received. This parameter must be configured. A value of zero (0) disables retries.

Values

0, 3 to 60

timeout-multiplier multiplier

Specifies the multiplier, in seconds. If a requesting node does not receive a valid response to a pseudowire status request within this multiplier times the retry timer, then it assume the pseudowire is down. This parameter is optional.

Values

3 to 15

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

  • configure service vprn redundant-interface spoke-sdp control-channel-status request-timer

All

  • configure service vprn interface spoke-sdp control-channel-status request-timer

request-timer

Syntax

request-timer request-timer-secs retry-timer retry-timer-secs timeout-multiplier multiplier

no request-timer

Context

[Tree] (config>mirror>mirror-dest>remote-src>spoke-sdp>control-channel-status request-timer)

[Tree] (config>mirror>mirror-dest>spoke-sdp>control-channel-status request-timer)

Full Context

configure mirror mirror-dest remote-source spoke-sdp control-channel-status request-timer

configure mirror mirror-dest spoke-sdp control-channel-status request-timer

Description

This command configures the control channel status request mechanism. When it is configured, control channel status request procedures are used. These augment the procedures for control channel status messaging from RFC 6478. This command is mutually exclusive with a non-zero refresh-timer value.

Parameters

request-timer-secs

Specifies the interval, in seconds, at which pseudowire status messages, including a reliable delivery TLV, with the "request” bit set, are sent.

Values

10 to 65535

retry-timer-secs

Specifies the timeout interval, in seconds, if no response to a pseudowire status request is received. This parameter must be configured. A value of zero (0) disables retries.

Values

3 to 60

multiplier

Specifies the multiplier, in seconds, that if a requesting node does not receive a valid response to a pseudowire status request within this multiplier times the retry timer, then it will assume the pseudowire is down. This parameter is optional.

Values

3 to 15

Platforms

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

requests

requests

Syntax

[no] requests [neighbor ip-int-name | ip-address]

Context

[Tree] (debug>router>rip requests)

Full Context

debug router rip requests

Description

This command enables debugging for RIP requests.

Parameters

ip-int-name | ip-address

Debugs the RIP requests sent on the neighbor IP address or interface.

Platforms

All

requests

Syntax

[no] requests [neighbor ip-int-name | ipv6-address]

Context

[Tree] (debug>router>ripng requests)

Full Context

debug router ripng requests

Description

This command enables debugging for RIP requests.

Parameters

ip-int-name| ipv6-address

Debugs the RIP requests sent on the neighbor IP address or interface.

Platforms

All

required

required

Syntax

required [lowercase count] [uppercase count] [numeric count] [special-character count]

no required

Context

[Tree] (config>system>security>password>complexity-rules required)

Full Context

configure system security password complexity-rules required

Description

Force the minimum number of different character classes required.

The no form of this command resets to default.

Default

required lowercase 0 uppercase 0 numeric 0 special-character 0

Parameters

count

Specifies the minimum count of characters classes.

Values

0 to 10

Platforms

All

rescue-location

rescue-location

Syntax

rescue-location file-url

no rescue-location

Context

[Tree] (config>system>rollback rescue-location)

Full Context

configure system rollback rescue-location

Description

The location and filename of the rescue configuration is configurable to be local (on compact flash) or remote. The suffix .rc will be automatically appended to the filename when a rescue configuration file is saved. Trivial FTP (TFTP) is not supported for remote locations.

Default

no rescue location

Parameters

file-url

Specifies the URL or filename.

Values

local-url | remote-url

local-url

[cflash-id/][file-path] up to 200 characters, including cflash-id directory length of up to 99 characters each

remote-url

[{ftp://}login:pswd@ remote-locn/][file-path] up to 255 characters, directory length of up to 99 characters each

remote-locn

[hostname | ipv4-address | ipv6-address]

ipv4-address

a.b.c.d

ipv6-address

x:x:x:x:x:x:x:x[-interface]

x:x:x:x:x:x:d.d.d.d[-interface]

x - [0 to FFFF]H

d - [0 to 255]D

interface - 32 chars max, for link local addresses

cflash-id

cf1:, cf1-A:, cf1-B:, cf2:, cf2-A:, cf2-B:, cf3:, cf3-A:, cf3-B:

rescue filename

suffixed with .rc during the rescue file creation

Platforms

All

reserved

reserved

Syntax

reserved num-sessions

no reserved

Context

[Tree] (config>isa>nat-group>session-limits reserved)

Full Context

configure isa nat-group session-limits reserved

Description

This command configures the number of sessions per block that are reserved for prioritized sessions.

Default

no reserved

Parameters

num-sessions

Specifies the number of sessions reserved for prioritized sessions.

Values

0 to 6291456

Platforms

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

reserved

Syntax

reserved num-sessions

no reserved

Context

[Tree] (config>service>nat>nat-policy>session-limits reserved)

[Tree] (config>service>nat>firewall-policy>session-limits reserved)

[Tree] (config>service>nat>up-nat-policy>session-limits reserved)

Full Context

configure service nat nat-policy session-limits reserved

configure service nat firewall-policy session-limits reserved

configure service nat up-nat-policy session-limits reserved

Description

This command configures the number of sessions per block that will be reserved for prioritized sessions.

Default

no reserved

Parameters

num-sessions

Specifies the number of sessions reserved for prioritized sessions.

Values

0 to 65534

Platforms

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

  • configure service nat up-nat-policy session-limits reserved
  • configure service nat nat-policy session-limits reserved

7750 SR, 7750 SR-e, 7750 SR-s, VSR

  • configure service nat firewall-policy session-limits reserved

reserved

Syntax

reserved num-ports

no reserved

Context

[Tree] (config>service>nat>up-nat-policy>port-limits reserved)

[Tree] (config>service>nat>nat-policy>port-limits reserved)

Full Context

configure service nat up-nat-policy port-limits reserved

configure service nat nat-policy port-limits reserved

Description

This command configures the number of ports per block that will be reserved for prioritized sessions.

Default

no reserved

Parameters

num-ports

Specifies the number of ports to reserve for prioritized sessions.

Values

1 to 65534

Platforms

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

reserved-label-block

reserved-label-block

Syntax

[no] reserved-label-block name

Context

[Tree] (config>router>mpls-labels reserved-label-block)

Full Context

configure router mpls-labels reserved-label-block

Description

Commands in this context configure a block of labels from the dynamic range to be locally assigned for specific applications, such as Segment Routing adjacency SIDs. The reserved label block is not advertised by the IGP.

The no form of this command removes a reserved label block.

Parameters

name

Specifies the name of the reserved label block, up to 64 characters

Platforms

All

reserved-label-block

Syntax

reserved-label-block name

no reserved-label-block

Context

[Tree] (config>router>rib-api>mpls reserved-label-block)

Full Context

configure router rib-api mpls reserved-label-block

Description

This command specifies the reserved label block for use in all label-FIB entries programmed using the RIB-API gRPC service. The named reserved label block must already have been configured under config>router>mpls>mpls-labels.

The no form of this command removes the assignment of the reserved label block, causing all existing label-FIB entry programming, using the RIB-API gRPC service, to become invalid and unusable.

Default

no reserved-label-block

Parameters

name

Specifies the name of the reserved label block up to 64 characters in length.

Platforms

All

reserved-label-block

Syntax

reserved-label-block name

no reserved-label-block

Context

[Tree] (config>router>mpls>fwd-policies reserved-label-block)

Full Context

configure router mpls forwarding-policies reserved-label-block

Description

This command specifies the reserved label block to use for all MPLS forwarding policies. The named reserved label block must already have been configured under config>router>mpls-labels.

The no form of the command removes the assignment of the reserved label block.

Parameters

name

Specifies the name of the reserved label block, up to 64 characters.

Platforms

All

reserved-label-block

Syntax

reserved-label-block name

no reserved-label-block

Context

[Tree] (config>router>segment-routing>sr-policies reserved-label-block)

Full Context

configure router segment-routing sr-policies reserved-label-block

Description

This command associates a reserved label block with segment routing policies. The name must already exist. Reserved label blocks are configured under the config>router>mpls-labels hierarchy.

A locally-targeted segment routing policy (statically configured or BGP signaled) cannot be activated if its binding SID (BSID) is not an available label between the start-label and end-label of the referenced reserved label block.

The no form of this command removes any association of segment routing policies with a reserved label block.

Default

no reserved-label-block

Parameters

name

Specifies the name of a reserved-label-block that has already been configured, up to 64 characters.

Platforms

All

reserved-label-block

Syntax

[no] reserved-label-block name

Context

[Tree] (config>anysec reserved-label-block)

Full Context

configure anysec reserved-label-block

Description

This command assigns the label block that is reserved for ANYsec encryption SID under the configure router mpls-labels context. Without this reserved block, ANYsec cannot assign any encryption SIDs. The encryption SID uniquely identifies the encrypting node within a network and avoids double encryption scenarios. The encryption SID can be assigned per encryption group. However, all encryption groups can have the same encryption SID.

To save label space, Nokia recommends limiting the number of encryption SIDs within a network.

The no form of this command removes a reserved label block.

Parameters

name

Specifies the name of the reserved label block.

Platforms

7750 SR-1-24D, 7750 SR-1-46S, 7750 SR-1-48D, 7750 SR-1-92S, 7750 SR-1x-48D, 7750 SR-1x-92S, 7750 SR-1se

reserved-lbl-block

reserved-lbl-block

Syntax

reserved-lbl-block reserved-lbl-block

no reserved-lbl-block

Context

[Tree] (config>router>p2mp-sr-tree reserved-lbl-block)

Full Context

configure router p2mp-sr-tree reserved-lbl-block

Description

This command configures the reserved label block name for the P2MP SR tree. Before configuring for the P2MP SR tree, the reserved label block name must be configured on the root node of the P2MP policy in the config>router>mpls-labels context.

The no form of this command removes the reserved label block name for the P2MP SR tree.

Default

no reserved-lbl-block

Parameters

reserved-lbl-block

Specifies the value of the reserved label block name, up to 64 characters.

Platforms

All

reserved-non-shaper-queues

reserved-non-shaper-queues

Syntax

reserved-non-shaper-queues range

Context

[Tree] (config>qos>fp-resource-policy>aggregate-shapers reserved-non-shaper-queues)

Full Context

configure qos fp-resource-policy aggregate-shapers reserved-non-shaper-queues

Description

This command configures the number of egress queues which will not be used by hardware aggregate shapers.

Parameters

range

Specifies the number of queues which will not be used by hardware aggregate shapers

Values

2048 to 262144

Default

8192

Platforms

7750 SR-1, 7750 SR-s

reserved-pool-in-use

reserved-pool-in-use

Syntax

reserved-pool-in-use percentage

no reserved-pool-in-use

Context

[Tree] (config>card>fp>ingress>network>pool>monitor-depth>alarm reserved-pool-in-use)

[Tree] (config>port>access>ingress>pool>monitor-depth>alarm reserved-pool-in-use)

[Tree] (config>port>network>egress>pool>monitor-depth>alarm reserved-pool-in-use)

[Tree] (config>port>access>egress>pool>monitor-depth>alarm reserved-pool-in-use)

Full Context

configure card fp ingress network pool monitor-pool-depth alarm-thresholds reserved-pool-in-use

configure port access ingress pool monitor-pool-depth alarm-thresholds reserved-pool-in-use

configure port network egress pool monitor-pool-depth alarm-thresholds reserved-pool-in-use

configure port access egress pool monitor-pool-depth alarm-thresholds reserved-pool-in-use

Description

This command configures the threshold for the reserved pool in use.

A tmnxResvPoolUseThreshExcd trap is generated when the reserved pool usage exceeds this threshold percentage. When the usage returns below the threshold percentage, the tmnxResvPoolUseThreshNotExcd trap is generated.

The no form of this command removes the threshold on which to alarm.

Default

no reserved-pool-in-use

Parameters

percentage

Specifies the reserved pool in-use alarm threshold.

Values

0.01 to 100.00

Platforms

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

reset-on-recoverable-error

reset-on-recoverable-error

Syntax

[no] reset-on-recoverable-error

Context

[Tree] (config>card reset-on-recoverable-error)

Full Context

configure card reset-on-recoverable-error

Description

This command configures the behavior of the card when a fatal memory parity error is detected on a Q-chip of the card. If reset-on-recoverable-error is enabled, the card is reset, regardless of the setting of the fail-on-error parameter.

The no form of this command specifies that the recovery action is taken instead of resetting the card.

Default

no reset-on-recoverable-error

Platforms

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

reset-on-recoverable-error

Syntax

[no] reset-on-recoverable-error

Context

[Tree] (config>card>mda reset-on-recoverable-error)

Full Context

configure card mda reset-on-recoverable-error

Description

This command configures the behavior of the MDA when a fatal memory parity error is detected on a Q-chip of the MDA. If reset-on-recoverable-error is enabled, the MDA is reset, regardless of the setting of the fail-on-error parameter.

The no form of this command specifies that the recovery action is taken instead of resetting the MDA.

Default

no reset-on-recoverable-error

Platforms

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

reset-on-recoverable-error

Syntax

[no] reset-on-recoverable-error

Context

[Tree] (config>card>xiom reset-on-recoverable-error)

Full Context

configure card xiom reset-on-recoverable-error

Description

This command configures the behavior of the XIOM when a fatal memory parity error is detected on a Q-chip of the XIOM. If reset-on-recoverable-error is enabled, the XIOM is reset, regardless of the setting of the fail-on-error parameter.

The no form of this command specifies that the recovery action is taken instead of resetting the XIOM.

Default

no reset-on-recoverable-error

Platforms

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

reset-policy-exclusive

reset-policy-exclusive

Syntax

reset-policy-exclusive

Context

[Tree] (admin reset-policy-exclusive)

Full Context

admin reset-policy-exclusive

Description

This command allows an authorized administrator to reset the exclusive policy editing lock. This will reset the lock flag and end the policy editing session in progress, discarding any policy edits.

Platforms

All

reset-query

reset-query

Syntax

[no] reset-query

Context

[Tree] (debug>router>rpki-session>packet reset-query)

Full Context

debug router rpki-session packet reset-query

Description

This command enables debugging for reset query RPKI packets.

The no form of this command disables debugging for reset query RPKI packets.

Platforms

All

reset-unknown-tcp

reset-unknown-tcp

Syntax

[no] reset-unknown-tcp

Context

[Tree] (config>service>nat>nat-policy reset-unknown-tcp)

[Tree] (config>service>nat>up-nat-policy reset-unknown-tcp)

Full Context

configure service nat nat-policy reset-unknown-tcp

configure service nat up-nat-policy reset-unknown-tcp

Description

This command enables the system to drop a TCP packet and generate a TCP reset, when a TCP packet without the SYN flag set is received by the NAT inside for an unknown flow.

The no form of this command disables sending the reset, but the packet is still dropped.

Default

no reset-unknown-tcp

Platforms

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

resignal-on-igp-event

resignal-on-igp-event

Syntax

[no] resignal-on-igp-event

Context

[Tree] (config>router>mpls>sr-te-resignal resignal-on-igp-event)

Full Context

configure router mpls sr-te-resignal resignal-on-igp-event

Description

This command enables the ad hoc reoptimzation of all CSPF paths in the operational UP state of all SR-TE LSPs at the receipt of an IGP link event. The following link events are supported:

  • link down
  • link up
  • IGP or TE metric change
  • SRLG change
  • admin group change

The ad hoc reoptimization follows the same behavior as in the timer-based resignal Make-Before-Break (MBB) feature. MPLS reevaluates all the paths in operational UP state of all SR-TE LSPs. The reevaluation consists of updating the total IGP or TE metric of the current path, checking the validity of the hops and labels, and computing a new CSPF path. MPLS programs the new path only if its total metric is different than the updated metric of the current path, or if one or more hops or labels of the current path are invalid. Otherwise, the current path is considered to be the most optimal and retained.

This feature does not require that the timer-based resignal (configure router mpls sr-te-resignal resignal-timer) command be enabled. If enabled, the resignal timer is aborted and an ad hoc reoptimization is performed.

The no form of this command disables ad hoc reoptimization of SR-TE LSPs.

Default

no resignal-on-igp-event

Platforms

All

resignal-on-igp-event

Syntax

[no] resignal-on-igp-event

Context

[Tree] (config>router>mpls resignal-on-igp-event)

Full Context

configure router mpls resignal-on-igp-event

Description

This command enables the ad hoc reoptimization of the active CSPF path of all RSVP-TE LSPs at the receipt of an IGP link event. The following link events are supported:

  • link down
  • link up
  • IGP or TE metric change
  • SRLG change
  • admin group change

The ad hoc reoptimization follows the same behavior as in the timer-based resignal Make-Before-Break (MBB) feature. MPLS reevaluates the active paths of all RSVP-TE LSPs. The reevaluation consists of updating the total IGP or TE metric of the current path, checking the validity of the hops, and computing a new CSPF path. MPLS signals and programs the new path only if its total metric is different than the updated metric of the current path, or if one or more hops of the current path are invalid. Otherwise, the current path is considered to be the most optimal and retained.

This feature does not require that the timer-based resignal (configure router mpls resignal-timer) command be enabled. If enabled, the resignal timer is aborted and an ad hoc reoptimization is performed.

The no form of this command disables ad hoc reoptimization of the active RSVP-TE LSPs.

Default

no resignal-on-igp-event

Platforms

All

resignal-on-igp-overload

resignal-on-igp-overload

Syntax

[no] resignal-on-igp-overload

Context

[Tree] (config>router>mpls resignal-on-igp-overload)

Full Context

configure router mpls resignal-on-igp-overload

Description

This command enables the resignaling of all RSVP-TE LSPs at the receipt of the IS-IS overload bit in the TE-DB.

Once the re-optimization is triggered, the behavior is the same as the timer-based resignal or the delay option of the manual-based resignal. MPLS forces the expiry of the resignal timer and requests the TE-DB to compute a new CSPF for each RSVP-TE LSP active path.

This re-optimization effectively causes the immediate move of transit RSVP-TE LSP paths away from the IS-IS node in overload.

By default, MPLS re-optimizes, using the MBB procedure, the transit paths away from the node in an IS-IS overload state only at the time a manual or timer-based resignal is performed for the LSP paths. MPLS does not act immediately on the receipt of the IS-IS overload bit.

Note:

This command and the retry-on-overload command are mutually exclusive.

The no form of this command results in the MPLS not acting immediately to the request of the IS-IS overload bit.

Default

no resignal-on-overload

Platforms

All

resignal-on-igp-overload

Syntax

[no] resignal-on-igp-overload

Context

[Tree] (config>router>mpls>sr-te-resignal resignal-on-igp-overload)

Full Context

configure router mpls sr-te-resignal resignal-on-igp-overload

Description

This command enables the ad-hoc re-optimzation of the CSPF paths of all SR-TE LSPs when IS-IS receives an IS-IS overload bit advertisement from a remote router.

When this command is enabled on the router and an IGP overload bit is set in a Layer 1 or Layer 2 IS-IS LSP received from a remote router, MPLS performs an ad-hoc re-optimization of all the paths of all the SR-TE LSPs that have paths computed by the local CSPF. For each SR-TE LSP current path that transits the router in overload, the CSPF looks for a new path that avoids the router. For each SR-TE LSP current path that terminates on the router in overload, the CSPF checks if a better path exists. In both cases, if a new path is not found the system maintains the current path when operationally up.

The ad-hoc re-optimization triggers the timer-based re-optimization by forcing the resignal timer to expire. Therefore, the user must use the following command to configure the resignal timer for the SR-TE application.
configure router mpls sr-te-resignal resignal-timer

The no form of this command configures MPLS to not act immediately on an IS-IS overload bit from a remote router. MPLS will act on it at the next timer-based or manual re-optimization of the SR-TE LSPs.

Default

no resignal-on-igp-overload

Platforms

All

resignal-timer

resignal-timer

Syntax

resignal-timer minutes

no resignal-timer

Context

[Tree] (config>router>mpls resignal-timer)

Full Context

configure router mpls resignal-timer

Description

This command specifies the value for the LSP resignal timer. The resignal timer is the time, in minutes, the software waits before attempting to resignal the LSPs.

When the resignal timer expires, if the new computed path for an LSP has a better metric than the current recorded hop list, an attempt is made to resignal that LSP using the make-before-break mechanism. If the attempt to resignal an LSP fails, the LSP continues to use the existing path and a resignal will be attempted the next time the timer expires.

The no form of this command disables timer-based LSP resignaling.

Default

no resignal-timer

Parameters

minutes

Specifies the time the software waits before attempting to resignal the LSPs.

Values

30 to 10080

Platforms

All

resignal-timer

Syntax

resignal-timer minutes

no resignal-timer

Context

[Tree] (config>router>mpls>sr-te-resignal resignal-timer)

Full Context

configure router mpls sr-te-resignal resignal-timer

Description

This command specifies the value for the SR-TE LSP resignal timer when the path computation method is set to the local CSPF or the PCE.

The resignal timer is the time, in minutes, MPLS waits before attempting to re-optimize all paths of all SR-TE LSPs. The re-optimization is performed by the local CSPF or the PCE, depending on the value of the parameter path-computation-method.

When local CSPF is used and the resignal timer expires, MPLS provides the current path of the SR-TE LSP and TE-DB updates the total IGP or TE metric of the current path and checks the validity of the hops and labels. CSPF then computes a new path for each SR-TE LSP. MPLS programs the new path only if the total metric of the new computed path is different than the updated metric of the current path, or if one or more hops or labels of the current path are invalid. Otherwise, the current path is considered to be one of the most optimal ECMP paths and is not updated in data path.

The no form of this command disables timer-based LSP resignaling.

Default

no resignal-timer

Parameters

minutes

Specifies the time, in minutes, the software waits before attempting to resignal the SR-TE LSPs.

Values

30 to 10080

Platforms

All

resolution

resolution

Syntax

resolution {route-table | tunnel-table | fallback-tunnel-to-route-table}

Context

[Tree] (config>service>vpls>bgp-evpn>srv6 resolution)

[Tree] (config>service>vprn>bgp-ipvpn>srv6 resolution)

[Tree] (config>service>vprn>bgp-evpn>srv6 resolution)

[Tree] (config>router>bgp>srv6>family resolution)

[Tree] (config>service>epipe>bgp-evpn>srv6 resolution)

Full Context

configure service vpls bgp-evpn segment-routing-v6 resolution

configure service vprn bgp-ipvpn segment-routing-v6 resolution

configure service vprn bgp-evpn segment-routing-v6 resolution

configure router bgp segment-routing-v6 family resolution

configure service epipe bgp-evpn segment-routing-v6 resolution

Description

This command configures the resolution option for routes in the specified family.

The no form of the command reverts to the default.

Default

resolution route-table

Parameters

route-table

Keyword that specifies to resolve the route to the shortest-path SRv6 tunnel. If no such shortest-path tunnel is found, the resolution fails.

tunnel-table

Keyword that specifies to resolve the route directly to a tunnel in TTMv6. The system tries to find an SRv6 policy with a matching color and endpoint for BGP routes received with an SRv6 TLV and containing an SRv6 service SID in the IPv6 tunnel table. If none is found, the resolution fails.

fallback-tunnel-to-route-table

Keyword that specifies to first try resolving the route to a tunnel in the IPv6 tunnel table. If none is found in the IPv6 tunnel table, fall back to the shortest-path SRv6 resolution. If no such shortest-path tunnel is found in RTM, the resolution fails.

Platforms

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

resolution

Syntax

resolution {disabled | any | filter}

Context

[Tree] (config>service>vprn>bgp-evpn>mpls>auto-bind-tunnel resolution)

[Tree] (config>service>epipe>bgp-evpn>mpls>auto-bind-tunnel resolution)

[Tree] (config>service>vprn>bgp-ipvpn>mpls>auto-bind-tunnel resolution)

[Tree] (config>service>vpls>bgp-evpn>mpls>auto-bind-tunnel resolution)

Full Context

configure service vprn bgp-evpn mpls auto-bind-tunnel resolution

configure service epipe bgp-evpn mpls auto-bind-tunnel resolution

configure service vprn bgp-ipvpn mpls auto-bind-tunnel resolution

configure service vpls bgp-evpn mpls auto-bind-tunnel resolution

Description

This command configures the resolution mode in the automatic binding of a BGP-EVPN or BGP-IPVPN MPLS service to tunnels to MP-BGP peers.

Default

resolution disabled

Parameters

any

Enables the binding to any supported tunnel type in a BGP-EVPN or BGP-IPVPN MPLS context following TTM preference.

disabled

Disables the automatic binding of a BGP-EVPN or BGP-IPVPN MPLS service to tunnels to MP-BGP peers.

filter

Enables the binding to the subset of tunnel types configured the resolution-filter context.

Platforms

All

resolution

Syntax

resolution {any | disabled | filter}

Context

[Tree] (config>router>static-route-entry>indirect>tunnel-next-hop resolution)

Full Context

configure router static-route-entry indirect tunnel-next-hop resolution

Description

This command determines the resolution mode for the associated static route to a tunnel next hop.

Default

resolution any

Parameters

any

Allows the associated static route to be resolved to any active entry in the TTM, following the TTM preference order.

disabled

Disables the resolution of the associated static route to any active entry in the TTM. As a result, the static route can only be resolved via IP RTM resolution of the static route's next hop.

filter

Allows the associated static route to be resolved to active tunnels in the TTM using the resolution-filter restrictions.

Platforms

All

resolution

Syntax

resolution {any | filter | disabled}

Context

[Tree] (config>router>bgp>next-hop-resolution>labeled-routes>transport-tunnel>family resolution)

Full Context

configure router bgp next-hop-resolution labeled-routes transport-tunnel family resolution

Description

This command configures the resolution mode in the resolution of BGP label routes using tunnels to BGP peers.

Parameters

any

Enables the binding to any supported tunnel type in the BGP label route context following TTM preference.

filter

Enables the binding to the subset of tunnel types configured under resolution-filter.

disabled

Disables the resolution of BGP label routes using tunnels to BGP peers.

Platforms

All

resolution

Syntax

resolution {any | filter | disabled}

Context

[Tree] (config>router>bgp>next-hop-res>shortcut-tunn>family resolution)

Full Context

configure router bgp next-hop-resolution shortcut-tunnel family resolution

Description

This command configures the resolution mode in the resolution of BGP prefixes using tunnels to BGP peers.

Parameters

any

Enables the binding to any supported tunnel type in BGP shortcut context following TTM preference.

filter

Enables the binding to the subset of tunnel types configured under resolution-filter.

disabled

Disables the resolution of BGP prefixes using tunnels to BGP peers.

Platforms

All

resolution

Syntax

resolution {any | disabled | filter | match-family-ip}

Context

[Tree] (config>router>isis>igp-shortcut>tunnel-next-hop>family resolution)

Full Context

configure router isis igp-shortcut tunnel-next-hop family resolution

Description

This command configures resolution mode in the resolution of the IP prefix or SR tunnel family using IGP shortcuts.

Parameters

any

Enables the binding to any supported tunnel type following TTM preference.

disabled

Disables the resolution of the IP prefix or SR tunnel family using IGP shortcuts.

filter

Enables the binding to the subset of tunnel types configured under resolution-filter.

match-family-ip

Enables the resolution of the SR tunnel family to match that of the corresponding IP prefix family.

Platforms

All

resolution

Syntax

resolution {any | disabled | filter | match-family-ip}

Context

[Tree] (config>router>ospf>igp-shortcut>tunnel-next-hop>family resolution)

Full Context

configure router ospf igp-shortcut tunnel-next-hop family resolution

Description

This command configures resolution mode in the resolution of the IP prefix or SR tunnel family using IGP shortcuts.

Parameters

any

Enables the binding to any supported tunnel type following TTM preference.

disabled

Disables the resolution of the IP prefix or SR tunnel family using IGP shortcuts.

filter

Enables the binding to the subset of tunnel types configured under resolution-filter.

match-family-ip

Enables the resolution of the SR tunnel family to match that of the corresponding IP prefix family.

Platforms

All

resolution

Syntax

resolution {any | disabled | filter}

Context

[Tree] (config>router>ospf3>igp-shortcut>tunnel-next-hop>family resolution)

Full Context

configure router ospf3 igp-shortcut tunnel-next-hop family resolution

Description

This command configures resolution mode in the resolution of the IPv6 prefix using IGP shortcuts.

Parameters

any

Enables the binding to any supported tunnel type following TTM preference.

disabled

Disables the resolution of the IPv6 prefix using IGP shortcuts.

filter

Enables the binding to the subset of tunnel types configured under resolution-filter.

Platforms

All

resolution

Syntax

resolution {any | disabled | filter}

Context

[Tree] (config>service>vprn>auto-bind-tunnel resolution)

Full Context

configure service vprn auto-bind-tunnel resolution

Description

This command configures the resolution method for tunnel selection.

Default

resolution any

Parameters

any

Allows the associated static route to be resolved to any active entry in the TTM, following the TTM preference order.

disabled

Disables the associated static route to be resolved to any active entry in the TTM. As a result, the static route can only be resolved via IP RTM resolution of the static route's nexthop.

filter

Allows the associated static route to be resolved to active tunnels in the TTM using the resolution-filter restrictions.

Platforms

All

resolution

Syntax

resolution

Context

[Tree] (config>service>vprn>auto-bind-tunnel resolution)

Full Context

configure service vprn auto-bind-tunnel resolution

Description

Note: This command is no longer supported and will be removed in a future release.

Platforms

All

resolution-filter

resolution-filter

Syntax

resolution-filter

Context

[Tree] (config>service>vpls>bgp-evpn>mpls>auto-bind-tunnel resolution-filter)

[Tree] (config>service>vprn>bgp-evpn>mpls>auto-bind-tunnel resolution-filter)

[Tree] (config>service>vprn>bgp-ipvpn>mpls>auto-bind-tunnel resolution-filter)

[Tree] (config>service>epipe>bgp-evpn>mpls>auto-bind-tunnel resolution-filter)

Full Context

configure service vpls bgp-evpn mpls auto-bind-tunnel resolution-filter

configure service vprn bgp-evpn mpls auto-bind-tunnel resolution-filter

configure service vprn bgp-ipvpn mpls auto-bind-tunnel resolution-filter

configure service epipe bgp-evpn mpls auto-bind-tunnel resolution-filter

Description

Commands in this context configure the subset of tunnel types that can be used in the resolution of BGP-EVPN or BGP-IPVPN routes within the automatic binding of BGP-EVPN or BGP-IPVPN MPLS service to tunnels to MP-BGP peers.

The following tunnel types are supported in a BGP-EVPN or BGP-IPVPN MPLS context: BGP, LDP, RIB-API, RSVP, SR-ISIS, SR-OSPF, SR-policy, SR-TE, UDP, and MPLS forwarding policy.

The user must set resolution to filter to activate the list of tunnel-types configured under resolution-filter.

Note:

UDP tunnels are created through import policies with action create-udp-tunnel.

Platforms

All

resolution-filter

Syntax

resolution-filter

Context

[Tree] (config>router>static-route-entry>indirect>tunnel-next-hop resolution-filter)

Full Context

configure router static-route-entry indirect tunnel-next-hop resolution-filter

Description

This command creates the context to configure the tunnel next-hop resolution options.

If one or more tunnel filter criteria are specified, the static route nexthop is resolved to an available tunnel from one of those LSP types. The tunnel type is selected based on the TTM preference.

Platforms

All

resolution-filter

Syntax

resolution-filter

Context

[Tree] (config>router>bgp>next-hop-resolution>labeled-routes>transport-tunnel>family resolution-filter)

Full Context

configure router bgp next-hop-resolution labeled-routes transport-tunnel family resolution-filter

Description

Commands in this context set resolution filter types.

Platforms

All

resolution-filter

Syntax

resolution-filter [bgp] [ldp] [rsvp] [sr-isis] [sr-ospf] [sr-policy] [sr-te]

Context

[Tree] (config>router>bgp>next-hop-res>shortcut-tunn>family resolution-filter)

Full Context

configure router bgp next-hop-resolution shortcut-tunnel family resolution-filter

Description

This command configures the subset of tunnel types that can be used to resolve BGP unlabeled routes.

Parameters

bgp

Selects the BGP label route tunnel type.

ldp

Selects the LDP tunnel type.

rsvp

Selects the RSVP-TE tunnel type.

sr-isis

Selects the SR tunnel type programmed by an IS-IS instance in TTM.

sr-ospf

Selects the SR tunnel type programmed by an OSPF instance in TTM.

sr-policy

Selects the SR tunnel type programmed by an SR policy instance in TTM.

sr-te

Selects the SR tunnel type programmed by a TE instance in TTM.

Platforms

All

resolution-filter

Syntax

resolution-filter

Context

[Tree] (config>router>isis>igp-shortcut>tunnel-next-hop>family resolution-filter)

Full Context

configure router isis igp-shortcut tunnel-next-hop family resolution-filter

Description

Commands in this context configure the subset of tunnel types which can be used in the resolution of the IP prefix or SR tunnel family using IGP shortcuts.

Parameters

rsvp

Selects the RSVP-TE tunnel type.

sr-te

Selects the SR-TE tunnel type.

Platforms

All

resolution-filter

Syntax

resolution-filter

Context

[Tree] (config>router>ospf3>igp-shortcut>tunnel-next-hop>family resolution-filter)

[Tree] (config>router>ospf>igp-shortcut>tunnel-next-hop>family resolution-filter)

Full Context

configure router ospf3 igp-shortcut tunnel-next-hop family resolution-filter

configure router ospf igp-shortcut tunnel-next-hop family resolution-filter

Description

Commands in this context configure the subset of tunnel types that can be used in the resolution of the IP prefix or SR tunnel family using IGP shortcuts.

Platforms

All

resolution-filter

Syntax

resolution-filter

Context

[Tree] (config>service>vprn>auto-bind-tunnel resolution-filter)

Full Context

configure service vprn auto-bind-tunnel resolution-filter

Description

Note: This command is no longer supported and will be removed in a future release.

Platforms

All

resolve

resolve

Syntax

resolve minutes

Context

[Tree] (config>service>vpls>proxy-nd>dynamic resolve)

[Tree] (config>service>vpls>proxy-arp>dynamic resolve)

Full Context

configure service vpls proxy-nd dynamic resolve

configure service vpls proxy-arp dynamic resolve

Description

This command configures the frequency at which a resolve message is sent. The resolve message is an ARP-request or NS message flooded to all the non-EVPN endpoints in the service irrespective of the current status of the unknown-arp-request-flood-evpn or unknown-ns-flood-evpn commands.

Default

resolve 5

Parameters

minutes

Specifies the frequency in minutes at which the resolve message is issued.

Values

1 to 60

Default

5

Platforms

All

resolve-root-using

resolve-root-using

Syntax

resolve-root-using {ucast-rtm | mcast-rtm}

Context

[Tree] (config>router>ldp resolve-root-using)

Full Context

configure router ldp resolve-root-using

Description

By default, MLDP resolves the FEC using the unicast RTM. When this command is set to mcast-rtm, MLDP will resolve the FEC using the multicast route table. The multicast route table does not include any IGP shortcuts, unlike the unicast RTM. MLDP cannot resolve a FEC using an IGP shortcut, so if IGP shortcuts are used for unicast, enable multicast MLDP lookups.

If this command is set to mcast-rtm:

  • For FEC resolution using IGP, static or local, the ROOT in this FEC is resolved using the multicast RTM.

  • A FEC being resolved using BGP is recursive, so the FEC next-hop (ASBR/ABR) is resolved using the multicast RTM first and, if this fails, it is resolved using the unicast RTM. This next-hop needs to be recursively resolved again using IGP/Static-Route or Local, this second resolution (recursive resolution) uses the multicast RTM only.

  • In all cases, MLDP uses the unicast RTM to resolve the FEC and will not resolve the FEC if its next hop is resolved using an IGP shortcut.

Default

resolve-root-using ucast-rtm

Platforms

All

resolve-static

resolve-static

Syntax

[no] resolve-static

Context

[Tree] (config>router>policy-options>policy-statement>default-action resolve-static)

[Tree] (config>router>policy-options>policy-statement>entry>action resolve-static)

Full Context

configure router policy-options policy-statement default-action resolve-static

configure router policy-options policy-statement entry action resolve-static

Description

This command has an affect only in BGP route-table-import policies and applies only to BGP IPv4 and IPv6 routes created by importing static routes with indirect next-hops. When such a route matches a policy entry with this action, the BGP next-hop is the resolved next-hop of the static route.

The no form of this command reverts to the default behavior, which copies the indirect next-hop of the static route into the BGP next-hop without resolving it further.

Default

no resolve-static

Platforms

All

resolve-v6-prefix-over-shortcut

resolve-v6-prefix-over-shortcut

Syntax

[no] resolve-v6-prefix-over-shortcut

Context

[Tree] (config>router>ldp>targ-session resolve-v6-prefix-over-shortcut)

Full Context

configure router ldp targeted-session resolve-v6-prefix-over-shortcut

Description

This command allows an IPv6 prefix FEC to be resolved over an IGP shortcut.

The no form of this command disables the resolution.

Platforms

All

responder-url

responder-url

Syntax

responder-url url-string

no responder-url

Context

[Tree] (config>system>security>pki>ca-profile>ocsp responder-url)

Full Context

configure system security pki ca-profile ocsp responder-url

Description

This command specifies HTTP URL of the OCSP responder for the CA, this URL will only be used if there is no OCSP responder defined in the AIA extension of the certificate to be verified.

Default

no responder-url

Parameters

url-string

Specifies the HTTP URL of the OCSP responder

Platforms

All

response-signing-cert

response-signing-cert

Syntax

response-signing-cert filename

no response-signing-cert

Context

[Tree] (config>system>security>pki>ca-profile>cmpv2 response-signing-cert)

Full Context

configure system security pki ca-profile cmpv2 response-signing-cert

Description

This command specifies a imported certificate that is used to verify the CMP response message if they are protected by signature. If this command is not configured, CA’s certificate is used.

Default

no response-signing-cert

Parameters

filename

Specifies the filename of the imported certificate.

Platforms

All

restart-backoff

restart-backoff

Syntax

restart-backoff initial-time seconds max-time seconds

no restart-backoff

Context

[Tree] (config>subscr-mgmt>pppoe-client-policy restart-backoff)

Full Context

configure subscriber-mgmt pppoe-client-policy restart-backoff

Description

This command configures backoff timer parameters that determine how often and how long the system will attempt to restart a PPPoE client after a failure. When a client first fails, the system immediately tries to re-establish connectivity. If this attempt is also unsuccessful, the system initiates a backoff timer and waits until it expires before attempting to restart the client again, to avoid flooding the BNG. The initial duration of the backoff timer is configured with the initial-time parameter. With each subsequent failure, the backoff timer is doubled until the configured max-time is reached.

The no form of this command reverts to the default.

Default

restart-backoff initial-time 30 max-time 600

Parameters

initial-time seconds

Specifies the initial backoff time to wait before attempting a client restart.

Values

10 to 3600

max-time seconds

Specifies the maximum time to attempt client restarts.

Values

10 to 3600

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

restart-time

restart-time

Syntax

restart-time seconds

no restart-time

Context

[Tree] (config>service>vprn>bgp>graceful-restart restart-time)

[Tree] (config>service>vprn>bgp>group>neighbor>graceful-restart restart-time)

[Tree] (config>service>vprn>bgp>group>graceful-restart restart-time)

Full Context

configure service vprn bgp graceful-restart restart-time

configure service vprn bgp group neighbor graceful-restart restart-time

configure service vprn bgp group graceful-restart restart-time

Description

This command sets the value of the restart-time that is advertised in the router’s graceful-restart capability. If this command is not configured, the default is 300.

Default

no restart-time

Parameters

seconds

Specifies the restart-time that is advertised in the router’s graceful-restart capability.

Values

0 to 4095 seconds

Default

300

Platforms

All

restart-time

Syntax

restart-time seconds

no restart-time

Context

[Tree] (config>router>bgp>graceful-restart restart-time)

[Tree] (config>router>bgp>group>graceful-restart restart-time)

[Tree] (config>router>bgp>group>neighbor>graceful-restart restart-time)

Full Context

configure router bgp graceful-restart restart-time

configure router bgp group graceful-restart restart-time

configure router bgp group neighbor graceful-restart restart-time

Description

This command sets the value of the restart-time that is advertised in the router’s graceful-restart capability. If this command is not configured, the default is 300.

Default

no restart time

Parameters

seconds

Specifies the restart-time that is advertised in the router’s graceful-restart capability.

Values

0 to 4095 seconds

Default

config>router>bgp>graceful-restart: 120 seconds

config>router>bgp>group>graceful-restart: 300 seconds

config>router>bgp>group>neighbor>graceful-restart: 300 seconds

Platforms

All

restore-disconnected

restore-disconnected

Syntax

[no] restore-disconnected

Context

[Tree] (config>service>vprn>sub-if>grp-if>wpp restore-disconnected)

[Tree] (config>service>ies>sub-if>grp-if>wpp restore-disconnected)

Full Context

configure service vprn subscriber-interface group-interface wpp restore-disconnected

configure service ies subscriber-interface group-interface wpp restore-disconnected

Description

This command specifies that the initial profiles must be restored after a DHCP host has disconnected. The behavior that system will restore the initial-sla-profile, initial-sub-profile, or initial-app-profile when hosts disconnects instead of removing them.

The no form of this command specifies that the initial profiles will not be restored after a DHCP host has disconnected.

Default

restore-disconnected

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

restore-disconnected

Syntax

restore-disconnected {restore | no-restore}

no restore-disconnected

Context

[Tree] (config>subscr-mgmt>loc-user-db>ipoe>host>wpp restore-disconnected)

Full Context

configure subscriber-mgmt local-user-db ipoe host wpp restore-disconnected

Description

This command specifies the behavior that system will restore the initial-sla-profile, initial-sub-profile, or initial-app-profile when hosts disconnects instead of removing them.

The no form of this command reverts to the default.

Parameters

restore

Specifies that the initial profiles must be restored after a DHCP host has disconnected.

no-restore

Specifies that the initial profiles will not be restored after a DHCP host has disconnected.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

restrict-non-configured-ip-address

restrict-non-configured-ip-address

Syntax

restrict-non-configured-ip-address [sponge-mac mac-address]

no restrict-non-configured-ip-address

Context

[Tree] (config>service>vpls>proxy-arp restrict-non-configured-ip-address)

[Tree] (config>service>vpls>proxy-nd restrict-non-configured-ip-address)

Full Context

configure service vpls proxy-arp restrict-non-configured-ip-address

configure service vpls proxy-nd restrict-non-configured-ip-address

Description

This command configures whether all the configured dynamic IP address entries are considered the only authorized entries in the proxy ARP or ND table. ARP or ND packets coming from a unauthorized sender IP addresses are dropped. Therefore, unauthorized IP addresses are not learned in the proxy ARP or ND table, and ARP requests or neighbor solicitations (NS) coming from a unauthorized sender IP addresses are not replied to, unless the sponge-mac option is configured.

The no form of this command does not drop ARP or ND packets coming from a unauthorized sender IP addresses.

Parameters

sponge-mac

Keyword to specify that ARP requests or NSs from an unauthorized IP address are not learned in the proxy ARP or ND table and ARP requests or NSs from an unauthorized IP address are replied with the configured sponge MAC address. Any IP address that is not configured as proxy ARP, ND dynamic ARP, or neighbor IP address is considered unauthorized and dropped.

mac-address

Specifies the MAC address.

The configured sponge MAC address is not installed in the FDB or advertised in EVPN. If needed, the sponge MAC address can be configured as a static MAC in the same service in the node or a remote node.

Values

xx:xx:xx:xx:xx:xx or xx-xx-xx-xx-xx-xx

Platforms

All

restrict-protected-src

restrict-protected-src

Syntax

restrict-protected-src discard-frame

restrict-protected-src [alarm-only]

no restrict-protected-src

Context

[Tree] (config>service>vpls>split-horizon-group restrict-protected-src)

[Tree] (config>service>vpls>mesh-sdp restrict-protected-src)

[Tree] (config>service>pw-template restrict-protected-src)

[Tree] (config>service>vpls>endpoint restrict-protected-src)

[Tree] (config>service>vpls>spoke-sdp restrict-protected-src)

[Tree] (config>service>vpls>sap restrict-protected-src)

[Tree] (config>service>pw-template>split-horizon-group restrict-protected-src)

Full Context

configure service vpls split-horizon-group restrict-protected-src

configure service vpls mesh-sdp restrict-protected-src

configure service pw-template restrict-protected-src

configure service vpls endpoint restrict-protected-src

configure service vpls spoke-sdp restrict-protected-src

configure service vpls sap restrict-protected-src

configure service pw-template split-horizon-group restrict-protected-src

Description

This command indicates how the agent will handle relearn requests for protected MAC addresses, either manually added using the mac-protect command or automatically added using the auto-learn-mac-protect command. While enabled all packets entering the configured SAP, spoke SDP, mesh SDP, or any SAP that is part of the configured split horizon group (SHG) is verified not to contain a protected source MAC address. If the packet is found to contain such an address, the action taken depends on the parameter specified on the restrict-protected-src command, namely:

  • No parameter — The packet is discarded, an alarm is generated and the SAP, spoke SDP or mesh SDP is set operationally down. The SAP, spoke SDP or mesh SDP must be shut down and enabled (no shutdown) for this state to be cleared.

  • alarm-only — The packet is forwarded, an alarm is generated but the source MAC is not learned on the SAP, spoke SDP or mesh SDP.

  • discard-frame — The packet is discarded and an alarm generated. The frequency of alarm generation is fixed to be at most one alarm per MAC address per FP per 10 minutes in a given VPLS service. This parameter is only applicable to automatically protected MAC addresses.

When the restrict-protected-src is enabled on an SHG the action only applies to the associated SAPs (no action is taken by default for spoke SDPs in the SHG) and is displayed in the SAP show output as the oper state unless it is overridden by the configuration of restrict-protected-src on the SAP itself. To enable this function for spoke SDPs within a SHG, the restrict-protected-src must be enabled explicitly under the spoke SDP. If required, restrict-protected-src can also be enabled explicitly under specific SAPs within the SHG.

When this command is applied or removed, with either the alarm-only or discard-frame parameters, the MAC addresses are cleared from the related object.

The use of restrict-protected-src discard-frame is mutually exclusive with the configuration of manually protected MAC addresses within a given VPLS.

The alarm-only parameter is not supported on the 7750 SR-a, 7750 SR-1e/2e/3e, 7950 XRS, 7750 SR-1,or 7750 SR-1s/2s/7s/14s platforms.

The no form of the command reverts to the default.

Default

no restrict-protected-src

Parameters

alarm-only

Specifies that the packet is forwarded, an alarm is generated but the source MAC is not learned on the SAP, spoke SDP, or mesh SDP.

Default

no alarm-only

discard-frame

Specifies that the packet is discarded and an alarm generated. The frequency of alarm generation is fixed to be at most one alarm per MAC address per FP per 10 minutes within a given VPLS service.

Default

no discard-frame

Platforms

All

restrict-protected-src

Syntax

restrict-protected-src discard-frame

no restrict-protected-src

Context

[Tree] (config>service>vpls>pbb>backbone-vpls restrict-protected-src)

Full Context

configure service vpls pbb backbone-vpls restrict-protected-src

Description

This command indicates how the agent handles relearn requests for protected MAC addresses, either manually added using the mac-protect command or automatically added using the auto-learn-mac-protect command. While enabled, all packets entering the configured SAP, spoke SDP, mesh SDP, or any SAP that is part of the configured split horizon group (SHG) is verified not to contain a protected source MAC address. If the packet is found to contain such an address, the action taken depends on the parameter specified on the restrict-protected-src command, namely:

  • No parameter — The packet is discarded, an alarm is generated and the SAP, spoke SDP or mesh SDP will be set as operationally down. The SAP, spoke SDP or mesh SDP must be shutdown and enabled (no shutdown) for this state to be cleared.

  • discard-frame — The packet is discarded and an alarm generated. The frequency of alarm generation is fixed to be at most one alarm per MAC address per FP per 10 minutes in a specified VPLS service. This parameter is only applicable to automatically protected MAC addresses.

When the restrict-protected-src is enabled on an SHG, the action only applies to the associated SAPs (no action is taken by default for spoke-SDPs in the SHG) and is displayed in the SAP show output as the oper state unless it is overridden by the configuration of restrict-protected-src on the SAP itself. To enable this function for spoke SDPs within a SHG, the restrict-protected-src must be enabled explicitly under the spoke SDP. If required, restrict-protected-src can also be enabled explicitly under specific SAPs within the SHG.

When this command is applied or removed, with the discard-frame parameter, the MAC addresses are cleared from the related object.

The use of restrict-protected-src discard-frame is mutually exclusive with the configuration of manually protected MAC addresses within a specified VPLS.

Default

no restrict-protected-src

Parameters

discard-frame

Specifies that the packet is discarded and an alarm generated. The frequency of alarm generation is fixed to be at most one alarm per MAC address per FP per 10 minutes within a specified VPLS service

Platforms

All

restrict-protected-src

Syntax

restrict-protected-src discard-frame

no restrict-protected-src

Context

[Tree] (config>service>vpls>bgp-evpn>srv6 restrict-protected-src)

[Tree] (config>service>vpls>vxlan restrict-protected-src)

Full Context

configure service vpls bgp-evpn segment-routing-v6 restrict-protected-src

configure service vpls vxlan restrict-protected-src

Description

This command enables protected source MAC restrictions.

Platforms

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

  • configure service vpls bgp-evpn segment-routing-v6 restrict-protected-src

All

  • configure service vpls vxlan restrict-protected-src

restrict-unprotected-dst

restrict-unprotected-dst

Syntax

restrict-unprotected-dst

no restrict-unprotected-dst

Context

[Tree] (config>service>vpls>sap restrict-unprotected-dst)

[Tree] (config>service>pw-template>split-horizon-group restrict-unprotected-dst)

[Tree] (config>service>vpls>split-horizon-group restrict-unprotected-dst)

[Tree] (config>service>vpls restrict-unprotected-dst)

Full Context

configure service vpls sap restrict-unprotected-dst

configure service pw-template split-horizon-group restrict-unprotected-dst

configure service vpls split-horizon-group restrict-unprotected-dst

configure service vpls restrict-unprotected-dst

Description

This command indicates how the system will forward packets destined for an unprotected MAC address, either manually added using the mac-protect command or automatically added using the auto-learn-mac-protect command. While enabled all packets entering the configured SAP or SAPs within a split horizon group (but not spoke or mesh-SDPs) will be verified to contain a protected destination MAC address. If the packet is found to contain a non-protected destination MAC, it will be discarded. Detecting a non-protected destination MAC on the SAP will not cause the SAP to be placed in the operationally down state. No alarms are generated.

If the destination MAC address is unknown, even if the packet is entering a restricted SAP, with restrict-unprotected-dst enabled, it will be flooded.

Default

no restrict-unprotected-dst

Platforms

All

restricted-to-home

restricted-to-home

Syntax

[no] restricted-to-home

Context

[Tree] (config>system>security>user restricted-to-home)

[Tree] (config>system>security>user-template restricted-to-home)

Full Context

configure system security user restricted-to-home

configure system security user-template restricted-to-home

Description

This command denies the user from accessing files outside of their home directory. Files can be accessed locally by CLI file commands and output modifiers such as > (file redirect), or remotely via FTP and SCP.

When enabled, the system denies all configuration save operations (such as admin save) via any management interface (such as CLI and NETCONF) unless save-when-restricted is enabled.

When restricted-to-home is configured, file access is denied unless the home-directory is configured and the directory is created by an administrator.

The no form of this command permits the user to access all files on the system.

Default

restricted-to-home

Platforms

All

results

results

Syntax

results file-url

no results

Context

[Tree] (config>system>script-control>script-policy results)

Full Context

configure system script-control script-policy results

Description

This command is used to specify the location where the system writes the output of an event script’s execution.

The no form of the command removes the file location from the configuration. Scripts will not execute if there is no result location defined.

Default

no results

Parameters

file-url

Specifies the location to send CLI output from script runs. The file-url is a location, directory, and filename prefix to which a data and timestamp suffix is added when the results files are created during a script run, as follows:

file-url_YYYYMMDD-hhmmss.uuuuuu.out

where:

YYYYMMDD — date

hhmmss — hours, minutes, and seconds

uuuuuu — microseconds (padded to 6 characters with leading zeros)

Values

local-url | remote-url

local-url — [cflash-id/] [file-path] 167 chars max, including cflash-idfile-path 166 chars max

remote url — [{ftp:// | tftp://}login:password@remote-location/][file-path] 255 characters max directory length 99 characters max each

remote-location — [hostname | ipv4-address | ipv6-address]

ipv4-address — a.b.c.d

ipv6-address — x:x:x:x:x:x:x:x[-interface] x:x:x:x:x:x:d.d.d.d[-interface] x — [0 to FFFF]H d — [0 to 255]D interface — 32 characters max, for link local addresses

cflash-id — cf1:, cf1-A:, cf1-B:, cf2:, cf2-A:, cf2-B:, cf3:, cf3-A:, cf3-B:

Platforms

All

resv

resv

Syntax

resv [detail]

no resv

Context

[Tree] (debug>router>rsvp>event resv)

Full Context

debug router rsvp event resv

Description

This command debugs RSVP reservation events.

The no form of the command disables the debugging.

Parameters

detail

Displays detailed information about RSVP reservation events.

Platforms

All

resv

Syntax

resv [detail]

no resv

Context

[Tree] (debug>router>rsvp>packet resv)

Full Context

debug router rsvp packet resv

Description

This command enables debugging for RSVP resv packets.

The no form of the command disables the debugging.

Parameters

detail

Displays detailed information about RSVP Resv events.

Platforms

All

resv-cbs

resv-cbs

Syntax

resv-cbs percent-or-default amber-alarm-action step percent max percent

resv-cbs percent-or-default

no resv-cbs

Context

[Tree] (config>port>access>ingress>pool resv-cbs)

[Tree] (config>port>access>egress>pool resv-cbs)

[Tree] (config>port>network>egress>pool resv-cbs)

Full Context

configure port access ingress pool resv-cbs

configure port access egress pool resv-cbs

configure port network egress pool resv-cbs

Description

This command defines the percentage or specifies the sum of the pool buffers that are used as a guideline for CBS calculations for access and network ingress and egress queues. Two actions are accomplished by this command:

  • A reference point is established to compare the currently assigned (provisioned) total CBS with the amount the buffer pool considers to be reserved. Based on the percentage of the pool reserved that has been provisioned, the over provisioning factor can be calculated.

  • The size of the shared portion of the buffer pool is indirectly established. The shared size is important to the calculation of the instantaneous-shared-buffer-utilization and the average-shared-buffer-utilization variables used in Random Early Detection (RED) per packet slope plotting.

It is important to note that this command does not actually set aside buffers within the buffer pool for CBS reservation. The CBS value per queue only determines the point at which enqueuing packets are subject to a RED slope. Oversubscription of CBS could result in a queue operating within its CBS size and still not able to enqueue a packet due to unavailable buffers. The resv-cbs parameter can be changed at any time.

If the total pool size is 10 Mb and the resv-cbs set to 5, the 'reserved size’ is 500 kb.

The no form of this command clears all the adaptive configurations. There cannot be any adaptive sizing enabled for default resv-cbs.

Default

resv-cbs 30

Parameters

percent-or-default

Specifies the pool buffer size percentage.

Values

0 to 100, default

amber-alarm-action step percent

Specifies the percentage step-size for the reserved CBS size of the pool. When using the default value, the adaptive CBS sizing is disabled. To enable adaptive CBS sizing, step percent must be set to non-default value along with the max parameter. When reserved CBS is default adaptive CBS sizing cannot be enabled. The reserved CBS (Committed Burst Size) defines the amount of buffer space within the pool that is not considered shared.

Values

1 to 100

Default

0

max percent

Specifies the maximum percentage for the reserved CBS size of the pool. When using the default value, the adaptive CBS sizing is disabled. To enable adaptive CBS sizing, max value must be set to non-default value along with the step percent. When reserved CBS is default adaptive CBS sizing cannot be enabled. The reserved CBS (Committed Burst Size) defines the amount of buffer space within the pool that is not considered shared. Max reserved CBS must not be more than the reserved CBS.

Values

1 to 100

Default

0

Platforms

All

resv-cbs

Syntax

resv-cbs min percentage max percentage

no resv-cbs

Context

[Tree] (config>card>fp>egress>wred-queue-control resv-cbs)

Full Context

configure card fp egress wred-queue-control resv-cbs

Description

This command defines the amount of buffers within the WRED mega-pool that will be set aside for WRED queues operating within their configured CBS thresholds. Note that the min percentage and max percentage parameters must be set to the same value. The forwarding plane protects against WRED queue buffer starvation by setting aside a portion of the buffers within the WRED mega-pool. The WRED queue CBS threshold defines when a WRED queue requests buffers from reserved portion of the WRED mega-pool and when it starts requesting buffers from the shared portion of the mega-pool. With proper oversubscription provisioning, this prevents a seldom active queue from being denied a buffer from the mega-pool when the shared portion of the mega-pool is congested.

The WRED mega-slope reserve CBS size is controlled in the same manner as the overall sizing of the WRED mega-pool. A min and max parameter is provided to scope the range that the reserved portion based on percentages of the WRED mega-pool current size.

The no form of this command immediately restores the default min and max percentage values for sizing the WRED mega-pool CBS reserve.

Default

resv-cbs min 25.00 max 25.00

Parameters

min percentage

Specifies that the required keyword defines the minimum percentage of the WRED mega-pool buffers that will be applied to the CBS reserve. The value given for percentage must be less than or equal to the value given for the max percentage. Percentages are defined with an accuracy of hundredths of a percent in the nn.nn format (15.65 = 15.65%).

Values

0.00 to 99.99

Default

25.00

max percentage

Specifies that the required keyword defines the maximum percentage of the WRED mega-pool buffers that may be applied to the CBS reserve. The value given for percentage must be greater than or equal to the value given for the min percentage. Percentages are defined with an accuracy of hundredths of a percent in the nn.nn format (15.65 = 15.65%).

Values

0.01 to 99.99

Default

25.00

Platforms

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

resv-cbs

Syntax

resv-cbs percent-or-default

resv-cbs percent-or-default amber-alarm-action step percent max percent

no resv-cbs

Context

[Tree] (config>card>fp>ingress>network>pool resv-cbs)

Full Context

configure card fp ingress network pool resv-cbs

Description

This command defines the percentage or specifies the sum of the pool buffers that are used as a guideline for CBS calculations for access and network ingress and egress queues. Two actions are accomplished by this command:

  • A reference point is established to compare the currently assigned (provisioned) total CBS with the amount the buffer pool considers to be reserved. Based on the percentage of the pool reserved that has been provisioned, the over provisioning factor can be calculated.

  • The size of the shared portion of the buffer pool is indirectly established. The shared size is important to the calculation of the instantaneous-shared-buffer-utilization and the average-shared-buffer-utilization variables used in Random Early Detection (RED) per packet slope plotting.

It is important to note that this command does not actually set aside buffers within the buffer pool for CBS reservation. The CBS value per queue only determines the point at which enqueuing packets are subject to a RED slope. Oversubscription of CBS could result in a queue operating within its CBS size and still not able to enqueue a packet due to unavailable buffers. The resv-cbs parameter can be changed at any time.

If the total pool size is 10 Mb and the resv-cbs set to 5, the 'reserved size’ is 500 kb.

The no form of this command clears all the adaptive configurations. There cannot be any adaptive sizing enabled for default resv-cbs.

Default

resv-cbs 30

Parameters

percent-or-default

Specifies the pool buffer size percentage.

Values

0 to 100, default

amber-alarm-action step percent

Specifies the percentage step-size for the reserved CBS size of the pool. When using the default value, the adaptive CBS sizing is disabled. To enable adaptive CBS sizing, step percent must be set to non-default value along with the max parameter. When reserved CBS is default adaptive CBS sizing cannot be enabled. The reserved CBS defines the amount of buffer space within the pool that is not considered shared.

Values

1 to 100

Default

0

max percent

Specifies the maximum percentage for the reserved CBS size of the pool. When using the default value, the adaptive CBS sizing is disabled. To enable adaptive CBS sizing, max value must be set to non-default value along with the step percent. When reserved CBS is default adaptive CBS sizing cannot be enabled. The reserved CBS defines the amount of buffer space within the pool that is not considered shared. Max reserved CBS must not be more than the reserved CBS.

Values

1 to 100

Default

0

Platforms

All

resv-cbs

Syntax

resv-cbs percent-or-default

no resv-cbs

Context

[Tree] (config>isa>aa-grp>qos>egress>from-subscriber>pool resv-cbs)

[Tree] (config>isa>aa-grp>qos>egress>to-subscriber>pool resv-cbs)

Full Context

configure isa application-assurance-group qos egress from-subscriber pool resv-cbs

configure isa application-assurance-group qos egress to-subscriber pool resv-cbs

Description

This command defines the percentage or specifies the sum of the pool buffers that are used as a guideline for CBS calculations for access and network ingress and egress queues. Two actions are accomplished by this command.

  • A reference point is established to compare the currently assigned (provisioned) total CBS with the amount the buffer pool considers to be reserved. Based on the percentage of the pool reserved that has been provisioned, the over provisioning factor can be calculated.

  • The size of the shared portion of the buffer pool is indirectly established. The shared size is important to the calculation of the instantaneous-shared-buffer-utilization and the average-shared-buffer-utilization variables used in Random Early Detection (RED) per packet slope plotting.

This command does not actually set aside buffers within the buffer pool for CBS reservation. The CBS value per queue only determines the point at which enqueuing packets are subject to a RED slope. Oversubscription of CBS could result in a queue operating within its CBS size and still not able to enqueue a packet due to unavailable buffers. The resv-cbs parameter can be changed at any time.

If the total pool size is 10 MB and the resv-cbs set to 5, the 'reserved size’ is 500 KB.

The no form of this command restores the default value of 30.

Default

resv-cbs default

Parameters

percent-or-default

Specifies the pool buffer size percentage.

Values

0 to 100, default

Platforms

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

resv-ret

resv-ret

Syntax

resv-ret resv-ret

Context

[Tree] (config>isa>video-group resv-ret)

Full Context

configure isa video-group resv-ret

Description

This command provides a mechanism to reserve an explicit amount of egress bandwidth, in Mb/s, for RET for all the ISAs within a video group. If the amount of egress bandwidth is less than the reserved amount, FCC requests are discarded and only RET requests processed. The bandwidth is dynamically adjusted per ISA within the video group if an ISA becomes operational/non-operational within the group.

Default

resv-ret 0

Parameters

resv-ret

Specifies the egress bandwidth in Mb/s.

Values

0 to 10500

Platforms

7450 ESS, 7750 SR, 7750 SR-s

resverr

resverr

Syntax

resverr [detail]

no resverr

Context

[Tree] (debug>router>rsvp>packet resverr)

Full Context

debug router rsvp packet resverr

Description

This command debugs ResvErr packets.

The no form of the command disables the debugging.

Parameters

detail

Displays detailed information about ResvErr packets.

Platforms

All

resvtear

resvtear

Syntax

resvtear [detail]

no resvtear

Context

[Tree] (debug>router>rsvp>packet resvtear)

Full Context

debug router rsvp packet resvtear

Description

This command debugs ResvTear packets.

The no form of the command disables the debugging.

Parameters

detail

Displays detailed information about ResvTear packets.

Platforms

All

ret

ret

Syntax

ret percent

Context

[Tree] (config>isa>video-group>watermark>bandwidth ret)

[Tree] (config>isa>video-group>watermark>session ret)

Full Context

configure isa video-group watermark bandwidth ret

configure isa video-group watermark session ret

Description

This command sets the watermark to trigger the SNMP trap if the RET bandwidth or session exceeds the configured percentage. The bandwidth is the available egress bandwidth of the ISA. The SNMP trap is cleared when the consumption is lowered by 10%. For example, if the system resource of the bandwidth available is 10 Gb/s and the watermark is configured to be 90%, the SNMP trap is raised as the bandwidth exceeds 9 Gb/s (90% of 10 Gb/s). The SNMP trap is cleared when the bandwidth drops below 8.1 Gb/s (10% of 9 Gb/s = 0.9 Gb/s, and 9 Gb/s - 0.9 Gb/s = 8.1 Gb/s). The default value of the watermark is set at 90% of the system resources for both bandwidth and session.

Default

ret 90

Parameters

percent

Specifies the percentage of the system resources per ISA.

Values

1 to 99

Platforms

7450 ESS, 7750 SR, 7750 SR-s

ret-session-timeout

ret-session-timeout

Syntax

ret-session-timeout seconds

no ret-session-timeout

Context

[Tree] (config>mcast-mgmt>mcast-info-plcy>video-policy>video-if ret-session-timeout)

Full Context

configure mcast-management multicast-info-policy video-policy video-interface ret-session-timeout

Description

By default, the video ISA will wait for 5 minutes before closing the RTCP session from the subscriber. The RTCP session can be adjusted from 5 second to 5 minutes. The timeout is applicable to both RET and FCC RTCP sessions.

The no form of the command reverts to the default.

Default

ret-session-timeout 300

Parameters

seconds

Specifies the RET session timeout, in seconds.

Values

5 to 300

Platforms

7450 ESS, 7750 SR, 7750 SR-s

retail-service-id

retail-service-id

Syntax

retail-service-id service-id

no retail-service-id

Context

[Tree] (config>subscr-mgmt>loc-user-db>ipoe>host retail-service-id)

[Tree] (config>subscr-mgmt>loc-user-db>ppp>host retail-service-id)

Full Context

configure subscriber-mgmt local-user-db ipoe host retail-service-id

configure subscriber-mgmt local-user-db ppp host retail-service-id

Description

This command indicates the service ID of the retailer VPRN service to which this session belongs. If the value of this object is non-zero, the session belongs to a retailer VPRN.

The no form of this command removes the service ID from the configuration.

Parameters

service-id

Specifies the retailer service ID or name.

Values

service-id:

1 to 2147483647

service-name:

up to 64 characters

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

retail-svc-id

retail-svc-id

Syntax

retail-svc-id service-id

retail-svc-id

Context

[Tree] (config>service>vprn>sub-if>grp-if>sap>static-host retail-svc-id)

[Tree] (config>service>ies>sub-if>grp-if>sap>static-host retail-svc-id)

Full Context

configure service vprn subscriber-interface group-interface sap static-host retail-svc-id

configure service ies subscriber-interface group-interface sap static-host retail-svc-id

Description

This command specifies the service id of the retailer IES/VPRN service to which the static IPv6 host belongs. A corresponding retailer subscriber interface must exist in the specified service.

The no form of this command reverts to the default.

Parameters

service-id

Specifies the retailer service ID or retailer service name.

Values

service-id: 1 to 2148007978

svc-name: A string up to 64 characters

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

retail-svc-id

Syntax

retail-svc-id service-id

no retail-svc-id

Context

[Tree] (config>service>ies>sub-if>grp-if>wlan-gw>ranges>range retail-svc-id)

[Tree] (config>service>vprn>sub-if>grp-if>wlan-gw>ranges>range retail-svc-id)

Full Context

configure service ies subscriber-interface group-interface wlan-gw vlan-tag-ranges range retail-svc-id

configure service vprn subscriber-interface group-interface wlan-gw vlan-tag-ranges range retail-svc-id

Description

This command configures the retailer service.

Parameters

service-id

Specifies the identifier of the retail service.

Values

1 to 2147483650

svc-name: up to 64 characters

Platforms

7750 SR, 7750 SR-e, 7750 SR-s, VSR

retransmit-interval

retransmit-interval

Syntax

retransmit-interval seconds

no retransmit-interval

Context

[Tree] (config>service>vpls>spoke-sdp>spb retransmit-interval)

[Tree] (config>service>vpls>sap>spb retransmit-interval)

Full Context

configure service vpls spoke-sdp spb retransmit-interval

configure service vpls sap spb retransmit-interval

Description

This command configures the minimum time between LSP PDU retransmissions on a point-to-point interface. This command is valid only for interfaces on control B-VPLS.

The no form of this command reverts to the default value.

Default

retransmit-interval 5

Parameters

seconds

The interval in seconds that SPB IS-IS LSPs can be sent on the interface.

Values

1 to 65535

Platforms

All

retransmit-interval

Syntax

retransmit-interval seconds

no retransmit-interval

Context

[Tree] (config>service>vpls>spoke-sdp>spb retransmit-interval)

[Tree] (config>service>vpls>sap>spb retransmit-interval)

Full Context

configure service vpls spoke-sdp spb retransmit-interval

configure service vpls sap spb retransmit-interval

Description

This command configures the minimum time between LSP PDU retransmissions on a point-to-point interface.

The no form of this command reverts to the default value.

Default

retransmit-interval 100

Parameters

seconds

Specifies the interval in seconds that IS-IS LSPs can be sent on the interface

Values

1 to 65535

Platforms

All

retransmit-interval

Syntax

retransmit-interval seconds

no retransmit-interval

Context

[Tree] (config>service>vprn>isis>if retransmit-interval)

Full Context

configure service vprn isis interface retransmit-interval

Description

This command configures the minimum time between LSP PDU retransmissions on a point-to-point interface.

The no form of this command reverts to the default value.

Default

retransmit-interval 5

Parameters

seconds

Specifies the interval in seconds that IS-IS LSPs can be sent on the interface

1 to 65535.

Platforms

All

retransmit-interval

Syntax

retransmit-interval seconds

no retransmit-interval

Context

[Tree] (config>service>vprn>ospf3>area>virtual-link retransmit-interval)

[Tree] (config>service>vprn>ospf>area>virtual-link retransmit-interval)

[Tree] (config>service>vprn>ospf>area>sham-link retransmit-interval)

[Tree] (config>service>vprn>ospf3>area>if retransmit-interval)

[Tree] (config>service>vprn>ospf>area>if retransmit-interval)

Full Context

configure service vprn ospf3 area virtual-link retransmit-interval

configure service vprn ospf area virtual-link retransmit-interval

configure service vprn ospf area sham-link retransmit-interval

configure service vprn ospf3 area interface retransmit-interval

configure service vprn ospf area interface retransmit-interval

Description

This command specifies the length of time, in seconds, that OSPF will wait before retransmitting an unacknowledged link state advertisement (LSA) to an OSPF neighbor.

The value should be longer than the expected round trip delay between any two routers on the attached network. Once the retransmit interval expires and no acknowledgment is received, the LSA is retransmitted.

The no form of this command reverts to the default interval.

Default

retransmit-interval 5

Parameters

seconds

The retransmit interval in seconds expressed as a decimal integer.

Values

1 to 3600

Platforms

All

retransmit-interval

Syntax

retransmit-interval seconds

no retransmit-interval

Context

[Tree] (config>router>isis>interface retransmit-interval)

Full Context

configure router isis interface retransmit-interval

Description

This command configures the minimum time between LSP PDU retransmissions on a point-to-point interface.

The no form of this command reverts to the default value.

Default

retransmit-interval 5

Parameters

seconds

Specifies the interval, in seconds, that IS-IS LSPs can be sent on the interface.

Values

1 to 65535

Platforms

All

retransmit-interval

Syntax

retransmit-interval seconds

no retransmit-interval

Context

[Tree] (config>router>ospf>area>interface retransmit-interval)

[Tree] (config>router>ospf3>area>virtual-link retransmit-interval)

[Tree] (config>router>ospf3>area>interface retransmit-interval)

[Tree] (config>router>ospf>area>virtual-link retransmit-interval)

Full Context

configure router ospf area interface retransmit-interval

configure router ospf3 area virtual-link retransmit-interval

configure router ospf3 area interface retransmit-interval

configure router ospf area virtual-link retransmit-interval

Description

This command specifies the length of time, in seconds, that OSPF will wait before retransmitting an unacknowledged link state advertisement (LSA) to an OSPF neighbor.

The value should be longer than the expected round trip delay between any two routers on the attached network. After the retransmit-interval expires and no acknowledgment has been received, the LSA will be retransmitted.

The no form of this command reverts to the default interval.

Default

retransmit-interval 5

Parameters

seconds

Specifies the retransmit interval in seconds expressed as a decimal integer.

Values

1 to 1800

Platforms

All

retransmit-time

retransmit-time

Syntax

retransmit-time milli-seconds

no retransmit-time

Context

[Tree] (config>service>vprn>sub-if>grp-if>ipv6>rtr-adv retransmit-time)

[Tree] (config>router>router-advert>if retransmit-time)

[Tree] (config>service>ies>sub-if>ipv6>rtr-adv retransmit-time)

[Tree] (config>subscr-mgmt>rtr-adv-plcy retransmit-time)

[Tree] (config>service>ies>sub-if>grp-if>ipv6>rtr-adv retransmit-time)

[Tree] (config>service>vprn>router-advert>if retransmit-time)

[Tree] (config>service>vprn>sub-if>ipv6>rtr-adv retransmit-time)

Full Context

configure service vprn subscriber-interface group-interface ipv6 router-advertisements retransmit-time

configure router router-advertisement interface retransmit-time

configure service ies subscriber-interface ipv6 router-advertisements retransmit-time

configure subscriber-mgmt router-advertisement-policy retransmit-time

configure service ies subscriber-interface group-interface ipv6 router-advertisements retransmit-time

configure service vprn router-advertisement interface retransmit-time

configure service vprn subscriber-interface ipv6 router-advertisements retransmit-time

Description

This command configures the value to be placed in the retransmit timer field in router advertisements sent from this interface.

The no form of this command reverts to the default.

Default

retransmit-time 0

Parameters

milli-seconds

Specifies the retransmit time, in milli-seconds, for advertisement from this group-interface.

Values

0 to 1800000

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

  • configure service ies subscriber-interface group-interface ipv6 router-advertisements retransmit-time
  • configure subscriber-mgmt router-advertisement-policy retransmit-time
  • configure service vprn subscriber-interface group-interface ipv6 router-advertisements retransmit-time
  • configure service ies subscriber-interface ipv6 router-advertisements retransmit-time
  • configure service vprn subscriber-interface ipv6 router-advertisements retransmit-time

All

  • configure router router-advertisement interface retransmit-time
  • configure service vprn router-advertisement interface retransmit-time

retries

retries

Syntax

retries number

no retries

Context

[Tree] (config>subscr-mgmt>pfcp-association>heartbeat retries)

Full Context

configure subscriber-mgmt pfcp-association heartbeat retries

Description

This command configures the number of times the same Heartbeat Request message is sent before the PFCP path to the peer is considered down.

The no form of this command reverts to the default value.

Default

retries 4

Parameters

number

Specifies the number of times the same Heartbeat Request message is sent. This value should be identical on both the BNG UPF and CPF. For information about the BNG CUPS CPF configuration, refer to the CMG BNG CUPS Control Plane Function Guide and the 7750 SR MG and CMG CLI Reference Guide.

Values

1 to 15

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

retries

Syntax

retries number

no retries

Context

[Tree] (config>subscr-mgmt>pfcp-association>tx retries)

Full Context

configure subscriber-mgmt pfcp-association tx retries

Description

This command configures the number of times a message is retried before the message is considered lost. This retry number is also known as N1.

The no form of this command reverts to the default value.

Default

retries 3

Parameters

number

Specifies the number of times a message is retried.

This value should be identical on both the BNG UPF and CPF. For information about the BNG CUPS CPF configuration, refer to the CMG BNG CUPS Control Plane Function Guide and the 7750 SR MG and CMG CLI Reference Guide.

Values

1 to 7

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

retries

Syntax

retries count

no retries

Context

[Tree] (config>system>grpc>tcp-keepalive retries)

Full Context

configure system grpc tcp-keepalive retries

Description

This command configures the number of TCP keepalive probes sent by the router that must be unacknowledged before the connection is closed.

The no form of this command reverts to the default value.

Default

retries 4

Parameters

count

Specifies the number of missed keep-alives before the TCP connection is declared down.

Values

3 to 100

Default

4

Platforms

All

retries

Syntax

retries count

no retries

Context

[Tree] (config>system>grpc-tunnel>destination-group>tcp-keepalive retries)

[Tree] (config>system>telemetry>destination-group>tcp-keepalive retries)

Full Context

configure system grpc-tunnel destination-group tcp-keepalive retries

configure system telemetry destination-group tcp-keepalive retries

Description

This command configures the number of missed TCP keepalive probes before the TCP connection is closed and attempts are made to reach other destinations within the same destination group.

The no form of this command reverts to the default value.

Default

retries 4

Parameters

count

Specifies the number of missed keep-alives before the TCP connection is declared down.

Values

3 to 100

Default

4

Platforms

All