b Commands
back
back
Syntax
back
Context
[Tree] (back)
Full Context
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.
Platforms
7705 SAR Gen 2
backup
backup
Syntax
[no] backup ip-address
Context
[Tree] (config>service>ies>if>ipv6>vrrp backup)
Full Context
configure service ies interface ipv6 vrrp backup
Description
This command configures virtual router IP addresses for the interface.
Platforms
7705 SAR Gen 2
backup
Syntax
[no] backup ip-address
Context
[Tree] (config>service>ies>if>vrrp backup)
Full Context
configure service ies interface vrrp backup
Description
This command configures virtual router IP addresses for the interface.
Platforms
7705 SAR Gen 2
backup
Syntax
[no] backup ip-address
Context
[Tree] (config>service>vprn>if>vrrp backup)
Full Context
configure service vprn interface vrrp backup
Description
This command configures virtual router IP addresses for the interface.
Platforms
7705 SAR Gen 2
backup
Syntax
[no] backup ipv6-address
Context
[Tree] (config>service>vprn>if>ipv6>vrrp backup)
Full Context
configure service vprn interface ipv6 vrrp backup
Description
This command configures virtual router IP addresses for the interface.
Platforms
7705 SAR Gen 2
backup
Syntax
backup mda-id
no backup
Context
[Tree] (config>isa>tunnel-grp backup)
Full Context
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 are lost. Auto-switching from the backup to primary, after the primary becomes available again, is supported.
The user is notified through SNMP events when:
-
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).
-
When ISA IPsec redundancy fails (one of the modules in the group is down) or recovers (the failed module comes back up).
-
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.
Platforms
7705 SAR Gen 2
backup
Syntax
[no] backup ip-address
Context
[Tree] (config>router>if>vrrp backup)
Full Context
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.
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.
Platforms
7705 SAR Gen 2
backup
Syntax
[no] backup ipv6-address
Context
[Tree] (config>router>if>ipv6>vrrp backup)
Full Context
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 (RFC 4861). 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.
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.
Platforms
7705 SAR Gen 2
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 Context
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:
-
A local interface failure or a control plane failure (hello timeout and so on).
-
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.
-
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.
-
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.
-
Receipt of a ResvTear message.
-
A configuration change MBB.
-
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.
Platforms
7705 SAR Gen 2
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 Context
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
7705 SAR Gen 2
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 Context
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.
- index
-
Specifies the index for this backup node SID.
- label
-
Specifies the SID value for this backup node SID.
Platforms
7705 SAR Gen 2
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 Context
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.
Platforms
7705 SAR Gen 2
bandwidth
bandwidth
Syntax
bandwidth bandwidth
no bandwidth
Context
[Tree] (config>lag>access bandwidth)
[Tree] (config>port>ethernet>access bandwidth)
Full Context
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.
Platforms
7705 SAR Gen 2
bandwidth
Syntax
bandwidth bandwidth
no bandwidth
Context
[Tree] (config>service>epipe>sap bandwidth)
Full Context
configure service epipe 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.
Platforms
7705 SAR Gen 2
bandwidth
Syntax
bandwidth bw-value
bandwidth max
no bandwidth
Context
[Tree] (config>service>epipe>spoke-sdp bandwidth)
Full Context
configure service epipe 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 OS 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.
Platforms
7705 SAR Gen 2
bandwidth
Syntax
bandwidth bandwidth
no bandwidth
Context
[Tree] (config>service>vpls>sap bandwidth)
Full Context
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.
Platforms
7705 SAR Gen 2
bandwidth
Syntax
bandwidth bandwidth
no bandwidth
Context
[Tree] (config>service>ies>if>sap bandwidth)
Full Context
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.
Platforms
7705 SAR Gen 2
bandwidth
Syntax
bandwidth bandwidth
no bandwidth
Context
[Tree] (config>service>vprn>if>sap bandwidth)
Full Context
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.
Platforms
7705 SAR Gen 2
bandwidth
Syntax
bandwidth bandwidth-in-mbps
no bandwidth
Context
[Tree] (config>router>mpls>lsp-template bandwidth)
Full Context
configure router mpls lsp-template bandwidth
Description
This command specifies the amount of bandwidth to be reserved for the P2MP instance.
Parameters
- bandwidth-in-mbps
-
Specifies the bandwidth, in Mb/s.
Platforms
7705 SAR Gen 2
bandwidth
Syntax
bandwidth bandwidth-in-mbps
no bandwidth
Context
[Tree] (config>router>mpls>lsp>secondary bandwidth)
[Tree] (config>router>mpls>lsp>primary bandwidth)
Full Context
configure router mpls lsp secondary bandwidth
configure router mpls lsp primary 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.
Platforms
7705 SAR Gen 2
base-op-authorization
base-op-authorization
Syntax
base-op-authorization
Context
[Tree] (config>system>security>profile>netconf base-op-authorization)
Full Context
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
7705 SAR Gen 2
begin
begin
Syntax
begin
Context
[Tree] (config>router>bfd begin)
Full Context
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
7705 SAR Gen 2
begin
Syntax
begin
Context
[Tree] (config>router>route-next-hop-policy begin)
Full Context
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
7705 SAR Gen 2
begin
Syntax
begin {exclusive}
Context
[Tree] (config>router>policy-options begin)
Full Context
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
7705 SAR Gen 2
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>uni>send>entry begin-time)
[Tree] (config>system>security>keychain>direction>bi>entry begin-time)
[Tree] (config>system>security>keychain>direction>uni>receive>entry begin-time)
Full Context
configure system security keychain direction uni send entry begin-time
configure system security keychain direction bi entry begin-time
configure system security keychain direction uni receive 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.
- 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
7705 SAR Gen 2
best-path-selection
best-path-selection
Syntax
best-path-selection
Context
[Tree] (config>service>vprn>bgp best-path-selection)
Full Context
configure service vprn bgp best-path-selection
Description
This command enables path selection configuration.
Platforms
7705 SAR Gen 2
best-path-selection
Syntax
best-path-selection
Context
[Tree] (config>router>bgp best-path-selection)
Full Context
configure router bgp best-path-selection
Description
Commands in this context configure path selection parameters.
Platforms
7705 SAR Gen 2
bfd
bfd
Syntax
bfd transmit-interval [receive receive-interval] [multiplier multiplier [echo-receive echo-interval] [type cpm-np]
no bfd
Context
[Tree] (config>service>vprn>if bfd)
[Tree] (config>service>vprn>nw-if bfd)
[Tree] (config>service>vprn>if>ipv6 bfd)
[Tree] (config>service>ies>if bfd)
[Tree] (config>service>ies>if>ipv6 bfd)
Full Context
configure service vprn interface bfd
configure service vprn network-interface bfd
configure service vprn interface ipv6 bfd
configure service ies interface bfd
configure service ies interface ipv6 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.
The transmit-interval, receive receive-interval, and echo-receive echo-interval values can only be modified to a value less than 100 when:
-
The type cpm-np option is explicitly configured.
-
The service is shut down (shutdown)
-
The interval is specified 10 to 100000.
-
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.
- receive receive-interval
-
Sets the receive interval for the BFD session.
- multiplier multiplier
-
Sets the multiplier for the BFD session.
- echo-receive echo-interval
-
Sets the minimum echo receive interval, in milliseconds, for the BFD session.
- type cpm-np
-
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
7705 SAR Gen 2
bfd
Syntax
bfd transmit-interval [receive receive-interval] [multiplier multiplier] [echo-receive echo-interval] [type cpm-np]
no bfd
Context
[Tree] (config>router>if>ipv6 bfd)
[Tree] (config>router>if bfd)
Full Context
configure router interface ipv6 bfd
configure router interface 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: The transmit-interval and receive receive-interval values can only be modified to a value less than 100 ms when:
-
The type cpm-np option is explicitly configured.
-
The service is shut down (shutdown)
-
The interval is specified 10 to 100000.
-
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.
- receive-interval
-
Sets the receive interval, in milliseconds, for the BFD session.
- multiplier
-
Sets the multiplier for the BFD session. A multiplier of less than 3 should not be used in production environments.
- echo-interval
-
Sets the minimum echo receive interval, in milliseconds, for the session.
- cpm-np
-
Selects the CPM network processor type as the local termination point for the BFD session. See Important Notes, above.
Platforms
7705 SAR Gen 2
bfd-designate
bfd-designate
Syntax
[no] bfd-designate
Context
[Tree] (config>service>vprn>if>ipsec>ipsec-tunnel bfd-designate)
[Tree] (config>service>vprn>if>sap>ipsec-tunnel bfd-designate)
[Tree] (config>service>ies>if>ipsec>ipsec-tunnel bfd-designate)
[Tree] (config>router>if>ipsec>ipsec-tunnel bfd-designate)
Full Context
configure service vprn interface ipsec ipsec-tunnel bfd-designate
configure service vprn interface sap ipsec-tunnel bfd-designate
configure service ies interface ipsec ipsec-tunnel bfd-designate
configure router interface ipsec ipsec-tunnel bfd-designate
Description
This command specifies whether this IPsec tunnel is the BFD designated tunnel.
Default
no bfd-designate
Platforms
7705 SAR Gen 2
bfd-enable
bfd-enable
Syntax
[no] bfd-enable
Context
[Tree] (config>router>bgp>group>neighbor bfd-enable)
[Tree] (config>redundancy>multi-chassis>peer>mc-ep bfd-enable)
[Tree] (config>router>bgp>group bfd-enable)
[Tree] (config>router>bgp bfd-enable)
Full Context
configure router bgp group neighbor bfd-enable
configure redundancy multi-chassis peer mc-endpoint bfd-enable
configure router bgp group bfd-enable
configure router bgp 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
7705 SAR Gen 2
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>ipv6>vrrp bfd-enable)
[Tree] (config>service>ies>if>vrrp bfd-enable)
Full Context
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.
- 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
7705 SAR Gen 2
bfd-enable
Syntax
[no] bfd-enable
Context
[Tree] (config>service>vprn>static-route-entry>next-hop bfd-enable)
Full Context
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
7705 SAR Gen 2
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>ipv6>vrrp bfd-enable)
[Tree] (config>service>vprn>if>vrrp bfd-enable)
Full Context
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.
- 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
7705 SAR Gen 2
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 Context
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
7705 SAR Gen 2
bfd-enable
Syntax
bfd-enable [remain-down-on-failure]
bfd-enable [remain-down-on-failure] strict [strict-mode-holddown number]
no bfd-enable
Context
[Tree] (config>service>vprn>ospf3>area>if bfd-enable)
[Tree] (config>service>vprn>ospf>area>if bfd-enable)
Full Context
configure service vprn ospf3 area interface bfd-enable
configure service vprn ospf area interface bfd-enable
Description
This command configures Bidirectional Forwarding Detection (BFD) to control the state of the associated protocol interface. By enabling BFD on a 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 session 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
-
Keyword to force adjacency down on BFD failure.
- strict
-
Keyword to specify that the system uses BFD strict-mode, which requires that an active BFD session exists between the OSPF neighbors before establishing a full adjacency. When this keyword is configured, the router uses Link-Local Signaling (LLS) with the B-flag set to instruct OSPF neighbors that BFD must be enabled on the link. BFD strict-mode requires that both sides have the B-flag set.
During OSPFv3 BFD strict-mode operations, the router advertises the Local Interface IPv4 Address TLV using LLS, but the SR OS router continues to use IPv6-based BFD sessions for both the IPv4 and IPv6 address families.
- strict-mode-holddown number
-
Specifies a delay in bringing up the OSPF adjacency after the BFD session is established. Holddown helps mitigate potential routing churn when BFD sessions are unstable. The holddown timer is reset on an adjacency when a BFD session operationally toggles.
Platforms
7705 SAR Gen 2
bfd-enable
Syntax
[no] bfd-enable [ipv4 | ipv6]
Context
[Tree] (config>service>vprn>pim>if bfd-enable)
Full Context
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
7705 SAR Gen 2
bfd-enable
Syntax
[no] bfd-enable
Context
[Tree] (config>service>vprn>bgp>group>neighbor bfd-enable)
[Tree] (config>service>vprn>bgp>group bfd-enable)
[Tree] (config>service>vprn>bgp bfd-enable)
Full Context
configure service vprn bgp group neighbor bfd-enable
configure service vprn bgp group bfd-enable
configure service vprn bgp 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
7705 SAR Gen 2
bfd-enable
Syntax
[no] bfd-enable
Context
[Tree] (config>service>vprn>ripng>group>neighbor bfd-enable)
[Tree] (config>service>vprn>ripng>group bfd-enable)
[Tree] (config>service>vprn>ripng bfd-enable)
[Tree] (config>service>vprn>rip bfd-enable)
[Tree] (config>service>vprn>rip>group>neighbor bfd-enable)
[Tree] (config>service>vprn>rip>group bfd-enable)
Full Context
configure service vprn ripng group neighbor bfd-enable
configure service vprn ripng group bfd-enable
configure service vprn ripng bfd-enable
configure service vprn rip bfd-enable
configure service vprn rip group neighbor bfd-enable
configure service vprn rip group 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
7705 SAR Gen 2
bfd-enable
Syntax
bfd-enable [ipv4][ipv6]
no bfd-enable
Context
[Tree] (config>router>ldp>if-params>if bfd-enable)
Full Context
configure router ldp interface-parameters interface bfd-enable
Description
This command enables tracking of the Hello adjacency to an LDP peer using BFD.
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
7705 SAR Gen 2
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 Context
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
7705 SAR Gen 2
bfd-enable
Syntax
[no] bfd-enable
Context
[Tree] (config>router>rsvp>interface bfd-enable)
Full Context
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.
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
7705 SAR Gen 2
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>sap>ipsec-tunnel bfd-enable)
[Tree] (config>router>if>ipsec>ipsec-tunnel bfd-enable)
[Tree] (config>service>vprn>if>ipsec>ipsec-tunnel bfd-enable)
Full Context
configure service ies interface ipsec ipsec-tunnel bfd-enable
configure service vprn interface sap ipsec-tunnel bfd-enable
configure router interface ipsec ipsec-tunnel bfd-enable
configure service vprn interface ipsec 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
7705 SAR Gen 2
bfd-enable
Syntax
[no] bfd-enable
Context
[Tree] (config>redundancy>multi-chassis>peer>mc-ipsec bfd-enable)
Full Context
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
7705 SAR Gen 2
bfd-enable
Syntax
[no] bfd-enable [ipv4 | ipv6]
Context
[Tree] (config>router>pim>interface bfd-enable)
Full Context
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
7705 SAR Gen 2
bfd-enable
Syntax
[no] bfd-enable
Context
[Tree] (config>router>static-route-entry>next-hop bfd-enable)
Full Context
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
7705 SAR Gen 2
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 Context
configure router interface vrrp bfd-enable
configure router interface ipv6 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.
Platforms
7705 SAR Gen 2
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 Context
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
7705 SAR Gen 2
bfd-enable
Syntax
bfd-enable {ipv4 | ipv6} [include-bfd-tlv]
no bfd-enable {ipv4 | ipv6}
Context
[Tree] (config>router>isis>if bfd-enable)
Full Context
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
7705 SAR Gen 2
bfd-enable
Syntax
bfd-enable [remain-down-on-failure]
bfd-enable [remain-down-on-failure] strict [strict-mode-holddown number]
no bfd-enable
Context
[Tree] (config>router>ospf3>area>interface bfd-enable)
[Tree] (config>router>ospf>area>interface bfd-enable)
Full Context
configure router ospf3 area interface bfd-enable
configure router ospf area interface bfd-enable
Description
This command configures BFD to control the state of the associated protocol interface. By enabling BFD on a 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 session are set through 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
-
Keyword to specify that OSPF brings down the adjacency and waits on BFD again if the BFD session does not come back up within 10 seconds. 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.
- strict
-
Keyword to specify that the system uses BFD strict-mode, which requires that an active BFD session exists between the OSPF neighbors before establishing a full adjacency. When this keyword is configured, the router uses Link-Local Signaling (LLS) with the B-flag set to instruct OSPF neighbors that BFD must be enabled on the link. BFD strict-mode requires that both sides have the B-flag set.
During OSPFv3 BFD strict-mode operations, the router advertises the Local Interface IPv4 Address TLV using LLS, but the SR OS router continues to use IPv6-based BFD sessions for both the IPv4 and IPv6 address families.
- strict-mode-holddown number
-
Keyword to specify a delay in bringing up the OSPF adjacency after the BFD session is established. Holddown helps mitigate potential routing churn when BFD sessions are unstable. The holddown timer is reset on an adjacency when a BFD session operationally toggles.
Platforms
7705 SAR Gen 2
bfd-enable
Syntax
[no] bfd-enable
Context
[Tree] (config>router>rip>group bfd-enable)
[Tree] (config>router>ripng>group bfd-enable)
[Tree] (config>router>rip bfd-enable)
[Tree] (config>router>ripng>group>neighbor bfd-enable)
[Tree] (config>router>ripng bfd-enable)
[Tree] (config>router>rip>group>neighbor bfd-enable)
Full Context
configure router rip group bfd-enable
configure router ripng group bfd-enable
configure router rip bfd-enable
configure router ripng group neighbor bfd-enable
configure router ripng bfd-enable
configure router rip 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
7705 SAR Gen 2
bfd-enable
Syntax
[no] bfd-enable
Context
[Tree] (config>router>segment-routing>maintenance-policy bfd-enable)
Full Context
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
7705 SAR Gen 2
bfd-strict-mode
bfd-strict-mode
Syntax
bfd-strict-mode
Context
[Tree] (config>router>bgp bfd-strict-mode)
[Tree] (config>service>vprn>bgp>group>neighbor bfd-strict-mode)
[Tree] (config>router>bgp>group bfd-strict-mode)
[Tree] (config>router>bgp>group>neighbor bfd-strict-mode)
[Tree] (config>service>vprn>bgp bfd-strict-mode)
[Tree] (config>service>vprn>bgp>group bfd-strict-mode)
Full Context
configure router bgp bfd-strict-mode
configure service vprn bgp group neighbor bfd-strict-mode
configure router bgp group bfd-strict-mode
configure router bgp group neighbor bfd-strict-mode
configure service vprn bgp bfd-strict-mode
configure service vprn bgp group bfd-strict-mode
Description
Commands in this context configure the BFD Strict-Mode feature.
Platforms
7705 SAR Gen 2
bfd-template
bfd-template
Syntax
[no] bfd-template name
Context
[Tree] (config>router>bfd bfd-template)
Full Context
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
7705 SAR Gen 2
bfd-template
Syntax
bfd-template bfd-template
no bfd-template
Context
[Tree] (config>router>segment-routing>maintenance-policy bfd-template)
Full Context
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
7705 SAR Gen 2
bgp
bgp
Syntax
[no] bgp [bgp-instance]
Context
[Tree] (config>service>epipe bgp)
Full Context
configure service epipe bgp
Description
Commands in this context configure the BGP-related parameters BGP uses for multihoming and BGP VPWS.
The no form of this command removes this string from the configuration.
Default
bgp 1
Parameters
- bgp-instance
-
The BGP instance.
Platforms
7705 SAR Gen 2
bgp
Syntax
[no] bgp
Context
[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)
[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)
Full Context
configure service vprn bgp-evpn mpls auto-bind-tunnel resolution-filter bgp
configure service vprn bgp-ipvpn mpls auto-bind-tunnel resolution-filter bgp
configure service epipe bgp-evpn mpls auto-bind-tunnel resolution-filter bgp
configure service vpls bgp-evpn 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
7705 SAR Gen 2
bgp
Syntax
bgp bgp-instance
no bgp bgp-instance
Context
[Tree] (config>service>vpls bgp)
Full Context
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.
Platforms
7705 SAR Gen 2
bgp
Syntax
[no] bgp
Context
[Tree] (config>router bgp)
Full Context
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
7705 SAR Gen 2
bgp
Syntax
[no] bgp
Context
[Tree] (config>service>vprn bgp)
Full Context
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
7705 SAR Gen 2
bgp
Syntax
bgp [source src-Addr] [group grpAddr] [peer peerAddr]
no bgp
Context
[Tree] (debug>router>pim bgp)
Full Context
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.
- grp-Addr
-
Debugs BGP information associated with the specified group.
- PeerAddr
-
Debugs BGP information associated with the specified peer.
Platforms
7705 SAR Gen 2
bgp
Syntax
[no] bgp
Context
[Tree] (config>router>bgp>next-hop-resolution>labeled-routes>transport-tunnel>family>resolution-filter bgp)
[Tree] (config>router>bgp>next-hop-resolution>shortcut-tunn>family>resolution-filter bgp)
Full Context
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
7705 SAR Gen 2
bgp
Syntax
bgp
Context
[Tree] (config>service>vprn>auto-bind-tunnel>res-filter bgp)
Full Context
configure service vprn auto-bind-tunnel resolution-filter bgp
Description
Platforms
7705 SAR Gen 2
bgp-ad
bgp-ad
Syntax
[no] bgp-ad
Context
[Tree] (config>service>vpls bgp-ad)
Full Context
configure service vpls bgp-ad
Description
This command configures BGP auto-discovery.
Platforms
7705 SAR Gen 2
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 Context
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:
-
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.
-
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.
Platforms
7705 SAR Gen 2
bgp-evpn
bgp-evpn
Syntax
[no] bgp-evpn
Context
[Tree] (config>service>system bgp-evpn)
[Tree] (config>service>epipe bgp-evpn)
[Tree] (config>service>vpls bgp-evpn)
Full Context
configure service system bgp-evpn
configure service epipe bgp-evpn
configure service vpls bgp-evpn
Description
Commands in this context configure the BGP EVPN parameters in the base instance.
Platforms
7705 SAR Gen 2
bgp-evpn
Syntax
bgp-evpn
Context
[Tree] (config>service>vprn bgp-evpn)
Full Context
configure service vprn bgp-evpn
Description
Commands in this context configure the BGP EVPN parameters.
Platforms
7705 SAR Gen 2
bgp-high-priority
bgp-high-priority
Syntax
[no] bgp-high-priority
Context
[Tree] (config>router>policy-options>policy-statement>entry>action bgp-high-priority)
[Tree] (config>router>policy-options>policy-statement>default-action bgp-high-priority)
Full Context
configure router policy-options policy-statement entry action bgp-high-priority
configure router policy-options policy-statement default-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:
-
IPv4
-
label-IPv4
-
IPv6
-
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
7705 SAR Gen 2
bgp-ipvpn
bgp-ipvpn
Syntax
bgp-ipvpn
Context
[Tree] (config>service>vprn bgp-ipvpn)
Full Context
configure service vprn bgp-ipvpn
Description
Commands in this context configure the BGP IPVPN parameters.
Platforms
7705 SAR Gen 2
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 Context
configure router mpls-labels bgp-labels-hold-timer
Description
This command configures the time to delay before the label-forwarding entries programmed by BGP are removed from the datapath. A non-zero delay is useful in the following situations:
-
label-unicast route is readvertised by an ABR/ASBR operating in label-per-next-hop mode to choose a new primary path
-
IP VPN route is readvertised by an ABR/ASBR operating in label-per-next-hop mode to choose a new primary path
-
IP VPN best-external route is readvertised by a VPRN to choose a new backup path
-
IP VPN route is readvertised by a VPRN in label-per-next-hop mode to choose a new primary path
In the preceding situations, configure the hold timer to be large enough to account for the propagation delay of the route withdrawal to all ingress routers.
Default
bgp-labels-hold-timer 0
Parameters
- seconds
-
Specifies the time delay, in seconds.
Platforms
7705 SAR Gen 2
bgp-leak
bgp-leak
Syntax
[no] bgp-leak
Context
[Tree] (config>router>policy-options>policy-statement>entry>action bgp-leak)
[Tree] (config>router>policy-options>policy-statement>default-action bgp-leak)
Full Context
configure router policy-options policy-statement entry action bgp-leak
configure router policy-options policy-statement default-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.
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
7705 SAR Gen 2
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>entry>action bgp-med)
[Tree] (config>router>policy-options>policy-statement>default-action bgp-med)
Full Context
configure router policy-options policy-statement entry action bgp-med
configure router policy-options policy-statement default-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:
-
parentheses () to change the order of operations
-
mathematical operators: + (addition), - (subtraction) and * (multiplication)
-
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
-
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.
Platforms
7705 SAR Gen 2
bgp-multi-homing
bgp-multi-homing
Syntax
bgp-multi-homing
Context
[Tree] (config>redundancy bgp-multi-homing)
Full Context
configure redundancy bgp-multi-homing
Description
This command configures BGP multi-homing parameters.
Platforms
7705 SAR Gen 2
bgp-path-selection
bgp-path-selection
Syntax
[no] bgp-path-selection
Context
[Tree] (config>service>system>bgp-evpn>ad-per-evi-routes bgp-path-selection)
Full Context
configure service system bgp-evpn ad-per-evi-routes bgp-path-selection
Description
This command compares the received EVPN VPWS AD per-EVI routes based on BGP path attributes.
Attribute propagation must be configured before configuring this command.
The no form of this command disables the comparison of the routes.
Default
no bgp-path-selection
Platforms
7705 SAR Gen 2
bgp-path-selection
Syntax
bgp-path-selection [d-path-length-ignore]
no bgp-path-selection
Context
[Tree] (config>service>system>bgp-evpn>ip-prefix-routes>iff bgp-path-selection)
Full Context
configure service system bgp-evpn ip-prefix-routes interface-ful bgp-path-selection
Description
This command enables BGP path selection for EVPN-IFF (Interface-ful) routes.
Once the command is enabled, the EVPN-IFF routes are ordered and selected in a similar manner as IPVPN or EVPN-IFL routes, that is, based on the regular BGP path selection process.
The no form of this command causes the system to order EVPN-IFF routes based on their {R-VPLS Ifindex, RD, Ethernet Tag}. For example, if two EVPN-IFF routes with different Route Distinguishers (RDs) are received for the same prefix on the same R-VPLS, the route with the lowest RD is selected.
Default
no bgp-path-selection
Parameters
- d-path-length-ignore
-
Keyword used to make EVPN ignore the D-PATH length when iff-bgp-path-selection is enabled.
Platforms
7705 SAR Gen 2
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>ipv6-prefix-list>apply-path bgp-peers)
[Tree] (config>filter>match-list>ip-prefix-list>apply-path bgp-peers)
Full Context
configure filter match-list ipv6-prefix-list apply-path bgp-peers
configure filter match-list ip-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.
- 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
7705 SAR Gen 2
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 Context
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
7705 SAR Gen 2
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 Context
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
7705 SAR Gen 2
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 Context
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
7705 SAR Gen 2
bgp-tunnel
bgp-tunnel
Syntax
[no] bgp-tunnel
Context
[Tree] (config>service>sdp bgp-tunnel)
Full Context
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
7705 SAR Gen 2
bgp-tunnel-metric
bgp-tunnel-metric
Syntax
bgp-tunnel-metric [value] [prefer-med]
bgp-tunnel-metric [value] prefer-aigp
bgp-tunnel-metric [value] prefer-aigp prefer-med
bgp-tunnel-metric [value] [prefer-aigp]
no bgp-tunnel-metric
Context
[Tree] (config>router>bgp bgp-tunnel-metric)
Full Context
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 or the MED metric of the BGP-LU route, if the BGP-LU route has an AIGP or MED path attribute. Otherwise, the TTM metric is set to the number specified using the value parameter. BGP import policies override the configuration of this command.
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 the command configures the router to use the default value.
Default
no bgp-tunnel-metric
Parameters
- value
-
Specifies the BGP tunnel metric.
- prefer-aigp
-
Specifies that the TTM metric is based on the AIGP metric value of the BGP-LU route. When a BGP-LU route is selected for installation in TTM and 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 with the resolved cost to the BGP next hop of the route added to it. Otherwise, the metric is set to the value configured using the value parameter.
- prefer-med
-
Specifies that the TTM metric is based on the MED metric value of the BGP-LU route. When a BGP-LU route is selected for installation in TTM and 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 MED metric value of the BGP-LU route with the resolved cost to the BGP next hop of the route added to it. Otherwise, the metric is set to the value configured using the value parameter.
Note: prefer-aigp takes precedence over this parameter if the received BGP-LU has both attributes.
Platforms
7705 SAR Gen 2
bgp-tunnel-metric
Syntax
bgp-tunnel-metric [value | param-name] [prefer-aigp] [prefer-med]
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 Context
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 sets 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 or the MED metric of the BGP-LU route, if the BGP-LU route has an AIGP or MED path attribute. Otherwise, the TTM metric is set to the number specified using the value parameter.
The no form of this command configures the router to use the default value.
Default
no bgp-tunnel-metric
Parameters
- value
-
Specifies the BGP tunnel metric.
- param-name
-
Specifies the parameter name, up to 32 characters that starts and ends with an at-sign (@).
- prefer-aigp
-
Specifies that if a BGP-LU route is selected for installation in the TTM and is matched by this action in a BGP import policy, the TTM metric of the tunnel is set to the AIGP metric value of the BGP-LU route with the IGP cost to reach the BGP next hop added to it.
- prefer-med
- Specifies that if a BGP-LU route is selected for installation in the TTM and is matched by this action in a BGP import policy, the TTM metric of the tunnel is set to the MED metric value of the BGP-LU route with the IGP cost to reach the BGP next hop added to it.
Platforms
7705 SAR Gen 2
bgp-tunnel-preference
bgp-tunnel-preference
Syntax
bgp-tunnel-preference [preference]
no bgp-tunnel-preference
Context
[Tree] (config>router>bgp bgp-tunnel-preference)
Full Context
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.
Platforms
7705 SAR Gen 2
bgp-vpls
bgp-vpls
Syntax
bgp-vpls
Context
[Tree] (config>service>vpls bgp-vpls)
Full Context
configure service vpls bgp-vpls
Description
Commands in this context configure the BGP-VPLS parameters and addressing.
Platforms
7705 SAR Gen 2
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 Context
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.
Platforms
7705 SAR Gen 2
bgp-vpws
bgp-vpws
Syntax
[no] bgp-vpws
Context
[Tree] (config>service>epipe bgp-vpws)
Full Context
configure service epipe bgp-vpws
Description
Commands in this context configure BGP-VPWS parameters and addressing.
Default
no bgp-vpws
Platforms
7705 SAR Gen 2
bi
bi
Syntax
bi
Context
[Tree] (config>system>security>keychain>direction bi)
Full Context
configure system security keychain direction bi
Description
This command configures keys for both send and receive stream directions.
Platforms
7705 SAR Gen 2
bin
bin
Syntax
bin bin-number
Context
[Tree] (config>oam-pm>bin-group>bin-type bin)
Full Context
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.
Platforms
7705 SAR Gen 2
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 Context
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.
- fd-bin-count
-
Specifies the number of frame delay bins that are created.
- fdr-bin-count
-
Specifies the number of frame delay range bins that are created.
- ifdv-bin-count
-
Specifies the number of inter-frame delay variation bins that are created.
- create
-
Keyword that creates the bin group.
Platforms
7705 SAR Gen 2
bin-group
Syntax
bin-group bin-group-number
no bin-group
Context
[Tree] (config>oam-pm>session bin-group)
Full Context
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.
Platforms
7705 SAR Gen 2
bin-type
bin-type
Syntax
bin-type {fd | fdr | ifdv}
Context
[Tree] (config>oam-pm>bin-group bin-type)
Full Context
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
7705 SAR Gen 2
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 Context
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. LDAP Attributes lists the LDAP attributes.
The no version of this command removes the bind-authentication.
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
7705 SAR Gen 2
binding-label
binding-label
Syntax
binding-label label-number
no binding-label
Context
[Tree] (config>router>mpls>fwd-policies>fwd-policy binding-label)
Full Context
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.
Platforms
7705 SAR Gen 2
binding-operator
binding-operator
Syntax
binding-operator {and | or}
no binding-operator
Context
[Tree] (config>filter>redirect-policy-binding binding-operator)
Full Context
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
7705 SAR Gen 2
binding-sid
binding-sid
Syntax
binding-sid number
no binding-sid
Context
[Tree] (conf>router>segment-routing>sr-policies>policy binding-sid)
Full Context
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.
Platforms
7705 SAR Gen 2
binding-sid
Syntax
binding-sid label
no binding-sid
Context
[Tree] (config>router>mpls>lsp binding-sid)
Full Context
configure router mpls lsp binding-sid
Description
This command configures a binding SID label for the LSP. The label value must belong to the reserved label block that is configured with the configure router mpls lsp-bsid-block command.
The no form of this command unbinds the label, removes the ILM entry, and triggers the appropriate PCEP messages.
Parameters
- label
-
Specifies an MPLS label value from a specific reserved label block.
Platforms
7705 SAR Gen 2
binding-sid
Syntax
[no] binding-sid
Context
[Tree] (config>router>mpls>lsp-template binding-sid)
Full Context
configure router mpls lsp-template binding-sid
Description
This command configures the system to allocate and bind a label to any LSP that is created using the template.
The no form of this command removes the configuration but does not affect LSPs that were already created using the template.
Default
no binding-sid
Platforms
7705 SAR Gen 2
bindings
bindings
Syntax
[no] bindings
Context
[Tree] (debug>router>ldp>peer>event bindings)
Full Context
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
7705 SAR Gen 2
black-hole
black-hole
Syntax
[no] black-hole
Context
[Tree] (config>service>vprn>static-route-entry black-hole)
Full Context
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
7705 SAR Gen 2
black-hole
Syntax
[no] black-hole
Context
[Tree] (config>router>static-route-entry black-hole)
Full Context
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
7705 SAR Gen 2
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 Context
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:
-
Source-Identifier—black-hole
-
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
7705 SAR Gen 2
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 Context
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
7705 SAR Gen 2
blackhole-aggregate
Syntax
[no] blackhole-aggregate
Context
[Tree] (config>router>ospf>area blackhole-aggregate)
[Tree] (config>router>ospf3>area blackhole-aggregate)
Full Context
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
7705 SAR Gen 2
block-limit
block-limit
Syntax
block-limit [1..40]
no block-limit
Context
[Tree] (config>service>nat>nat-policy block-limit)
Full Context
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
7705 SAR Gen 2
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 Context
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
7705 SAR Gen 2
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 Context
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
7705 SAR Gen 2
block-on-peer-fault
Syntax
[no] block-on-peer-fault
Context
[Tree] (config>service>pw-template block-on-peer-fault)
Full Context
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
7705 SAR Gen 2
block-prefix-sid
block-prefix-sid
Syntax
[no] block-prefix-sid
Context
[Tree] (config>router>bgp>group>neighbor block-prefix-sid)
[Tree] (config>router>bgp block-prefix-sid)
[Tree] (config>router>bgp>group block-prefix-sid)
Full Context
configure router bgp group neighbor block-prefix-sid
configure router bgp block-prefix-sid
configure router bgp group 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
7705 SAR Gen 2
bof
bof
Syntax
bof
Context
[Tree] (bof)
Full Context
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
7705 SAR Gen 2
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 Context
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.
Platforms
7705 SAR Gen 2
booking-factor
Syntax
booking-factor percentage
no booking-factor
Context
[Tree] (config>service>sdp booking-factor)
Full Context
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.
Platforms
7705 SAR Gen 2
boot-bad-exec
boot-bad-exec
Syntax
boot-bad-exec file-url
no boot-bad-exec
Context
[Tree] (config>system boot-bad-exec)
Full Context
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.
Platforms
7705 SAR Gen 2
boot-file-param
boot-file-param
Syntax
boot-file-param hex-string
no boot-file-param
Context
[Tree] (config>subscr-mgmt>loc-user-db>ipoe>host>options6 boot-file-param)
Full Context
configure subscriber-mgmt local-user-db ipoe host options6 boot-file-param
Description
This command configures a hexadecimal string that contains the value for the concatenation of all param-len n and parameter n fields of DHCPv6 option BOOTFILE_PARAM (60).
The no form of this command removes the configured string.
Parameters
- hex-string
-
Specifies the hexadecimal format for this option, up to 254 hex nibbles.
Platforms
7705 SAR Gen 2
boot-file-url
boot-file-url
Syntax
boot-file-url ascii-string
no boot-file-url
Context
[Tree] (config>subscr-mgmt>loc-user-db>ipoe>host>options6 boot-file-url)
Full Context
configure subscriber-mgmt local-user-db ipoe host options6 boot-file-url
Description
This command configures an ASCII string that contains the value for the boot-file-url field in the DHCPv6 option BOOTFILE_URL (59).
The no form of this command removes the configuration.
Parameters
- ascii-string
-
Specifies the ASCII string, up to 127 characters.
Platforms
7705 SAR Gen 2
boot-good-exec
boot-good-exec
Syntax
boot-good-exec file-url
no boot-good-exec
Context
[Tree] (config>system boot-good-exec)
Full Context
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.
Platforms
7705 SAR Gen 2
boot-timer
boot-timer
Syntax
boot-timer interval
no boot-timer
Context
[Tree] (config>redundancy>multi-chassis>peer>mc-ep boot-timer)
Full Context
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.
Platforms
7705 SAR Gen 2
boot-timer
Syntax
boot-timer seconds
no boot-timer
Context
[Tree] (config>service>vpls>site boot-timer)
Full Context
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.
Platforms
7705 SAR Gen 2
boot-timer
Syntax
boot-timer seconds
no boot-timer
Context
[Tree] (config>service>epipe>site boot-timer)
Full Context
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.
Platforms
7705 SAR Gen 2
boot-timer
Syntax
boot-timer secs
no boot-timer
Context
[Tree] (config>service>pw-routing boot-timer)
Full Context
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.
Platforms
7705 SAR Gen 2
boot-timer
Syntax
boot-timer seconds
no boot-timer
Context
[Tree] (config>redundancy>bgp-multi-homing boot-timer)
Full Context
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.
Platforms
7705 SAR Gen 2
bootstrap-export
bootstrap-export
Syntax
bootstrap-export policy-name [policy-name]
no bootstrap-export
Context
[Tree] (config>service>vprn>pim>rp bootstrap-export)
Full Context
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
7705 SAR Gen 2
bootstrap-export
Syntax
bootstrap-export policy-name [policy-name]
no bootstrap-export
Context
[Tree] (config>router>pim>rp bootstrap-export)
Full Context
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
7705 SAR Gen 2
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 Context
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
7705 SAR Gen 2
bootstrap-import
Syntax
bootstrap-import policy-name [policy-name]
no bootstrap-import
Context
[Tree] (config>router>pim>rp bootstrap-import)
Full Context
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
7705 SAR Gen 2
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 Context
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
7705 SAR Gen 2
bpdu
bpdu
Syntax
[no] bpdu
Context
[Tree] (debug>service>id>stp bpdu)
Full Context
debug service id stp bpdu
Description
This command enables STP debugging for received and transmitted BPDUs.
Platforms
7705 SAR Gen 2
bpdu
Syntax
[no] bpdu
Context
[Tree] (debug>service>id>stp bpdu)
Full Context
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
7705 SAR Gen 2
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 Context
configure service vpls spoke-sdp bpdu-translation
configure service vpls sap 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:
-
BPDU sent on egress of dot1q SAP will contain the VLAN ID of the SAP in BPDU-PVID TLV
-
BPDU sent on egress of default QinQ SAP will contain the outer VLAN ID of the SAP in BPDU-PVID TLV
-
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:
-
BPDU sent on egress of dot1q SAP will contain the VLAN ID of the SAP in BPDU-PVID TLV
-
BPDU sent on egress of default QinQ SAP will contain the outer VLAN ID of the SAP in BPDU-PVID TLV
-
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
7705 SAR Gen 2
breakout
breakout
Syntax
breakout breakout
no breakout
Context
[Tree] (config>port>connector breakout)
Full Context
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 more information.
For some connectors (such as QSFPDD), there can be overlap in the breakout for different host interfaces. The same port breakout can be supported on an optical module that uses a host interface of CAUI-4 as another optical module that uses 100GAUI-2. To distinguish from the CAUI-4 host interface, the "-aui2" suffix is used on some breakout options. This is only necessary where there is overlap. In other situations, SR OS sets the host interface correctly without requiring the distinction in the breakout option.
The no form of this command removes the ports under the connector.
Default
no breakout
Parameters
- breakout
-
Specifies the breakout type.
Platforms
7705 SAR Gen 2
broadcast
broadcast
Syntax
broadcast {interface ip-int-name} [key-id key-id | authentication-keychain keychain-name] [version version] [ttl ttl]
no broadcast {interface ip-int-name}
Context
[Tree] (config>service>vprn>ntp broadcast)
Full Context
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, therefore, 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 (#, ?, space), the entire string must be enclosed between 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 is rejected and an event/trap generated.
- keychain-name
-
Identifies the keychain name, up to 32 characters.
- 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 are accepted.
- ttl
-
Specifies the IP Time To Live (TTL) value.
Platforms
7705 SAR Gen 2
broadcast
Syntax
broadcast [router router-name] {interface ip-int-name} [key-id key-id | authentication-keychain keychain-name] [version version] [ttl ttl]
no broadcast [router router-name] {interface ip-int-name}
Context
[Tree] (config>system>time>ntp broadcast)
Full Context
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, therefore, 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 7705 SAR Gen 2 Layer 3 Services Guide: IES and VPRN for more information.
- ip-int-name
-
Specifies the local interface on which to transmit NTP broadcast packets, up to 32 characters. If the string contains special characters (#, ?, space), 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 is rejected and an event or trap generated.
- keychain-name
-
Identifies the keychain name, up to 32 characters.
- 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 are accepted.
- ttl
-
Specifies the IP Time To Live (TTL) value.
Platforms
7705 SAR Gen 2
broadcast-client
broadcast-client
Syntax
[no] broadcast-client
Context
[Tree] (config>system>time>sntp broadcast-client)
Full Context
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
7705 SAR Gen 2
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 Context
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.
- fp-redirect-group
-
Redirects a forwarding class to a forwarding plane queue-group as specified in a SAP QoS policy.
Platforms
7705 SAR Gen 2
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 Context
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.
- 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
7705 SAR Gen 2
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 Context
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.
- 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
7705 SAR Gen 2
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 Context
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
7705 SAR Gen 2
bsm-check-rtr-alert
Syntax
[no] bsm-check-rtr-alert
Context
[Tree] (config>router>pim>interface bsm-check-rtr-alert)
Full Context
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
7705 SAR Gen 2
bsr
bsr
Syntax
bsr [detail]
no bsr
Context
[Tree] (debug>router>pim bsr)
Full Context
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
7705 SAR Gen 2
bsr-candidate
bsr-candidate
Syntax
bsr-candidate
Context
[Tree] (config>service>vprn>pim>rp>ipv6 bsr-candidate)
[Tree] (config>service>vprn>pim>rp bsr-candidate)
Full Context
configure service vprn pim rp ipv6 bsr-candidate
configure service vprn pim rp 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
7705 SAR Gen 2
bsr-candidate
Syntax
bsr-candidate
Context
[Tree] (config>router>pim>rp>ipv6 bsr-candidate)
[Tree] (config>router>pim>rp bsr-candidate)
Full Context
configure router pim rp ipv6 bsr-candidate
configure router pim rp 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
7705 SAR Gen 2
buffer-unresolved-packets
buffer-unresolved-packets
Syntax
[no] buffer-unresolved-packets
Context
[Tree] (config>system>ip buffer-unresolved-packets)
Full Context
configure system ip buffer-unresolved-packets
Description
This command configures the buffering of unresolved IPv4 and IPv6 packets waiting for an address resolution process (ARP) or neighbor discovery (ND) reply.
The no form of this command configures the system to discard IPv4 and IPv6 traffic needing a destination resolution that is buffered while waiting for a response to avoid any potential of out-of-order delivery of packets to the resolved destination. As a result, after the ARP or ND entry is populated, the system delivers only newly received packets in order.
Default
buffer-unresolved-packets
Platforms
7705 SAR Gen 2
bundle
bundle
Syntax
bundle [detail]
no bundle
Context
[Tree] (debug>router>rsvp>packet bundle)
Full Context
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
7705 SAR Gen 2
burst-limit
burst-limit
Syntax
burst-limit {default | size [bytes | kilobytes]}
no burst-limit
Context
[Tree] (config>service>vprn>if>sap>egress>queue-override>queue burst-limit)
Full Context
configure service vprn 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 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 burst limit is controlled by its defining policy.
Default
no burst-limit
Parameters
- default
-
Reverts the queues 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.
- 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
7705 SAR Gen 2
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 Context
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.
- 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
7705 SAR Gen 2
burst-limit
Syntax
burst-limit size [bytes | kilobytes]
no burst-limit
Context
[Tree] (config>service>epipe>sap>egress>queue-override>queue burst-limit)
Full Context
configure service epipe 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.
- 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
7705 SAR Gen 2
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 Context
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.
- 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
7705 SAR Gen 2
burst-limit
Syntax
burst-limit {default | size [bytes | kilobytes]}
no burst-limit
Context
[Tree] (config>service>ies>if>sap>egress>queue-override>queue burst-limit)
Full Context
configure service ies 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 queues 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 queues 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.
- 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
7705 SAR Gen 2
burst-limit
Syntax
burst-limit size [bytes | kilobytes]
no burst-limit
Context
[Tree] (config>qos>sap-ingress>queue burst-limit)
Full Context
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.
- 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
7705 SAR Gen 2
burst-limit
Syntax
burst-limit {default | size [bytes | kilobytes]}
burst-limit delay-time microseconds
no burst-limit
Context
[Tree] (config>qos>sap-egress>queue burst-limit)
Full Context
configure qos sap-egress queue burst-limit
Description
The queue burst-limit command configures 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 delay-time command option configures the burst time as a function of the expected delay. The system automatically translates this configuration into kilobytes based on the administrative rate of the queue parent (for example, the port, scheduler, or aggregate-shaper).
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.
Default
no burst-limit
Parameters
- default
-
Reverts the burst limit of the queue 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.
- bytes
-
Specifies that the configured size value must be interpreted as the burst limit in bytes.
- kilobytes
-
Specifies that the configure size value must be interpreted as the burst limit in kilobytes. If neither bytes nor kilobytes is specified, the default qualifier is kilobytes.
- microseconds
-
Specifies the burst limit as a function of delay time.
Platforms
7705 SAR Gen 2
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 Context
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.
- 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
7705 SAR Gen 2
bypass-resignal-timer
bypass-resignal-timer
Syntax
bypass-resignal-timer minutes
no bypass-resignal-timer
Context
[Tree] (config>router>mpls bypass-resignal-timer)
Full Context
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.
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.
Platforms
7705 SAR Gen 2