6. b Commands

6.1. back

back

Syntax 
back
Context 
[Tree] (global back)
Full Contexts 
global back
Description 

This command moves the context back one level of the command hierarchy. For example, if the current level is the config router ospf context, the back command moves the cursor to the config router context level.

6.2. backbone-vpls

backbone-vpls

Syntax 
backbone-vpls service-id [isid isid]
no backbone-vpls
Context 
[Tree] (config>service>vpls>pbb backbone-vpls)
Full Contexts 
configure service vpls pbb backbone-vpls
Description 

This command configures B-VPLS service associated with the I-VPLS.

Parameters 
service-id—
Specifies the service ID.
Values—
1 to 2147483648

 

isid—
Specifies the ISID.
Values—
0 to 16777215

 

Platforms 

All

6.3. backup

backup

Syntax 
[no] backup ip-address
Context 
[Tree] (config>service>ies>if>ipv6>vrrp backup)
Full Contexts 
configure service ies interface ipv6 vrrp backup
Description 

This command configures virtual router IP addresses for the interface.

Platforms 

All

backup

Syntax 
[no] backup ip-address
Context 
[Tree] (config>service>ies>if>vrrp backup)
Full Contexts 
configure service ies interface vrrp backup
Description 

This command configures virtual router IP addresses for the interface.

Platforms 

All

backup

Syntax 
[no] backup ip-address
Context 
[Tree] (config>service>vprn>if>vrrp backup)
Full Contexts 
configure service vprn interface vrrp backup
Description 

This command configures virtual router IP addresses for the interface.

Platforms 

All

backup

Syntax 
[no] backup ipv6-address
Context 
[Tree] (config>service>vprn>if>ipv6>vrrp backup)
Full Contexts 
configure service vprn interface ipv6 vrrp backup
Description 

This command configures virtual router IP addresses for the interface.

Platforms 

All

backup

Syntax 
[no] backup [mda-id | esa-vm-id]
Context 
[Tree] (config>isa>aa-grp backup)
Full Contexts 
configure isa application-assurance-group backup
Description 

This command assigns an AA ISA or ESA-VM configured in the specified location to this application assurance group. The backup module provides the application assurance group with warm redundancy when the primary module in the group is configured. Primary and backup modules have equal operational status and when both module are coming up, the ones that becomes operational first becomes the active module. A module can serve as a backup for multiple AA ISA cards but only one can fail to it at one time.

On an activity switch from the primary module, configurations are already on the backup MDA but flow state information must be re-learned. Any statistics not yet spooled will be lost. Auto-switching from the backup to primary, once the primary becomes available again, is not supported.

Operator is notified through SNMP events when:

  1. When the AA service goes down (all modules in the group are down) or comes back up (a module in the group becomes active).
  2. When AA redundancy fails (one of the modules in the group is down) or recovers (the failed module comes back up).
  3. When an AA activity switch occurred.

The no form of this command removes the specified module from the application assurance group.

Parameters 
mda-id—
Specifies the slot and MDA, identifying a provisioned module to use as a backup module.
Values—

slot/mda

slot

1 to 10, depending on chassis model

mda

1 to 2

 

esa-vm-id—
Specifies the ESA and VM, identifying a provisioned module to use as a backup module; for example, an ESA 1 with VM2 would be referred to as esa-1/2.
Values—

esa-esa-id/vm-id

esa-id

1 to 16

vm-id

1 to 4

 

Platforms 

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

backup

Syntax 
backup mda-id
no backup
Context 
[Tree] (config>isa>tunnel-grp backup)
Full Contexts 
configure isa tunnel-group backup
Description 

This command assigns a tunnel ISA configured in the specified slot to this IPsec group. The backup module provides the IPsec group with warm redundancy when the primary module in the group is configured. An IPsec group must always have a primary configured.

Primary and backup modules have equal operational status and when both modules are coming up, the one that becomes operational first becomes the active module. An IPsec module can serve as a backup for multiple IPsec groups but the backup can become active for only one ISA IPsec group at a time.

All configuration information is pushed down to the backup MDA from the CPM once the CPM gets notice that the primary module has gone down. This allows multiple IPsec groups to use the same backup module. Any statistics not yet spooled will be lost. Auto-switching from the backup to primary, once the primary becomes available again, is supported.

The operator is notified through SNMP events when:

  1. When the ISA IPsec service goes down (all modules in the group are down) or comes back up (a module in the group becomes active).
  2. When ISA IPsec redundancy fails (one of the modules in the group is down) or recovers (the failed module comes back up).
  3. When an ISA IPsec activity switch took place.

The no form of this command removes the specified module from the IPsec group.

Default 

no backup

Parameters 
mda-id—
Specifies the card/slot identifying a provisioned module to be used as a backup module.
Values—
mda-id: slot/mda slot 1 to up to 10 depending on chassis model mda 1 to 2

 

Platforms 

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

backup

Syntax 
[no] backup ip-address
Context 
[Tree] (config>router>if>vrrp backup)
Full Contexts 
configure router interface vrrp backup
Description 

This command associates router IP addresses with the parental IP interface IP addresses.

The backup command has two distinct functions when used in an owner or a non-owner context of the virtual router instance.

Non-owner virtual router instances actually create a routable IP interface address that is operationally dependent on the virtual router instance mode (master or backup). The backup command in owner virtual router instances does not create a routable IP interface address; it simply defines the existing parental IP interface IP addresses that are advertised by the virtual router instance.

For owner virtual router instances, the backup command defines the IP addresses that are advertised within VRRP advertisement messages. This communicates the IP addresses that the master is representing to backup virtual routers receiving the messages. Advertising a correct list is important. The specified ip-address must be equal to one of the existing parental IP interface IP addresses (primary or secondary) or the backup command fails.

For non-owner virtual router instances, the backup command actually creates an IP interface IP address used for routing IP packets and communicating with the system when the access commands are defined (ntp-reply, ping-reply, telnet-reply, and ssh-reply). The specified ip-address must be an IP address that is within one of the parental IP interface local subnets created with the address or secondary commands. If a local subnet does not exist that includes the specified ip-address or if ip-address is the same IP address as the parental IP interface IP address, the backup command fails.

The new interface IP address created with the backup command assumes the mask and parameters of the corresponding parent IP interface IP address. The ip-address is only active when the virtual router instance is operating in the master state. When not operating as master, the virtual router instance acts as if it is operationally down. It does not respond to ARP requests to ip-address, nor does it route packets received with its vrid derived source MAC address. A non-master virtual router instance always silently discards packets destined to ip-address. A single virtual router instance may only have a single virtual router IP address from a given parental local subnet. Multiple virtual router instances can define a virtual router IP address from the same local subnet as long as each is a different IP address.

In IPv4, up to sixteen backup ip-address commands can be executed within the same virtual router instance. Executing backup multiple times with the same ip-address results in no operation performed and no error generated. At least one successful backup ip-address command must be executed before the virtual router instance can enter the operational state.

When operating as (non-owner) master, the default functionality associated with ip-address is ARP response to ARP requests to ip-address, routing of packets destined to the virtual router instance source MAC address and silently discarding packets destined to ip-address. Enabling the non-owner-access parameters selectively allows ping, Telnet and SSH connectivity to ip-address when the virtual router instance is operating as master.

The no form of the command removes the specified virtual router IP address from the virtual router instance. For non-owner virtual router instances, this causes all routing and local access associated with the ip-address to cease. For owner virtual router instances, the no backup command only removes ip-address from the list of advertised IP addresses. If the last ip-address is removed from the virtual router instance, the virtual router instance will enter the operationally down state

Default 

no backup — No virtual router IP address is assigned.

Special Cases 
Assigning the Virtual Router ID IP Address—
Once the vrid is created on the parent IP interface, IP addresses need to be assigned to the virtual router instance. If the vrid was created with the keyword owner, the virtual router instance IP addresses must have one or more of the parent IP interface defined IP addresses (primary and secondary). For non-owner virtual router instances, the virtual router IP addresses each must be within one of the parental IP interface IP address defined local subnets. For both owner and non-owner virtual router instances, the virtual router IP addresses must be explicitly defined using the backup ip-addr command.
Virtual Router Instance IP Address Assignment Conditions—
The RFC does not specify that the assigned IP addresses to the virtual router instance must be in the same subnet as the parent IP interface primary IP address or secondary IP addresses. The only requirement is that all virtual routers participating in the same virtual router instance have the same virtual router IP addresses assigned. To avoid confusion, the assigned virtual router IP addresses must be in a local subnet of one of the parent IP interfaces IP addresses. For owner virtual router instances the assigned virtual router IP address must be the same as one of the parental IP interface primary or secondary IP addresses.

The following rules apply when adding, changing, or removing parental and virtual router IP addresses:

Owner Virtual Router IP Address Parental Association—
When an IP address is assigned to an owner virtual router instance, it must be associated with one of the parental IP interface-assigned IP addresses. The virtual router IP address must be equal to the primary or one of the secondary IP addresses within the parental IP interface.
Table 29:  Example - Owner Virtual Router Instance

Parent IP addresses:

10.10.10.10/24

11.11.11.11/24

Virtual router IP addresses:

10.10.10.11

Invalid (not equal to parent IP address)

10.10.10.10

Associated (same as parent IP address 10.10.10.10)

10.10.11.11

Invalid (not equal to parent IP address)

11.11.11.254

Invalid (not equal to parent IP address)

11.11.11.255

Invalid (not equal to parent IP address)

Non-Owner Virtual Router IP Address Parental Association—
When an IP address is assigned to a non-owner virtual router instance, it must be associated with one of the parental IP interface assigned IP addresses. The virtual router IP address must be a valid IP address within one of the parental IP interfaces local subnet. Local subnets are created by the primary or secondary IP addresses in conjunction with the IP addresses mask. If the defined virtual router IP address is equal to the associated subnet’s broadcast address, it is invalid. Virtual router IP addresses for non-owner virtual router instances that are equal to a parental IP interface IP address are also invalid.

The same virtual router IP address may not be assigned to two separate virtual router instances. If the virtual router IP address already exists on another virtual router instance, the virtual router IP address assignment will fail.

Table 30:  Example - Non-Owner Virtual Router Instance

Parent IP addresses:

10.10.10.10/24

11.11.11.11/24

Virtual router IP addresses:

10.10.10.11

Associated with 10.10.10.10 (in subnet)

10.10.10.10

Invalid (same as parent IP address)

10.10.11.11

Invalid (outside of all Parent IP subnets)

11.11.11.254

Associated with 11.11.11.11 (in subnet)

11.11.11.255

Invalid (broadcast address of 11.11.11.11/24)

Virtual Router IP Address Assignment without Parent IP Address—
When assigning an IP address to a virtual router instance, an associated IP address (see backup) on the parental IP interface must already exist. If an associated IP address on the parental IP interface is not configured, the virtual router IP address assignment fails.
Parent Primary IP Address Changed—
When a virtual router IP address is set and the associated parent IP interface IP address is changed, the new parent IP interface IP address is evaluated to ensure it meets the association rules defined in backup (config>router>if>vrrp backup) or config>router>if>ipv6>vrrp backup. If the association check fails, the parental IP address change is not allowed. If the parental IP address change fails, the previously configured IP address definition remains in effect.

Only the primary parent IP address can be changed. Secondary addresses must be removed before the new IP address can be added. backup (config>router>if>vrrp backup) explains IP address removal conditions.

Parent Primary or Secondary IP Address Removal—
When a virtual router IP address is successfully set, but removing the associated parent IP interface IP address is attempted and fails. All virtual router IP addresses associated with the parental IP interface IP address must be deleted prior to removing the parental IP address. This includes virtual router IP address associations from multiple virtual router instances on the IP interface.
Parameters 
ip-address—
The virtual router IP address expressed in dotted decimal notation. The IP virtual router IP address must be in the same subnet of the parental IP interface IP address or equal to one of the primary or secondary IP addresses for owner virtual router instances.
Values—
1.0.0.1 to 223.255.255.254

 

Platforms 

All

backup

Syntax 
[no] backup ipv6-address
Context 
[Tree] (config>router>if>ipv6>vrrp backup)
Full Contexts 
configure router interface ipv6 vrrp backup
Description 

This command associates router IPv6 addresses with the parental IP interface IP addresses.

The backup command has two distinct functions when used in an owner or a non-owner context of the virtual router instance.

Non-owner virtual router instances actually create a routable IP interface address that is operationally dependent on the virtual router instance mode (master or backup). The backup command in owner virtual router instances does not create a routable IP interface address; it simply defines the existing parental IP interface IP addresses that are advertised by the virtual router instance.

For owner virtual router instances, the backup command defines the IP addresses that are advertised within VRRP advertisement messages. This communicates the IP addresses that the master is representing to backup virtual routers receiving the messages. Advertising a correct list is important. The specified ipv6-addr must be equal to one of the existing parental IP interface IP addresses (link-local or global) or the backup command will fail.

For non-owner virtual router instances, the backup command actually creates an IP interface IP address used for routing IP packets and communicating with the system when the access commands are defined (ntp-reply, ping-reply, telnet-reply, and ssh-reply). The specified ipv6-addr must be an IP address that is within one of the parental IP interface local subnets created with the link-local-address or address commands. If a local subnet does not exist that includes the specified ipv6-addr or if ipv6-addr is the same IP address as the parental IP interface IP address, the backup command will fail.

The new interface IP address created with the backup command assumes the mask and parameters of the corresponding parent IP interface IP address. The ipv6-addr is only active when the virtual router instance is operating in the master state. For IPv6 VRRP, the parental interface's IP address that is in the same subnet as the backup address must be manually-configured, non EUI-64 and configured to be in the preferred state.

When not operating as master, the virtual router instance acts as if it is operationally down. It will not respond to Neighbor Solicitation (NS) requests to ipv6-addr, nor will it route packets received with its vrid derived source MAC address. A non-master virtual router instance always silently discards packets destined to ipv6-addr.

IPv6 allows the configuration of a link-local IPv6 address and multiple global IPv6 addresses on an interface. For each of these configured subnets, a virtual router IP address can be configured. Each IPv6 enabled device on a particular IPv6 subnet dynamically learns the connected IPv6 routers and correlated subnets in addition to the IPv6 default gateway using IPv6 neighbor discovery protocol (RFC4861). This protocol behavior is revised from IPv4 where the default gateway is manually configured or derived from supporting protocols (for example, DHCP). During the IPv6 neighbor discovery process, VRRP enabled routers will use backup IPv6 addresses and correlated derived virtual MAC addresses. Multiple virtual router instances can define a virtual router IP address from the same local subnet as long as each is a different IP address.

Executing backup multiple times with the same ipv6-addr results in no operation performed and no error generated. At least one successful backup ipv6-addr command must be executed before the virtual router instance can enter the operational state.

When operating as (non-owner) master, the default functionality associated with ipv6-addr results in the IPv6 Neighbor Advertisement response to IPv6 Neighbor Solicitation requests to ip-addr, routing of packets destined to the virtual router instance source MAC address, and silently discarding packets destined to ipv6-addr. An IPv6 virtual router instance can enter the operational state only if one of the configured backup addresses is a link-local address and the router advertisement of the interface is configured to use the virtual MAC address. Enabling the non-owner-access parameters selectively allows ping, Telnet, and traceroute connectivity to ipv6-addr when the virtual router instance is operating as master.

The no form of the command removes the specified virtual router IP address from the virtual router instance. For non-owner virtual router instances, this causes all routing and local access associated with the ipv6-addr to cease. For owner virtual router instances, the no backup command only removes ipv6-addr from the list of advertised IP addresses. If the last ipv6-addr or the link-local address is removed from the virtual router instance, the virtual router instance will enter the operationally down state

Default 

no backup — No virtual router IP address is assigned.

Special Cases 
Assigning the Virtual Router ID Address—
Once the vrid is created on the parent IP interface, IP addresses need to be assigned to the virtual router instance. If the vrid was created with the keyword owner, the virtual router instance IP addresses must have one or more of the parent IP interface defined IP addresses. For non-owner virtual router instances, the virtual router IP addresses each must be within one of the parental IP interface IP address defined local subnets. For both owner and non-owner virtual router instances, the virtual router IP addresses must be explicitly defined using the backup ipv6-addr command.

The following rules apply when adding, changing, or removing parental and virtual router IP addresses:

Owner Virtual Router IP Address Parental Association—
When an IP address is assigned to an owner virtual router instance, it must be associated with one of the parental IP interface-assigned IP addresses.
Table 31:  Example - Owner Virtual Router Instance

Parent IP addresses

2001:db8:1::2/64

fe80::1:2/64

Virtual router IP addresses

2001:db8:1::23

Invalid (not equal to parent IP address)

2001:db8:1::2

Associated (same as parent IP address)

2001:db8:2::23

Invalid (not equal to parent IP address)

Non-Owner Virtual Router IP Address Parental Association—
When an IP address is assigned to a non-owner virtual router instance, it must be associated with one of the parental IP interface assigned IP addresses. The virtual router IP address must be a valid IP address within one of the parental IP interfaces local subnet. Local subnets are created by the link-local or global IP addresses in conjunction with the IP addresses mask. Virtual router IP addresses for non-owner virtual router instances that are equal to a parental IP interface IP address are also invalid.

The same virtual router IP address may not be assigned to two separate virtual router instances. If the virtual router IP address already exists on another virtual router instance, the virtual router IP address assignment will fail.

One exception to this rule is for the IPv6 link-local address that is configured as a backup address. The same link-local address can be configured in all virtual routers that use the same vrid.

Table 32:  Example - Non-Owner Virtual Router Instance

Parent IP addresses:

2001:db8:1::2/64

fe80::1:2/64

Virtual router IPv6 addresses:

2001:db8:1::23

Associated with 2001:db8:1::2 (in subnet)

2001:db8:1::2

Invalid (same as parent IP address)

2001:db8:2::2

Invalid (outside of all Parent IP subnets)

fe80::1:23

Associated with fe80::1:2 (in subnet)

Virtual Router IP Address Assignment without Parent IP Address—
When assigning an IP address to a virtual router instance, an associated IP address (see config>router>if>vrrp backup and config>router>if>ipv6>vrrp backup [this command]) on the parental IP interface must already exist. If an associated IP address on the parental IP interface is not configured, the virtual router IP address assignment fails.
Virtual Router IPv6 Address Assignment—
An IPv6 backup address requires that the parental IP address that is in the same subnet as the backup address must be manually configured, non-EUI-64 and configured to be in the preferred state. A configured IPv6 address is manually set in preferred state by using the dad-disable command. A configured IPv6 address on an interface with DAD disabled, immediately enters preferred state, without checking for uniqueness on the interface.
Parameters 
ipv6-address—
The virtual router IP address is represented as eight groups of four hexadecimal digits, each group representing 16 bits (two octets). The groups are separated by colons (:). The IP virtual router IP address must be in the same subnet of the parental IP interface IP address or equal to one of the parent interface addresses for owner virtual router instances.
Values—

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..FFFF]H

d: [0..255]D

 

Platforms 

All

6.4. backup-class-type

backup-class-type

Syntax 
backup-class-type ct-number
no backup-class-type
Context 
[Tree] (config>router>mpls>lsp>primary backup-class-type)
Full Contexts 
configure router mpls lsp primary backup-class-type
Description 

This command enables the use of the Diff-Serv backup Class-Type (CT), instead of the Diff-Serv main CT, to signal the LSP primary path when it fails and goes into retry. The Diff-Serv main CT is configured at the LSP level or at the primary path level using the following commands:

config>router>mpls>lsp>class-type ct-number

config>router>mpls>lsp>primary>class-type ct-number

When an LSP primary path retries due a failure, for example, it fails after being in the UP state, or undergoes any type of Make-Before-Break (MBB), MPLS will retry a new path for the LSP using the main CT. If the first attempt failed, the head-end node performs subsequent retries using the backup CT. This procedure must be followed regardless if the currently used CT by this path is the main or backup CT. This applies to both CSPF and non-CSPF LSPs.

The triggers for using the backup CT after the first retry attempt are:

  1. A local interface failure or a control plane failure (hello timeout and so on).
  2. Receipt of a PathErr message with a notification of a FRR protection becoming active downstream and/or Receipt of a Resv message with a ‘Local-Protection-In-Use’ flag set. This invokes the FRR Global Revertive MBB.
  3. Receipt of a PathErr message with error code=25 (“Notify”) and sub-code=7 (“Local link maintenance required”) or a sub-code=8 (“Local node maintenance required”). This invokes the TE Graceful Shutdown MBB.
  4. Receipt of a Resv refresh message with the ‘Preemption pending’ flag set or a PathErr message with error code=34 (“Reroute”) and a value=1 (“Reroute request soft preemption”). This invokes the soft preemption MBB.
  5. Receipt of a ResvTear message.
  6. A configuration change MBB.
  7. The user executing the clear>router>mpls>lsp command.

When an unmapped LSP primary path goes into retry, it uses the main CT until the number of retries reaches the value of the new main-ct-retry-limit parameter. If the path did not come up, it must start using the backup CT at that point in time. By default, this parameter is set to infinite value. The new main-ct-retry-limit parameter has no effect on an LSP primary path which retries due to a failure event.

An unmapped LSP primary path is a path which has never received a Resv in response to the first Path message sent. This can occur when performing a ‘shut/no-shut’ on the LSP or LSP primary path or when the node reboots. An unmapped LSP primary path goes into retry if the retry timer expired or the head-end node received a PathErr message before the retry timer expired.

When the re-signal timer expires, CSPF will try to find a path with the main CT. The head-end node must re-signal the LSP even if the new path found by CSPF is identical to the existing one since the idea is to restore the main CT for the primary path. A path with main CT is not found, the LSP remains on its current primary path using the backup CT.

When the user performs a manual re-signal of the primary path, CSPF will try to find a path with the main CT. The head-end node must re-signal the LSP as in current implementation.

The no form of this command disables the use of the Diff-Serv backup CT.

Default 

no backup-class-type

Parameters 
ct-number—
Specifies the Diff-Serv Class Type number. One or more system forwarding classes can be mapped to a CT.
Values—
0 to 7, integer

 

Platforms 

All

6.5. backup-next-hop

backup-next-hop

Syntax 
[no] backup-next-hop
Context 
[Tree] (config>router>mpls>fwd-policies>fwd-policy>nh-grp backup-next-hop)
Full Contexts 
configure router mpls forwarding-policies forwarding-policy next-hop-group backup-next-hop
Description 

Commands in this context configure the backup next hop of an NHG entry in a forwarding policy.

The no form of this command removes the backup next hop context from an NHG entry in a forwarding policy.

Platforms 

All

backup-next-hop

Syntax 
backup-next-hop
Context 
[Tree] (config>router>static-route-entry>next-hop backup-next-hop)
[Tree] (config>service>vprn>static-route-entry>next-hop backup-next-hop)
Full Contexts 
configure router static-route-entry next-hop backup-next-hop
configure service vprn static-route-entry next-hop backup-next-hop
Description 

Commands in this context configure static route entry fast failover.

Platforms 

All

6.6. backup-node-sid

backup-node-sid

Syntax 
backup-node-sid ip-prefix/prefix-length index index
backup-node-sid ip-prefix/prefix-length label label
no backup-node-sid
Context 
[Tree] (config>router>ospf>segm-rtng backup-node-sid)
Full Contexts 
configure router ospf segment-routing backup-node-sid
Description 

This command enables LFA Protection using segment routing backup node SID.

The objective of this feature is to reduce the label stack pushed in a LFA tunnel next hop of inter-area and inter-domain prefixes. This is applicable in MPLS deployments across multiple IGP areas or domains such in seamless MPLS design.

The user enables the feature by configuring a backup node SID at an ABR/ASBR that is acting as a backup to the primary exit ABR/ASBR of inter-area or inter-as routes learned as BGP labeled routes. The user can enter either a label or an index for the backup node SID.

When a node in a IGP domain resolves a BGP label route for an inter-area or inter-domain prefix via the primary ABR exit router, it will use the backup node SID of this router, which is advertised by the backup ABR/ABR, as the LFA backup instead of the SID to the remote LFA PQ node to save on the pushed label stack.

This feature only allows the configuration of a single backup node SID per IGP instance and per ABR/ASBR. In other words, only a pair of ABR/ASBR nodes can back up each other in an IGP domain. Each time the user invokes the above command within the same IGP instance, it will override any previous configuration of the backup node SID. The same ABR/ASBR can, however, participate in multiple IGP instances and provide backup support within each instance.

Default 

no backup-node-sid

Parameters 
ip-prefix/prefix-length—
Specifies the IP prefix in dotted decimal notation for the range used by the ABR to advertise that summarizes the area into another area.
Values—
ip-prefix/mask:
  1. ip-prefix a.b.c.d (host bits must be 0)
ipv6-prefix:
  1. x:x:x:x:x:x:x:x (eight 16-bit pieces)
  2. x:x:x:x:x:x:d.d.d.d
  3. x: [0 to FFFF]H
  4. d: [0 to 255]D
prefix-length: 0 to 128

 

index—
Specifies the index for this backup node SID.
Values—
0 to 4294967295

 

label—
Specifies the SID value for this backup node SID.
Values—
1 to 4294967295

 

Platforms 

All

6.7. backup-path

backup-path

Syntax 
[no] backup-path [ipv4] [ipv6] [label-ipv4] [label-ipv6]
Context 
[Tree] (config>service>vprn>bgp backup-path)
Full Contexts 
configure service vprn bgp backup-path
Description 

This command enables the computation and use of a backup path for IPv4 and/or IPv6 BGP-learned prefixes belonging to the base router or a particular VPRN. Multiple paths must be received for a prefix to take advantage of this feature. When a prefix has a backup path and its primary paths fail, the affected traffic is rapidly diverted to the backup path without waiting for control plane reconvergence to occur. When many prefixes share the same primary paths, and in some cases also the same backup path, the time to failover traffic to the backup path is independent of the number of prefixes.

By default, IPv4 and IPv6 prefixes do not have a backup path installed in the IOM.

Default 

no backup-path

Parameters 
ipv4 —
Keyword that enables the use of a backup path for BGP-learned unlabeled IPv4 prefixes.
ipv6 —
Keyword that enables the use of a backup path for BGP-learned unlabeled IPv6 prefixes.
label-ipv4 —
Keyword that enables the use of a backup path for BGP-learned labeled-IPv4 prefixes.
label-ipv6 —
Keyword that enables support for labeled-unicast IPv6 routes.
Platforms 

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

backup-path

Syntax 
[no] backup-path [ipv4] [ipv6] [label-ipv4] [label-ipv6]
Context 
[Tree] (config>router>bgp backup-path)
Full Contexts 
configure router bgp backup-path
Description 

This command enables the computation and use of a backup path for IPv4 and/or IPv6 BGP-learned prefixes belonging to the base router. Multiple paths must be received for a prefix to take advantage of this feature. When a prefix has a backup path and its primary paths fail, the affected traffic is rapidly diverted to the backup path without waiting for control plane reconvergence to occur. When many prefixes share the same primary paths, and in some cases also the same backup path, the time to failover traffic to the backup path is independent of the number of prefixes.

By default, IPv4 and IPv6 prefixes do not have a backup path installed in the IOM.

Default 

no backup-path

Parameters 
ipv4 —
Keyword that enables BGP fast reroute for unlabeled unicast IPv4 routes.
ipv6 —
Keyword that enables BGP fast reroute for unlabeled unicast IPv6 routes.
label-ipv4 —
Keyword that enables BGP fast reroute for labeled-unicast IPv4 routes.
label-ipv6 —
Keyword that enables BGP fast reroute for labeled-unicast IPv6 routes.
Platforms 

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

6.8. backup-remote-ip

backup-remote-ip

Syntax 
backup-remote-ip ip-address
no backup-remote-ip
Context 
[Tree] (config>service>ies>if>sap>ip-tunnel backup-remote-ip)
[Tree] (config>service>vprn>if>sap>ip-tunnel backup-remote-ip)
Full Contexts 
configure service ies interface sap ip-tunnel backup-remote-ip
configure service vprn interface sap ip-tunnel backup-remote-ip
Description 

This command configures the alternate destination IPv4 or IPv6 address to use for an IP tunnel. This destination address is used only if the primary destination configured with the remote-ip command is unreachable in the delivery service. 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 backup-remote-ip address contains an IPv6 address it must be a global unicast address.

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

Default 

no backup-remote-ip

Parameters 
ip-address—
Specifies the destination IPv4 address or IPv6 address of the tunnel.
Values—
ipv4-address:
  1. a.b.c.d
ipv6-address:
  1. x:x:x:x:x:x:x:x (eight 16-bit pieces)
  2. x:x:x:x:x:x:d.d.d.d
  3. x: [0 to FFFF]H
  4. d: [0 to 255]D

 

Platforms 

All

6.9. backup-tag

backup-tag

Syntax 
backup-tag tag-id
no backup-tag
Context 
[Tree] (config>router>static-route-entry backup-tag)
[Tree] (config>service>vprn>static-route-entry backup-tag)
Full Contexts 
configure router static-route-entry backup-tag
configure service vprn static-route-entry backup-tag
Description 

This command associates a 4-byte backup route tag with the static route when the backup-next-hop command is activated. The tag value is an identifier that can be used in route policies to control distribution of the static route into other protocols when the backup-next-hop is activated for the associated static route.

The tag specified at this level of the static route causes the tag values that are configured under the next-hop, black-hole, and indirect contexts of the static route to be ignored.

The no form of this command removes the tag association.

Default 

no backup-tag

Parameters 
tag-id—
Specifies an integer tag value.
Values—
1 to 4294967295

 

Platforms 

All

6.10. bandwidth

bandwidth

Syntax 
bandwidth bandwidth
no bandwidth
Context 
[Tree] (config>lag>access bandwidth)
[Tree] (config>port>ethernet>access bandwidth)
Full Contexts 
configure lag access bandwidth
configure port ethernet access bandwidth
Description 

This command configures the administrator bandwidth assigned and available to ports and LAGs for use by SAP bandwidth Connection Admission Control (CAC). The administrator bandwidth on a port or LAG can be overbooked or underbooked using the booking-factor command.

Port or LAG: Increasing the port or LAG admin bandwidth will increase the available admin bandwidth on that port or LAG. Reducing the port or LAG admin bandwidth will reduce the available admin bandwidth on that port or LAG, however, if the reduction of available admin bandwidth would cause it to be insufficient to cover the sum of the current SAP admin bandwidth on the port or LAG then the command will fail.

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

Default 

no bandwidth

Parameters 
bandwidth—
Specifies the administrator bandwidth, in kb/s, that is assigned to the port or LAG.
Values—
1 to 6400000000

 

Platforms 

All

bandwidth

Syntax 
bandwidth bandwidth
no bandwidth
Context 
[Tree] (config>service>apipe>sap bandwidth)
[Tree] (config>service>epipe>sap bandwidth)
[Tree] (config>service>fpipe>sap bandwidth)
[Tree] (config>service>ipipe>sap bandwidth)
Full Contexts 
configure service apipe sap bandwidth
configure service epipe sap bandwidth
configure service fpipe sap bandwidth
configure service ipipe sap bandwidth
Description 

This command configures the administrator bandwidth assigned and available to SAPs for use by SAP bandwidth Connection Admission Control (CAC).

Attempts to increase the SAP administrator bandwidth fail if there is insufficient available administrator bandwidth on its port or LAG, otherwise the available port or LAG administrator bandwidth is reduced by the incremental SAP administrator bandwidth. Reducing the SAP administrator bandwidth increases the available administrator bandwidth on its port or LAG.

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

Default 

no bandwidth

Parameters 
bandwidth—
Specifies the administrator bandwidth, in kb/s, that is assigned to the SAP.
Values—
1 to 6400000000

 

Platforms 

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

  1. configure service fpipe sap bandwidth

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

  1. configure service apipe sap bandwidth

All

  1. configure service epipe sap bandwidth
  2. configure service ipipe sap bandwidth

bandwidth

Syntax 
bandwidth bw-value
bandwidth max
no bandwidth
Context 
[Tree] (config>service>apipe>spoke-sdp bandwidth)
[Tree] (config>service>cpipe>spoke-sdp bandwidth)
[Tree] (config>service>epipe>spoke-sdp bandwidth)
[Tree] (config>service>fpipe>spoke-sdp bandwidth)
[Tree] (config>service>ipipe>spoke-sdp bandwidth)
Full Contexts 
configure service apipe spoke-sdp bandwidth
configure service cpipe spoke-sdp bandwidth
configure service epipe spoke-sdp bandwidth
configure service fpipe spoke-sdp bandwidth
configure service ipipe spoke-sdp bandwidth
Description 

This command specifies the bandwidth to be used for VLL bandwidth accounting by the VLL CAC feature.

The service manager keeps track of the available bandwidth for each SDP. The maximum value is the sum of the bandwidths of all constituent LSPs in the SDP. The SDP available bandwidth is adjusted by the user configured booking factor.

If an LSP consists of a primary and many secondary standby LSPs, then the bandwidth used in the maximum SDP available bandwidth is that of the active path. Any change to and LSP active path bandwidth will update the maximum SDP available bandwidth. Note however that a change to any constituent LSP bandwidth due to re-signaling of the primary LSP path or the activation of a secondary path which causes overbooking of the maximum SDP available bandwidth causes a warning and a trap to be issued but no further action is taken. The activation of a bypass or detour LSP in the path of the primary LSP does not change the maximum SDP available bandwidth.

When the user binds a VLL service to this SDP, an amount of bandwidth equal to bandwidth is subtracted from the SDP available bandwidth adjusted by the booking factor. When the user deletes this VLL service binding from this SDP, an amount of bandwidth equal to bandwidth is added back into the SDP available bandwidth.

If the total SDP available bandwidth when adding this VLL service is about to overbook, a warning is issued and the binding is rejected. This means that the spoke SDP bandwidth does not update the maximum SDP available bandwidth. In this case, the spoke SDP is put in operational down state and a status message of “pseudowire not forwarding” is sent to the remote SR-series PE node. A trap is also generated. The service manager will not put the spoke SDP into an operationally up state until the user executes a shutdown command and then a no-shutdown command of the spoke SDP and the bandwidth check succeeds. Therefore, the service manager will not automatically audit spoke SDPs subsequently to their creation to check if bandwidth is available.

If the VLL service contains an endpoint with multiple redundant spoke SDPs, each spoke SDP will have its bandwidth checked against the available bandwidth of the corresponding SDP.

If the VLL service performs a pseudowire switching (VC switching) function, each spoke SDP is separately checked for bandwidth against the corresponding SDP.

This feature does not alter the way service packets are sprayed over multiple RSVP LSPs, which are part of the same SDP. That is, by default load balancing of service packets occurs over the SDP LSPs based on service-id, or based on a hash of the packet header if ingress SAP shared queuing is enabled. In both cases, the VLL bandwidth is not checked against the available bandwidth of the selected LSPs but on the total SDP available bandwidth. Therefore, if there is a single LSP per SDP, these two matches.

If class-forwarding is enabled on the SDP, VLL service packets are forwarded to the SDP LSP which the packet forwarding class maps to, or if this is down to the default LSP. However, the VLL bandwidth is not checked against the selected LSP available bandwidth but on the total SDP available bandwidth. If there is a single LSP per SDP, these two matches.

If a non-zero bandwidth is specified for a VLL service and attempts to bind the service to an LDP or a GRE SDP, a warning is issued that CAC failed but the VLL is established. A trap is also generated.

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

Parameters 
bw-value—
The bandwidth to be used for VLL bandwidth accounting by the VLL CAC feature, in kilobits per second.
Values—
0 to 100000000

 

Default—
0
Platforms 

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

  1. configure service fpipe spoke-sdp bandwidth
  2. configure service cpipe spoke-sdp bandwidth

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

  1. configure service apipe spoke-sdp bandwidth

All

  1. configure service epipe spoke-sdp bandwidth
  2. configure service ipipe spoke-sdp bandwidth

bandwidth

Syntax 
bandwidth bandwidth
no bandwidth
Context 
[Tree] (config>service>vpls>sap bandwidth)
Full Contexts 
configure service vpls sap bandwidth
Description 

This command specifies the admin bandwidth assigned to SAPs, ports and LAGs which is used by SAP bandwidth CAC.

SAP: Attempts to increase the SAP admin bandwidth will fail if there is insufficient available admin bandwidth on its port or LAG, otherwise the port or LAG available admin bandwidth will be reduced by the incremental SAP admin bandwidth. Reducing the SAP admin bandwidth will increase the available admin bandwidth on its port or LAG. This is not supported for PW-SAPs, Ethernet tunnels or subscriber group interface SAPs.

The no version of the command reverts to the default value.

Default 

no bandwidth

Parameters 
bandwidth—
Specifies the admin bandwidth assigned to the SAP, port or LAG, in kb/s.
Values—
1 to 6400000000

 

Platforms 

All

bandwidth

Syntax 
bandwidth bandwidth
no bandwidth
Context 
[Tree] (config>service>ies>if>sap bandwidth)
Full Contexts 
configure service ies interface sap bandwidth
Description 

This command specifies the admin bandwidth assigned to SAPs, ports and LAGs which is used by SAP bandwidth CAC.

SAP: Attempts to increase the SAP admin bandwidth will fail if there is insufficient available admin bandwidth on its port or LAG, otherwise the port or LAG available admin bandwidth will be reduced by the incremental SAP admin bandwidth. Reducing the SAP admin bandwidth will increase the available admin bandwidth on its port or LAG. This is not supported for PW-SAPs, Ethernet tunnels or subscriber group interface SAPs.

The no version of the command reverts to the default value.

Default 

no bandwidth

Parameters 
bandwidth—
Specifies the admin bandwidth assigned to the SAP, port or LAG, in kb/s.
Values—
1 to 6400000000

 

Platforms 

All

bandwidth

Syntax 
bandwidth bandwidth
no bandwidth
Context 
[Tree] (config>service>vprn>if>sap bandwidth)
Full Contexts 
configure service vprn interface sap bandwidth
Description 

This command specifies the admin bandwidth assigned to SAPs, ports and LAGs which is used by SAP bandwidth CAC.

SAP: Attempts to increase the SAP admin bandwidth will fail if there is insufficient available admin bandwidth on its port or LAG, otherwise the port or LAG available admin bandwidth will be reduced by the incremental SAP admin bandwidth. Reducing the SAP admin bandwidth will increase the available admin bandwidth on its port or LAG. This is not supported for PW-SAPs, Ethernet tunnels or subscriber group interface SAPs.

The no version of the command reverts to the default value.

Default 

no bandwidth

Parameters 
bandwidth—
Specifies the admin bandwidth assigned to the SAP, port or LAG, in kb/s.
Values—
1 to 6400000000

 

Platforms 

All

bandwidth

Syntax 
bandwidth signal-type signal-type
no bandwidth
Context 
[Tree] (config>router>gmpls>lsp>working-path bandwidth)
[Tree] (config>router>gmpls>lsp>protect-path bandwidth)
Full Contexts 
configure router gmpls lsp protect-path bandwidth
configure router gmpls lsp working-path bandwidth
Description 

This command specifies the bandwidth to be signaled for the path of the GMPLS LSP. Bandwidth is specified in terms of the RFC 3471 signal type name.

If an empty path is configured or the first hop TE Link is not configured, the system will automatically select a TE Link to use for a GMPLS LSP path based on the lowest available TE Link ID with a matching bandwidth (if a bandwidth is configured for the GMPLS LSP). During a data-bearer link allocation request, an RSVP-requested GMPLS LSP BW can be either a non-zero value as per RFC 3471 signal-type, or it can be zero). There are the following cases:

  1. Case 1 — The requested BW is non-zero as per RFC 3471 Signal-type config:
    a) When a TE (or TE/DB) Link is configured in the related hop, LMP checks whether the related port BW is the same (exact match) as the requested BW, and allocates the port (provided any other checks are OK).
    b) When the related Hop is empty: LMP finds a db-link port to the peer node matching the requested BW, and allocates it.
  2. Case 2 — Requested BW is zero:
    a) When a TE (or TE/DB) Link is configured in the related hop, LMP allocates the port (provided the other checks are OK), and provides the port BW to RSVP to use in signaling.
    b) When the related Hop is empty, LMP finds the first available db-link to the peer (based on lower db-link Id), and allocates it and provides the port BW to RSVP to use in signaling.

The no form of the command updates the bandwidth to zero.

Default 

no bandwidth

Parameters 
signal-type—
Specifies the RFC 3471 name of the signal type representing the requested bandwidth for the GMPLS LSP path.
Values—
{ds0 | ds1 | e1 | ds2 | e2 | ethernet | e3 | ds3 | sts-1 | fast-ethernet | e4 | fc-0-133m | oc-3/stm1 | fc-0-266m | fc-0-531m | oc-12/stm-4 | gige | fc-0-1062m | oc-48/stm-16 | oc-192/stm-64 | 10gige-ieee | oc-768/stm-256 | 100gige-ieee}

 

Platforms 

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

bandwidth

Syntax 
bandwidth bandwidth-in-mbps
no bandwidth
Context 
[Tree] (config>router>mpls>lsp>primary-p2mp-instance bandwidth)
[Tree] (config>router>mpls>lsp-template bandwidth)
Full Contexts 
configure router mpls lsp primary-p2mp-instance bandwidth
configure router mpls lsp-template bandwidth
Description 

This command specifies the amount of bandwidth to be reserved for the P2MP instance.

The config>router>mpls>lsp>primary-p2mp-instance>bandwidth command is not supported on the 7450 ESS.

Parameters 
bandwidth-in-mbps—
Specifies the bandwidth, in Mb/s.
Values—
0 to 6400000

 

Platforms 

All

bandwidth

Syntax 
bandwidth bandwidth-in-mbps
no bandwidth
Context 
[Tree] (config>router>mpls>lsp>primary bandwidth)
[Tree] (config>router>mpls>lsp>secondary bandwidth)
Full Contexts 
configure router mpls lsp primary bandwidth
configure router mpls lsp secondary bandwidth
Description 

This command specifies the amount of bandwidth to be reserved for the LSP path.

The no form of this command resets bandwidth parameters (no bandwidth is reserved).

Default 

no bandwidth (bandwidth setting in the global LSP configuration)

Parameters 
bandwidth-in-mbps—
Specifies the amount of bandwidth reserved for the LSP path in Mb/s.
Values—
0 to 6400000

 

Platforms 

All

bandwidth

Syntax 
bandwidth
Context 
[Tree] (config>isa>video-group>watermark bandwidth)
Full Contexts 
configure isa video-group watermark bandwidth
Description 

Commands in this context configure watermark parameters based on the bandwidth.

Platforms 

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

bandwidth

Syntax 
bandwidth bandwidth-in-kbps
no bandwidth
Context 
[Tree] (config>router>mcac>policy>bundle bandwidth)
Full Contexts 
configure router mcac policy bundle bandwidth
Description 

This command configures the MCAC policy bundle maximum bandwidth.

Parameters 
bandwidth-in-kbps—
Specifies the MCAC policy bandwidth.
Values—
1 to 4294967295

 

Platforms 

All

bandwidth

Syntax 
bandwidth gbps
no bandwidth
Context 
[Tree] (config>card>mda>xcon>mac>lpbk bandwidth)
[Tree] (config>card>xiom>mda>xcon>mac>lpbk bandwidth)
Full Contexts 
configure card mda xconnect mac loopback bandwidth
configure card xiom mda xconnect mac loopback bandwidth
Description 

This command defines the bandwidth for a maximum Layer 2 rate for the MAC loopback. This is equivalent to a faceplate port rate with the difference that the bandwidth of a faceplate port is a Layer 1 rate, which on Ethernet- based ports includes 20B per frame (preamble and inter-packet gap).

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

Default 

bandwidth 100

Parameters 
gbps—
Specifes the bandwidth in Gb/s.
Values—
10, 25, 40, 100, 400

 

Platforms 

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

  1. configure card mda xconnect mac loopback bandwidth

7750 SR-s

  1. configure card xiom mda xconnect mac loopback bandwidth

6.11. bandwidth-distribution

bandwidth-distribution

Syntax 
bandwidth-distribution
Context 
[Tree] (config>qos>adv-config-policy>child-control bandwidth-distribution)
Full Contexts 
configure qos adv-config-policy child-control bandwidth-distribution
Description 

This command modifies or controls the bandwidth distribution phase of the parent virtual scheduler.

This command edits the parameters that control the child given bandwidth for all policers and queues associated with the policy.

Platforms 

All

6.12. bandwidth-policer

bandwidth-policer

Syntax 
bandwidth-policer policer-name
no bandwidth-policer
Context 
[Tree] (config>app-assure>group>policy>aqp>entry>action bandwidth-policer)
Full Contexts 
configure application-assurance group policy app-qos-policy entry action bandwidth-policer
Description 

This command assigns an existing bandwidth policer as an action on flows matching this AQP entry. The match criteria for the AQP entry must specify a uni-directional traffic direction before a policer action can be configured. If a policer is used in one direction in an AQP match entry the same policer name cannot be used by another AQP entry which uses a different traffic direction match criteria.

When multiple policers apply to a single flow, the final action on a packet is the worst case of all policer outcomes (for example, if one of the policers marks packet out of profile, the final marking will reflect that).

The no form of this command removes bandwidth policer from actions on flows matching this AQP entry.

Default 

no bandwidth-policer

Parameters 
policer-name —
Specifies the name of the existing flow setup rate policer for this application assurance profile. The policer-name is configured in the config>app-assure>group>policer context.
Platforms 

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

6.13. bandwidth-policy

bandwidth-policy

Syntax 
bandwidth-policy policy-name [create]
no bandwidth-policy policy-name
Context 
[Tree] (config>mcast-mgmt bandwidth-policy)
Full Contexts 
configure mcast-management bandwidth-policy
Description 

This command creates a multicast bandwidth policy. Bandwidth policies are used to manage the ingress multicast path bandwidth. Each forwarding plane supports multicast forwarding paths into the switch fabric. By default, two paths are available; the multicast high priority path and the multicast low priority path. Multicast packets are forwarded on either path based on the expedited or non-expedited (best-effort) nature of the queue the packets are scheduled from. The ingress forwarding plane uses the classification rules to determine the forwarding class of each multicast packet and uses the forwarding class to queue mapping to decide which ingress multipoint queue forwards the packet.

When multicast path management is enabled, the ingress forwarding plane allows IP multicast snooped or routed packets to be placed on to the two multicast paths independently of the ingress classification rules. The high priority multicast path is treated as the primary path and the low priority multicast path is treated as the secondary path. The ingress bandwidth manager evaluates each multicast FIB (M-FIB) record to determine which path is best based on ingress bandwidth, number of switch fabric destinations and the fill level of each path. Explicit path association is also supported.

Dynamic Bandwidth Activity Monitoring

When ingress multicast path management is enabled on an MDA, the system monitors the in-use bandwidth associated with each Layer 2 and Layer 3 ingress multicast record. When records are first populated by static, snooping or routing protocols, they are first assumed to be inactive. An inactive record is not considered to be currently consuming ingress multicast path bandwidth.

Within the multicast-info-policy, the bandwidth activity of the new record was configured to be either managed based on an administrative bandwidth, or based on the dynamic bandwidth rate table. The bandwidth-policy associated with ingress MDA contains the configuration parameters for creating the dynamic bandwidth rate table. The purpose of the table is to allow for the system to monitor the bandwidth activity associated with a multicast record and compare the current rate against several rate thresholds. Rate thresholds are used to allow a multicast streams rate to fluctuate between a given range while keeping the managed rate at a certain level. Multiple dynamic managed rates are supported in the table to allow monitoring of different types of multicast traffic. Each rate threshold is associated with a rising and falling threshold that defines when the specified rate should be used and when the next lower rate should be used.

Once a record’s monitored current rate rises to the first dynamic rising threshold, the record is active and the system then manages the bandwidth the record represents based on the parameters associated with the record in the records multicast-info-policy and the configured path information in the MDAs associated bandwidth-policy.

Ingress Multicast Path Parameters

The bandwidth-policy also contains the configuration parameters for each of the managed ingress multicast paths. The queue default parameters can be overridden for each primary and secondary path. In addition, the number of secondary paths (and by implication the number of primary paths) can be overridden.

Default Bandwidth Policy

A bandwidth policy with the name ‘default’ always exists and is used as the default bandwidth policy when ingress multicast path management is enabled without an explicit bandwidth policy defined on an FP. The default policy cannot be deleted or edited.

The no form of this command removes the specified bandwidth policy from the system. The bandwidth policy associations must be removed from MDA configurations before it can be removed.

Default 

bandwidth-policy “default”

Parameters 
policy-name—
Specifies the name of the bandwidth policy, up to 32 characters. Each bandwidth policy must be uniquely named within the system. 32 policies can be configured per system.
create—
This keyword is required if creating a new bandwidth policy when the system is configured to require the explicit use of the keyword to prevent accidental object creation. Objects may be accidentally created when this protection is disabled and an object name is mistyped when attempting to edit the object. This keyword is not required when the protection is disabled. The keyword is ignored when the bandwidth policy name already exists.
Platforms 

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

bandwidth-policy

Syntax 
bandwidth-policy policy-name
no bandwidth-policy
Context 
[Tree] (config>card>fp>ingress>mcast-path-management bandwidth-policy)
Full Contexts 
configure card fp ingress mcast-path-management bandwidth-policy
Description 

This command explicitly associates a bandwidth policy to a forwarding plane. The bandwidth policy defines the dynamic rate table and the multicast paths bandwidth and queuing parameters.

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

The no form of this command removes an explicit bandwidth policy from a forwarding plane or MDA and restores the default bandwidth policy.

Parameters 
policy-name—
The policy-name parameter is required and defines the bandwidth policy that should be associated with the MDA or forwarding plane for ingress multicast path management. If the policy name does not exist, the bandwidth-policy command will fail. The name can be up to 32 characters long.
Values—
Any existing bandwidth policy name.

 

Default—
default
Platforms 

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

6.14. base-op-authorization

base-op-authorization

Syntax 
base-op-authorization
Context 
[Tree] (config>system>security>profile>netconf base-op-authorization)
Full Contexts 
configure system security profile netconf base-op-authorization
Description 

Commands in this context configure the permission to use NETCONF operations at the base operation level for the specified profile.The NETCONF operations are authorized by default in the built-in system-generated administrative profile.

Platforms 

All

6.15. base-r13-modules

base-r13-modules

Syntax 
[no] base-r13-modules
Context 
[Tree] (config>system>management-interface>yang-modules base-r13-modules)
Full Contexts 
configure system management-interface yang-modules base-r13-modules
Description 

This command enables or disables support of the Base-R13 YANG modules in the SR OS NETCONF server. If the Base-R13 modules are disabled, then the NETCONF requests, which reference the Base-R13 modules, return an error, and when a NETCONF client establishes a new session, the Base-R13 modules are not advertised in the SR OS hello. When management-interface configuration-mode is set to model-driven, attempts to modify the configuration using the Base-13 configuration modules or namespace via NETCONF results in errors, even if base-r13-modules is enabled.

The no form of this command disables support of the Base-R13 YANG modules in the SR OS NETCONF server.

Default 

no base-r13-modules

Platforms 

All

6.16. base-routing-instance

base-routing-instance

Syntax 
base-routing-instance
Context 
[Tree] (config>router>segment-routing>srv6 base-routing-instance)
Full Contexts 
configure router segment-routing segment-routing-v6 base-routing-instance
Description 

Commands in this context configure the function value for End SID, End.X SID, and service SID of an IPv4 or an IPv6 prefix in the global routing instance.

Platforms 

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

6.17. base-user-name

base-user-name

Syntax 
base-user-name user-name
no base-user-name
Context 
[Tree] (config>aaa>route-downloader base-user-name)
Full Contexts 
configure aaa route-downloader base-user-name
Description 

This command sets the prefix for the user name that shall be used as access requests. The actual name used is a concatenation of this string, the “-” (dash) character and a monotonically increasing integer.

The no form of this command removes the user-name from the configuration.

Default 

The system’s configured name (system name).

Parameters 
user-name—
Specifies the prefix of the username that is used in the RADIUS access requests. The username used in the RADIUS access requests is a concatenation of this string, the dash character and an increasing integer.
Platforms 

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

6.18. bd

bd

Syntax 
bd identifier
Context 
[Tree] (config>subscr-mgmt>wlan-gw>ue-query bd)
Full Contexts 
configure subscriber-mgmt wlan-gw ue-query bd
Description 

This command enables matching on UEs that are part of the specified BD.

The no form of this command disables matching on the BD.

Default 

no bd

Parameters 
identifier—
Specifies the BD identifier.
Values—
0 to 4294967294

 

Platforms 

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

6.19. bd-mac-prefix

bd-mac-prefix

Syntax 
bd-mac-prefix mac-prefix
no bd-mac-prefix
Context 
[Tree] (config>service>ies>sub-if>grp-if>wlan-gw>ranges>range>vrgw>lanext bd-mac-prefix)
[Tree] (config>service>vprn>sub-if>grp-if>wlan-gw>ranges>range>vrgw>lanext bd-mac-prefix)
Full Contexts 
configure service ies subscriber-interface group-interface wlan-gw vlan-tag-ranges range vrgw lanext bd-mac-prefix
configure service vprn subscriber-interface group-interface wlan-gw vlan-tag-ranges range vrgw lanext bd-mac-prefix
Description 

This command specifies the prefix of the HLE BD MAC address.

The no form of this command removes the MAC prefix from the configuration.

Platforms 

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

6.20. bearer-fteid

bearer-fteid

Syntax 
[no] bearer-fteid
Context 
[Tree] (config>subscr-mgmt>acct-plcy>include-radius-attribute bearer-fteid)
Full Contexts 
configure subscriber-mgmt radius-accounting-policy include-radius-attribute bearer-fteid
Description 

This command, in the case of ESM over GTP access includes the Alc-Bearer-Fteid VSA in accounting. This VSA contains the fully qualified TEID of the current GTP-U tunnel, including the bearer ID, endpoint IP addresses and TEIDs for both local and remote endpoints.

The no version of this command disables inclusion of the Alc-Bearer-Fteid VSA.

Default 

no bearer-fteid

Platforms 

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

6.21. begin

begin

Syntax 
begin
Context 
[Tree] (config>app-assure>group>policy begin)
Full Contexts 
configure application-assurance group policy begin
Description 

This command begins a policy editing session.

The editing session continues until one of the following conditions takes place:

  1. Abort or commit is issued.
  2. Control complex resets.

The editing session is not interrupted by:

  1. HA activity switch.
  2. CLI session termination (for example, as result of closing a Telnet session).
Platforms 

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

begin

Syntax 
begin
Context 
[Tree] (config>router>bfd begin)
Full Contexts 
configure router bfd begin
Description 

This command switches to edit mode for a BFD template. Changes are not activated until the commit command is issued for the BFD template changes.

Platforms 

All

begin

Syntax 
begin
Context 
[Tree] (config>router>route-next-hop-policy begin)
Full Contexts 
configure router route-next-hop-policy begin
Description 

This command switches to edit mode for route next-hop templates. Changes are not activated until the commit command is issued for the route next-hop templates changes.

Default 

begin

Platforms 

All

begin

Syntax 
begin
Context 
[Tree] (config>system>sync-if-timing begin)
Full Contexts 
configure system sync-if-timing begin
Description 

This command is required in order to enter the mode to create or edit the system synchronous interface timing configuration.

Platforms 

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

begin

Syntax 
begin {exclusive}
Context 
[Tree] (config>router>policy-options begin)
Full Contexts 
configure router policy-options begin
Description 

This command is required in order to enter the mode to create or edit route policies.

Parameters 
exclusive —
Specifies an exclusive lock on the policy configuration. Other CLI and SNMP users will be unable to edit the policy configuration until the lock is removed (via commit, abort, a timeout occurring, or a forced override).
Platforms 

All

6.22. begin-time

begin-time

Syntax 
begin-time date hours-minutes [UTC]
begin-time {now | forever}
no begin-time
Context 
[Tree] (config>system>security>keychain>direction>bi>entry begin-time)
[Tree] (config>system>security>keychain>direction>uni>receive>entry begin-time)
[Tree] (config>system>security>keychain>direction>uni>send>entry begin-time)
Full Contexts 
configure system security keychain direction bi entry begin-time
configure system security keychain direction uni receive entry begin-time
configure system security keychain direction uni send entry begin-time
Description 

This command specifies the calendar date and time after which the key specified by the keychain authentication key is used to sign and/or authenticate the protocol stream.

If no date and time is set, the begin-time is represented by a date and time string with all NULLs and the key is not valid by default.

Default 

begin-time forever

Parameters 
date hours-minutes—
Specifies the date and time for the key to become active.
Values—
date: YYYY/MM/DD hours-minutes: hh:mm[:ss]

 

now—
Specifies the key should become active immediately.
forever—
Specifies that the key is always inactive.
UTC—
Indicates that time is given with reference to Coordinated Universal Time in the input.
Platforms 

All

6.23. ber-sf-link-down

ber-sf-link-down

Syntax 
[no] ber-sf-link-down
Context 
[Tree] (config>port>tdm>ds1>channel-group>ppp ber-sf-link-down)
[Tree] (config>port>tdm>e1>channel-group>ppp ber-sf-link-down)
Full Contexts 
configure port tdm ds1 channel-group ppp ber-sf-link-down
configure port tdm e1 channel-group ppp ber-sf-link-down
Description 

This command enables the port down on BER-SF alarm. When enabled, the link will be placed out of service once ber-sf is detected.

The no form of this command reverts to normal operation where the link remains in-service when ber-sf is encountered.

Default 

no ber-sf-link-down

Platforms 

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

6.24. bert

bert

Syntax 
bert {2e3 | 2e9 | 2e11 | 2e15 | 2e20 | 2e20q | 2e23 | ones | zeros | alternating} duration duration
no bert
Context 
[Tree] (config>port>tdm>ds1 bert)
[Tree] (config>port>tdm>ds3 bert)
[Tree] (config>port>tdm>e1 bert)
[Tree] (config>port>tdm>e3 bert)
Full Contexts 
configure port tdm ds1 bert
configure port tdm ds3 bert
configure port tdm e1 bert
configure port tdm e3 bert
Description 

This command initiates or restarts a Bit Error Rate Test (BERT) on the associated DS-1/E-1 or DS-3/E-3 circuit.

The associated DS-1, E-1, DS-3, or E-3 must be in a shutdown (admin down) state to initiate this test.

The no form of this command terminates the BERT test if it has not yet completed.

Notes:

  1. This command is not saved in the router configuration between boots.
  2. The 4-port OC-3/STM-1 and the 1-port OC-12/STM-4 ASAP MDA supports up to 28 concurrent BERT tests per MDA. The 4-port and 12-port DS-3/E-3 ASAP MDAs support a single BERT test per MDA. An attempt to configure more BERT tests can result in an error indicating an operation failure due to resource exhaustion.
  3. If the ASAP MDA BERT error insertion rate command is executed when tests are running, it will not take effect until test is restarted.
Default 

bert 2e3

Parameters 
duration—
Sets the duration for the BERT test.
Values—
Up to 24 hours, in seconds or hh:mm:ss format

 

ones —
Sends an all ones pattern.
zeros —
Sends an all zeros pattern.
alternating—
Sends an alternating ones and zeros pattern.
2e3 —
Sends a pseudo-random 2^3 -1 pattern.
2e9—
Sends a pseudo-random 2^9 -1 pattern.
2e15 —
Sends a pseudo-random 2^15 -1 pattern.
2e20 —
Sends a pseudo-random 2^20 -1 pattern. Not available on channelized ASAP MDAs.
2e23 —
Sends a pseudo-random 2^23 -1 pattern.
Platforms 

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

6.25. best-path-selection

best-path-selection

Syntax 
best-path-selection
Context 
[Tree] (config>service>vprn>bgp best-path-selection)
Full Contexts 
configure service vprn bgp best-path-selection
Description 

This command enables path selection configuration.

Platforms 

All

best-path-selection

Syntax 
best-path-selection
Context 
[Tree] (config>router>bgp best-path-selection)
Full Contexts 
configure router bgp best-path-selection
Description 

Commands in this context configure path selection parameters.

Platforms 

All

6.26. bfd

bfd

Syntax 
bfd transmit-interval [receive receive-interval] [multiplier multiplier [echo-receive echo-interval] [type cpm-np]
no bfd
Context 
[Tree] (config>service>ies>if bfd)
[Tree] (config>service>ies>if>ipv6 bfd)
[Tree] (config>service>vprn>if bfd)
[Tree] (config>service>vprn>if>ipv6 bfd)
[Tree] (config>service>vprn>nw-if bfd)
Full Contexts 
configure service ies interface bfd
configure service ies interface ipv6 bfd
configure service vprn interface bfd
configure service vprn interface ipv6 bfd
configure service vprn network-interface bfd
Description 

This command specifies the BFD parameters for the associated IP interface. If no parameters are defined the default value are used.

The multiplier specifies the number of consecutive BFD messages that must be missed from the peer before the BFD session state is changed to down and the upper level protocols (OSPF, IS-IS, BGP or PIM) is notified of the fault.

The no form of this command removes BFD from the interface.

Note:

On the 7750 SR, the transmit-interval, receive receive-interval, and echo-receive echo-interval values can only be modified to a value less than 100 when:

  1. The type cpm-np option is explicitly configured.
  2. The service is shut down (shutdown)
  3. The interval is specified 10 to 100000.
  4. The service is re-enabled (no shutdown)

To remove the type cpm-np option, re-issue the bfd command without specifying the type parameter.

Parameters 
transmit-interval—
Sets the transmit interval for the BFD session.
Values—
100 to 100000
10 to 100000 (for the 7750 SR only; see the note above)

 

Default—
100
receive receive-interval
Sets the receive interval for the BFD session.
Values—
100 to 100000
10 to 100000 (for the 7750 SR only; see the note above)

 

Default—
100
multiplier multiplier
Sets the multiplier for the BFD session.
Values—
3 to 20

 

Default—
3
echo-receive echo-interval
Sets the minimum echo receive interval, in milliseconds, for the BFD session.
Values—
100 to 100000
10 to 100000 (for the 7750 SR only; see the Note above)

 

Default—
100
type cpm-np—
For the 7750 SR only, specifies that BFD sessions associated with this interface is created on the CPM network processor to allow for fast timers down to 10 ms granularity.
Platforms 

All

bfd

Syntax 
bfd transmit-interval [receive receive-interval] [multiplier multiplier [echo-receive echo-interval] [type cpm-np]
no bfd
Context 
[Tree] (config>service>vprn>sub-if bfd)
[Tree] (config>service>vprn>sub-if>grp-if bfd)
[Tree] (config>service>vprn>sub-if>ipv6 bfd)
[Tree] (config>service>vprn>sub-if>grp-if>ipv6 bfd)
Full Contexts 
configure service vprn subscriber-interface bfd
configure service vprn subscriber-interface group-interface bfd
configure service vprn subscriber-interface group-interface ipv6 bfd
configure service vprn subscriber-interface ipv6 bfd
Description 

This command specifies the BFD attributes for the associated retail subscriber interface or group interface. If no parameters are defined the default value are used.

The no form of this command removes BFD from the interface.

To remove the type cpm-np option, re-issue the bfd command without specifying the type parameter.

Default 

no bfd

Parameters 
transmit-interval—
Sets the transmit interval for the BFD session.
Values—
10 to 100000

 

Default—
100
Note:

On the 7750 SR, the transmit-interval can only be modified to a value less than 100 when the type cpm-np option is explicitly configured.

receive-interval
Sets the receive interval for the BFD session.
Values—
10 to 100000

 

Default—
100
Note:

On the 7750 SR, the receive-interval can only be modified to a value less than 100 when the type cpm-np option is explicitly configured.

multiplier
Sets the multiplier for the BFD session. A multiplier of less than 3 should not be used in production environments. The multiplier specifies the number of consecutive BFD messages that must be missed from the peer before the BFD session state is changed to down and the upper level protocol (BGP) is notified of the fault.
Values—
1 to 20

 

Default—
3
echo-interval
Sets the minimum echo receive interval, in milliseconds, for the BFD session.
Values—
100 to 100000

 

Default—
0
type cpm-np—
Sets the CPM network processor as the local termination point for the BFD session to allow for fast timers down to 10ms granularity.
Platforms 

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

bfd

Syntax 
bfd
Context 
[Tree] (config>lag bfd)
Full Contexts 
configure lag bfd
Description 

This command creates the bfd context and enables BFD over the associated LAG links.

Platforms 

All

bfd

Syntax 
bfd
Context 
[Tree] (config>router>mpls>lsp bfd)
[Tree] (config>router>mpls>lsp>primary bfd)
[Tree] (config>router>mpls>lsp>secondary bfd)
[Tree] (config>router>mpls>lsp-template bfd)
Full Contexts 
configure router mpls lsp bfd
configure router mpls lsp primary bfd
configure router mpls lsp secondary bfd
configure router mpls lsp-template bfd
Description 

Commands in this context configure LSP BFD commands on RSVP LSPs or seamless BFD commands on SR-TE LSPs.

Platforms 

All

bfd

Syntax 
bfd
Context 
[Tree] (config bfd)
Full Contexts 
configure bfd
Description 

This command specifies the context for the configuration of BFD parameters global to a specific router.

The no form of this command removes the context.

Platforms 

All

bfd

Syntax 
bfd transmit-interval [receive receive-interval] [multiplier multiplier] [echo-receive echo-interval] [type cpm-np]
no bfd
Context 
[Tree] (config>router>if bfd)
[Tree] (config>router>if>ipv6 bfd)
Full Contexts 
configure router interface bfd
configure router interface ipv6 bfd
Description 

This command specifies the bidirectional forwarding detection (BFD) parameters for the associated IP interface. If no parameters are defined the default values are used.

The multiplier specifies the number of consecutive BFD messages that must be missed from the peer before the BFD session state is changed to down and the upper level protocols (OSPF, IS-IS, BGP or PIM) is notified of the fault.

The no form of this command removes BFD from the router interface regardless of the IGP/RSVP.

Important notes: On the 7750 SR and 7950 XRS SR OS, the transmit-interval and receive receive-interval values can only be modified to a value less than 100 ms when:

  1. The type cpm-np option is explicitly configured.
  2. The service is shut down (shutdown)
  3. The interval is specified 10 to 100000.
  4. The service is re-enabled (no shutdown)

To remove the type cpm-np option, re-issue the bfd command without specifying the type parameter.

Default 

no bfd

Parameters 
transmit-interval—
Sets the transmit interval, in milliseconds, for the BFD session.
Values—
10 to 100000 (see Important Notes above) The minimum value is 300 msec for central BFD sessions in the 7950 XRS.

 

Default—
100
receive-interval—
Sets the receive interval, in milliseconds, for the BFD session.
Values—
10 to 100000 (see Important Notes above)

 

Default—
100
multiplier—
Sets the multiplier for the BFD session. A multiplier of less than 3 should not be used in production environments.
Values—
1 to 20

 

Default—
3
echo-interval—
Sets the minimum echo receive interval, in milliseconds, for the session.
Values—
100 to 100000

 

Default—
0
cpm-np—
Selects the CPM network processor type as the local termination point for the BFD session for the 7750 SR and 7950 XRS. See Important Notes, above.
Platforms 

All

bfd

Syntax 
bfd
Context 
[Tree] (config>service>apipe>spoke-sdp bfd)
[Tree] (config>service>cpipe>spoke-sdp bfd)
[Tree] (config>service>epipe>spoke-sdp bfd)
[Tree] (config>service>fpipe>spoke-sdp bfd)
[Tree] (config>service>ies>if>spoke-sdp bfd)
[Tree] (config>service>ipipe>spoke-sdp bfd)
[Tree] (config>service>vpls>mesh-sdp bfd)
[Tree] (config>service>vpls>spoke-sdp bfd)
[Tree] (config>service>vprn>if>spoke-sdp bfd)
Full Contexts 
configure service apipe spoke-sdp bfd
configure service cpipe spoke-sdp bfd
configure service epipe spoke-sdp bfd
configure service fpipe spoke-sdp bfd
configure service ies interface spoke-sdp bfd
configure service ipipe spoke-sdp bfd
configure service vpls mesh-sdp bfd
configure service vpls spoke-sdp bfd
configure service vprn interface spoke-sdp bfd
Description 

This command creates a context for the configuration of VCCV BFD.

Platforms 

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

  1. configure service cpipe spoke-sdp bfd
  2. configure service fpipe spoke-sdp bfd

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

  1. configure service apipe spoke-sdp bfd

All

  1. configure service ies interface spoke-sdp bfd
  2. configure service ipipe spoke-sdp bfd
  3. configure service vpls mesh-sdp bfd
  4. configure service epipe spoke-sdp bfd
  5. configure service vprn interface spoke-sdp bfd
  6. configure service vpls spoke-sdp bfd

6.27. bfd-designate

bfd-designate

Syntax 
[no] bfd-designate
Context 
[Tree] (config>service>ies>if>ipsec>ipsec-tunnel bfd-designate)
[Tree] (config>service>vprn>if>ipsec>ipsec-tunnel bfd-designate)
[Tree] (config>service>vprn>if>sap>ipsec-tunnel bfd-designate)
[Tree] (config>router>if>ipsec>ipsec-tunnel bfd-designate)
Full Contexts 
configure router interface ipsec ipsec-tunnel bfd-designate
configure service ies interface ipsec ipsec-tunnel bfd-designate
configure service vprn interface ipsec ipsec-tunnel bfd-designate
configure service vprn interface sap ipsec-tunnel bfd-designate
Description 

This command specifies whether this IPsec tunnel is the BFD designated tunnel.

Default 

no bfd-designate

Platforms 

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

  1. configure service vprn interface sap ipsec-tunnel bfd-designate

VSR

  1. configure service vprn interface ipsec ipsec-tunnel bfd-designate
  2. configure service ies interface ipsec ipsec-tunnel bfd-designate
  3. configure router interface ipsec ipsec-tunnel bfd-designate

6.28. bfd-enable

bfd-enable

Syntax 
[no] bfd-enable service-id interface interface-name dst-ip ip-address
[no] bfd-enable interface interface-name dst-ip ip-address name service-name
[no] bfd-enable interface interface-name dst-ip ip-address
Context 
[Tree] (config>service>ies>sub-if>grp-if>srrp bfd-enable)
[Tree] (config>service>vprn>sub-if>grp-if>srrp bfd-enable)
Full Contexts 
configure service ies subscriber-interface group-interface srrp bfd-enable
configure service vprn subscriber-interface group-interface srrp bfd-enable
Description 

This commands assigns a bi-directional forwarding (BFD) session providing heart-beat mechanism for the given VRRP/SRRP instance. There can be only one BFD session assigned to any given VRRP/SRRP instance, but there can be multiple SRRP/VRRP sessions using the same BFD session. If the interface configured with BFD is using a LAG or a spoke-SDP, the BFD transmit and receive intervals need to be set to a minimum of 300 ms.

BFD control the state of the associated interface. By enabling BFD on a given protocol interface, the state of the protocol interface is tied to the state of the BFD session between the local node and the remote node. The parameters used for the BFD are set via the BFD command under the IP interface. The specified interface may not be configured with BFD; when it is, the virtual router will then initiate the BFD session.

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

Parameters 
service-id—
Specifies the service ID of the interface running BFD. If no svc-id is specified then it indicates that the interface is a network interface in the Base router instance.

This variant of the command is only supported in 'classic' configuration-mode (configure system management-interface configuration-mode classic). The bfd-enable interface interface-name dst-ip ip-address name name variant can be used in all configuration modes.

Values—
{id | svc-name}

id:

1 to 2147483647

svc-name:

Specifies an existing service name up to 64 characters (svc-name is an alias for input only. The svc-name gets replaced with an id automatically by SR OS in the configuration)

 

interface interface-name
Specifies the name of the interface running BFD, up to 32 characters.
dst-ip ip-address
Specifies the destination address for the BFD session.
name service-name
Specifies a service name, up to 64 characters.
Platforms 

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

bfd-enable

Syntax 
[no] bfd-enable
Context 
[Tree] (config>redundancy>multi-chassis>peer>mc-ep bfd-enable)
[Tree] (config>router>bgp bfd-enable)
[Tree] (config>router>bgp>group bfd-enable)
[Tree] (config>router>bgp>group>neighbor bfd-enable)
Full Contexts 
configure redundancy multi-chassis peer mc-endpoint bfd-enable
configure router bgp bfd-enable
configure router bgp group bfd-enable
configure router bgp group neighbor bfd-enable
Description 

This command enables the use of bi-directional forwarding (BFD) to control the state of the associated protocol interface. By enabling BFD on a given protocol interface, the state of the protocol interface is tied to the state of the BFD session between the local node and the remote node. The parameters used for the BFD are set via the BFD command under the IP interface.

The no form of this command disables BFD.

Default 

no bfd-enable

Platforms 

All

bfd-enable

Syntax 
[no] bfd-enable
Context 
[Tree] (config>service>apipe>spoke-sdp>bfd bfd-enable)
[Tree] (config>service>cpipe>spoke-sdp>bfd bfd-enable)
[Tree] (config>service>epipe>spoke-sdp>bfd bfd-enable)
[Tree] (config>service>fpipe>spoke-sdp>bfd bfd-enable)
[Tree] (config>service>ipipe>spoke-sdp>bfd bfd-enable)
Full Contexts 
configure service apipe spoke-sdp bfd bfd-enable
configure service cpipe spoke-sdp bfd bfd-enable
configure service epipe spoke-sdp bfd bfd-enable
configure service fpipe spoke-sdp bfd bfd-enable
configure service ipipe spoke-sdp bfd bfd-enable
Description 

This command enables VCCV BFD on the PW associated with the VLL, BGP VPWS, or VPLS service. The parameters for the BFD session are derived from the named BFD template, which must have been first configured using the bfd-template command.

The no form of this command disables VCCV BFD on the spoke-SDP.

Default 

no bfd-enable

Platforms 

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

  1. configure service cpipe spoke-sdp bfd bfd-enable
  2. configure service fpipe spoke-sdp bfd bfd-enable

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

  1. configure service apipe spoke-sdp bfd bfd-enable

All

  1. configure service ipipe spoke-sdp bfd bfd-enable
  2. configure service epipe spoke-sdp bfd bfd-enable

bfd-enable

Syntax 
[no] bfd-enable
Context 
[Tree] (config>service>epipe>bgp>pw-template-binding bfd-enable)
Full Contexts 
configure service epipe bgp pw-template-binding bfd-enable
Description 

This command enables VCCV BFD on the PW associated with the VLL, BGP VPWS, or VPLS service. The parameters for the BFD session are derived from the named BFD template, which must have been first configured using the bfd-template command.

The no form of this command disables VCCV BFD.

Default 

no bfd-enable

Platforms 

All

bfd-enable

Syntax 
[no] bfd-enable
Context 
[Tree] (config>service>vpls>mesh-sdp>bfd bfd-enable)
[Tree] (config>service>vpls>spoke-sdp>bfd bfd-enable)
Full Contexts 
configure service vpls mesh-sdp bfd bfd-enable
configure service vpls spoke-sdp bfd bfd-enable
Description 

This command enables VCCV BFD on the PWs associated with the VPLS service's spoke or mesh SDPs. The parameters for the BFD session are derived from the named BFD template, which must have been first configured using the bfd-template command.

The no form of this command disables VCCV BFD on the mesh-SDP or spoke-SDP.

Default 

no bfd-enable

Platforms 

All

bfd-enable

Syntax 
[no] bfd-enable
Context 
[Tree] (config>service>vpls>bgp>pw-template-binding bfd-enable)
[Tree] (config>service>vpls>bgp-ad>pw-template-binding bfd-enable)
Full Contexts 
configure service vpls bgp pw-template-binding bfd-enable
configure service vpls bgp-ad pw-template-binding bfd-enable
Description 

This command enables VCCV BFD on the PWs associated with the BGP AD VPLS service. The parameters for the BFD session are derived from the named BFD template, which must have been first configured using the bfd-template command.

The no form of this command disables VCCV BFD.

Default 

no bfd-enable

Platforms 

All

bfd-enable

Syntax 
[no] bfd-enable
Context 
[Tree] (config>service>ies>if>spoke-sdp>bfd bfd-enable)
Full Contexts 
configure service ies interface spoke-sdp bfd bfd-enable
Description 

This command enables VCCV BFD on the PW associated with the spoke-SDP terminated on the IES interface. The parameters for the BFD session are derived from the named BFD template, which must have been first configured using the bfd-template command.

The no form of this command disables VCCV BFD on the spoke-SDP.

Platforms 

All

bfd-enable

Syntax 
[no] bfd-enable [service-id] interface interface-name dst-ip ip-address
[no] bfd-enable interface interface-name dst-ip ip-address name name
Context 
[Tree] (config>service>ies>if>vrrp bfd-enable)
[Tree] (config>service>ies>if>ipv6>vrrp bfd-enable)
Full Contexts 
configure service ies interface ipv6 vrrp bfd-enable
configure service ies interface vrrp bfd-enable
Description 

This commands assigns a bi-directional forwarding (BFD) session providing heart-beat mechanism for the given VRRP/SRRP instance. There can be only one BFD session assigned to any given VRRP/SRRP instance, but there can be multiple SRRP/VRRP sessions using the same BFD session.

BFD control the state of the associated interface. By enabling BFD on a given protocol interface, the state of the protocol interface is tied to the state of the BFD session between the local node and the remote node. The parameters used for the BFD are set via the BFD command under the IP interface. The specified interface may not be configured with BFD; however, when it is, the virtual router will then initiate the BFD session.

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

Parameters 
service-id—
Specifies the service ID of the interface running BFD.
Values—
service-id: 1 to 2147483648
No service ID indicates a network interface.

 

interface interface-name
Specifies the name of the interface running BFD.
dst-ip ip-address
Specifies the destination address to be used for the BFD session.
name name
Specifies the name, up to 64 characters.
Platforms 

All

bfd-enable

Syntax 
[no] bfd-enable
Context 
[Tree] (config>service>vprn>static-route-entry>next-hop bfd-enable)
Full Contexts 
configure service vprn static-route-entry next-hop bfd-enable
Description 

This command associates the static route state to a BFD session between the local system and the configured nexthop.

The remote end of the BFD session must also be configured to originate or accept the BFD session controlling the static route state.

The no form of this command removes the association of the static route state to that of the BFD session.

Default 

no bfd-enable

Platforms 

All

bfd-enable

Syntax 
[no] bfd-enable
Context 
[Tree] (config>service>vprn>if>spoke-sdp>bfd bfd-enable)
Full Contexts 
configure service vprn interface spoke-sdp bfd bfd-enable
Description 

This command enables VCCV BFD on the PW associated with the spoke-SDP terminated on the VPRN interface service. The parameters for the BFD session are derived from the named BFD template, which must have been first configured using the bfd-template command.

The no form of this command disables VCCV BFD on the spoke-SDP.

Platforms 

All

bfd-enable

Syntax 
[no] bfd-enable interface interface-name dst-ip ip-address
[no] bfd-enable service-id interface interface-name dst-ip ip-address
[no] bfd-enable interface interface-name dst-ip ip-address name service-name
Context 
[Tree] (config>service>vprn>if>vrrp bfd-enable)
[Tree] (config>service>vprn>if>ipv6>vrrp bfd-enable)
Full Contexts 
configure service vprn interface ipv6 vrrp bfd-enable
configure service vprn interface vrrp bfd-enable
Description 

This commands assigns a bi-directional forwarding (BFD) session providing heart-beat mechanism for the given VRRP/SRRP instance. There can be only one BFD session assigned to any given VRRP/SRRP instance, but there can be multiple SRRP/VRRP sessions using the same BFD session. If the interface used is configured with centralized BFD, the BFD transmit and receive intervals need to be set to at least 300 ms.

BFD control the state of the associated interface. By enabling BFD on a given protocol interface, the state of the protocol interface is tied to the state of the BFD session between the local node and the remote node. The parameters used for the BFD are set via the BFD command under the IP interface. The specified interface may not be configured with BFD; when it is, the virtual router will then initiate the BFD session.

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

Parameters 
svc-id—
Specifies the service ID of the interface running BFD. If no svc-id is specified then it indicates that the interface is a network interface in the Base router instance.

This variant of the command is only supported in 'classic' configuration-mode (configure system management-interface configuration-mode classic). The bfd-enable interface interface-name dst-ip ip-address name name variant can be used in all configuration modes.

Values—
{id | svc-name}

id:

1 to 2147483647

svc-name:

Specifies an existing service name up to 64 characters (svc-name is an alias for input only. The svc-name gets replaced with an id automatically by SR OS in the configuration)

 

interface interface-name
Specifies the name of the interface running BFD, up to 32 characters.
dst-ip ip-address
Specifies the destination address to be used for the BFD session.
name name
Specifies a service name, up to 64 characters.
Platforms 

All

bfd-enable

Syntax 
bfd-enable {ipv4 | ipv6} [include-bfd-tlv]
no bfd-enable {ipv4 | ipv6}
Context 
[Tree] (config>service>vprn>isis>if bfd-enable)
Full Contexts 
configure service vprn isis interface bfd-enable
Description 

This command enables the use of bi-directional forwarding (BFD) to control IPv4 or adjacencies. By enabling BFD on an IPv4 or IPv6 protocol interface, the state of the protocol interface is tied to the state of the BFD session between the local node and the remote node. The parameters used for the BFD are set by the BFD command under the IP interface. This command must be given separately to enable or disable BFD for IPv4 and IPv6.

The no form of this command removes BFD from the associated adjacency.

Default 

no bfd-enable ipv4

no bfd-enable ipv6

Parameters 
ipv4—
Keyword to enable BFD to control IPv4 adjacencies.
ipv6—
Keyword to enable BFD to control IPv6 adjacencies.
include-bfd-tlv—
Enables support for the IS-IS BFD TLV options in accordance with RFC 6213, which specifies that a BFD session must be established before an IS-IS adjacency can transition to the established state. This option must be enabled on all IS-IS neighbors on a shared interface.
Platforms 

All

bfd-enable

Syntax 
bfd-enable [remain-down-on-failure]
no bfd-enable
Context 
[Tree] (config>service>vprn>ospf>if bfd-enable)
[Tree] (config>service>vprn>ospf3>area>if bfd-enable)
Full Contexts 
configure service vprn ospf interface bfd-enable
configure service vprn ospf3 area interface bfd-enable
Description 

This command enables the use of bi-directional forwarding (BFD) to control the state of the associated protocol interface. By enabling BFD on a given protocol interface, the state of the protocol interface is tied to the state of the BFD session between the local node and the remote node. The parameters used for the BFD are set using the bfd command in the associated IP interface context.

The no form of this command removes BFD from the associated IGP protocol adjacency.

Default 

no bfd-enable

Parameters 
remain-down-on-failure—
Forces adjacency down on BFD failure.
Platforms 

All

bfd-enable

Syntax 
[no] bfd-enable [ipv4 | ipv6]
Context 
[Tree] (config>service>vprn>pim>if bfd-enable)
Full Contexts 
configure service vprn pim interface bfd-enable
Description 

This command enables the use of bi-directional forwarding (BFD) to control the state of the associated protocol interface. By enabling BFD on a given protocol interface, the state of the protocol interface is tied to the state of the BFD session between the local node and the remote node. The parameters used for the BFD are set via the BFD command under the IP interface.

The no form of this command removes BFD from the associated IGP protocol adjacency.

Default 

no bfd-enable

Platforms 

All

bfd-enable

Syntax 
[no] bfd-enable
Context 
[Tree] (config>service>vprn>bgp bfd-enable)
[Tree] (config>service>vprn>bgp>group bfd-enable)
[Tree] (config>service>vprn>bgp>group>neighbor bfd-enable)
Full Contexts 
configure service vprn bgp bfd-enable
configure service vprn bgp group bfd-enable
configure service vprn bgp group neighbor bfd-enable
Description 

This command enables the use of bi-directional forwarding (BFD) to control the state of the associated protocol interface. The parameters used for the BFD are set with the BFD command under the IP interface.

The no form of this command disables bfd-enable on the VPRN service.

Default 

no bfd-enable

Platforms 

All

bfd-enable

Syntax 
[no] bfd-enable
Context 
[Tree] (config>service>vprn>rip bfd-enable)
[Tree] (config>service>vprn>rip>group bfd-enable)
[Tree] (config>service>vprn>rip>group>neighbor bfd-enable)
[Tree] (config>service>vprn>ripng bfd-enable)
[Tree] (config>service>vprn>ripng>group bfd-enable)
[Tree] (config>service>vprn>ripng>group>neighbor bfd-enable)
Full Contexts 
configure service vprn rip bfd-enable
configure service vprn rip group bfd-enable
configure service vprn rip group neighbor bfd-enable
configure service vprn ripng bfd-enable
configure service vprn ripng group bfd-enable
configure service vprn ripng group neighbor bfd-enable
Description 

This command enables bi-directional forwarding (BFD) to control the state of the associated protocol adjacency. By enabling BFD on a given protocol interface, the state of the RIP neighbor is tied to the state of the BFD session between the local node and the remote node. The parameters used for the BFD are set using the bfd command under the IP interface configuration context.

The no form of this command removes BFD from the associated protocol adjacency.

Default 

no bfd-enable

Platforms 

All

bfd-enable

Syntax 
[no] bfd-enable
Context 
[Tree] (config>router>ldp>lsp-bfd bfd-enable)
Full Contexts 
configure router ldp lsp-bfd bfd-enable
Description 

This command enables BFD on LDP LSPs with FECs that match the prefix list specified using the lsp-bfd command. A named BFD template must be configured and applied prior to enabling BFD.

The no form of this command disables BFD.

Default 

no bfd-enable

Platforms 

All

bfd-enable

Syntax 
bfd-enable [ipv4][ipv6]
no bfd-enable
Context 
[Tree] (config>router>ldp>if-params>if bfd-enable)
Full Contexts 
configure router ldp interface-parameters interface bfd-enable
Description 

This command enables tracking of the Hello adjacency to an LDP peer using BFD.

The ipv6 option for this command is not supported on the 7450 ESS.

When this command is enabled on an LDP interface, LDP registers with BFD and starts tracking the LSR-id of all peers it formed Hello adjacencies with over that LDP interface. The LDP hello mechanism is used to determine the remote address to be used for the BFD session. The parameters used for the BFD session, that is, transmit-interval, receive-interval, and multiplier are those configured under the IP interface in existing implementation: config>router>if>bfd.

The operation of BFD over an LDP interface tracks the next-hop of the IPv4 and IPv6 prefixes in addition to tracking the LDP peer address of the Hello adjacency over that link. This is required since LDP can resolve both IPv4 and IPv6 prefix FECs over a single IPv4 or IPv6 LDP session and as such the next-hop of a prefix will not necessarily match the LDP peer source address of the Hello adjacency.

The failure of either or both of the BFD session tracking the FEC next-hop and the one tracking the Hello adjacency will cause the LFA backup NHLFE for the FEC to be activated or the FEC to be re-resolved if there is no FRR backup.

When multiple links exist to the same LDP peer, a Hello adjacency is established over each link and a separate BFD session is enabled on each LDP interface. If a BFD session times out on a specific link, LDP will immediately associate the LDP session with one of the remaining Hello adjacencies and trigger the LDP FRR procedures. As soon as the last Hello adjacency goes down due to BFD timing out, the LDP session goes down and the LDP FRR procedures will be triggered.

The no form of this command disables BFD on the LDP interface.

Default 

no bfd-enable

Platforms 

All

bfd-enable

Syntax 
[no] bfd-enable
Context 
[Tree] (config>router>ldp>targ-session>peer bfd-enable)
[Tree] (config>router>ldp>targ-session>peer-template bfd-enable)
Full Contexts 
configure router ldp targeted-session peer bfd-enable
configure router ldp targeted-session peer-template bfd-enable
Description 

This command enables the bidirectional forwarding detection (BFD) session for the selected TLDP session. By enabling BFD for a selected targeted session, the state of that session is tied to the state of the underneath BFD session between the two nodes.

The parameters used for the BFD are set via the BFD command under the IP interface.

The no form of this command removes the TLDP session operational state binding to the central BFD session one.

Default 

no bfd-enable

Platforms 

All

bfd-enable

Syntax 
[no] bfd-enable
Context 
[Tree] (config>router>mpls>lsp>bfd bfd-enable)
[Tree] (config>router>mpls>lsp>primary>bfd bfd-enable)
[Tree] (config>router>mpls>lsp>secondary>bfd bfd-enable)
[Tree] (config>router>mpls>lsp-template>bfd bfd-enable)
Full Contexts 
configure router mpls lsp bfd bfd-enable
configure router mpls lsp primary bfd bfd-enable
configure router mpls lsp secondary bfd bfd-enable
configure router mpls lsp-template bfd bfd-enable
Description 

This command enables LSP BFD on the RSVP LSP or S-BFD for the SR-TE LSP. LSP BFD must also be configured under config>router to enable LSP BFD. The parameters for the BFD session are derived from the named BFD Template, which must have been configured prior to the bfd-enable command and associated with the service using the bfd-template command.

The no form of this command disables LSP BFD on the RSVP LSP or S-BFD on the SR-TE LSP.

Default 

no bfd-enable

Platforms 

All

bfd-enable

Syntax 
bfd-enable [cc | cc_cv]
no bfd-enable
Context 
[Tree] (config>router>mpls>lsp>working-tp-path>mep bfd-enable)
[Tree] (config>router>mpls>lsp>protect-tp-path>mep bfd-enable)
Full Contexts 
configure router mpls lsp protect-tp-path mep bfd-enable
configure router mpls lsp working-tp-path mep bfd-enable
Description 

The command associates the operational state of an MPLS-TP path with a BFD session whose control packets flow on the path. The BFD packets are encapsulated in a generic associated channel (G-ACh) on the path. The timer parameters of the BFD session are taken from the OAM template of the MEP.

A value of cc means that the BFD session is only used for continuity check of the MPLS-TP path. In this case, the CC timer parameters of the OAM template apply. A value of cv means that the BFD session is used for both continuity checking and connectivity verification, and the CV timers of the OAM template apply.

This form of the bfd-enable command is only applicable when it is configured under a MEP used on an MPLS-TP working or protection path.

Default 

no bfd-enable

Parameters 
cc —
Indicates that BFD runs in CC only mode. This mode uses G-ACh channel type 0x07.
cc_cv—
Indicates that BFD runs in combined CC and CV mode. This mode uses channel type 0x22 for MPLS-TP CC packets, and 0x23 for MPLS-TP CV packets.
Platforms 

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

bfd-enable

Syntax 
[no] bfd-enable
Context 
[Tree] (config>router>rsvp>interface bfd-enable)
Full Contexts 
configure router rsvp interface bfd-enable
Description 

This command enables the use of bi-directional forwarding (BFD) to control the state of the associated RSVP interface. This causes RSVP to register the interface with the BFD session on that interface.

The user configures the BFD session parameters, such as, transmit-interval, receive-interval, and multiplier, under the IP interface in the config>router> if>bfd context.

Note:

It is possible that the BFD session on the interface was started because of a prior registration with another protocol, for example, OSPF or IS-IS.

The registration of an RSVP interface with BFD is performed at the time of neighbor gets its first session. This means when this node sends or receives a new Path message over the interface. If however the session did not come up, due to not receiving a Resv for a new path message sent after the maximum number of re-tries, the LSP is shutdown and the node de-registers with BFD. In general, the registration of RSVP with BFD is removed as soon as the last RSVP session is cleared.

The registration of an RSVP interface with BFD is performed independent of whether RSVP hello is enabled on the interface or not. However, hello timeout will clear all sessions towards the neighbor and RSVP de-registers with BFD at clearing of the last session.

An RSVP session is associated with a neighbor based on the interface address the path message is sent to. If multiple interfaces exist to the same node, each interface is treated as a separate RSVP neighbor. The user will have to enable BFD on each interface and RSVP will register with the BFD session running with each of those neighbors independently

Similarly the disabling of BFD on the interface results in removing registration of the interface with BFD.

When a BFD session transitions to DOWN state, the following actions are triggered. For RSVP signaled LSPs, this triggers activation of FRR bypass/detour backup (PLR role), global revertive (head-end role), and switchover to secondary if any (head-end role) for affected LSPs with FRR enabled. It triggers switchover to secondary if any and scheduling of re-tries for signaling the primary path of the non-FRR affected LSPs (head-end role).

The no form of this command removes BFD from the associated RSVP protocol adjacency.

Default 

no bfd-enable

Platforms 

All

bfd-enable

Syntax 
bfd-enable service-name service-name interface-name interface-name dst-ip ip-address
no bfd-enable
Context 
[Tree] (config>service>ies>if>ipsec>ipsec-tunnel bfd-enable)
[Tree] (config>service>vprn>if>ipsec>ipsec-tunnel bfd-enable)
[Tree] (config>service>vprn>if>sap>ipsec-tunnel bfd-enable)
[Tree] (config>router>if>ipsec>ipsec-tunnel bfd-enable)
Full Contexts 
configure router interface ipsec ipsec-tunnel bfd-enable
configure service ies interface ipsec ipsec-tunnel bfd-enable
configure service vprn interface ipsec ipsec-tunnel bfd-enable
configure service vprn interface sap ipsec-tunnel bfd-enable
Description 

This command assigns a BFD session to provide a heart-beat mechanism for a given IPsec tunnel. There can be only one BFD session assigned to any given IPsec tunnel, but there can be multiple IPsec tunnels using same BFD session. BFD controls the state of the associated tunnel. If the BFD session goes down, the system will also bring down the associated non-designated IPsec tunnel.

Parameters 
service-name —
Specifies the service name, up to 64 characters, on which the BFD session resides.
interface-name—
Specifies the name, up to 32 characters, of the interface used by the BFD session.
ip-address—
Specifies the destination address to be used for the BFD session.
Platforms 

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

  1. configure service vprn interface sap ipsec-tunnel bfd-enable

VSR

  1. configure service vprn interface ipsec ipsec-tunnel bfd-enable
  2. configure service ies interface ipsec ipsec-tunnel bfd-enable
  3. configure router interface ipsec ipsec-tunnel bfd-enable

bfd-enable

Syntax 
[no] bfd-enable
Context 
[Tree] (config>redundancy>multi-chassis>peer>mc-ipsec bfd-enable)
Full Contexts 
configure redundancy multi-chassis peer mc-ipsec bfd-enable
Description 

This command enables tracking a central BFD session, if the BFD session goes down, then system consider the peer is down and change the mc-ipsec status of configured tunnel-group accordingly.

The BFD session uses specified the loopback interface (in the specified service) address as the source address and uses specified dst-ip as the destination address. Other BFD parameters are configured with the bfd command on the specified interface.

Default 

no bfd-enable

Platforms 

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

bfd-enable

Syntax 
[no] bfd-enable [ipv4 | ipv6]
Context 
[Tree] (config>router>pim>interface bfd-enable)
Full Contexts 
configure router pim interface bfd-enable
Description 

This command enables the use of IPv4 or IPv6 bidirectional forwarding detection (BFD) to control the state of the associated protocol interface. By enabling BFD on a given protocol interface, the state of the protocol interface is tied to the state of the BFD session between the local node and the remote node. The parameters used for the BFD are set via the BFD command under the IP interface.

The no form of this command removes BFD from the associated IGP protocol adjacency.

Default 

no bfd-enable

Parameters 
ipv4—
Enables the use of IPv4 BFD.
ipv6—
Enables the use of IPv6 BFD.
Platforms 

All

bfd-enable

Syntax 
bfd-enable [ipv4] [ipv6]
no bfd-enable
Context 
[Tree] (config>router>p2mp-sr-tree bfd-enable)
Full Contexts 
configure router p2mp-sr-tree bfd-enable
Description 

This command enables BFD tracking at the P2MP SR tree level, which causes all next-hops of the replication segments that use a BFD-enabled Layer 3 interface to register with the BFD module.

The no form of this command disables BFD tracking of the P2MP SR tree.

Default 

no bfd-enable

Parameters 
ipv4
Enables the use of IPv4 BFD tracking.
ipv6
Enables the use of IPv6 BFD tracking.
Platforms 

All

bfd-enable

Syntax 
[no] bfd-enable
Context 
[Tree] (config>router>static-route-entry>next-hop bfd-enable)
Full Contexts 
configure router static-route-entry next-hop bfd-enable
Description 

This command associates the static route state to a BFD session between the local system and the configured nexthop.

The remote end of the BFD session must also be configured to originate or accept the BFD session controlling the static route state.

The no form of this command removes the association of the static route state to that of the BFD session.

Default 

no bfd-enable

Platforms 

All

bfd-enable

Syntax 
[no] bfd-enable interface interface-name dst-ip ip-address
[no] bfd-enable interface interface-name dst-ip ip-address name name
[no] bfd-enable svc-id interface interface-name dst-ip ip-address
Context 
[Tree] (config>router>if>vrrp bfd-enable)
[Tree] (config>router>if>ipv6>vrrp bfd-enable)
Full Contexts 
configure router interface ipv6 vrrp bfd-enable
configure router interface vrrp bfd-enable
Description 

This commands assigns a bidirectional forwarding detect (BFD) session to a specific VRRP/SRRP instance. This BFD sessions provided a heartbeat mechanism that can be used to speed up the transition of the standby VRRP router to an active state. If the associated BFD session fails, the VRRP routers will immediately send a VRRP Advertisement message. In addition, the standby VRRP router(s) will transition to a Master state to speed convergence. The normal VRRP election process will then take place based on the Advertisement messages sent by all VRRP routers.

There can be only one BFD session assigned to any given VRRP/SRRP instance, but there can be multiple SRRP/VRRP sessions using the same BFD session.

The parameters used for the BFD sessions are set by the BFD command under the IP interface.

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

Parameters 
interface-name—
Specifies the name of the interface running BFD. The specified interface may not yet be configured with BFD. However, when it is, this virtual router will then initiate the BFD session.
ip-address—
Specifies the destination address to be used for the BFD session.
svc-id—
Specifies the service ID of the interface running BFD.
Values—
service-id:1 to 2147483647
svc-name:  64 characters maximum

 

Platforms 

All

bfd-enable

Syntax 
bfd-enable interface interface-name dest-ip ipv4-address [service service-id]
no bfd-enable
Context 
[Tree] (config>service>oper-group bfd-enable)
Full Contexts 
configure service oper-group bfd-enable
Description 

This command associates a BFD sessions with the named oper-group so that if the BFD session fails then the oper-group is changed to operationally down and all monitoring interfaces should also be brought operationally down.

Parameters 
interface-name
Specifies the source interface, up to 32 characters in length, for the BFD sessions to be monitored for the associated oper-group.
ipv4-address
Specifies the destination IPv4 address for the BFD sessions to be monitored for the associated oper-group.
service-id
Specifies the service ID, up to 64 characters in length, in which the BFD session exists if it is not in the base routing context.
Platforms 

All

bfd-enable

Syntax 
bfd-enable {ipv4 | ipv6} [include-bfd-tlv]
no bfd-enable {ipv4 | ipv6}
Context 
[Tree] (config>router>isis>if bfd-enable)
Full Contexts 
configure router isis interface bfd-enable
Description 

This command enables the use of bidirectional forwarding detection (BFD) to control IPv4 or IPv6 adjacencies. By enabling BFD on an IPv4 or IPv6 protocol interface, the state of the protocol interface is tied to the state of the BFD session between the local node and the remote node. The parameters used for the BFD are set by the BFD command under the IP interface. This command must be given separately to enable or disable BFD for both IPv4 and IPv6.

The no form of this command removes BFD from the associated adjacency.

Default 

no bfd-enable ipv4

no bfd-enable ipv6

Parameters 
ipv4—
Keyword to enable BFD to control IPv4 adjacencies.
ipv6—
Keyword to enable BFD to control IPv6 adjacencies.
include-bfd-tlv—
Enables support for the IS-IS BFD TLV options in accordance with RFC 6213, which specifies that a BFD session must be established before an IS-IS adjacency can transition to the established state. This option must be enabled on all IS-IS neighbors on a shared interface.
Platforms 

All

bfd-enable

Syntax 
[no] bfd-enable [remain-down-on-failure]
Context 
[Tree] (config>router>ospf>area>interface bfd-enable)
[Tree] (config>router>ospf3>area>interface bfd-enable)
Full Contexts 
configure router ospf area interface bfd-enable
configure router ospf3 area interface bfd-enable
Description 

This command enables the use of bidirectional forwarding detection (BFD) to control the state of the associated protocol interface. By enabling BFD on a given protocol interface, the state of the protocol interface is tied to the state of the BFD session between the local node and the remote node. The parameters used for the BFD are set via the BFD command under the IP interface.

The no form of this command removes BFD from the associated OSPF protocol adjacency.

Default 

no bfd-enable

Parameters 
remain-down-on-failure—
If the BFD session does not come back up within 10 seconds, then OSPF brings down the adjacency and wait on BFD again. This can cause OSPF neighbors to flap, because OSPF will form the adjacency and then bring it down if the BFD session is still down. If this parameter is not configured, the OSPF adjacency will form even if the BFD adjacency does not come back up after a failure.
Platforms 

All

bfd-enable

Syntax 
[no] bfd-enable
Context 
[Tree] (config>router>rip bfd-enable)
[Tree] (config>router>rip>group bfd-enable)
[Tree] (config>router>rip>group>neighbor bfd-enable)
[Tree] (config>router>ripng bfd-enable)
[Tree] (config>router>ripng>group bfd-enable)
[Tree] (config>router>ripng>group>neighbor bfd-enable)
Full Contexts 
configure router rip bfd-enable
configure router rip group bfd-enable
configure router rip group neighbor bfd-enable
configure router ripng bfd-enable
configure router ripng group bfd-enable
configure router ripng group neighbor bfd-enable
Description 

This command enables bidirectional forwarding detection (BFD) to control the state of the associated protocol adjacency. By enabling BFD on a given protocol interface, the state of the RIP neighbor is tied to the state of the BFD session between the local node and the remote node. The parameters used for the BFD are set using the bfd command under the IP interface configuration context.

The no form of this command removes BFD from the associated protocol adjacency.

Platforms 

All

bfd-enable

Syntax 
[no] bfd-enable
Context 
[Tree] (config>router>segment-routing>maintenance-policy bfd-enable)
Full Contexts 
configure router segment-routing maintenance-policy bfd-enable
Description 

This command enables seamless BFD on every programmed segment list of an SR policy candidate path to which the maintenance policy is applied. BFD session parameters are taken from the BFD template that is configured for the maintenance policy.

The no form of this command disables seamless BFD on every segment list of an SR policy.

Default 

no bfd-enable

Platforms 

All

bfd-enable

Syntax 
bfd-enable [ipv4]
no bfd-enable
Context 
[Tree] (config>router>bier bfd-enable)
Full Contexts 
configure router bier bfd-enable
Description 

This command configures BFD tracking for BIER, which means that all next-hops that use a BFD-enabled interface register with the BFD module.

The no form of this command disables BFD tracking under BIER.

Default 

no bfd-enable

Parameters 
ipv4
Enables the use of IPv4 BFD tracking.
Platforms 

All

bfd-enable

Syntax 
[no] bfd-enable
Context 
[Tree] (config>subscr-mgmt>bgp-prng-plcy bfd-enable)
Full Contexts 
configure subscriber-mgmt bgp-peering-policy bfd-enable
Description 

This command enables bi-directional forwarding (BFD) to control the state of an ESM dynamic BGP peer that is setup with this BGP peering policy. The parameters used for the BFD session are configured in the bfd context of the group-interface or retail subscriber-interface.

The no form of this command disables BFD for new ESM dynamic BGP peers that are setup with this BGP peering policy.

Default 

no bfd-enable

Platforms 

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

6.29. bfd-on-distributing-only

bfd-on-distributing-only

Syntax 
[no] bfd-on-distributing-only
Context 
[Tree] (config>lag>bfd>family bfd-on-distributing-only)
Full Contexts 
configure lag bfd family bfd-on-distributing-only
Description 

This command enables standardized implementation for interworking with other vendors by restricting micro-BFD sessions to links in LACP state distributing.

The no form of this command disables restricting micro-BFD sessions, which is an enhanced proprietary solution.

Default 

no bfd-on-distributing-only

Platforms 

All

6.30. bfd-sessions

bfd-sessions

Syntax 
bfd-sessions max-limit
no bfd-sessions
Context 
[Tree] (config>router>lsp-bfd bfd-sessions)
Full Contexts 
configure router lsp-bfd bfd-sessions
Description 

This command enables or disables LSP BFD at the tail end of LSPs on the system. It is also used to limit the maximum number of LSP BFD sessions that may be established at the tail-end of LSPs on a node to max-limit. It has no impact on the number of LSP BFD sessions that may be configured at the head end.

The no version of this command disables the creation of LSP BFD sessions by the node at the tail end of LSPs.

Default 

no bfd-sessions

Parameters 
max-limit—
Specifies the maximum number of LSP BFD sessions at the tail end of LSPs that can be established on a system. The maximum value that can be entered is constrained by the system wide limit for centralized BFD sessions.
Values—
1- max, where max is the platform specific limit on centralized BFD sessions.

 

Platforms 

All

6.31. bfd-template

bfd-template

Syntax 
bfd-template name
no bfd-template
Context 
[Tree] (config>service>apipe>spoke-sdp>bfd bfd-template)
[Tree] (config>service>cpipe>spoke-sdp>bfd bfd-template)
[Tree] (config>service>epipe>spoke-sdp>bfd bfd-template)
[Tree] (config>service>fpipe>spoke-sdp>bfd bfd-template)
[Tree] (config>service>ipipe>spoke-sdp>bfd bfd-template)
Full Contexts 
configure service apipe spoke-sdp bfd bfd-template
configure service cpipe spoke-sdp bfd bfd-template
configure service epipe spoke-sdp bfd bfd-template
configure service fpipe spoke-sdp bfd bfd-template
configure service ipipe spoke-sdp bfd bfd-template
Description 

This command configures a named BFD template to be used by VCCV BFD on PWs belonging to the VLL service. The template specifies parameters, such as the minimum transmit and receive control packet timer intervals, used by the BFD session. Template parameters are configured under the config>router>bfd context.

The no form of this command removes the binding of the BFD template to the spoke-SDP.

Default 

no bfd-template

Parameters 
name—
Specifies the BFD template name as a text string, up to 32 characters, in printable 7-bit ASCII, enclosed in double quotes.
Platforms 

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

  1. configure service cpipe spoke-sdp bfd bfd-template
  2. configure service fpipe spoke-sdp bfd bfd-template

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

  1. configure service apipe spoke-sdp bfd bfd-template

All

  1. configure service epipe spoke-sdp bfd bfd-template
  2. configure service ipipe spoke-sdp bfd bfd-template

bfd-template

Syntax 
bfd-template name
no bfd-template
Context 
[Tree] (config>service>epipe>bgp>pw-template-binding bfd-template)
Full Contexts 
configure service epipe bgp pw-template-binding bfd-template
Description 

This command configures a named BFD template to be used by VCCV BFD on PWs belonging to the BGP VPWS service. The template specifies parameters, such as the minimum transmit and receive control packet timer intervals, to be used by the BFD session. Template parameters are configured under the config>router>bfd context.

The no form of this command removes the binding of the BFD template to the BGP VPWS.

Default 

no bfd-template

Parameters 
name—
Specifies the BFD template name as a text string, up to 32 characters, in printable 7-bit ASCII, enclosed in double quotes.
Platforms 

All

bfd-template

Syntax 
bfd-template name
no bfd-template
Context 
[Tree] (config>service>vpls>mesh-sdp>bfd bfd-template)
[Tree] (config>service>vpls>spoke-sdp>bfd bfd-template)
Full Contexts 
configure service vpls mesh-sdp bfd bfd-template
configure service vpls spoke-sdp bfd bfd-template
Description 

This command configures a named BFD template to be used by VCCV BFD on the PW belonging to the VPLS spoke-SDP or mesh-SDP. The template specifies parameters, such as the minimum transmit and receive control packet timer intervals, to be used by the BFD session. Template parameters are configured under the config>router>bfd context.

The no form of this command removes the binding of the BFD template to the spoke-SDP.

Default 

no bfd-template

Parameters 
name—
Specifies the BFD template name as a text string, up to 32 characters, in printable 7-bit ASCII, enclosed in double quotes.
Platforms 

All

bfd-template

Syntax 
bfd-template name
no bfd-template
Context 
[Tree] (config>service>vpls>bgp-ad>pw-template-binding bfd-template)
[Tree] (config>service>vpls>bgp>pw-template-binding bfd-template)
Full Contexts 
configure service vpls bgp pw-template-binding bfd-template
configure service vpls bgp-ad pw-template-binding bfd-template
Description 

This command configures a named BFD template to be used by VCCV BFD on PWs belonging to the BGP VPWS, or BGP AD VPLS service. The template specifies parameters, such as the minimum transmit and receive control packet timer intervals, to be used by the BFD session. Template parameters are configured under the config>router>bfd context.

Default 

no bfd-template

Parameters 
name—
Specifies the BFD template name as a text string, up to 32 characters, in printable 7-bit ASCII, enclosed in double quotes.
Platforms 

All

bfd-template

Syntax 
bfd-template name
no bfd-template
Context 
[Tree] (config>service>ies>if>spoke-sdp>bfd bfd-template)
Full Contexts 
configure service ies interface spoke-sdp bfd bfd-template
Description 

This command configures a named BFD template to be used by VCCV BFD on the PW belonging to the spoke-SDP that is terminated on the IES interface. The template specifies parameters, such as the minimum transmit and receive control packet timer intervals, to be used by the BFD session. Template parameters are configured under the config>router>bfd context.

The no form of this command removes the binding of the BFD template to the spoke-SDP.

Default 

no bfd-template

Parameters 
name—
Specifies the BFD template name as a text string, up to 32 characters, in printable 7-bit ASCII, enclosed in double quotes.
Platforms 

All

bfd-template

Syntax 
bfd-template name
no bfd-template
Context 
[Tree] (config>service>vprn>if>spoke-sdp>bfd bfd-template)
Full Contexts 
configure service vprn interface spoke-sdp bfd bfd-template
Description 

This command configures a named BFD template to be used by VCCV BFD on the PW belonging to spoke-SDP that is terminated on the VPRN interface. The template specifies parameters, such as the minimum transmit and receive control packet timer intervals, to be used by the BFD session. Template parameters are configured under the config>router>bfd context.

The no form of this command removes the binding of the BFD template to the spoke-SDP.

Default 

no bfd-template

Parameters 
name—
Specifies the BFD template name as a text string, up to 32 characters, in printable 7-bit ASCII, enclosed in double quotes.
Platforms 

All

bfd-template

Syntax 
bfd-template bfd-template-name
no bfd-template
Context 
[Tree] (config>router>ldp>lsp-bfd bfd-template)
Full Contexts 
configure router ldp lsp-bfd bfd-template
Description 

This command applies the specified BFD template to the BFD sessions for LDP LSPs with FECs that match the prefix list. The specified BFD template must exist prior to its application to LSP BFD.

The no form of this command removes the application of the BFD template.

Default 

no bfd-template

Parameters 
bfd-template-name—
Specifies the name of the BFD template configured using the config>router>bfd>bfd-template command, up to 32 characters maximum.
Platforms 

All

bfd-template

Syntax 
bfd-template name
no bfd-template
Context 
[Tree] (config>router>mpls>mpls-tp>oam-template bfd-template)
Full Contexts 
configure router mpls mpls-tp oam-template bfd-template
Description 

This command configures a named BFD template to be referenced by an OAM template.

Default 

no bfd-template

Parameters 
name—
Specifies the BFD template name as a text string up to 32 characters in printable 7-bit ASCII, enclosed in double quotes.
Platforms 

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

bfd-template

Syntax 
bfd-template name
no bfd-template
Context 
[Tree] (config>router>mpls>lsp>bfd bfd-template)
[Tree] (config>router>mpls>lsp>primary>bfd bfd-template)
[Tree] (config>router>mpls>lsp>secondary>bfd bfd-template)
[Tree] (config>router>mpls>lsp-template>bfd bfd-template)
Full Contexts 
configure router mpls lsp bfd bfd-template
configure router mpls lsp primary bfd bfd-template
configure router mpls lsp secondary bfd bfd-template
configure router mpls lsp-template bfd bfd-template
Description 

This command references a named BFD template to be used by LSP BFD. The template specifies parameters, such as the minimum transmit and receive control packet timer intervals, to be used by the BFD session. Templates are configured under the config>router>bfd context.

The no form of this command removes the association of the named BFD template to the LSP.

Default 

no bfd-template

Parameters 
name—
Specifies a text string name for the template of up to 32 characters in printable 7-bit ASCII, enclosed in double quotes.
Platforms 

All

bfd-template

Syntax 
[no] bfd-template name
Context 
[Tree] (config>router>bfd bfd-template)
Full Contexts 
configure router bfd bfd-template
Description 

This command configures a BFD template. A BFD template defines the set of configurable parameters used by a BFD session. These include the transmit and receive timer intervals used for BFD CC packets, the transmit timer interval used when the session is providing a CV function, the multiplier value, the echo-receive interval, and whether the BFD session terminates in the CPM network processor.

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

Default 

no bfd-template

Parameters 
name—
Specifies a text string name for the template, up to 32 characters in printable 7-bit ASCII, enclosed in double quotes.
Platforms 

All

bfd-template

Syntax 
bfd-template bfd-template
no bfd-template
Context 
[Tree] (config>router>segment-routing>maintenance-policy bfd-template)
Full Contexts 
configure router segment-routing maintenance-policy bfd-template
Description 

This command references a named BFD template that is used by seamless BFD. The template specifies parameters, such as the minimum transmit and receive control packet timer intervals, that are used by the BFD session. Templates are configured under the config>router>bfd context.

A BFD template must exist on the system before being referenced from a maintenance policy.

The no form of this command removes the configured template.

Parameters 
bfd-template—
Specifies the name of the BFD template, up to 32 characters.
Platforms 

All

6.32. bfd-trap-suppression

bfd-trap-suppression

Syntax 
[no] bfd-trap-suppression
Context 
[Tree] (config>router>mpls>lsp>protect-tp-path>mep bfd-trap-suppression)
[Tree] (config>router>mpls>lsp>working-tp-path>mep bfd-trap-suppression)
Full Contexts 
configure router mpls lsp protect-tp-path mep bfd-trap-suppression
configure router mpls lsp working-tp-path mep bfd-trap-suppression
Description 

This command enables AIS packets on a working or protection path of an MPLS-TP LSP to suppress BFD Down traps if a BFD session goes down on that path. It also causes BFD Up traps to be suppressed, and enables the 2.5 s hold-down timer.

Suppression only occurs as a result of a received AIS packet. Traps generated as a result of a local failure at an LER are not suppressed.

The no form of this command disables BFD Down/Up trap suppression when AIS packets are received.

Default 

no bfd-trap-suppression

Platforms 

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

6.33. bfr-id

bfr-id

Syntax 
bfr-id bfr-id
no bfr-id
Context 
[Tree] (config>router>bier>template>sub-domain bfr-id)
Full Contexts 
configure router bier template sub-domain bfr-id
Description 

This command specifies the BIER-ID for this sub-domain. BIER-IDs should be assigned sequentially as the SI and BIER bit position are driven by the IDs. The equation used to drive BIER SI and bit positions from the ID is as follows:

SI = (BFR-id -1) /BitStringLength

bit position = ((BFR-id -1) modulo BitStringLength) +1

If the BIER-ID is sequential then the all bit positions in a bit string length will be utilized before moving on to the next SetID (SI).

BFR ID configuration is only necessary for BFIR and BFER, and not for transit BFRs

The no form of this command removes the BIER-ID.

Parameters 
bfr-id—
The BIER-ID of the router.
Values—
1 to 4096

 

Platforms 

All

6.34. bgp

bgp

Syntax 
[no] bgp
Context 
[Tree] (config>subscr-mgmt>isa-svc-chain>evpn bgp)
Full Contexts 
configure subscriber-mgmt isa-service-chaining evpn bgp
Description 

Commands in this context configure EVPN BGP-specific information.

The no form of this command reverts to the default.

Platforms 

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

bgp

Syntax 
[no] bgp
Context 
[Tree] (config>service>epipe bgp)
Full Contexts 
configure service epipe bgp
Description 

Commands in this context configure the BGP related parameters BGP used for multi-homing and BGP VPWS.

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

Platforms 

All

bgp

Syntax 
[no] bgp
Context 
[Tree] (config>service>epipe>bgp-evpn>mpls>auto-bind-tunnel>resolution-filter bgp)
[Tree] (config>service>vpls>bgp-evpn>mpls>auto-bind-tunnel>resolution-filter bgp)
[Tree] (config>service>vprn>bgp-evpn>mpls>auto-bind-tunnel>resolution-filter bgp)
[Tree] (config>service>vprn>bgp-ipvpn>mpls>auto-bind-tunnel>resolution-filter bgp)
Full Contexts 
configure service epipe bgp-evpn mpls auto-bind-tunnel resolution-filter bgp
configure service vpls bgp-evpn mpls auto-bind-tunnel resolution-filter bgp
configure service vprn bgp-evpn mpls auto-bind-tunnel resolution-filter bgp
configure service vprn bgp-ipvpn mpls auto-bind-tunnel resolution-filter bgp
Description 

This command selects the BGP tunnel type.

This command instructs BGP EVPN to search for a BGP LSP to the address of the BGP next hop. If the user does not enable the BGP tunnel type, inter-area or inter-as prefixes are not resolved.

The no form of this command removes the BGP tunnel type configuration.

Default 

bgp

Platforms 

All

bgp

Syntax 
bgp bgp-instance
no bgp bgp-instance
Context 
[Tree] (config>service>vpls bgp)
Full Contexts 
configure service vpls bgp
Description 

Commands in this context configure the BGP related parameters for BGP VPLS.

A maximum of two BGP instances can be configured in a VPLS service. The bgp-instance parameter value can be configured as 1 or 2. If it is not specified, the parameter value is configured as 1 by default.

The route-distinguisher configured in BGP instance 1 and 2 must be different. However, the route-target value may be configured the same or different for the two instances.

Only BGP-EVPN MPLS is allowed to be assigned to instance 2. Instance 1 must be used for the VXLAN and L2VPN address families.

BGP-EVPN VXLAN and BGP-EVPN MPLS can only be configured as no shutdown in the same service if they are associated with different instances (When the two BGP instances are created, the bgp-instance command must be configured in the bgp-evpn mpls context).

The evi value in bgp-evpn can be used to auto-derive the route distinguisher in instance 1 only. However, the evi value can be used to auto-derive the route-target in both instances.

The no version of the command removes the BGP instance.

Parameters 
bgp-instance
Specifies the value associated with the BGP instance.
Values—
1 to 2

 

Platforms 

All

bgp

Syntax 
[no] bgp
Context 
[Tree] (config>router bgp)
Full Contexts 
configure router bgp
Description 

This command creates the BGP protocol instance and BGP configuration context. BGP is administratively enabled upon creation.

The no form of this command deletes the BGP protocol instance and removes all configuration parameters for the BGP instance. BGP must be shutdown before deleting the BGP instance. An error occurs if BGP is not shutdown first.

Platforms 

All

bgp

Syntax 
[no] bgp
Context 
[Tree] (config>service>vprn bgp)
Full Contexts 
configure service vprn bgp
Description 

This command enables the BGP protocol with the VPRN service.

The no form of this command disables the BGP protocol from the given VPRN service.

Default 

no bgp

Platforms 

All

bgp

Syntax 
bgp [source src-Addr] [group grpAddr] [peer peerAddr]
no bgp
Context 
[Tree] (debug>router>pim bgp)
Full Contexts 
debug router pim bgp
Description 

This command enables debugging for PIM/BGP-specific interoperation.

The no form of this command disables debugging for PIM/BGP-specific interoperation.

Parameters 
src-Addr
Debugs BGP information associated with the specified source.
Values—
source address (ipv4, ipv6)

 

grp-Addr
Debugs BGP information associated with the specified group.
Values—
group address (ipv4, ipv6)

 

PeerAddr
Debugs BGP information associated with the specified peer.
Values—
peer address (ipv4, ipv6)

 

Platforms 

All

bgp

Syntax 
[no] bgp
Context 
[Tree] (config>router>bgp>next-hop-resolution>shortcut-tunn>family>resolution-filter bgp)
[Tree] (config>router>bgp>next-hop-resolution>labeled-routes>transport-tunnel>family>resolution-filter bgp)
Full Contexts 
configure router bgp next-hop-resolution labeled-routes transport-tunnel family resolution-filter bgp
configure router bgp next-hop-resolution shortcut-tunnel family resolution-filter bgp
Description 

This command selects BGP tunneling for next-hop resolution and specifies the IPv4 tunnels created by receiving BGP label-unicast IPv4 routes for /32.

The no form of this command disables the selection of BGP tunneling for next-hop resolution.

Platforms 

All

6.35. bgp-ad

bgp-ad

Syntax 
[no] bgp-ad
Context 
[Tree] (config>service>vpls bgp-ad)
Full Contexts 
configure service vpls bgp-ad
Description 

This command configures BGP auto-discovery.

Platforms 

All

6.36. bgp-auto-rd-range

bgp-auto-rd-range

Syntax 
bgp-auto-rd-range ip-address comm-val comm-val to comm-val
no bgp-auto-rd-range
Context 
[Tree] (config>service>system bgp-auto-rd-range)
Full Contexts 
configure service system bgp-auto-rd-range
Description 

This command defines the type-1 route-distinguisher IPv4 address and community value range within which the system will select a route-distinguisher for the bgp-enabled services using auto-rd.

Interactions:

This command is used along with the route-distinguisher auto-rd command supported in VPLS, VPRN and Epipe services. The system forces the user to create a bgp-auto-range before the auto-rd option can be used in the services.

The system will keep allocating values for services configured with route-distinguisher auto-rd as long as there are available community values within the configured range. After the command is added, the following changes are allowed:

  1. The ip-address can be changed without modifying the comm-val range, even if services using auto-rd are present. The affected routes will be withdrawn and re-advertised with the new route-distinguishers.
  2. The comm-val range can be modified as long as no conflicting values are present in the new range. For example, the user may expand the range as long as the new range does not overlap with existing manual route-distinguishers. The user may also reduce the range as long as the new range can accommodate the already allocated auto-RDs.
Parameters 
ip-address—
Specifies the IPv4 address used in the first 4 octets of all the type-1 auto route-distinguishers selected by the system.
comm-val—
Specifies the community value of the type-1 auto route-distinguisher.
Values—
1 to 65535

 

Platforms 

All

6.37. bgp-evpn

bgp-evpn

Syntax 
[no] bgp-evpn
Context 
[Tree] (config>service>epipe bgp-evpn)
[Tree] (config>service>system bgp-evpn)
[Tree] (config>service>vpls bgp-evpn)
Full Contexts 
configure service epipe bgp-evpn
configure service system bgp-evpn
configure service vpls bgp-evpn
Description 

Commands in this context configure the BGP EVPN parameters in the base instance.

Platforms 

All

bgp-evpn

Syntax 
bgp-evpn
Context 
[Tree] (config>service>vprn bgp-evpn)
Full Contexts 
configure service vprn bgp-evpn
Description 

Commands in this context configure the BGP EVPN parameters.

Platforms 

All

6.38. bgp-evpn-multi-homing

bgp-evpn-multi-homing

Syntax 
bgp-evpn-multi-homing
Context 
[Tree] (config>redundancy bgp-evpn-multi-homing)
Full Contexts 
configure redundancy bgp-evpn-multi-homing
Description 

Commands in this context configure the BGP-EVPN global timers

Platforms 

All

6.39. bgp-high-priority

bgp-high-priority

Syntax 
[no] bgp-high-priority
Context 
[Tree] (config>router>policy-options>policy-statement>default-action bgp-high-priority)
[Tree] (config>router>policy-options>policy-statement>entry>action bgp-high-priority)
Full Contexts 
configure router policy-options policy-statement default-action bgp-high-priority
configure router policy-options policy-statement entry action bgp-high-priority
Description 

This command enables eligible BGP routes matched by the policy entry or policy default-action that are tagged for faster route table updates.

This action applies only when the policy is applied as a BGP import policy to a base router BGP peer or VPRN BGP peer and applies only to the following route types:

  1. IPv4
  2. label-IPv4
  3. IPv6
  4. label-IPv6

This command is useful when the BGP RIB contains a large number of routes and quick routing table updates are needed for a small subset of these routes. The effectiveness of this command decreases as the subset becomes a larger proportion of the total RIB.

The no form of this command disables the routes that are tagged for faster route table updates.

Default 

no bgp-high-priority

Platforms 

All

6.40. bgp-ipvpn

bgp-ipvpn

Syntax 
bgp-ipvpn
Context 
[Tree] (config>service>vprn bgp-ipvpn)
Full Contexts 
configure service vprn bgp-ipvpn
Description 

Commands in this context configure the BGP IPVPN parameters.

Platforms 

All

6.41. bgp-labels-hold-timer

bgp-labels-hold-timer

Syntax 
bgp-labels-hold-timer seconds
no bgp-labels-hold-timer
Context 
[Tree] (config>router>mpls-labels bgp-labels-hold-timer)
Full Contexts 
configure router mpls-labels bgp-labels-hold-timer
Description 

This command configures the BGP labels hold timer on the ingress router.

Default 

bgp-labels-hold-timer 0

Parameters 
seconds—
Specifies the seconds
Values—
0 to 255

 

Platforms 

All

6.42. bgp-leak

bgp-leak

Syntax 
[no] bgp-leak
Context 
[Tree] (config>router>policy-options>policy-statement>default-action bgp-leak)
[Tree] (config>router>policy-options>policy-statement>entry>action bgp-leak)
Full Contexts 
configure router policy-options policy-statement default-action bgp-leak
configure router policy-options policy-statement entry action bgp-leak
Description 

This command causes qualifying matched BGP routes to be marked as leakable, meaning they are candidates to be leaked into other routing instances (copied with their complete set of path attributes). A BGP route is a qualifying route if it is an IPv4 route (unlabeled), IPv6 route (unlabeled) or a label-IPv4 route.

Note:

A leakable BGP route is not actually leaked into another routing instance unless it is accepted by a leak-import policy of that other routing instance.

The bgp-leak command has an effect only when the policy is applied as a BGP import policy in the base router or a VPRN context.

Default 

no bgp-leak

Platforms 

All

6.43. bgp-med

bgp-med

Syntax 
bgp-med adjust expression
bgp-med set {igp | min-igp}
bgp-med set med-value
no bgp-med
Context 
[Tree] (config>router>policy-options>policy-statement>default-action bgp-med)
[Tree] (config>router>policy-options>policy-statement>entry>action bgp-med)
Full Contexts 
configure router policy-options policy-statement default-action bgp-med
configure router policy-options policy-statement entry action bgp-med
Description 

This command changes the BGP MED attribute value in BGP routes matched by the route policy entry (or the policy default action).

If the matched route already has a MED attribute, this command overwrites the existing value. If the matched route does not have a MED attribute, then one is added and the value is set based on the parameters of this command.

This command has no effect on non-BGP routes. The default, no bgp-med, does not modify MED values.

Default 

no bgp-med

Parameters 
expression—
Specifies a logical expression parsed as a string. The string can contain:
  1. parentheses () to change the order of operations
  2. mathematical operators: + (addition), - (subtraction) and * (multiplication)
  3. directly entered decimal values that act as operands of the mathematical operators. Each decimal value supports up to three decimal places precision in the range of 0.000 to 4294967295.000
  4. decimal values represented by parameter names (using the usual @parameter-name@ syntax) that act as operands of the mathematical operators. Each parameterized decimal value supports up to three decimal places precision in the range of 0.000 to 4294967295.000
igp—
Instructs the policy to set the MED based on the current route table or tunnel table cost to resolve the BGP next-hop address.
min-igp—
Instructs the policy to set the MED based on the minimum route table or tunnel table cost to resolve the BGP next-hop of the route, over its lifetime in the local RIB.
med-value—
Specifies a new MED value (or parameter name to use for the new MED value) to use with the route.
Values—
value
  1. 0 to 4294967295
param-name
  1. up to 32 characters
  2. Must start and end with an at-sign (@)

 

Platforms 

All

6.44. bgp-multi-homing

bgp-multi-homing

Syntax 
bgp-multi-homing
Context 
[Tree] (config>redundancy bgp-multi-homing)
Full Contexts 
configure redundancy bgp-multi-homing
Description 

This command configures BGP multi-homing parameters.

Platforms 

All

6.45. bgp-peering-policy

bgp-peering-policy

Syntax 
bgp-peering-policy policy-name [create]
no bgp-peering-policy policy-name
Context 
[Tree] (config>subscr-mgmt bgp-peering-policy)
Full Contexts 
configure subscriber-mgmt bgp-peering-policy
Description 

This command configures the name of the BGP peering policy.

The no form of this command removes the policy name from the configuration.

Parameters 
policy-name—
Specifies the BGP peer policy name, up to 32 characters.
create—
Keyword used to create the peering policy. The create keyword requirement can be enabled or disabled in the environment>create context.
Platforms 

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

6.46. bgp-peers

bgp-peers

Syntax 
bgp-peers criterion-index group reg-exp neighbor reg-exp
bgp-peers criterion-index router router-instance group reg-exp neighbor reg-exp
bgp-peers criterion-index router service-name service-name group reg-exp neighbor reg-exp
no bgp-peers criterion-index
Context 
[Tree] (config>filter>match-list>ip-prefix-list>apply-path bgp-peers)
[Tree] (config>filter>match-list>ipv6-prefix-list>apply-path bgp-peers)
Full Contexts 
configure filter match-list ip-prefix-list apply-path bgp-peers
configure filter match-list ipv6-prefix-list apply-path bgp-peers
Description 

This command configures auto-generation of IPv4 or IPv6 address prefixes (as required by the context that the command is executed within) based on the base router BGP instance configuration.

The no form of this command removes the bgp-peers configuration for auto-generation of address prefixes for the specified index value.

Parameters 
service-name—
Specifies the service name, up to 64 characters in length.
group
Configures a match against the base router BGP instance group configuration.

Regex match (.*) can be used to match against any group.

neighbor
Configures a match against the base router BGP instance neighbor configuration.

Regex match (.*) can be used to match against any neighbor.

criterion-index —
Specifies an integer from 1 to 255 enumerating BGP peers auto-generation configuration within this list.
router-instance—
Specifies the router name or service ID.
Values—
router-instance: router-name or vprn-svc-id
router-name: "Base"
vprn-svc-id: 1 to 2147483647
service-name: Specifies the service name, up to 64 characters in length.

 

router—
Configures a match against the base router BGP instance configuration.
reg-exp—
Specifies a regular expression that defines a match string, up to 255 characters in length, to be used to auto-generate address prefixes. Matching is performed from the least-significant digit. For example, a string 10.0 matches all neighbors with addresses starting with 10, such as 10.0.x.x or 10.0xx.x.x.
Platforms 

All

6.47. bgp-shared-queue

bgp-shared-queue

Syntax 
bgp-shared-queue [cir rate] [pir rate]
no bgp-shared-queue
Context 
[Tree] (config>service>vprn bgp-shared-queue)
Full Contexts 
configure service vprn bgp-shared-queue
Description 

This command enables all BGP peers within a VPRN instance to share a single CPM queue. This command takes effect on new BGP connections established; already established BGP peers continue to use their own CPM queue. Any changes to PIR/CIR of the shared queue takes effect only after BGP connections are re-established.

Parameters 
cir rate
Specifies the CIR rate for the shared queue.
pir rate
Specifies the PIR rate for the shared queue.
Platforms 

All

6.48. bgp-shortcut

bgp-shortcut

Syntax 
[no] bgp-shortcut
Context 
[Tree] (config>router>mpls>lsp bgp-shortcut)
[Tree] (config>router>mpls>lsp-template bgp-shortcut)
Full Contexts 
configure router mpls lsp bgp-shortcut
configure router mpls lsp-template bgp-shortcut
Description 

This command enables the use of RSVP LSP for IPv4 BGP routes.

Platforms 

All

6.49. bgp-transport-tunnel

bgp-transport-tunnel

Syntax 
bgp-transport-tunnel [include | exclude]
Context 
[Tree] (config>router>mpls>lsp bgp-transport-tunnel)
[Tree] (config>router>mpls>lsp-template bgp-transport-tunnel)
Full Contexts 
configure router mpls lsp bgp-transport-tunnel
configure router mpls lsp-template bgp-transport-tunnel
Description 

This command allows or blocks RSVP-TE LSP to be used as a transport LSP for BGP tunnel routes.

Default 

bgp-transport-tunnel include

Parameters 
include—
Allows RSVP-TE LSP to be used as transport LSP from the ASBR to local PE router, from ingress PE to ASBR in the local AS or between multi-hop External Border Gateway Protocol (EBGP) peers with ASBR to ASBR adjacency.
exclude—
Blocks RSVP-TE LSP to be used as transport LSP from the ASBR to local PE router, from ingress PE to ASBR in the local AS or between multi-hop EBGP peers with ASBR to ASBR adjacency.
Platforms 

All

6.50. bgp-tunnel

bgp-tunnel

Syntax 
[no] bgp-tunnel
Context 
[Tree] (config>service>sdp bgp-tunnel)
Full Contexts 
configure service sdp bgp-tunnel
Description 

This command allows the use of BGP route tunnels available in the tunnel table to reach SDP far-end nodes. Use of BGP route tunnels are only available with MPLS-SDP. Only one of the transport methods is allowed per SDP - LDP, RSVP-LSP BGP, SR-ISIS, or SR-OSPF. This restriction is relaxed for some combinations of the transport methods when the mixed-lsp-mode option is enabled within the SDP.

The no form of the command disables resolving BGP route tunnel LSP for SDP far-end.

Default 

no bgp-tunnel (BGP tunnel route to SDP far-end is disabled)

Platforms 

All

6.51. bgp-tunnel-metric

bgp-tunnel-metric

Syntax 
bgp-tunnel-metric [value] prefer-aigp
bgp-tunnel-metric [value] [prefer-aigp]
no bgp-tunnel-metric
Context 
[Tree] (config>router>bgp bgp-tunnel-metric)
Full Contexts 
configure router bgp bgp-tunnel-metric
Description 

This command sets the TTM metric of all BGP tunnels to a fixed value or a value derived from the AIGP metric of the BGP-LU route, if the BGP-LU route has an AIGP path attribute; otherwise, it is set to the number specified by value. The effect of this command can be overridden by BGP import policies.

By default, BGP tunnels are installed with a fixed cost of 1000 in the tunnel table. This can overstate or understate their true cost when compared to other tunnels with IGP-derived costs.

The no form of this command reverts to the default.

Default 

no bgp-tunnel-metric

Parameters 
value—
Specifies the BGP tunnel metric.
Values—
0 to 4294967295

 

prefer-aigp—
Specifies that the TTM metric be based on the Accumulated IGP (AIGP) metric if the route has the path attribute. When prefer-aigp is configured and a BGP-LU route is selected for installation in TTM and it is not matched by a BGP import policy entry that overrides the bgp-tunnel-metric action, the TTM metric of the tunnel is set to the AIGP metric value of the BGP-LU route, plus the resolved cost to the BGP next-hop of the route if the tunnel has the AIGP path attribute. Otherwise, the number in value is set as the metric.
Platforms 

All

bgp-tunnel-metric

Syntax 
bgp-tunnel-metric [value | param-name] [prefer-aigp]
no bgp-tunnel-metric
Context 
[Tree] (config>router>policy-options>policy-statement>default-action bgp-tunnel-metric)
[Tree] (config>router>policy-options>policy-statement>entry>action bgp-tunnel-metric)
Full Contexts 
configure router policy-options policy-statement default-action bgp-tunnel-metric
configure router policy-options policy-statement entry action bgp-tunnel-metric
Description 

This command provides the ability to set the TTM metric of all BGP tunnels, matched by the policy entry or the policy default action, to a fixed value or a value derived from the AIGP metric of the BGP-LU route, if the BGP-LU route has an AIGP path attribute, otherwise it reverts to the value parameter.

The no form of this command reverts to the default.

Default 

no bgp-tunnel-metric

Parameters 
value—
Specifies the BGP tunnel metric.
Values—
0 to 4294967295

 

param-name—
Specifies the parameter name, up to 32 characters that starts and ends with an at-sign (@).
prefer-aigp—
Specifies that the TTM metric be based on the Accumulated IGP (AIGP) metric if the route has the path attribute.
Platforms 

All

6.52. bgp-tunnel-preference

bgp-tunnel-preference

Syntax 
bgp-tunnel-preference [preference]
no bgp-tunnel-preference
Context 
[Tree] (config>router>bgp bgp-tunnel-preference)
Full Contexts 
configure router bgp bgp-tunnel-preference
Description 

This command configures the tunnel table preference for BGP-LU tunnel type away from its default value.

The tunnel table preference applies to the next-hop resolution of BGP routes of the following families: EVPN, IPv4, IPv6, VPN-IPv4, VPN-IPv6, label-IPv4, and label-IPv6 in the tunnel table.

This feature does not apply to a VPRN, VPLS, or VLL service with explicit binding to an SDP which enabled the mixed-lsp-mode option. The tunnel preference, in such an SDP, is fixed and is controlled by the service manager. The configuration of the tunnel table preference parameter does not modify the behavior of such an SDP and the services that bind to it.

It is recommended to not set two or more tunnel types to the same preference value. In such a situation, the tunnel table prefers the tunnel type which was first introduced in SR OS implementation historically.

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

Default 

bgp-tunnel-preference 12

Parameters 
preference—
Specifies the BGP tunnel preference.
Values—
1 to 255

 

Default—
12
Platforms 

All

6.53. bgp-vpls

bgp-vpls

Syntax 
bgp-vpls
Context 
[Tree] (config>service>vpls bgp-vpls)
Full Contexts 
configure service vpls bgp-vpls
Description 

Commands in this context configure the BGP-VPLS parameters and addressing.

Platforms 

All

6.54. bgp-vpls-mh-ve-id

bgp-vpls-mh-ve-id

Syntax 
bgp-vpls-mh-ve-id number
no bgp-vpls-mh-ve-id
Context 
[Tree] (config>service>vpls>sap bgp-vpls-mh-ve-id)
Full Contexts 
configure service vpls sap bgp-vpls-mh-ve-id
Description 

This command upon the configuration of the ve-id under the SAP and if BGP-VPLS is configured and is operationally up, causes the PE to advertise a bgp-mh route for the ve-id (the route does not contain label information). The bgp-mh route contains the F and D flags properly set based on the SAP operational state. Upon switchover, the former active PE (DF in case of EVPN-MH) sends an update with a transition of the F bit from 1 to 0. This is an indication for the remote PEs to flush their MACs associated to the advertising PE.

This command is required when MC-LAG or EVPN-MH is used for multi-homing redundancy and mac-flush is required at remote BGP-VPLS PEs when there is a failure in the active PE.

The no form of this command withdraws the L2 VPN route.

Parameters 
number —
Specifies the BGP-VPLS multi-homing virtual-edge identifier.
Values—
1 to 65535

 

Platforms 

All

6.55. bgp-vpws

bgp-vpws

Syntax 
[no] bgp-vpws
Context 
[Tree] (config>service>epipe bgp-vpws)
Full Contexts 
configure service epipe bgp-vpws
Description 

Commands in this context configure BGP-VPWS parameters and addressing.

Default 

no bgp-vpws

Platforms 

All

6.56. bi

bi

Syntax 
bi
Context 
[Tree] (config>system>security>keychain>direction bi)
Full Contexts 
configure system security keychain direction bi
Description 

This command configures keys for both send and receive stream directions.

Platforms 

All

6.57. bier

bier

Syntax 
[no] bier
Context 
[Tree] (config>service>vprn>mvpn>provider-tunnel>inclusive bier)
[Tree] (config>service>vprn>mvpn>provider-tunnel>selective bier)
Full Contexts 
configure service vprn mvpn provider-tunnel inclusive bier
configure service vprn mvpn provider-tunnel selective bier
Description 

This command creates a BIER inclusive or selective provider tunnel.

The no form of this command deletes the tunnel.

Platforms 

All

bier

Syntax 
[no] bier
Context 
[Tree] (config>router bier)
Full Contexts 
configure router bier
Description 

Commands in this context configure BIER.

Platforms 

All

bier

Syntax 
[no] bier
Context 
[Tree] (config>router>isis>level bier)
Full Contexts 
configure router isis level bier
Description 

This command enables BIER capabilities.

The no form of this command disables BIER capabilities.

Platforms 

All

bier

Syntax 
[no] bier
Context 
[Tree] (config>router>ospf>area bier)
Full Contexts 
configure router ospf area bier
Description 

This command enables BIER capabilities.

The no form of this command disables BIER capabilities.

Default 

no bier

Platforms 

All

6.58. bier-ping

bier-ping

Syntax 
bier-ping [sub-domain sub-domain-id] bfr-id bfr-id [detail] [fc fc-name] [profile {in| out}] [timeout timeout] [ttl ttl]
bier-ping [sub-domain sub-domain-id] bfr-id-start bfr-id bfr-id-end bfr-id [detail] [fc fc-name] [profile {in| out}] [timeout timeout] [ttl ttl]
bier-ping [sub-domain sub-domain-id] bfr-prefix ipv4-address [ipv4-address] [detail] [fc fc-name] [profile {in| out}] [timeout timeout] [ttl ttl]
Context 
[Tree] (oam bier-ping)
Full Contexts 
oam bier-ping
Description 

This command performs connectivity tests on the BIER data plane.

Parameters 
sub-domain-id
Specifies the ID of the sub-domain where the BIER OAM packet is generated.
Values—
0 to 255

 

Default—
0
bfr-id 
Specifies the BIER-ID of the router.
Values—
1 to 4096

 

ipv4-address 
Specifies the routable IPv4 address of the BFR, used by BIER to identify the BFR. Up to 16 IPv4 addresses can be specified.
Values—
a.b.c.d

 

detail —
Keyword to display more information.
fc-name—
Specifies the FC and profile parameters that are used to indicate the forwarding class and profile of the BIER echo request packet.
Values—
be, l2, af, l1, h2, ef, h1, nc

 

Default—
be
{in | out}
Specifies the profile state of the BIER echo request packet.
Default—
out
timeout—
Specifies the number, in seconds, used to override the default timeout value and is the amount of time that the router waits for a message reply after sending the message request. Upon the expiration of the timeout, the test is marked complete and no more packets are processed.
Values—
1 to 120

 

Default—
10
ttl —
Specifies the TTL value for the BIER ping test, expressed as a decimal integer.
Values—
1 to 255

 

Default—
255
Platforms 

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

6.59. bier-signaling

bier-signaling

Syntax 
[no] bier-signaling [detail]
Context 
[Tree] (debug>router>pim bier-signaling)
Full Contexts 
debug router pim bier-signaling
Description 

This command enables debugging for bier inband.

The no form of this command disables debugging for bier inband.

Parameters 
detail—
Debugs detailed information on the bier inband.

bier-signaling

Syntax 
[no] bier-signaling [ipv4] [ipv6]
Context 
[Tree] (config>router>pim>interface bier-signaling)
Full Contexts 
configure router pim interface bier-signaling
Description 

This commands enables PIM signaling through a BIER domain. PIM signaling only functions in the context of SD0. PIM signaling can signal PIM IPv4 and IPv6 over a BIER IPV4 core.

The no form of this command disables PIM signaling through a BIER domain.

Default 

no bier-signaling

Parameters 
ipv4—
Enables the use of IPv4 PIM signaling through a BIER domain.
ipv6—
Enables the use of IPv6 PIM signaling through a BIER domain.
Platforms 

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

6.60. bier-trace

bier-trace

Syntax 
bier-trace [sub-domain sub-domain-id] bfr-id bfr-id [detail] [fc fc-name] [profile {in| out}] [min-ttl min-ttl] [max-ttl max-ttl] [probe-count probes-per-hop] [timeout timeout]
bier-trace [sub-domain sub-domain-id] bfr-prefix ipv4-address [detail] [fc fc-name] [profile {in| out}] [min-ttl min-ttl] [max-ttl max-ttl] [probe-count probes-per-hop] [timeout timeout]
Context 
[Tree] (oam bier-trace)
Full Contexts 
oam bier-trace
Description 

This command performs trace tests on the BIER data plane.

Parameters 
sub-domain-id
Specifies the ID of the sub-domain where the BIER OAM packet is generated.
Values—
0 to 255

 

Default—
0
bfr-id 
Specifies the BIER-ID of the router.
Values—
1 to 4096

 

ipv4-address 
Specifies the routable IPv4 address of the BFR, used by BIER to identify the BFR.
Values—
a.b.c.d

 

detail —
Keyword to display more information.
fc-name—
Specifies the FC and profile parameters that are used to indicate the forwarding class and profile of the BIER OAM packet.
Values—
be, l2, af, l1, h2, ef, h1, nc

 

Default—
be
{in | out}
Specifies the profile state of the BIER echo request packet.
Default—
out
min-ttl —
Specifies the minimum TTL value for the BIER trace test, expressed as a decimal integer.
Values—
1 to 255

 

Default—
1
max-ttl —
Specifies the maximum TTL value for the BIER trace test, expressed as a decimal integer.
Values—
1 to 255

 

Default—
30
probes-per-hop—
Specifies the probes-per-hop count, expressed as number of packets.
Values—
1 to 10

 

Default—
1
timeout—
Specifies the number, in seconds, used to override the default timeout value and is the amount of time that the router waits for a message reply after sending each probe for a specific test. Upon the expiration of the timeout, the test is marked complete and no more packets are processed for the request probe.

When the test consists of multiple probes, the timeout is the interval, in seconds, between request probes.

A BIER trace test terminates after five consecutive timeouts.

Values—
1 to 60

 

Default—
3
Platforms 

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

6.61. bin

bin

Syntax 
bin bin-number
Context 
[Tree] (config>oam-pm>bin-group>bin-type bin)
Full Contexts 
configure oam-pm bin-group bin-type bin
Description 

Commands in this context configure the thresholds for the specified bin.

Parameters 
bin-number—
Specifies bin to configure.
Values—
1 to 9

 

Platforms 

All

6.62. bin-group

bin-group

Syntax 
bin-group bin-group-number [fd-bin-count fd-bin-count fdr-bin-count fdr-bin-count ifdv-bin-count ifdv-bin-count create]
no bin-group bin-group-number
Context 
[Tree] (config>oam-pm bin-group)
Full Contexts 
configure oam-pm bin-group
Description 

This command allows the operator to configure the parameters for a specific bin group. Bin-group 1 is a default bin-group and cannot be modified. If no bin group is assigned to an oam-pm session, this is assigned by default. The default values for bin-group 1 are (fd-bin-count 3 bin 1 lower-bound 5000us, bin 2 lower-bound 10000us fdr-bin-count 2 bin 1lower-bound 5000us and ifdv-bin-count 2 bin 1lower-bound 5000us)

The no form of this command disables the OAM Performance Monitoring bin group.

Parameters 
bin-group-number—
Specifies an identifier for a bin-group that is referenced by oam-pm sessions. A bin group can only shutdown and modified when all the PM Sessions referencing the bin group have been shutdown. The only exception is the description parameter.
Values—
1 to 255

 

fd-bin-count—
Specifies the number of frame delay bins that are created.
Values—
2 to 10

 

fdr-bin-count—
Specifies the number of frame delay range bins that are created.
Values—
2 to 10

 

ifdv-bin-count—
Specifies the number of inter-frame delay variation bins that are created.
Values—
2 to 10

 

create —
Keyword that creates the bin group.
Platforms 

All

bin-group

Syntax 
bin-group bin-group-number
no bin-group
Context 
[Tree] (config>oam-pm>session bin-group)
Full Contexts 
configure oam-pm session bin-group
Description 

This command links the individual test to the group of bins that map the probe responses.

The no form of this command installs the default bin-group 1 as the bin-group for the session.

Parameters 
bin-group-number—
Specifies the number that was used to create the specific bin-group that is referenced for this session.
Values—
1 to 255

 

Default—
1
Platforms 

All

6.63. bin-type

bin-type

Syntax 
bin-type {fd | fdr | ifdv}
Context 
[Tree] (config>oam-pm>bin-group bin-type)
Full Contexts 
configure oam-pm bin-group bin-type
Description 

This command is the start of the hierarchy where the specific delay metric bin structure isis defined.

Parameters 
fd—
Keyword to enter the frame delay bin threshold configuration.
fdr—
Keyword to enter the frame delay range bin threshold configuration.
ifdv—
Keyword to enter the inter-frame delay variation bin thresholds configuration.
Platforms 

All

6.64. bind-authentication

bind-authentication

Syntax 
bind-authentication root-dn [password password] [hash | hash2 | custom]
no bind-authentication
Context 
[Tree] (config>system>security>ldap>server bind-authentication)
Full Contexts 
configure system security ldap server bind-authentication
Description 

This command configures the LDAP binding used to log into LDAP server. A string of domain components (DC) and common names (CN) can be programmed to identify the user in addition to the password field. The password is hashed. For example, “cn=admin,dc=nokia,dc=com” indicates the user admin in domain nokia.com. Table 33 lists the LDAP attributes.

The no version of this command removes the bind-authentication.

Table 33:  LDAP Attributes 

Object Class

Naming Attribute Display Name

Naming Attribute LDAP Name

user

Common-Name

cn

organizationalUnit

Organizational-Unit-Name

ou

domain

Domain-Component

dc

Parameters 
root-dn—
Up to 512 characters.
password
Configures the password which enables a user to bind to the LDAP server. The maximum length is 128 characters.
hash—
Specifies that the password is entered in an encrypted form. If the hash or hash2 parameter is not used, the password is assumed to be in an unencrypted, clear text form. For security, all passwords are stored in encrypted form in the configuration file with the hash or hash2 parameter specified
hash2—
Specifies the password is entered in a more complex encrypted form that involves more variables than the password value alone, meaning that the hash2 encrypted variable cannot be copied and pasted. If the hash or hash2 parameter is not used, the password is assumed to be in an unencrypted, clear text form. For security, all passwords are stored in encrypted form in the configuration file with the hash or hash2 parameter specified.
custom—
Specifies the custom encryption to management interface.
Platforms 

All

6.65. binding

binding

Syntax 
binding
Context 
[Tree] (config>service>sdp binding)
Full Contexts 
configure service sdp binding
Description 

Commands in this context configure SDP bindings.

Platforms 

All

6.66. binding-label

binding-label

Syntax 
binding-label label-number
no binding-label
Context 
[Tree] (config>router>mpls>fwd-policies>fwd-policy binding-label)
Full Contexts 
configure router mpls forwarding-policies forwarding-policy binding-label
Description 

This command configures a binding label for the MPLS forwarding policy.

The policy associates an incoming label, referred to as a binding label, to an NHG in which the primary and backup direct or indirect next hops are defined. This type of MPLS forwarding policy is referred to as a label-binding policy.

The no form of the command removes the binding label from the MPLS forwarding policy.

Parameters 
label-number—
Specifies the label number.
Values—
32 to 1048575

 

Platforms 

All

6.67. binding-operator

binding-operator

Syntax 
binding-operator {and | or}
no binding-operator
Context 
[Tree] (config>filter>redirect-policy-binding binding-operator)
Full Contexts 
configure filter redirect-policy-binding binding-operator
Description 

This command configures the logical operator to use with the destinations test results to obtain the master test result (the redirect-policy binding test result). A change in this configuration results in the re-evaluation of the master test result.

The no version of this command sets the value to its default

Default 

binding-operator and

Parameters 
and | or—
Keyword to specify the type of logical or boolean operation to perform between the individual destinations test results to obtain the master result.
Platforms 

All

6.68. binding-sid

binding-sid

Syntax 
binding-sid number
no binding-sid
Context 
[Tree] (config>router>segment-routing>sr-policies>static-policy binding-sid)
Full Contexts 
configure router segment-routing sr-policies static-policy binding-sid
Description 

This command associates a binding SID with a statically defined segment routing policy. This is a mandatory parameter and configuration command to enable the segment routing policy; if the binding SID label value is not configured, the execution of the no shutdown command on the static segment routing policy fails.The BSID label should be an available label in the reserved-label-block range.

The no form of this command removes the BSID association.

Default 

no binding-sid

Parameters 
number—
Specifies the binding SID label value.
Values—
32 to 1048575

 

Platforms 

All

6.69. bindings

bindings

Syntax 
[no] bindings
Context 
[Tree] (debug>router>ldp>peer>event bindings)
Full Contexts 
debug router ldp peer event bindings
Description 

This command displays debugging information about addresses and label bindings learned from LDP peers for LDP bindings.

The no form of the command disables the debugging output.

Platforms 

All

6.70. bit-error-insertion

bit-error-insertion

Syntax 
bit-error-insertion rate
no bit-error-insertion
Context 
[Tree] (config>port>tdm>ds1 bit-error-insertion)
[Tree] (config>port>tdm>ds3 bit-error-insertion)
[Tree] (config>port>tdm>e1 bit-error-insertion)
[Tree] (config>port>tdm>e3 bit-error-insertion)
Full Contexts 
configure port tdm ds1 bit-error-insertion
configure port tdm ds3 bit-error-insertion
configure port tdm e1 bit-error-insertion
configure port tdm e3 bit-error-insertion
Description 

This command inserts bit errors into a running BERT test. The number of errors inserted corresponds to 10^(-rate). A rate of 0 will cause 1 error in every bit transmitted. A rate of 7 will cause an error rate of 10^(-7), or 1 error in every one billion bits transmitted.

The no command disables the insertion of bit errors into the bit error rate test stream.

Note that this command is not saved in the router configuration between boots.

Default 

no bit-error-insertion

Parameters 
rate—
Specifies the bit error rate, expressed as an integer.
Values—
2 to 7

 

Platforms 

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

6.71. bit-error-threshold

bit-error-threshold

Syntax 
bit-error-threshold bit-errors
Context 
[Tree] (config>eth-tunnel>path>eth-cfm>mep>eth-test-enable bit-error-threshold)
[Tree] (config>lag>eth-cfm>mep bit-error-threshold)
Full Contexts 
configure eth-tunnel path eth-cfm mep eth-test-enable bit-error-threshold
configure lag eth-cfm mep bit-error-threshold
Description 

This command specifies the lowest priority defect that is allowed to generate a fault alarm.

Default 

bit-error-threshold 1

Parameters 
bit-errors—
Specifies the lowest priority defect.
Values—
0 to 11840

 

Platforms 

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

bit-error-threshold

Syntax 
bit-error-threshold errors
no bit-error-threshold
Context 
[Tree] (config>service>epipe>sap>eth-cfm>mep>eth-test-enable bit-error-threshold)
[Tree] (config>service>epipe>spoke-sdp>eth-cfm>mep>eth-test-enable bit-error-threshold)
Full Contexts 
configure service epipe sap eth-cfm mep eth-test-enable bit-error-threshold
configure service epipe spoke-sdp eth-cfm mep eth-test-enable bit-error-threshold
Description 

This command is used to specify the threshold value of bit errors.

Parameters 
errors—
The threshold value of bit errors.
Values—
0 to 11840

 

Default—
1
Platforms 

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

bit-error-threshold

Syntax 
bit-error-threshold bit-errors
Context 
[Tree] (config>service>vpls>sap>eth-cfm>mep>eth-test-enable bit-error-threshold)
[Tree] (config>service>vpls>spoke-sdp>eth-cfm>mep>eth-test-enable bit-error-threshold)
[Tree] (config>service>vpls>mesh-sdp>eth-cfm>mep>eth-test-enable bit-error-threshold)
[Tree] (config>service>vpls>eth-cfm>mep>eth-test-enable bit-error-threshold)
Full Contexts 
configure service vpls eth-cfm mep eth-test-enable bit-error-threshold
configure service vpls mesh-sdp eth-cfm mep eth-test-enable bit-error-threshold
configure service vpls sap eth-cfm mep eth-test-enable bit-error-threshold
configure service vpls spoke-sdp eth-cfm mep eth-test-enable bit-error-threshold
Description 

This command specifies the lowest priority defect that is allowed to generate a fault alarm.

Default 

bit-error-threshold 1

Parameters 
bit-errors
Specifies the lowest priority defect.
Values—
0 to 11840

 

Platforms 

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

bit-error-threshold

Syntax 
bit-error-threshold bit-errors
Context 
[Tree] (config>service>ies>if>sap>eth-cfm>mep>eth-test-enable bit-error-threshold)
[Tree] (config>service>ies>if>spoke-sdp>eth-cfm>mep>eth-test-enable bit-error-threshold)
[Tree] (config>service>ies>sub-if>grp-if>sap>eth-cfm>mep>eth-test-enable bit-error-threshold)
Full Contexts 
configure service ies interface sap eth-cfm mep eth-test-enable bit-error-threshold
configure service ies interface spoke-sdp eth-cfm mep eth-test-enable bit-error-threshold
configure service ies subscriber-interface group-interface sap eth-cfm mep eth-test-enable bit-error-threshold
Description 

This command specifies the lowest priority defect that is allowed to generate a fault alarm.

Default 

bit-error-threshold 1

Parameters 
bit-errors
Specifies the lowest priority defect.
Values—
0 to 11840

 

Platforms 

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

  1. configure service ies subscriber-interface group-interface sap eth-cfm mep eth-test-enable bit-error-threshold

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

  1. configure service ies interface spoke-sdp eth-cfm mep eth-test-enable bit-error-threshold
  2. configure service ies interface sap eth-cfm mep eth-test-enable bit-error-threshold

bit-error-threshold

Syntax 
bit-error-threshold bit-errors
Context 
[Tree] (config>service>vprn>if>sap>eth-cfm>mep bit-error-threshold)
[Tree] (config>service>vprn>if>spoke-sdp>eth-cfm>mep bit-error-threshold)
[Tree] (config>service>vprn>sub-if>grp-if>sap>eth-cfm bit-error-threshold)
Full Contexts 
configure service vprn interface sap eth-cfm mep bit-error-threshold
configure service vprn interface spoke-sdp eth-cfm mep bit-error-threshold
configure service vprn subscriber-interface group-interface sap eth-cfm bit-error-threshold
Description 

This command specifies the lowest priority defect that is allowed to generate a fault alarm.

Default 

bit-error-threshold 1

Parameters 
bit-errors
Specifies the lowest priority defect.
Values—
0 to 11840

 

bit-error-threshold

Syntax 
bit-error-threshold bit-errors
Context 
[Tree] (config>router>if>eth-cfm>mep>eth-test-enable bit-error-threshold)
Full Contexts 
configure router interface eth-cfm mep eth-test-enable bit-error-threshold
Description 

This command specifies the lowest priority defect that generates a fault alarm.

Default 

bit-error-threshold 1

Parameters 
bit-errors—
Specifies the priority defect threshold.
Values—
0 to 11840

 

Platforms 

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

bit-error-threshold

Syntax 
bit-error-threshold bit-errors
Context 
[Tree] (config>eth-ring>path>eth-cfm>mep>eth-test-enable bit-error-threshold)
Full Contexts 
configure eth-ring path eth-cfm mep eth-test-enable bit-error-threshold
Description 

This command specifies the lowest priority defect that is allowed to generate a fault alarm.

Default 

bit-error-threshold 1

Parameters 
bit-errors—
Specifies the lowest priority defect.
Values—
0 to 11840

 

Platforms 

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

6.72. bit-rate-high-wmark

bit-rate-high-wmark

Syntax 
bit-rate-high-wmark high-watermark
Context 
[Tree] (config>application-assurance bit-rate-high-wmark)
Full Contexts 
configure application-assurance bit-rate-high-wmark
Description 

This command configures the high watermark for bit rate alarms.

Default 

bit-rate-high-wmark max

Parameters 
high-watermark—
Specifies the high watermark for bit rate alarms, in Mb/s. The value must be larger than or equal to the low watermark value.
Values—
1 to 40000, max (disabled)

 

Platforms 

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

6.73. bit-rate-low-wmark

bit-rate-low-wmark

Syntax 
bit-rate-low-wmark low-watermark
no bit-rate-low-wmark
Context 
[Tree] (config>application-assurance bit-rate-low-wmark)
Full Contexts 
configure application-assurance bit-rate-low-wmark
Description 

This command configures the utilization of the flow records on the ISA-AA Group when the full alarm will be cleared by the agent.

Default 

bit-rate-low-wmark 0

Parameters 
low-watermark—
Specifies the low watermark for bit rate alarms, in Mb/s. The value must be lower than or equal to the high watermark value.
Values—
0 to 39999

 

Platforms 

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

6.74. bits

bits

Syntax 
bits
Context 
[Tree] (config>system>sync-if-timing bits)
Full Contexts 
configure system sync-if-timing bits
Description 

Commands in this context configure parameters for the Building Integrated Timing Supply (BITS). The settings specified under this context apply to both the BITS input and BITS output ports.

The bits command subtree is only available on the 7450 ESS-7, 7450 ESS-12, 7750 SR-7, 7750 SR-12, 7750 SR-12e, 7950 XRS-20, 7950 XRS-40, 7750 SR-a4, 7750 SR-a8, 7750 SR-1e, 7750 SR-2e, and 7750 SR-3e.

Platforms 

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

6.75. bits-interface-type

bits-interface-type

Syntax 
bits-interface-type {ds1 [{esf | sf}] | e1 [{pcm30crc | pcm31crc}
no bits-interface-type
Context 
[Tree] (config>system>sync-if-timing>ref1 bits-interface-type)
[Tree] (config>system>sync-if-timing>ref2 bits-interface-type)
Full Contexts 
configure system sync-if-timing ref1 bits-interface-type
configure system sync-if-timing ref2 bits-interface-type
Description 

This command configures the interface type of the BITS timing reference.

The no form of the command reverts to the default configuration

Parameters 
ds1 esf —
Specifies Extended Super Frame (ESF). This is a framing type used on DS1 circuits that consists of 24 192-bit frames, The 193rd bit provides timing and other functions.
ds1 sf—
Specifies Super Frame (SF), also called D4 framing. This is a common framing type used on DS1 circuits. SF consists of 12 192-bit frames. The 193rd bit provides error checking and other functions. ESF supersedes SF.
e1 pcm30crc—
Specifies the pulse code modulation (PCM) type. PCM30CRC uses PCM to separate the signal into 30 user channels with CRC protection.
e1 pcm31crc—
Specifies the pulse code modulation (PCM) type. PCM31CRC uses PCM to separate the signal into 31 user channels with CRC protection.

6.76. black-hole

black-hole

Syntax 
[no] black-hole
Context 
[Tree] (config>service>vprn>static-route-entry black-hole)
Full Contexts 
configure service vprn static-route-entry black-hole
Description 

This command specifies that the route is a black hole route. If the destination address on a packet matches this static route, it will be silently discarded.

Default 

no black-hole

Platforms 

All

black-hole

Syntax 
[no] black-hole
Context 
[Tree] (config>router>static-route-entry black-hole)
Full Contexts 
configure router static-route-entry black-hole
Description 

This command specifies that the route is a black hole route. If the destination address on a packet matches this static route, it will be silently discarded.

Default 

no black-hole

Platforms 

All

6.77. black-hole-dup-mac

black-hole-dup-mac

Syntax 
[no] black-hole-dup-mac
Context 
[Tree] (config>service>vpls>bgp-evpn>mac-duplication black-hole-dup-mac)
Full Contexts 
configure service vpls bgp-evpn mac-duplication black-hole-dup-mac
Description 

The black-hole-dup-mac command is disabled by default. If enabled, a duplicated MAC detected in the network is programmed as a black-hole MAC in the FDB and displayed in the show service id fdb detail command as follows:

  1. Source-Identifier—black-hole
  2. Type—EvpnD:P

Because the MAC is now programmed in the FDB as a black-hole, all received frames with MAC DA matching the duplicate MAC are discarded. The duplicate black-hole MACs are installed as Protected, therefore, all received frames with MAC SA matching the duplicate MAC are discarded by default.

A BGP-EVPN (MPLS or VXLAN) shutdown is required to add or remove the black-hole-dup-mac command.

The no form of the command removes the feature, and duplicate MACs are no longer programmed as black-hole MACs.

Default 

no black-hole-dup-mac

Platforms 

All

6.78. blackhole-aggregate

blackhole-aggregate

Syntax 
[no] blackhole-aggregate
Context 
[Tree] (config>service>vprn>ospf>area blackhole-aggregate)
[Tree] (config>service>vprn>ospf3>area blackhole-aggregate)
Full Contexts 
configure service vprn ospf area blackhole-aggregate
configure service vprn ospf3 area blackhole-aggregate
Description 

This command installs a low priority blackhole route for the entire aggregate. Existing routes that make up the aggregate have a higher priority and only the components of the range for which no route exists are blackholed.

It is possible that when performing area aggregation, addresses may be included in the range for which no actual route exists. This can cause routing loops. To avoid this problem, configure the blackhole-aggregate command.

The no form of this command removes this configuration.

Default 

blackhole-aggregate

Platforms 

All

blackhole-aggregate

Syntax 
[no] blackhole-aggregate
Context 
[Tree] (config>router>ospf>area blackhole-aggregate)
[Tree] (config>router>ospf3>area blackhole-aggregate)
Full Contexts 
configure router ospf area blackhole-aggregate
configure router ospf3 area blackhole-aggregate
Description 

This command installs a low priority blackhole route for the entire aggregate. Existing routes that make up the aggregate will have a higher priority and only the components of the range for which no route exists are blackholed.

When performing area aggregation, addresses may be included in the range for which no actual route exists, which can cause routing loops. To avoid this problem, configure the blackhole-aggregate option.

The no form of this command removes this option.

Default 

blackhole-aggregate

Platforms 

All

6.79. block-length

block-length

Syntax 
block-length block-length
no block-length
Context 
[Tree] (config>router>segment-routing>srv6>locator block-length)
Full Contexts 
configure router segment-routing segment-routing-v6 locator block-length
Description 

This command configures the length of the block field of a SRv6 locator.

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

Default 

block-length 0

Parameters 
block-length—
Specifies the block length, in bits, for the SRv6 locator. This value must be less than the locator prefix length and is enforced by CLI validation.
Values—
0 to 96

 

Platforms 

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

6.80. block-limit

block-limit

Syntax 
block-limit [1..40]
no block-limit
Context 
[Tree] (config>service>nat>nat-policy block-limit)
Full Contexts 
configure service nat nat-policy block-limit
Description 

This command configures the maximum number of port blocks per subscriber.

The no form of the command reverts to the default.

Default 

block-limit 1

Parameters 
1..40—
Specifies the maximum number of port-blocks per NAT subscriber.
Platforms 

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

6.81. block-on-mesh-failure

block-on-mesh-failure

Syntax 
[no] block-on-mesh-failure
Context 
[Tree] (config>service>vpls>endpoint block-on-mesh-failure)
[Tree] (config>service>vpls>spoke-sdp block-on-mesh-failure)
Full Contexts 
configure service vpls endpoint block-on-mesh-failure
configure service vpls spoke-sdp block-on-mesh-failure
Description 

This command enables blocking (brings the entity to an operationally down state) after all configured SDPs or endpoints are in operationally down state. This event is signaled to corresponding T-LDP peer by withdrawing service label (status-bit-signaling non-capable peer) or by setting “PW not forwarding” status bit in T-LDP message (status-bit-signaling capable peer).

The no form of this command reverts to the default.

Default 

no block-on-mesh-failure

Platforms 

All

6.82. block-on-peer-fault

block-on-peer-fault

Syntax 
[no] block-on-peer-fault
Context 
[Tree] (config>service>epipe>spoke-sdp block-on-peer-fault)
Full Contexts 
configure service epipe spoke-sdp block-on-peer-fault
Description 

When enabled, this command blocks the transmit direction of a PW when any of the following PW status codes is received from the far end PE:

0x00000001

Pseudowire Not Forwarding

0x00000002

Local Attachment Circuit (ingress) Receive Fault

0x00000004

Local Attachment Circuit (egress) Transmit Fault

0x00000008

Local PSN-facing PW (ingress) Receive Fault

0x00000010

Local PSN-facing PW (egress) Transmit Fault

The transmit direction is unblocked when the following PW status code is received:

0x00000000

Pseudowire forwarding (clear all failures)

This command is mutually exclusive with no pw-status-signaling, and standby-signaling-slave. It is not applicable to spoke SDPs forming part of an MC-LAG or spoke SDPs in an endpoint.

Default 

no block-on-peer-fault

Platforms 

All

block-on-peer-fault

Syntax 
[no] block-on-peer-fault
Context 
[Tree] (config>service>pw-template block-on-peer-fault)
Full Contexts 
configure service pw-template block-on-peer-fault
Description 

When enabled, this command blocks the transmit direction of a pseudowire when any of the following pseudowire status codes is received from the far end PE:

0x00000001

Pseudowire Not Forwarding

0x00000002

Local Attachment Circuit (ingress) Receive Fault

0x00000004

Local Attachment Circuit (egress) Transmit Fault

0x00000008

Local PSN-facing PW (ingress) Receive Fault

0x00000010

Local PSN-facing PW (egress) Transmit Fault

The transmit direction is unblocked when the following pseudowire status code is received:

0x00000000

Pseudowire forwarding (clear all failures)

This command is mutually exclusive with no pw-status-signaling, and standby-signaling-slave. It is not applicable to spoke SDPs forming part of an MC-LAG or spoke SDPs in an endpoint.

Default 

no block-on-peer-fault

Platforms 

All

6.83. block-prefix-sid

block-prefix-sid

Syntax 
[no] block-prefix-sid
Context 
[Tree] (config>router>bgp block-prefix-sid)
[Tree] (config>router>bgp>group block-prefix-sid)
[Tree] (config>router>bgp>group>neighbor block-prefix-sid)
Full Contexts 
configure router bgp block-prefix-sid
configure router bgp group block-prefix-sid
configure router bgp group neighbor block-prefix-sid
Description 

This command specifies whether all prefix SID attributes are removed from label IPv4 and label IPv6 routes when they are exchanges with EBGP and IBGP peers covered by the scope of the command. Even locally-imposed prefix SID attributes are removed.

A change of this configuration causes the affected BGP sessions to flap.

The no form of this command allows prefix SID attributes associated with label IPv4 and label IPv6 routes to be propagated without restriction.

Default 

no block-prefix-sid

Platforms 

All

6.84. bluetooth

bluetooth

Syntax 
bluetooth
Context 
[Tree] (config>system bluetooth)
Full Contexts 
configure system bluetooth
Description 

Commands in this context configure Bluetooth console attributes.

Platforms 

7750 SR-1, 7750 SR-s

6.85. bmp

bmp

Syntax 
bmp
Context 
[Tree] (config bmp)
Full Contexts 
configure bmp
Description 

Commands in this context configure BGP Monitoring Protocol (BMP) parameters.

Platforms 

All

bmp

Syntax 
bmp
Context 
[Tree] (debug>router bmp)
Full Contexts 
debug router bmp
Description 

Commands in this context debug BMP information.

Platforms 

All

6.86. bof

bof

Syntax 
bof
Context 
[Tree] (bof)
Full Contexts 
bof
Description 

This command creates or edits the boot option file (BOF) for the specified local storage device.

A BOF file specifies where the system searches for runtime images, configuration files, and other operational parameters during system initialization.

BOF parameters can be modified. Changes can be saved to a specified compact flash. The BOF must be located in the root directory of either an internal or external compact flash local to the system and have the mandatory filename of bof.cfg.

When modifications are made to in-memory parameters that are currently in use or operating, the changes are effective immediately. For example, if the IP address of the management port is changed, the change takes place immediately.

Only one entry of the BOF configuration command statement can be saved once the statement has been found to be syntactically correct.

When opening an existing BOF that is not the BOF used in the most recent boot, a message is issued notifying the user that the parameters will not affect the operation of the node.

No default boot option file exists. The router boots with the factory default boot sequence and options.

Platforms 

All

6.87. bonding-active-connections

bonding-active-connections

Syntax 
[no] bonding-active-connections
Context 
[Tree] (config>subscr-mgmt>acct-plcy>include-radius-attribute bonding-active-connections)
Full Contexts 
configure subscriber-mgmt radius-accounting-policy include-radius-attribute bonding-active-connections
Description 

This command triggers the inclusion of the Alc-Bonding-Active-Connection VSA in accounting for bonding subscribers.

The no form of this command disables the inclusion of the attribute.

Platforms 

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

6.88. bonding-id

bonding-id

Syntax 
[no] bonding-id
Context 
[Tree] (config>subscr-mgmt>acct-plcy>include-radius-attribute bonding-id)
Full Contexts 
configure subscriber-mgmt radius-accounting-policy include-radius-attribute bonding-id
Description 

This command triggers the inclusion of the Alc-Bonding-Id VSA in accounting for bonding subscribers.

The no form of this command disables the inclusion of the attribute.

Platforms 

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

6.89. bonding-parameters

bonding-parameters

Syntax 
bonding-parameters
Context 
[Tree] (config>service>vprn>sub-if>grp-if bonding-parameters)
[Tree] (config>service>ies>sub-if>grp-if bonding-parameters)
Full Contexts 
configure service ies subscriber-interface group-interface bonding-parameters
configure service vprn subscriber-interface group-interface bonding-parameters
Description 

Commands in this context configure ESM connection bonding parameters. The configuration of parameters under this context is only allowed when the group interface is created with the bonding parameter specified.

6.90. bonding-selection

bonding-selection

Syntax 
bonding-selection
Context 
[Tree] (config>subscr-mgmt>sla-profile>egress bonding-selection)
Full Contexts 
configure subscriber-mgmt sla-profile egress bonding-selection
Description 

Commands in this context configure parameters belonging to this node for link selection behavior in a bonding context. These parameters are ignored outside of bonding subscribers.

Platforms 

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

6.91. booking-factor

booking-factor

Syntax 
booking-factor factor
no booking-factor
Context 
[Tree] (config>lag>access booking-factor)
[Tree] (config>port>ethernet>access booking-factor)
Full Contexts 
configure lag access booking-factor
configure port ethernet access booking-factor
Description 

This command specifies the booking factor applied against the port or LAG administrator bandwidth by SAP administrator bandwidth CAC.

The service manager keeps track of the available administrator bandwidth for each port or LAG configured with an administrator bandwidth. The port or LAG available administrator bandwidth is adjusted by the user configured booking factor, allowing the port or LAG bandwidth to be overbooked or under booked.

If the booking factor is increased then available administrator bandwidth on the port or LAG increases. If the booking factor is decreased then available administrator bandwidth on the port or LAG decreases. However, if the reduction of available administrator bandwidth is insufficient to cover the sum of the current SAP administrator bandwidth on the port or LAG, the command fails.

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

Default 

booking-factor 100

Parameters 
factor—
Specifies the percentage of the port or LAG admin bandwidth for SAP bandwidth CAC.
Values—
1 to 1000

 

Platforms 

All

booking-factor

Syntax 
booking-factor percentage
no booking-factor
Context 
[Tree] (config>service>sdp booking-factor)
Full Contexts 
configure service sdp booking-factor
Description 

This command specifies the booking factor applied against the maximum SDP available bandwidth by the VLL CAC feature.

The service manager keeps track of the available bandwidth for each SDP. The maximum value is the sum of the bandwidths of all constituent LSPs in the SDP. The SDP available bandwidth is adjusted by the user configured booking factor. A value of 0 means no VLL can be admitted into the SDP.

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

Default 

no booking-factor

Parameters 
percentage—
Specifies the percentage of the SDP maximum available bandwidth for VLL call admission. When the value of this parameter is set to zero (0), no new VLL spoke SDP bindings with non-zero bandwidth are permitted with this SDP. Overbooking, >100% is allowed.
Values—
0 to 1000%

 

Default—
100
Platforms 

All

6.92. boot-bad-exec

boot-bad-exec

Syntax 
boot-bad-exec file-url
no boot-bad-exec
Context 
[Tree] (config>system boot-bad-exec)
Full Contexts 
configure system boot-bad-exec
Description 

Use this command to configure a URL for a CLI script to exec following a failure of a bootup configuration. The command specifies a URL for the CLI scripts to be run following the completion of the bootup configuration. A URL must be specified or no action is taken.

The commands are persistent between router (re)boots and are included in the configuration saves (admin>save).

Related Commands

exec — This command executes the contents of a text file as if they were CLI commands entered at the console.

Default 

no boot-bad-exec

Parameters 
file-url—
Specifies the location and name of the CLI script file executed following failure of the bootup configuration file execution. When this parameter is not specified, no CLI script file is executed.

Ipv6-address only applies to the 7750 SR and 7950 XRS.

Values—

file url

local-url | remote-url

255 chars max

local-url

[cflash-id/][file-path]

remote-url

[{ftp://} login:pswd@remote-locn/][file-path]

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:

 

Platforms 

All

6.93. boot-good-exec

boot-good-exec

Syntax 
boot-good-exec file-url
no boot-good-exec
Context 
[Tree] (config>system boot-good-exec)
Full Contexts 
configure system boot-good-exec
Description 

Use this command to configure a URL for a CLI script to exec following the success of a bootup configuration.

Related Commands

exec - This command executes the contents of a text file as if they were CLI commands entered at the console.

Default 

no boot-good-exec

Parameters 
file-url—
Specifies the location and name of the file executed following successful completion of the bootup configuration file execution. When this parameter is not specified, no CLI script file is executed.

Ipv6-address only applies to the 7750 SR and 7950 XRS and ipv4-address applies to the 7450 ESS.

Values—

file url

local-url | remote-url

255 chars max

local-url

[cflash-id/][file-path]

remote-url

[{ftp://} login:pswd@remote-locn/][file-path]

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:

 

Platforms 

All

6.94. boot-timer

boot-timer

Syntax 
boot-timer interval
no boot-timer
Context 
[Tree] (config>redundancy>multi-chassis>peer>mc-ep boot-timer)
Full Contexts 
configure redundancy multi-chassis peer mc-endpoint boot-timer
Description 

This command configures the boot timer interval. This command applies only when the node reboots. It specifies the time the MC-EP protocol keeps trying to establish a connection before assuming a failure of the remote peer. This is different from the keep-alive mechanism which is used just after the peer-peer communication was established. After this time interval passed all the mc-endpoints configured under services will revert to single chassis behavior, activating the best local PW.

The no form of this command sets the interval to default.

Default 

no boot-timer

Parameters 
interval—
Specifies the boot timer interval.
Values—
1 to 600

 

Platforms 

All

boot-timer

Syntax 
boot-timer seconds
Context 
[Tree] (config>redundancy>bgp-evpn-multi-homing boot-timer)
Full Contexts 
configure redundancy bgp-evpn-multi-homing boot-timer
Description 

This command allows the necessary time for the control plane protocols to come up upon PE boot-up before bringing up the ESs and running the DF algorithm.

The following considerations apply to this command:

  1. The boot-timer command must provide enough time to allow the IOMs and BGP sessions to come up before exchanging ES routes and running the DF election for each EVI or ISID.
  2. The boot-timer is synchronized across CPMs and is relative to the system up time; it is not changed or reset upon CPM switchover.
  3. The boot-timer is never interrupted (the es-activation-timer, however, can be interrupted if there is a new event triggering the DF election).
  4. The boot-timer runs per EVI or ISID on the ESs in the system. If the system up time (time the system has been up since the last reboot) is less than the boot-timer value, the system does not run the DF election for any EVI or ISID. When the boot-timer value expires, the DF election runs, and if the system is elected DF for the EVI or ISID, the es-activation-timer is triggered.
  5. The system does not advertise ES routes until the boot timer expires, which guarantees that the peer ES PEs only run the DF election when the PE is ready to become the DF, if required.
Default 

boot-timer 10

Parameters 
seconds—
Specifies the number of seconds for the boot-timer.
Values—
0 to 1800

 

Platforms 

All

boot-timer

Syntax 
boot-timer seconds
no boot-timer
Context 
[Tree] (config>service>vpls>site boot-timer)
Full Contexts 
configure service vpls site boot-timer
Description 

This command configures for how long the service manager waits after a node reboot before running the DF election algorithm. The boot-timer value should be configured to allow for the BGP sessions to come up and for the NLRI information to be refreshed/exchanged.

The no form of this command reverts the default.

Default 

boot-timer 10

Parameters 
seconds—
Specifies the site boot-timer in seconds.
Values—
0 to 100

 

Platforms 

All

boot-timer

Syntax 
boot-timer seconds
no boot-timer
Context 
[Tree] (config>service>epipe>site boot-timer)
Full Contexts 
configure service epipe site boot-timer
Description 

This command configures for how long the service manager waits after a node reboot before running the DF election algorithm. The boot-timer value should be configured to allow for the BGP sessions to come up and for the NLRI information to be refreshed/exchanged.

The no form of this command reverts the default.

Default 

boot-timer 10

Parameters 
seconds —
Specifies the site boot-timer in seconds.
Values—
0 to 600

 

Platforms 

All

boot-timer

Syntax 
boot-timer secs
no boot-timer
Context 
[Tree] (config>service>pw-routing boot-timer)
Full Contexts 
configure service pw-routing boot-timer
Description 

This command configures a hold-off timer for MS-PW routing advertisements and signaling and is used at boot time.

The no form of this command removes a previously configured timer and restores it to its default.

Default 

no boot-timer

Parameters 
timer-value —
Specifies the value of the boot timer in seconds.
Values—
0 to 600

 

Platforms 

All

boot-timer

Syntax 
boot-timer seconds
no boot-timer
Context 
[Tree] (config>redundancy>bgp-multi-homing boot-timer)
Full Contexts 
configure redundancy bgp-multi-homing boot-timer
Description 

This command configures the time the service manager waits after a node reboot before running the DF election algorithm. The boot-timer value should be configured to allow for the BGP sessions to come up and for the NLRI information to be refreshed or exchanged.

The no form of the command reverts the default.

Default 

no boot-timer

Parameters 
seconds—
Specifies the BGP multi-homing boot-timer in seconds.
Values—
0 to 600

 

Platforms 

All

6.95. bootstrap-export

bootstrap-export

Syntax 
bootstrap-export policy-name [policy-name]
no bootstrap-export
Context 
[Tree] (config>service>vprn>pim>rp bootstrap-export)
Full Contexts 
configure service vprn pim rp bootstrap-export
Description 

This command exports policies to control the flow of bootstrap messages from the RP. Up to five policies can be defined.

The no form of this command removes the specified policy names from the configuration.

Parameters 
policy-name—
Specifies up to five policy names. The policy statement must already be configured in the config>router>policy-options context.
Platforms 

All

bootstrap-export

Syntax 
bootstrap-export policy-name [policy-name]
no bootstrap-export
Context 
[Tree] (config>router>pim>rp bootstrap-export)
Full Contexts 
configure router pim rp bootstrap-export
Description 

This command applies export policies to control the flow of bootstrap messages from the RP, and apply them to the PIM configuration.

The no form of this command removes the policy name from the PIM RP configuration.

Default 

no bootstrap-export

Parameters 
policy-name—
Specifies up to five export policy names, up to 32 characters.
Platforms 

All

6.96. bootstrap-import

bootstrap-import

Syntax 
bootstrap-import policy-name [policy-name... up to five]
no bootstrap-import policy-name [policy-name... up to five]
Context 
[Tree] (config>service>vprn>pim>rp bootstrap-import)
Full Contexts 
configure service vprn pim rp bootstrap-import
Description 

This command imports policies to control the flow of bootstrap messages into the RP. Up to five policies can be defined.

The no form of this command removes the specified policy names from the configuration.

Parameters 
policy-name—
Specifies the policy name. The policy statement must already be configured in the config>router>policy-options context.
Platforms 

All

bootstrap-import

Syntax 
bootstrap-import policy-name [policy-name]
no bootstrap-import
Context 
[Tree] (config>router>pim>rp bootstrap-import)
Full Contexts 
configure router pim rp bootstrap-import
Description 

This command applies import policies to control the flow of bootstrap messages to the RP, and apply them to the PIM configuration.

The no form of this command removes the policy name from the

Default 

no bootstrap-import

Parameters 
policy-name—
Specifies up to five import policy names, up to 32 characters.
Platforms 

All

6.97. boundary-type

boundary-type

Syntax 
boundary-type {clock-aligned | test-relative}
no boundary-type
Context 
[Tree] (config>oam-pm>session>meas-interval boundary-type)
Full Contexts 
configure oam-pm session meas-interval boundary-type
Description 

This command establishes the alignment of the start of the measurement interval with either the time of day clock or the start of the test. Alignment with the time of day clock always defaults to the representative top of the hour. Clock-aligned 15-minute measurement intervals divide the hour into four equal sections 00, 15, 30, 45. Clock-aligned 1-hour measurement intervals start at 00. Clock-aligned 1-day measurement intervals start at midnight. Test relative start times launches the measurement interval when the individual test enters the active (no shutdown) state. It is typical for the first measurement interval of a clock-aligned test to have the suspect flag set to yes because it is unlikely the no shutdown exactly corresponds to the clock based measurement interval start time. Clock-aligned measurement intervals can include an additional offset.

The no form of this command sets the boundary to the default clock-aligned.

Default 

boundary-type clock-aligned

Parameters 
clock-aligned—
Aligns the start of the measurement interval with the time of day clock.
test-relative—
Aligns the start of the measurement interval with the start of the test.
Platforms 

All

6.98. bpdu

bpdu

Syntax 
[no] bpdu
Context 
[Tree] (debug>service>id>stp bpdu)
Full Contexts 
debug service id stp bpdu
Description 

This command enables STP debugging for received and transmitted BPDUs.

Platforms 

All

bpdu

Syntax 
[no] bpdu
Context 
[Tree] (debug>service>id>stp bpdu)
Full Contexts 
debug service id stp bpdu
Description 

This command enables STP debugging for received and transmitted BPDUs.

The no form of the command disables debugging.

Platforms 

All

6.99. bpdu-translation

bpdu-translation

Syntax 
bpdu-translation {auto | auto-rw | pvst | pvst-rw | stp}
no bpdu-translation
Context 
[Tree] (config>service>vpls>spoke-sdp bpdu-translation)
[Tree] (config>service>vpls>sap bpdu-translation)
Full Contexts 
configure service vpls sap bpdu-translation
configure service vpls spoke-sdp bpdu-translation
Description 

This command enables the translation of BPDUs to a specified format, meaning that all BPDUs transmitted on a specified SAP or spoke-SDP will have a specified format.

The no form of this command reverts to the default.

Default 

no bpdu-translation

Parameters 
auto—
Specifies that appropriate format will be detected automatically, based on type of BPDUs received on such port.
auto-rw—
Specifies that appropriate format will be detected automatically and the VLAN ID will be rewritten as follows:
  1. BPDU sent on egress of dot1q SAP will contain the VLAN ID of the SAP in BPDU-PVID TLV
  2. BPDU sent on egress of default QinQ SAP will contain the outer VLAN ID of the SAP in BPDU-PVID TLV
  3. BPDU sent on egress of QinQ SAP will contain the inner VLAN ID of the SAP in BPDU-PVID TLV
pvst—
Specifies the BPDU-format as PVST. Note: the correct VLAN tag is included in the payload (depending on encapsulation value of outgoing SAP).
pvst-rw—
Specifies the BPDU-format as PVST. The VLAN ID will be rewritten as follows:
  1. BPDU sent on egress of dot1q SAP will contain the VLAN ID of the SAP in BPDU-PVID TLV
  2. BPDU sent on egress of default QinQ SAP will contain the outer VLAN ID of the SAP in BPDU-PVID TLV
  3. BPDU sent on egress of QinQ SAP will contain the inner VLAN ID of the SAP in BPDU-PVID TLV
stp—
Specifies the BPDU-format as STP.
Platforms 

All

6.100. breakout

breakout

Syntax 
breakout breakout
no breakout
Context 
[Tree] (config>port>connector breakout)
Full Contexts 
configure port connector breakout
Description 

This command configures the transceiver port breakout for use in the connector. Specifying the breakout type triggers the creation of accessible ports for the connector.

When a QSFP28 connector uses an SFP+ optical module with the QSFP28-to-SFP+/SFP28 adapter, the user should set the breakout parameter to c1-10g, which indicates the presence of this adapter.

The options for breakout on specific connectors depend on both the card type and level (or XMA type and level). See the applicable installation guides for details.

The no form of this command removes the ports under the connector.

Default 

no breakout

Parameters 
breakout—
Specifies the breakout type.
Values—
c1-100g, c1-10g, c1-25g, c1-400g, c1-40g, c10-10g, c2-100g, c4-100g, c4-10g, c4-25g

 

Platforms 

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

6.101. brg

brg

Syntax 
brg
Context 
[Tree] (config>subscr-mgmt>vrgw brg)
Full Contexts 
configure subscriber-mgmt vrgw brg
Description 

Commands in this context configure Bridged Residential Gateway parameters.

Platforms 

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

brg

Syntax 
brg
Context 
[Tree] (config>service>ies>sub-if>grp-if>wlan-gw>ranges>range>vrgw brg)
[Tree] (config>service>vprn>sub-if>grp-if>wlan-gw>ranges>range>vrgw brg)
[Tree] (config>service>ies>sub-if>grp-if>wlan-gw>ranges>range brg)
[Tree] (config>service>vprn>sub-if>grp-if>wlan-gw>ranges>range brg)
[Tree] (config>service>ies>sub-if>grp-if brg)
[Tree] (config>service>vprn>sub-if>grp-if brg)
Full Contexts 
configure service ies subscriber-interface group-interface brg
configure service ies subscriber-interface group-interface wlan-gw ranges range brg
configure service ies subscriber-interface group-interface wlan-gw vlan-tag-ranges range vrgw brg
configure service vprn subscriber-interface group-interface brg
configure service vprn subscriber-interface group-interface wlan-gw ranges range brg
configure service vprn subscriber-interface group-interface wlan-gw vlan-tag-ranges range vrgw brg
Description 

Commands in this context configure BRG parameters. In the config>service>ies>sub-if>grp-if and config>service>vprn>sub-if>grp-if contexts, these commands are only available in the vlan-tag-ranges level.

Platforms 

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

  1. configure service ies subscriber-interface group-interface brg
  2. configure service vprn subscriber-interface group-interface brg

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

  1. configure service vprn subscriber-interface group-interface wlan-gw vlan-tag-ranges range vrgw brg
  2. configure service ies subscriber-interface group-interface wlan-gw vlan-tag-ranges range vrgw brg

6.102. brg-id

brg-id

Syntax 
[no] brg-id brg-ident
Context 
[Tree] (debug>subscr-mgmt>vrgw>brg>pppoe-client brg-id)
Full Contexts 
debug subscriber-mgmt vrgw brg pppoe-client brg-id
Description 

This command enables debugging of PPPoE client messages linked to a BRG.

Parameters 
brg-ident—
The string identifying the BRG.
Platforms 

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

6.103. brg-num-active-sessions

brg-num-active-sessions

Syntax 
[no] brg-num-active-sessions
Context 
[Tree] (config>subscr-mgmt>acct-plcy>include brg-num-active-sessions)
Full Contexts 
configure subscriber-mgmt radius-accounting-policy include-radius-attribute brg-num-active-sessions
Description 

This command indicates the number of IPoE sessions that are currently active on the BRG to which this accounting message relates. The no form of this command removes the attribute from inclusion.

Platforms 

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

6.104. brg-profile

brg-profile

Syntax 
brg-profile profile-name [create]
no brg-profile profile-name
Context 
[Tree] (config>subscr-mgmt>vrgw>brg brg-profile)
Full Contexts 
configure subscriber-mgmt vrgw brg brg-profile
Description 

This command creates the profile for Bridged Residential Gateway (BRG) devices. The BRG profile specifies default parameters that are used for host management under a single BRG.

The no form of this command removes the profile name from the configuration.

Parameters 
profile-name—
Specifies the name of the BRG profile.
create—
Keyword used to create a BRG profile. The create keyword requirement can be enabled/disabled in the environment>create context.
Platforms 

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

6.105. bridge-identifier

bridge-identifier

Syntax 
bridge-identifier bridge-id vlan vlan-id
Context 
[Tree] (config>eth-cfm>default-domain bridge-identifier)
Full Contexts 
configure eth-cfm default-domain bridge-identifier
Description 

This command configures the cross-reference required to link the CFM function with the service context. The link is created when the bridge-id, service-id, and vlan-id (for a primary VLAN) match.

This command allows the entry of MIP-specific parameters for the index (bridge-identifier and vlan) in the default-domain table.

This command is only supported in 'classic' configuration-mode (configure system management-interface configuration-mode classic).

Parameters 
bridge-id—
Specifies the ID for a link to a specific service. Note that there is no verification that a service has been created with a matching service ID.
Values—
1 to 2147483647

 

vlan-id—
Specifies the VLAN ID for the default-domain index. The complete index allows the user to reference specific MIP entries in the default-domain table. The vlan-id value must match the configured primary-vlan-enable vlan-id corresponding to the bridge-identifier. If the MIP does not have primary-vlan-enable configured, the vlan-id must be configured as “none”. When the vlan-id is configured as none, the MIP relies on the service delineation for extraction and installs no additional VLAN in that portion of the index.
Values—
1 to 4094 | none

 

Platforms 

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

bridge-identifier

Syntax 
[no] bridge-identifier [bridge-id | bridge-name bridge-name]
Context 
[Tree] (config>eth-cfm>domain>assoc bridge-identifier)
Full Contexts 
configure eth-cfm domain association bridge-identifier
Description 

This command configures the cross-reference required to link the CFM function with the service context. The link is created when the bridge-id, or bridge-name matches the service-id, or service-name, respectively.

The no form of this command removes the bridge identifier and the link between the ETH-CFM configuration and the matching service.

There is no verification that any service has been created with a matching value. An existing bridge-identifier configuration can be overwritten with the alternate type, as long as the new reference does not change the existing service linkage.

Parameters 
bridge-id—
Specifies the ID to link to a specific service. Note that there is no verification that a service has been created with a matching service-id.

This bridge-id variant of the command is only supported in classic configuration mode (configure system management-interface configuration-mode classic). The bridge-identifier bridge-name bridge-name variant can be used in all configuration modes. All references to bridge-identifier bridge-id must be changed to the bridge-identifier bridge-name bridge-name option as a prerequisite to model-driven mode.

Values—
1 to 2147483647

 

bridge-name bridge-name
Specifies a link to a service with a matching service-name, up to 64 characters.
Platforms 

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

6.106. bridge-priority

bridge-priority

Syntax 
bridge-priority bridge-priority
no bridge-priority
Context 
[Tree] (config>service>vpls>spb>level bridge-priority)
Full Contexts 
configure service vpls spb level bridge-priority
Description 

This command configures the four bit bridge priority for Shortest Path Bridging. This value is added to the 6 byte bridge Identifier (which is the system-id) in the top four bits of a two byte field. Note the actual value will be bit shifted 12 bits left effective putting this in the high bits of the 16 bits added to system ID.

The bridge priority is important in choosing the Root Bridge for the single tree algorithm (lowest value = best). Bridge priority also factors into the tie breaker for SPF algorithms as described in the SPB standard. The bridge-identifier (system-id) of the control B-VPLS determines the tiebreaker when the bridge-priorities are equal.

Default 

bridge-priority 8

Parameters 
bridge-priority—
The bridge-priority value.
Values—
0 to 15

 

Platforms 

All

6.107. broadcast

broadcast

Syntax 
broadcast {interface ip-int-name} [key-id key-id] [version version] [ttl ttl]
no broadcast {interface ip-int-name}
Context 
[Tree] (config>service>vprn>ntp broadcast)
Full Contexts 
configure service vprn ntp broadcast
Description 

This command configures the node to transmit NTP packets on a given interface. Broadcast and multicast messages can easily be spoofed, thus, authentication is strongly recommended.

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

Parameters 
ip-int-name—
Specifies the local interface on which to transmit NTP broadcast packets. If the string contains special characters (#, $, spaces, and so on), the entire string must be enclosed between double quotes.
Values—
32 character maximum

 

key-id key-id
Identifies the configured authentication key and authentication type used by this node to receive and transmit NTP packets to and from an NTP server and peers. If an NTP packet is received by this node both authentication key and authentication type must be valid otherwise the packet will be rejected and an event/trap generated.
Values—
1 to 255

 

version version
Specifies the NTP version number that is generated by this node. This parameter does not need to be configured when in client mode in which case all versions will be accepted.
Values—
2 to 4

 

Default—
4
ttl ttl
Specifies the IP Time To Live (TTL) value.
Values—
1 to 255

 

Platforms 

All

broadcast

Syntax 
broadcast [router router-name] {interface ip-int-name} [key-id key-id] [version version] [ttl ttl]
no broadcast [router router-name] {interface ip-int-name}
Context 
[Tree] (config>system>time>ntp broadcast)
Full Contexts 
configure system time ntp broadcast
Description 

This command configures the node to transmit NTP packets on a given interface. Broadcast and multicast messages can easily be spoofed, thus, authentication is strongly recommended.

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

Parameters 
router-name—
Specifies the router name used to transmit NTP packets. Base is the default. Select management to use the management port (Ethernet port on the CPM). Note that broadcast server capability can also be enabled on an interface within a VPRN context. Refer to “NTP Within a VPRN Service” in the 7450 ESS, 7750 SR, 7950 XRS, and VSR Layer 3 Services Guide: IES and VPRN for more information.
Values—
Base | Management

 

Default—
Base
ip-int-name—
Specifies the local interface on which to transmit NTP broadcast packets, up to 32 characters. If the string contains special characters (#, $, spaces, and so on), the entire string must be enclosed within double quotes.
key-id
Identifies the configured authentication key and authentication type used by this node to receive and transmit NTP packets to and from an NTP server and peers. If an NTP packet is received by this node both authentication key and authentication type must be valid otherwise the packet will be rejected and an event or trap generated.
Values—
1 to 255

 

version
Specifies the NTP version number that is generated by this node. This parameter does not need to be configured when in client mode in which case all versions will be accepted.
Values—
2 to 4

 

Default—
4
ttl
Specifies the IP Time To Live (TTL) value.
Values—
1 to 255

 

Platforms 

All

6.108. broadcast-client

broadcast-client

Syntax 
[no] broadcast-client
Context 
[Tree] (config>system>time>sntp broadcast-client)
Full Contexts 
configure system time sntp broadcast-client
Description 

This command enables listening to SNTP/NTP broadcast messages on interfaces with broadcast client enabled at global device level.

SNTP must be shutdown prior to changing either to or from broadcast mode.

The no form of the command disables broadcast client mode.

Default 

no broadcast-client

Platforms 

All

6.109. broadcast-policer

broadcast-policer

Syntax 
broadcast-policer policer-id [fp-redirect-group]
no broadcast-policer
Context 
[Tree] (config>qos>sap-ingress>fc broadcast-policer)
Full Contexts 
configure qos sap-ingress fc broadcast-policer
Description 

Within a sap-ingress QoS policy forwarding class context, the broadcast-policer command is used to map packets that match the forwarding class and are considered broadcast in nature to the specified policer-id. The specified policer-id must already exist within the sap-ingress QoS policy. While the system is determining the forwarding class of a packet, it is also looking up its forwarding destination based on the ingress service type and the service instance forwarding records. If the service type is VPLS and the destination MAC address is the broadcast address (ff:ff:ff:ff:ff:ff), the packet is classified into the broadcast forwarding type.

Broadcast forwarding type packets are mapped to either an ingress multipoint queue (using the broadcast queue-id or broadcast queue-id group ingress-queue-group commands) or an ingress policer (broadcast-policer policer-id). The broadcast and broadcast-policer commands within the forwarding class context are mutually exclusive. By default, the broadcast forwarding type is mapped to the SAP ingress default multipoint queue. If the broadcast-policer policer-id command is executed, any previous policer mapping or queue mapping for the broadcast forwarding type within the forwarding class is overridden if the policer mapping is successful.

A policer defined within the sap-ingress policy is not actually created on an ingress SAP or a subscriber using an sla-profile where the policy is applied until at least one forwarding type (unicast, broadcast, unknown, or multicast) from one of the forwarding classes is mapped to the policer. If insufficient policer resources exist to create the policer for a SAP or subscriber or multiservice site, or ingress policing is not supported on the port associated with the SAP or subscriber or multiservice site, the initial forwarding class forwarding type mapping will fail.

The broadcast-policer command is ignored for instances of the policer applied to SAPs or subscribers’ multiservice site where broadcast packets are not supported.

When the broadcast forwarding type within a forwarding class is mapped to a policer, the broadcast packets classified to the subclasses within the forwarding class are also mapped to the policer.

The no form of this command is used to restore the mapping of the broadcast forwarding type within the forwarding class to the default multipoint queue. If all forwarding class forwarding types had been removed from the default multipoint queue, the queue will not exist on the SAPs or subscribers or multiservice site associated with the QoS policy and the no broadcast-policer command will cause the system to attempt to create the default multipoint queue on each object. If the system cannot create the queue on each instance, the no broadcast-policer command will fail and the broadcast forwarding type within the forwarding class will continue its mapping to the existing policer-id. If the no broadcast-policer command results in a policer without any current mappings, the policer will be removed from the SAPs and subscribers associated with the QoS policy. All statistics associated with the policer on each SAP and subscriber will be lost.

Parameters 
policer-id—
When the forwarding class broadcast-policer command is executed, a valid policer-id must be specified. The parameter policer-id references a policer-id that has already been created within the sap-ingress QoS policy.
Values—
1 to 63

 

fp-redirect-group—
Redirects a forwarding class to a forwarding plane queue-group as specified in a SAP QoS policy.
Platforms 

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

6.110. broadcast-queue

broadcast-queue

Syntax 
broadcast-queue queue-id [group queue-group-name]
no broadcast queue
Context 
[Tree] (config>qos>sap-ingress>fc broadcast-queue)
Full Contexts 
configure qos sap-ingress fc broadcast-queue
Description 

This command overrides the default broadcast forwarding type queue mapping for fc fc-name. The specified queue-id must exist within the policy as a multipoint queue before the mapping can be made. When the forwarding class mapping is executed, all broadcast traffic on a SAP using this policy will be forwarded using the queue-id.

The broadcast forwarding type usually tracks the multicast forwarding type definition. This command overrides that default behavior.

The no form of this command sets the broadcast forwarding type queue-id back to the default of tracking the multicast forwarding type queue mapping.

Parameters 
queue-id—
The queue-id parameter must be an existing, multipoint queue defined in the config>qos>sap-ingress context.
Values—
Any valid multipoint queue ID in the policy including 2 through 32.

 

Default—
11
group queue-group-name
This optional parameter is used to redirect the forwarding type within the forwarding class to the specified queue-id within the queue-group-name. When the policy is applied, all packets matching the forwarding class and forwarding type will be redirected to the queue within the specified queue group. The queue-group-name are configured in the config>qos>queue-group-templates egress and ingress contexts.
Platforms 

All

broadcast-queue

Syntax 
broadcast-queue queue-id
Context 
[Tree] (config>qos>shared-queue>fc broadcast-queue)
Full Contexts 
configure qos shared-queue fc broadcast-queue
Description 

This command configures the broadcast forwarding type queue mapping for fc fc-name. The specified queue-id must exist within the policy as a multipoint queue before the mapping can be made. When the forwarding class mapping is executed, all broadcast traffic on a SAP using this policy will be forwarded using the queue-id.

The broadcast forwarding type usually tracks the multicast forwarding type definition. This command overrides that default behavior.

The no form of this command sets the broadcast forwarding type queue-id back to the default of tracking the multicast forwarding type queue mapping.

Parameters 
queue-id—
The queue-id parameter must specify an existing multipoint queue defined in the config>qos>sap-ingress context policer-output-queues profile. For the 7950 XRS, this is not configurable in the policer-output-queues profile.
Values—
17 to 24

 

Platforms 

All

6.111. broadcastclient

broadcastclient

Syntax 
broadcastclient [router router-instance | service-name service-name] {interface ip-int-name} [authenticate]
no broadcastclient [router router-instance | service-name service-name] {interface ip-int-name}
Context 
[Tree] (config>system>time>ntp broadcastclient)
Full Contexts 
configure system time ntp broadcastclient
Description 

When configuring NTP, the node can be configured to receive broadcast packets on a specified subnet. This command configures a specific interface to listen for broadcast NTP messages. The interface may exist within a VPRN service.

Broadcast and multicast messages can easily be spoofed, so authentication is strongly recommended. If broadcast is not configured, then any received NTP broadcast traffic will be ignored. Use the show command to view the state of the configuration.

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

Parameters 
router-instance—
Specifies the routing context that contains the interface in the form of router-name or service-id.
Values—
router-name — Base | Management
service-id — 1 to 2147483647

 

Default—
Base
service name—
Specifies the service name for the VPRN. The name can be up to 64 characters in length. Note that CPM routing instances are not supported.
ip-int-name—
Specifies the VPRN interface on which to receive NTP broadcast packets. If the string contains special characters (such as #, $, or spaces) the entire string must be enclosed within double quotes.
authenticate—
Specifies whether or not to require authentication of NTP PDUs. When enabled, NTP PDUs are authenticated upon receipt.
Platforms 

All

6.112. bsm-check-rtr-alert

bsm-check-rtr-alert

Syntax 
[no] bsm-check-rtr-alert
Context 
[Tree] (config>service>vprn>pim>if bsm-check-rtr-alert)
Full Contexts 
configure service vprn pim interface bsm-check-rtr-alert
Description 

This command enables the checking of router alert option in the bootstrap messages received on this interface.

Default 

no bsm-check-rtr-alert

Platforms 

All

bsm-check-rtr-alert

Syntax 
[no] bsm-check-rtr-alert
Context 
[Tree] (config>router>pim>interface bsm-check-rtr-alert)
Full Contexts 
configure router pim interface bsm-check-rtr-alert
Description 

This command enables the checking of the router alert option in the bootstrap messages received on this interface.

The no form of this command disables accepting BSM packets without the router alert option.

Default 

no bsm-check-rtr-alert

Platforms 

All

6.113. bsr

bsr

Syntax 
bsr {unicast | spmsi}
no bsr
Context 
[Tree] (config>service>vprn>mvpn>pt>inclusive bsr)
Full Contexts 
configure service vprn mvpn provider-tunnel inclusive bsr
Description 

This command configures the type of BSR signaling used.

The no form of this command restores the default.

Default 

no bsr

Parameters 
unicast—
BSR PDUs are sent/forwarded using unicast PDUs (default).
spmsi—
BSR PDUs are sent/forwarded using S-PMSI full mesh.
Platforms 

All

bsr

Syntax 
bsr [detail]
no bsr
Context 
[Tree] (debug>router>pim bsr)
Full Contexts 
debug router pim bsr
Description 

This command enables/disables debugging for the PIM bootstrap mechanism.

The no form of the command disables debugging.

Parameters 
detail—
Debugs detailed information on the PIM bootstrap mechanism.
Platforms 

All

6.114. bsr-candidate

bsr-candidate

Syntax 
bsr-candidate
Context 
[Tree] (config>service>vprn>pim>rp bsr-candidate)
[Tree] (config>service>vprn>pim>rp>ipv6 bsr-candidate)
Full Contexts 
configure service vprn pim rp bsr-candidate
configure service vprn pim rp ipv6 bsr-candidate
Description 

Commands in this context configure Candidate Bootstrap (BSR) parameters.

Either bsr-candidate for IPv4 or auto-rp-discovery can be configured; the two mechanisms cannot be enabled together. bsr-candidate for IPv6 and auto-rp-discovery for IPv4 can be enabled together.

The no form of this command disables BSR.

Default 

no bsr-candidate

Platforms 

All

bsr-candidate

Syntax 
bsr-candidate
Context 
[Tree] (config>router>pim>rp bsr-candidate)
[Tree] (config>router>pim>rp>ipv6 bsr-candidate)
Full Contexts 
configure router pim rp bsr-candidate
configure router pim rp ipv6 bsr-candidate
Description 

Commands in this context configure Candidate Bootstrap (BSR) parameters.

Either bsr-candidate for IPv4 or auto-rp-discovery can be configured; the two mechanisms cannot be enabled together. bsr-candidate for IPv6 and auto-rp-discovery for IPv4 can be enabled together.

Default 

bsr-candidate shutdown

Platforms 

All

6.115. buffer-allocation

buffer-allocation

Syntax 
buffer-allocation min percentage max percentage
no buffer-allocation
Context 
[Tree] (config>card>fp>egress>wred-queue-control buffer-allocation)
Full Contexts 
configure card fp egress wred-queue-control buffer-allocation
Description 

The buffer-allocation command defines the amount of buffers that will be set aside for WRED queue buffer pools. Note that the min percentage and max percentage parameters must be set to the same value. The forwarding plane protects against cross application buffer starvation by implementing a hierarchy of buffer pools. At the top of the hierarchy are mega-pools. Mega-pools are used to manage buffers at a system application level. Two mega-pools are currently used by the system. The first (default) mega-pool services all non-WRED type queues and when WRED queues are not enabled will contain all available forwarding plane queue buffers. When WRED queuing is enabled, the second mega-pool (the WRED mega-pool) is given buffers from the default mega-pool based on the buffer-allocation command.

The mega-pools provide buffers to the second tier buffer pools. The default mega-pool services all default pools. As the name implies, the WRED mega-pool services all the WRED buffer pools created for the WRED queues. The WRED mega-pool allows each WRED queue pool to be configured to an appropriate size while allowing the sum of the WRED queue pool sizes to oversubscribe the total amount set aside for WRED queue buffering without affecting the queues using the default pools.

No buffers are allocated to the WRED mega-pool until the wred-queue-control shutdown command is set to no shutdown. When the shutdown command is executed, all buffers allocated to the WRED mega-pool are returned to the default mega-pool and all WRED queues are returned to their default buffer pool.

The no form of this command immediately restores the default min and max percentage values for sizing the WRED mega-pool.

Default 

buffer-allocation min 25.00 max 25.00

Parameters 
min percentage
Specifies that the required keyword defines the minimum percentage of total egress forwarding plane queue buffers that will be applied to the WRED mega-pool. 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 total egress forwarding plane queue buffers that may be applied to the WRED mega-pool. The value given for percentage must be equal to or greater than 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

6.116. buffer-pool

buffer-pool

Syntax 
buffer-pool value
Context 
[Tree] (config>port>sonet-sdh>path>atm>custom-buffer-mode buffer-pool)
Full Contexts 
configure port sonet-sdh path atm custom-buffer-mode buffer-pool
Description 

This command configures the ATM port buffer pool percentage.

Parameters 
value—
Specifies the percentage of the buffers configured on this interface over the maximum allowed.
Values—
1 to 100

 

Platforms 

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

6.117. buffer-type

buffer-type

Syntax 
buffer-type buffer-type
Context 
[Tree] (config>app-assure>group>evt-log buffer-type)
Full Contexts 
configure application-assurance group event-log buffer-type
Description 

This command specifies the type of buffer to be used in the event log.

Default 

buffer-type linear

Parameters 
buffer-type—
Specifies the type of event type.
Values—
linear — Specifies a linear buffer which once full will stop recording events until it is cleared.
circular — Specifies a circular buffer whereby older entries will be overwritten by newer entries.
syslog—Specifies that events are stored offline on a syslog host.

 

Platforms 

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

6.118. buffering

buffering

Syntax 
[no] buffering
Context 
[Tree] (config>call-trace buffering)
Full Contexts 
configure call-trace buffering
Description 

This command specifies whether messages should be buffered for sessions where the trace key is not yet known, for example, a username for a PPP session. When the key indicates a match for a traced session, the router sends the buffered messages immediately. If the key does not match a trace, the router discards the buffered messages. By default, the router does not buffer any message and thus initial messages may not be traced.

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

Default 

no buffering

Platforms 

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

buffering

Syntax 
[no] buffering
Context 
[Tree] (config>aaa>radius-srv-plcy buffering)
Full Contexts 
configure aaa radius-server-policy buffering
Description 

Commands in this context configure RADIUS message buffering.

The no form of this command disables RADIUS message buffering.

6.119. build-packet

build-packet

Syntax 
build-packet
Context 
[Tree] (config>test-oam build-packet)
[Tree] (debug>oam build-packet)
Full Contexts 
configure test-oam build-packet
debug oam build-packet
Description 

Commands in this context configure packet header templates or the OAM test packet to be used when running an oam find-egress test.

Platforms 

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

6.120. buildout

buildout

Syntax 
buildout {long | short}
Context 
[Tree] (config>port>tdm buildout)
Full Contexts 
configure port tdm buildout
Description 

This command specifies line buildout (cable length) for physical DS-1/DS-3 ports.

Default 

buildout short

Parameters 
long —
Sets the line buildout for length runs up to 450 feet.
short —
Sets the line buildout for length runs up to 225 feet.
Platforms 

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

6.121. bundle

bundle

Syntax 
bundle bundle-name [create]
no bundle bundle-name
Context 
[Tree] (config>mcast-mgmt>mcast-info-plcy bundle)
Full Contexts 
configure mcast-management multicast-info-policy bundle
Description 

This command creates or edits channel bundles within a multicast information policy. Bundles are used for two main purposes. First, bundles are used by the multicast CAC function to group multicast channels into a common bandwidth context. The CAC function limits the ability for downstream nodes to join multicast channels based on the egress interfaces ability to handle the multicast traffic. Bundling allows multicast channels with common preference or application to be managed into a certain percentage of the available bandwidth.

The second function of bundles is to provide a simple provisioning mechanism. Each bundle within a multicast information policy has a set of default channel parameters. If each channel provisioned in to the bundle can use the default parameters for the bundle, the provisioning and configuration storage requirements are minimized.

Up to 31 explicit bundles may be defined within a multicast information policy (32 including the default bundle).

Once a bundle is created, the default channel parameters should be configured and the individual channel ranges should be defined. Within each channel range, override parameters may be defined that override the default channel parameters. Further overrides are supported within the channel range based on explicit source overrides.

A bundle can be deleted at any time (except for the default bundle). When a bundle is deleted, all configuration information within the bundle is removed including multicast channel ranges. Any multicast records using the bundle should be reevaluated. Multicast CAC and ECMP managers should also be updated.

Default Bundle

Each multicast information policy contains a bundle named default. The default bundle cannot be deleted. Any multicast channel that fails to match a channel range within an explicit bundle is automatically associated with the default bundle.

The no form of this command removes a bundle from the multicast information policy. The default bundle cannot be removed from the policy.

Default 

bundle “default”

Parameters 
bundle-name—
Specifies bundle expressed as an ASCII string with up to 16 characters and must follow normal naming conventions. If bundle-name already exists, the system enters the bundle context for editing purposes. If bundle-name does not exist, the system creates the defined bundle in the policy and enter the bundle context for editing purposes.
create—
The create keyword is required if creating a new multicast information policy bundle when the system is configured to require the explicit use of the keyword to prevent accidental object creation. Objects may be accidentally created when this protection is disabled and an object name is mistyped when attempting to edit the object. This keyword is not required when the protection is disabled. The keyword is ignored when the bundle name already exists.
Platforms 

All

bundle

Syntax 
bundle [detail]
no bundle
Context 
[Tree] (debug>router>gmpls>packet bundle)
Full Contexts 
debug router gmpls packet bundle
Description 

This command enables debugging for GMPLS Bundle packets.

The no form of the command disables debugging for GMPLS Bundle packets.

Parameters 
detail—
Keyword to produce debug output in greater detail.
Platforms 

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

bundle

Syntax 
bundle [detail]
no bundle
Context 
[Tree] (debug>router>rsvp>packet bundle)
Full Contexts 
debug router rsvp packet bundle
Description 

This command debugs bundle events.

The no form of the command disables the debugging.

Parameters 
detail—
Displays detailed information about bundle events.
Platforms 

All

bundle

Syntax 
bundle bundle-name [create]
no bundle bundle-name
Context 
[Tree] (config>router>mcac>policy bundle)
Full Contexts 
configure router mcac policy bundle
Description 

This command creates the context that enables the grouping of MCAC group addresses into bundles.

When a number of multicast groups or BTV channels are grouped into a single bundle, then policing, if a join for a particular MC-group (BTV channel), can depend on whether:

  1. There is enough physical bandwidth on the egress interface.
  2. The given channel is a mandatory or optional channel.
    1. If optional, is there sufficient bandwidth according to the policy settings for the relevant interface.
    2. If optional, is there sufficient bandwidth within the bundle.

The no form of this command removes the named bundle from the configuration.

Parameters 
bundle-name—
Specifies the multicast bundle name. Allowed values are any string up to 32 characters composed of printable, 7-bit ASCII characters. If the string contains special characters (#, $, spaces, and so on), the entire string must be no enclosed within double quotes.
create—
Mandatory keyword when creating a bundle instance. The create keyword requirement can be enabled or disabled in the environment>create context.

Platforms 

All

6.122. burst-limit

burst-limit

Syntax 
burst-limit {default | size [bytes | kilobytes]}
no burst-limit
Context 
[Tree] (config>service>vprn>sub-if>grp-if>sap>egress>queue-override>queue burst-limit)
Full Contexts 
configure service vprn subscriber-interface group-interface sap egress queue-override queue burst-limit
Description 

The queue burst-limit command defines an explicit shaping burst size for a queue. The configured size defines the shaping leaky bucket threshold level that indicates the maximum burst over the queue's shaping rate.

The no form of this command restores the default burst limit to the specified queue. This is equivalent to specifying burst-limit default within the QoS policies. When specified within a queue-override queue context, any current burst limit override for the queue is removed and the queue's burst limit is controlled by its defining policy.

Default 

no burst-limit

Parameters 
default—
Reverts the queue's burst limit to the system default value.
size—
When a numeric value is specified (size), the system interprets the value as an explicit burst limit size. The value is expressed as an integer and, by default, is interpreted as the burst limit in kilobytes. If the value is intended to be interpreted in bytes, the bytes qualifier must be added following size.
Values—
0 to 13671 kilobytes
0 to 14000000 bytes

 

Default—
No default for size; use the default keyword to specify default burst limit.
bytes—
Specifies that the value given for size must be interpreted as the burst limit in bytes.
kilobytes—
Specifies that the value given for size must be interpreted as the burst limit in kilobytes. If neither bytes nor kilobytes is specified, the default qualifier is kilobytes.

burst-limit

Syntax 
burst-limit {default | size [bytes | kilobytes]}
no burst-limit
Context 
[Tree] (config>port>ethernet>access>egr>qgrp>qover>q burst-limit)
Full Contexts 
configure port ethernet access egress queue-group queue-overrides queue burst-limit
Description 

The queue burst-limit command overrides the shaping burst size for a queue. The configured size defines the shaping leaky bucket threshold level that indicates the maximum burst over the queue’s shaping rate.

The no form of this command removes the current burst limit override for the queue. The queue’s burst limit is controlled by its defining template.

Default 

no burst-limit

Parameters 
default—
Reverts the queue's burst limit to the system default value.
size—
When a numeric value is specified (size), the system interprets the value as an explicit burst limit size. The value is expressed as an integer and, by default, is interpreted as the burst limit in kilobytes. If the value is intended to be interpreted in bytes, the bytes qualifier must be added following size.
Values—
1 to 13671 kilobytes
1 to 14000000 bytes

 

Default—
No default for size; use the default keyword to specify default burst limit.
bytes—
Specifies that the value given for size must be interpreted as the burst limit in bytes.
kilobytes—
Specifies that the value given for size must be interpreted as the burst limit in kilobytes. If neither bytes nor kilobytes is specified, the default qualifier is kilobytes.
Platforms 

All

burst-limit

Syntax 
burst-limit size [bytes | kilobytes]
no burst-limit
Context 
[Tree] (config>service>apipe>sap>egress>queue-override>queue burst-limit)
[Tree] (config>service>cpipe>sap>egress>queue-override>queue burst-limit)
[Tree] (config>service>epipe>sap>egress>queue-override>queue burst-limit)
[Tree] (config>service>fpipe>sap>egress>queue-override>queue burst-limit)
[Tree] (config>service>ipipe>sap>egress>queue-override>queue burst-limit)
Full Contexts 
configure service apipe sap egress queue-override queue burst-limit
configure service cpipe sap egress queue-override queue burst-limit
configure service epipe sap egress queue-override queue burst-limit
configure service fpipe sap egress queue-override queue burst-limit
configure service ipipe sap egress queue-override queue burst-limit
Description 

The queue burst-limit command defines an explicit shaping burst size for a queue. The configured size defines the shaping leaky bucket threshold level that indicates the maximum burst over the queue’s shaping rate.

The no form of this command restores the default burst limit to the specified queue. This is equivalent to specifying burst-limit default within the QoS policies. When specified within a queue-override queue context, any current burst limit override for the queue is removed and the queue’s burst limit is controlled by its defining policy.

Default 

no burst-limit

Parameters 
default—
Reverts the queue's burst limit to the system default value.
size—
When a numeric value is specified (size), the system interprets the value as an explicit burst limit size. The value is expressed as an integer and, by default, is interpreted as the burst limit in kilobytes. If the value is intended to be interpreted in bytes, the bytes qualifier must be added following size.
Values—
1 to 13671 kilobytes
14000000 bytes

 

Default—
No default for size; use the default keyword to specify default burst limit.
bytes—
Specifies that the value given for size must be interpreted as the burst limit in bytes.
kilobytes—
Specifies that the value given for size must be interpreted as the burst limit in kilobytes. If neither bytes nor kilobytes is specified, the default qualifier is kilobytes.
Platforms 

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

  1. configure service fpipe sap egress queue-override queue burst-limit
  2. configure service cpipe sap egress queue-override queue burst-limit

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

  1. configure service apipe sap egress queue-override queue burst-limit

All

  1. configure service epipe sap egress queue-override queue burst-limit
  2. configure service ipipe sap egress queue-override queue burst-limit

burst-limit

Syntax 
burst-limit {default | size [bytes | kilobytes]}
no burst-limit
Context 
[Tree] (config>service>vpls>sap>egress>queue-override>queue burst-limit)
Full Contexts 
configure service vpls sap egress queue-override queue burst-limit
Description 

The queue burst-limit command defines an explicit shaping burst size for a queue. The configured size defines the shaping leaky bucket threshold level that indicates the maximum burst over the queue's shaping rate. The no form of this command restores the default burst limit to the specified queue. This is equivalent to specifying burst-limit default within the QoS policies. When specified within a queue-override queue context, any current burst limit override for the queue is removed and the queue's burst limit is controlled by its defining policy.

Default 

no burst-limit

Parameters 
default—
Reverts the queue's burst limit to the system default value.
size—
When a numeric value is specified (size), the system interprets the value as an explicit burst limit size. The value is expressed as an integer and by default is interpreted as the burst limit in kilobytes. If the value is intended to be interpreted in bytes, the bytes qualifier must be added following size.
Values—
1 to 13671 kilobytes
1 to 14000000 bytes

 

Default—
No default for size; use the default keyword to specify default burst limit.
bytes—
Specifies that the value given for size must be interpreted as the burst limit in bytes.
kilobytes—
Specifies that the value given for size must be interpreted as the burst limit in kilobytes. If neither bytes nor kilobytes is specified, the default qualifier is kilobytes.
Platforms 

All

burst-limit

Syntax 
burst-limit {default | size [bytes | kilobytes]}
no burst-limit
Context 
[Tree] (config>service>ies>sub-if>grp-if>sap>egress>queue-override>queue burst-limit)
Full Contexts 
configure service ies subscriber-interface group-interface sap egress queue-override queue burst-limit
Description 

The queue burst-limit command defines an explicit shaping burst size for a queue. The configured size defines the shaping leaky bucket threshold level that indicates the maximum burst over the queue's shaping rate.

The no form of this command restores the default burst limit to the specified queue. This is equivalent to specifying burst-limit default within the QoS policies. When specified within a queue-override queue context, any current burst limit override for the queue is removed and the queue's burst limit is controlled by its defining policy.

Default 

no burst-limit

Parameters 
default—
Reverts the queue's burst limit to the system default value.
size—
When a numeric value is specified (size), the system interprets the value as an explicit burst limit size. The value is expressed as an integer and, by default, is interpreted as the burst limit in kilobytes. If the value is intended to be interpreted in bytes, the bytes qualifier must be added following size.
Values—
0 to 13671 kilobytes
0 to or 14000000 bytes

 

Default—
No default for size; use the default keyword to specify default burst limit.
bytes—
Specifies that the value given for size must be interpreted as the burst limit in bytes.
kilobytes—
Specifies that the value given for size must be interpreted as the burst limit in kilobytes. If neither bytes nor kilobytes is specified, the default qualifier is kilobytes.

burst-limit

Syntax 
burst-limit size [bytes | kilobytes]
no burst-limit
Context 
[Tree] (config>service>vprn>if>sap>egress>queue-override burst-limit)
Full Contexts 
configure service vprn interface sap egress queue-override burst-limit
Description 

The queue burst-limit command defines an explicit shaping burst size for a queue. The configured size defines the shaping leaky bucket threshold level that indicates the maximum burst over the queue's shaping rate.

The no form of this command restores the default burst limit to the specified queue. This is equivalent to specifying burst-limit default within the QoS policies. When specified within a queue-override queue context, any current burst limit override for the queue is removed and the queue's burst limit is controlled by its defining policy.

Default 

no burst-limit

Parameters 
default—
Reverts the queue's burst limit to the system default value.
size—
When a numeric value is specified (size), the system interprets the value as an explicit burst limit size. The value is expressed as an integer and, by default, is interpreted as the burst limit in kilobytes. If the value is intended to be interpreted in bytes, the bytes qualifier must be added following size.
Values—
1 to 14000000

 

bytes—
Specifies that the value given for size must be interpreted as the burst limit in bytes.
kilobytes—
Specifies that the value given for size must be interpreted as the burst limit in kilobytes. If neither bytes nor kilobytes is specified, the default qualifier is kilobytes.

burst-limit

Syntax 
burst-limit size [bytes | kilobytes]
no burst-limit
Context 
[Tree] (config>qos>sap-ingress>queue burst-limit)
Full Contexts 
configure qos sap-ingress queue burst-limit
Description 

The queue burst-limit command is used to define an explicit shaping burst size for a queue. The configured size defines the shaping leaky bucket threshold level that indicates the maximum burst over the queue’s shaping rate.

The burst-limit command is supported under the sap-ingress and sap-egress QoS policy queues. The command is also supported under the ingress and egress queue-group-templates queues.

The no form of this command is used to restore the default burst limit to the specified queue. This is equivalent to specifying burst-limit default within the QoS policies or queue group templates. When specified within a queue-override queue context, any current burst limit override for the queue will be removed and the queue’s burst limit will be controlled by its defining policy or template.

Default 

no burst-limit

Parameters 
size—
Specifies an explicit burst limit size. The value is expressed as an integer and, by default, is interpreted as the burst limit in kilobytes. If the value is intended to be interpreted in bytes, the byte qualifier must be added following size.
Values—
1 to 13,671 kbytes or 14,000,000 bytes

 

Default—
No default for size; use the default keyword to specify default burst limit.
bytes—
Specifies that the value given for size must be interpreted as the burst limit in bytes.
kilobytes—
Specifies that the value given for size must be interpreted as the burst limit in kilobytes. If neither bytes nor kilobytes is specified, the default qualifier is kilobytes.
Platforms 

All

burst-limit

Syntax 
burst-limit {default | size [bytes | kilobytes]}
no burst-limit
Context 
[Tree] (config>qos>sap-egress>queue burst-limit)
Full Contexts 
configure qos sap-egress queue burst-limit
Description 

The queue burst-limit command defines an explicit shaping burst size for a queue. The configured size defines the shaping leaky bucket threshold level that indicates the maximum burst over the queue’s shaping rate.

The burst-limit command is supported under the sap-ingress and sap-egress QoS policy queues. The command is also supported under the ingress and egress queue-group-templates queues.

The no form of this command restores the default burst limit to the specified queue. This is equivalent to specifying burst-limit default within the QoS policies or queue group templates. When specified within a queue-override queue context, any current burst limit override for the queue is removed and the queue’s burst limit is controlled by its defining policy or template.

Default 

no burst-limit

Parameters 
default—
Reverts the queue's burst limit to the system default value.
size—
Specifies an explicit burst limit size. The value is expressed as an integer and by default is interpreted as the burst limit in kilobytes. If the value is intended to be interpreted in bytes, the bytes keyword must be added following size.
Values—
1 to 13671 kilobytes
0 to 14,000,000 bytes

 

Default—
No default for size; use the default keyword to specify default burst limit.
bytes—
Specifies that the value given for size must be interpreted as the burst limit in bytes.
kilobytes—
Specifies that the value given for size must be interpreted as the burst limit in kilobytes.  If neither bytes nor kilobytes is specified, the default qualifier is kilobytes.
Platforms 

All

burst-limit

Syntax 
burst-limit {size [bytes | kilobytes] | default}
no burst-limit
Context 
[Tree] (config>qos>qgrps>egr>qgrp>queue burst-limit)
[Tree] (config>qos>qgrps>ing>qgrp>queue burst-limit)
Full Contexts 
configure qos queue-group-templates egress queue-group queue burst-limit
configure qos queue-group-templates ingress queue-group queue burst-limit
Description 

The queue burst-limit command is used to define an explicit shaping burst size for a queue. The configured size defines the shaping leaky bucket threshold level that indicates the maximum burst over the queue’s shaping rate.

The burst-limit command is supported under the sap-ingress and sap-egress QoS policy queues. The command is also supported under the ingress and egress queue-group-templates queues.

The no form of this command is used to restore the default burst limit to the specified queue. This is equivalent to specifying burst-limit default within the QoS policies or queue group templates. When specified within a queue-override queue context, any current burst limit override for the queue will be removed and the queue’s burst limit will be controlled by its defining policy or template.

Parameters 
size—
When a numeric value is specified (size), the system interprets the value as an explicit burst limit size. The value is expressed as an integer and by default is interpreted as the burst limit in kilobytes. If the value is intended to be interpreted in bytes, the byte qualifier must be added following size.
Values—
1 to 14,000 (14,000 or 14,000,000 depending on bytes or kilobytes)

 

bytes—
Specifies that the value given for size must be interpreted as the burst limit in bytes.
kilobytes—
Specifies that the value given for size must be interpreted as the burst limit in kilobytes.
Platforms 

All

6.123. bw-activity

bw-activity

Syntax 
bw-activity {use-admin-bw | dynamic [falling-delay seconds]} [black-hole-rate kbps]
no bw-activity
Context 
[Tree] (config>mcast-mgmt>mcast-info-plcy>bundle bw-activity)
[Tree] (config>mcast-mgmt>mcast-info-plcy>bundle>channel bw-activity)
[Tree] (config>mcast-mgmt>mcast-info-plcy>bundle>source-override bw-activity)
Full Contexts 
configure mcast-management multicast-info-policy bundle bw-activity
configure mcast-management multicast-info-policy bundle channel bw-activity
configure mcast-management multicast-info-policy bundle source-override bw-activity
Description 

This command defines how the multicast ingress path manager determines the amount of bandwidth required by a multicast channel. The default setting is dynamic which causes the bandwidth manager to use the bandwidth policies dynamic rate table entries to determine the current rate. The alternative setting is use-admin-bw which causes the bandwidth manager to use the configured admin-bw associated with the channel. The use-admin-bw setting also requires an active and inactive threshold to be defined which allows the bandwidth manager to determine when the channel is actively using ingress path bandwidth and when the channel is idle.

The use-admin-bw setting requires that the channel be configured with an admin-bw value that is not equal to 0 in the same context as the bw-activity command using the setting. Once a context has the use-admin-bw command configured, the context’s admin-bw value cannot be set to 0 and the no admin-bw command fails.

This command also supports an optional black-hole-rate kbps command that defines at which current rate a channel should be placed in the black-hole state. This is intended to provide a protection mechanism against multicast channels that exceed a reasonable rate and cause outages in other channels.

The no form of this command restores the default bandwidth activity monitoring setting (dynamic or null depending on the context).

Parameters 
use-admin-bw | dynamic—
The use-admin-bw and dynamic keywords are mutually exclusive and one must be specified when executing the bw-activity command. The use-admin-bw keyword indicates the channels current ingress bandwidth should be derived from the admin-bw setting. The admin-bw setting must not currently be set to 0 for the use-admin-bw setting to succeed. The dynamic keyword indicates that the multicast ingress path manager should use the dynamic rate table (as defined in the bandwidth-policy) to derive the channels current ingress rate.
falling-delay seconds
Specifies the value the bandwidth manager uses the falling-delay threshold to hold on to the previous highest bandwidth until the delay time has expired while operating in dynamic bandwidth mode. This allows the bandwidth manager to ignore momentary drops in channel bandwidth.
Values—
10 to 3600

 

Default—
30

Bundle default:

dynamic

Channel default:

Null (undefined)

Source-override default:

Null (undefined)

black-hole-rate kbps
Specifies a rate at which a channel is placed in the black-hole state. This parameter is expressed, in kb/s, as an integer and represents multiples of 1,000 bits per second.
Values—
1 to 40000000

 

Platforms 

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

6.124. bypass-resignal-timer

bypass-resignal-timer

Syntax 
bypass-resignal-timer minutes
no bypass-resignal-timer
Context 
[Tree] (config>router>mpls bypass-resignal-timer)
Full Contexts 
configure router mpls bypass-resignal-timer
Description 

This command triggers the periodic global re-optimization of all dynamic bypass LSP paths associated with RSVP P2P LSP. The operation is performed at each expiry of the user configurable bypass LSP resignal timer.

When this command is enabled, MPLS requests CSPF for the best path for each dynamic bypass LSP originated on this node. The constraints, hop-limit, SRLG and admin-group constraints, of the first associated LSP primary path that originally triggered the signaling of the bypass LSP must be satisfied. To do this, MPLS saves this initial Path State Block (PSB) of that LSP primary path, even if the latter is torn down.

CSPF first updates the SRLG membership of the current bypass LSP path and checks if the path violates the SRLG constraint of the initial PSB. It then attempts a new path computation for the bypass LSP using the initial PSB constraints. If CSPF returns no path or returns a new path with a cost that is lower than the current path, MPLS does not signal the new bypass path. If CSPF returns a new path with a cost that is lower than the current one, MPLS signals it. Also, if the new bypass path is SRLG strict disjoint with the primary path of the original PSB while the current path is SRLG loose disjoint, the manual bypass path is resignaled regardless of cost comparison.

Once the new path is successfully signaled, MPLS evaluates each PSB of each PLR (that is, each unique avoid-node or avoid-link constraint) associated with the current bypass LSP path to check if the corresponding LSP primary path constraints are still satisfied by the new bypass LSP path. If so, the PSB association is moved to the new bypass LSP.

Each PSB for which the constraints are not satisfied remains associated with the PLR on the current bypass LSP and is checked at the next timer or manual bypass re-optimization. Additionally, if SRLG FRR loose disjointness is configured using the configure router mpls srlg-frr command and the current bypass LSP is SRLG disjoint with a primary path while the new bypass LSP is not SRLG disjoint, the PSB association is not moved. When CSPF does not return a new bypass path or it returns a less optimal one, the PSBs remain associated with the current bypass path. However, it is possible that CSPF found the current bypass LSP path no longer satisfies the SRLG constraint of one or more PLRs after the update of the current path SRLG information. In that case, MPLS detaches from current bypass path the PSB associations of these PLRs. These orphaned PSBs are re-evaluated by the FRR background task which checks unprotected PSBs on a regular basis and following the same above procedure.

If a specific PLR associated with a bypass LSP is active, the corresponding PSBs remain associated with the current PLR until the Global Revertive Make-Before-Break (MBB) tears down all corresponding primary paths, which also causes the current PLR to be removed.

Note:

While it is in the preceding state, the older PLR does not get any new PSB association until the specific PLR with an active bypass LSP is removed. When the last PLR is removed, the older bypass LSP is torn down.

This feature is not supported with inter-area dynamic bypass LSP and bypass LSP protecting S2L paths of a P2MP LSP.

The no form of this command disables the periodic global re-optimization of dynamic bypass LSP paths.

Default 

no bypass-resignal timer.

Parameters 
minutes—
Specifies the time, in minutes, MPLS waits before attempting to resignal dynamic bypass LSP paths originated on the system.
Values—
1 to 10080

 

Platforms 

All