4.6. SLR Configuration Command Reference

4.6.1. Command Hierarchies

4.6.1.1. MPLS SLR Forwarding Policy Commands

config
— router
— mpls
[no] forwarding-policy name
binding-label label-number
[no] shutdown
next-hop-group index [resolution-type {direct | indirect}]
— no next-hop-group index
[no] backup-next-hop
next-hop ip-address
— no next-hop
next-hop ip-address
— no next-hop
[no] shutdown
preference preference-value
— no preference
revert-timer seconds
— no revert-timer
[no] shutdown
[no] shutdown

4.6.2. Command Descriptions

4.6.2.1. MPLS SLR Forwarding Policy Commands

forwarding-policies

Syntax 
[no] forwarding-policies
Context 
config>router>mpls
Description 

This command creates a context to configure an MPLS forwarding policy.

The no form of this command deletes all policies from the forwarding policy database.

forwarding-policy

Syntax 
[no] forwarding-policy name
Context 
config>router>mpls>forwarding-policies
Description 

This command command creates an MPLS forwarding policy. The policy associates an incoming label, referred to as a binding label, to a Next-Hop Group (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 MPLS forwarding policy supports two types of NHGs on a per policy basis:

  1. An NHG of resolution type indirect in which the primary or backup next-hop is modeled as a swap operation from the binding label to an implicit-null label over multiple outgoing interfaces (multiple NHLFEs) corresponding to the resolved next-hops of the indirect route.
    The forwarding database tracks the primary or backup next-hop in the routing table. A route delete of the primary indirect next-hop causes CPM to program the backup indirect next-hop in data path.
    A route modify to the indirect primary or backup next-hop causes CPM to update the its resolved next-hops and to update the data path if it is the active indirect next-hop.
    When the primary indirect next-hop is restored and is added back into the routing table, CPM waits for an amount of time equal to the user programmed revert-timer before updating the data path. However, if the backup indirect next-hop fails while the timer is running, CPM updates the data path immediately.
  2. An NHG of resolution type direct in which the primary or backup next-hop is modeled as a swap operation from the binding label to an implicit-null label over a single outgoing interface (single NHLFE) to the next-hop.
    The forwarding database tracks the primary or backup next-hop in the routing table. A route delete of the primary direct next-hop causes CPM to send a PG-ID switch to the data path.
    A route modify to the direct primary or backup next-hop causes CPM to update the MPLS forwarding database and to update the data path since both next-hops are programmed.
    When the primary direct next-hop is restored and is added back into the routing table, CPM waits for an amount of time equal to the user programmed revert-timer before activating it and updating the data path. However, if the backup direct next-hop fails while the timer is running, CPM activates it and updates the data path immediately.

The forwarding policy database activates the best label-binding policy among the named policies sharing the same binding label by selecting the lowest, preference value policy. This policy is then programmed into the label FIB table in data path.

Ingress statistics can be enabled as is associated with binding label, that is the ILM of the forwarding policy, and provides aggregate packet and byte counters for packets matching the binding label.

The no form of the command deletes the named MPLS forwarding policy.

Parameters 
name—
Specifies the name of the MPLS forwarding policy, up to 64 characters.

binding-label

Syntax 
binding-label label-number
no binding-label
Context 
config>router>mpls>forwarding-policies>forwarding-policy
Description 

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

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

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

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

 

ingress-statistics

Syntax 
[no] ingress-statistics
Context 
config>router>mpls>forwarding-policies>forwarding-policy
Description 

This command configures Ingress statistics in an MPLS forwarding policy.

The ingress statistics are associated with binding label, that is the ILM of the forwarding policy, and provides aggregate packet and byte counters for packets matching the binding label.

The no form of this command removes the statistics from the MPLS forwarding policy.

shutdown

Syntax 
[no] shutdown
Context 
config>router>mpls>forwarding-policies>forwarding-policy>ingress-statistics
Description 

This command shuts down the ingress statistics in a forwarding policy.

The no form of this command enables ingress statistics in a forwarding policy.

next-hop-group

Syntax 
next-hop-group index [resolution-type {direct | indirect}]
no next-hop-group index
Context 
config>router>mpls>forwarding-policies>forwarding-policy
Description 

This command configures an NHG entry in an MPLS forwarding policy.

Each NHG can have primary and backup next-hops of the same type.

The no form of this command removes the NHG from the MPLS forwarding policy.

Parameters 
index—
Specifies the index value.
Values—
1 to 32

 

resolution-type direct
Specifies the direct resolution type.
resolution-type indirect
Specifies the indirect resolution type.

backup-next-hop

Syntax 
[no] backup-next-hop
Context 
config>router>mpls>forwarding-policies>forwarding-policy>next-hop-group
Description 

This command configures the context for 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.

next-hop

Syntax 
next-hop ip-address
no next-hop
Context 
config>router>mpls>forwarding-policies>forwarding-policy>next-hop-group>backup-next-hop
config>router>mpls>forwarding-policies>forwarding-policy>next-hop-group>primary-next-hop
Description 

This command configures the address of primary or backup next-hop of an NHG entry in a forwarding policy.

The no form of this command removes the address of primary or backup next-hop of an NHG entry in a forwarding policy.

Parameters 
ip-address—
Specifies the destination IPv4 or IPv6 address.
Values—

<ip-address>

ipv4-address

a.b.c.d

ipv6-address

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

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

x - [0..FFFF]H

d - [0..255]D

 

primary-next-hop

Syntax 
[no] primary-next-hop
Context 
config>router>mpls>forwarding-policies>forwarding-policy>next-hop-group
Description 

This command configures the context for the primary next-hop of an NHG entry in a forwarding policy.

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

shutdown

Syntax 
[no] shutdown
Context 
config>router>mpls>forwarding-policies>forwarding-policy>next-hop-group
Description 

This command shuts down an NHG entry in a forwarding policy.

When an NHG is shut down, it is deprogrammed in the data path entry of the forwarding policy.

The no form of this command brings up an NHG entry in a forwarding policy.

preference

Syntax 
preference preference-value
no preference
Context 
config>router>mpls>forwarding-policies>forwarding-policy
Description 

This command configures the preference of an MPLS forwarding policy.

The preference-value parameter allows the user to configure multiple forwarding policies with the same binding label. This provides the capability to achieve a 1:N backup strategy for the forwarding policy. Only the most preferred, lowest numerical preference-value policy, is activated in data path.

The no form of this command removes the preference parameter from the MPLS forwarding policy.

Parameters 
preference-value—
Specifies the preference value.
Values—
1 to 255

 

revert-timer

Syntax 
revert-timer seconds
no revert-timer
Context 
config>router>mpls>forwarding-policies>forwarding-policy
Description 

This command configures the revert timer in an MPLS forwarding policy.

When the primary direct or indirect next-hop is restored and is added back into the routing table, CPM waits for an amount of time equal to the user-programmed revert-timer before activating it and updating the data path. However, if the backup direct or indirect next-hop fails while the timer is running, CPM activates it and updates the data path immediately.

The no form of this command removes the revert timer from the MPLS forwarding policy.

Default 

revert-timer 0— Disables the revert timer; meaning the policy reverts immediately.

Parameters 
seconds—
Specifies the revert-timer value, in number of seconds.
Values—
1 to 600

 

shutdown

Syntax 
[no] shutdown
Context 
config>router>mpls>forwarding-policies>forwarding-policy
Description 

This command shuts down forwarding policy.

The no form of this command enables the forwarding policy.

reserved-label-block

Syntax 
reserved-label-block name
no reserved-label-block
Context 
config>router>mpls>forwarding-policies
Description 

This command specifies the reserved label block to use for all MPLS forwarding policies. The named reserved label block must already have been configured under configure>router>mpls>mpls-labels.

The no form of the command removes the assignment of the reserved label block.

Parameters 
name—
Specifies the name of the reserved label block, up to 64 characters.

shutdown

Syntax 
[no] shutdown
Context 
config>router>mpls>forwarding-policies
Description 

This command shuts down the forwarding-policies context; causing all forwarding policies to be de-programmed from the data path but they remain in the MPLS forwarding database.

The no form of this command enables the forwarding-policies context.