4.8. SLR Configuration Command Reference

4.8.1. Command Hierarchies

4.8.1.1. MPLS SLR Forwarding Policy Commands

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

4.8.2. Command Descriptions

4.8.2.1. MPLS SLR Forwarding Policy Commands

forwarding-policies

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

This command enters the 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>fwd-policies
Description 

This command creates an MPLS forwarding policy.

There are two types of MPLS forwarding policy:

  1. endpoint policy
  2. label-binding policy

The endpoint policy allows the user to forward unlabeled packets over a set of user-defined direct (with option to push a label stack) or indirect next hops. Routes are bound to an endpoint policy when their next hop matches the endpoint address of the policy.

The label-binding policy provides the same capability for labeled packets. In this case, labeled packets matching the ILM of the policy binding label are forwarded over the set of next hops of the policy.

The data model of a forwarding policy represents each pair of {primary next hop, backup next hop} as a group and models the ECMP set as the set of Next-Hop Groups (NHGs). Flows of prefixes can be switched on a per-NHG basis from the primary next hop, when it fails, to the backup next hop without disturbing the flows forwarded over the other NHGs of the policy. The same can be performed when reverting back from a backup next hop to the restored primary next hop of the same NHG.

The MPLS forwarding policy supports two types of NHGs on a per policy basis:

  1. An NHG of resolution type indirect supported with the label-binding policy and in which forwarding over the primary/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.
    Within a given NHG, the primary next hop is the preferred active path in the absence of any failure of the NHG of resolution type indirect.
    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 the 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 is modeled as follows:
    1. For a label-binding policy, forwarding over the primary or backup next hop is modeled as a swap operation from the binding label to the configured label stack or to an implicit-null label (if the pushed-labels command not configured) over a single outgoing interface to the next hop.
    2. For an endpoint policy, forwarding over the primary or backup next hop is modeled as a push operation from the binding label to the configured label stack or to an implicit-null label (if the pushed-labels command not configured) over a single outgoing interface to the next hop.
    3. The labels configured by the pushed-labels command are not validated.
    Within a given NHG, the primary next hop is the preferred active path in the absence of any failure of the NHG of resolution type direct.
    The NHG supports uniform failover. The forwarding policy database assigns a Protect-Group ID (PG-ID) to each of the primary next hop and the backup next hop and programs both of them in data path. A failure of the active path switches traffic to the other path following the uniform failover procedures.
    The forwarding database tracks the primary or backup next hop in the routing table. A route delete of the primary/backup direct next hop causes CPM to send the corresponding 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 latter failover to the restored primary next hop is performed using the uniform failover procedure.

The forwarding policy database activates the best endpoint policy among the named policies sharing the same value of the endpoint parameter by selecting the lowest preference value policy. This policy is then programmed into the TTM and into the tunnel table in data path. If this policy goes down, then the forwarding policy database performs a re-evaluation and activates the named policy with the next lowest preference value for the same endpoint value. If a more preferred policy comes back up, the forwarding policy database reverts to it and activates it.

The forwarding policy database similarly 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. If this policy goes down, then the forwarding policy database performs a re-evaluation and activates the names policy with the next lowest preference value for the same binding label value. If a more preferred policy comes back up, the forwarding policy database reverts to it and activates it.

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>fwd-policies>fwd-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

 

endpoint

Syntax 
endpoint ip-address
no endpoint
Context 
config>router>mpls>fwd-policies>fwd-policy
Description 

This command configures the endpoint address for an MPLS forwarding policy.

The policy allows the user to forward unlabeled packets over a set of user-defined direct (with option to push a label stack) or indirect next hops. Routes are bound to an endpoint policy when their next hop matches the endpoint address of the policy.

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

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

ipv4-address

a.b.c.d

ipv6-address

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

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

x - [0..FFFF]H

d - [0..255]D

 

ingress-statistics

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

This command configures ingress statistics in an MPLS forwarding policy.

The ingress statistics are associated with a 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>fwd-policies>fwd-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.

metric

Syntax 
metric metric
no metric
Context 
config>router>mpls>fwd-policies>fwd-policy
Description 

This command configures the metric of an MPLS forwarding policy.

The metric parameter is supported with the endpoint policy only and is inherited by the routes which resolve their next hop to this policy.

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

Parameters 
metric—
Specifies the metric value.
Values—
1 to 16777215

 

next-hop-group

Syntax 
next-hop-group index [resolution-type {direct | indirect}]
no next-hop-group index
Context 
config>router>mpls>fwd-policies>fwd-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

 

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

backup-next-hop

Syntax 
[no] backup-next-hop
Context 
config>router>mpls>fwd-policies>fwd-policy>nh-grp
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>fwd-policies>fwd-policy>nh-grp>bkup
config>router>mpls>fwd-policies>fwd-policy>nh-grp>pri
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—

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

 

pushed-labels

Syntax 
pushed-labels label [label]
no pushed-labels
Context 
config>router>mpls>fwd-policies>fwd-policy>nh-grp>bkup
config>router>mpls>fwd-policies>fwd-policy>nh-grp>pri
Description 

This command configures the pushed label stack for the primary or backup next hop of a next-hop group of an MPLS forwarding policy.

The no form of this command removes the pushed label stack.

Parameters 
label—
Specifies the label value; up to a maximum of 10 labels.
Values—
0 to 1048575

 

load-balancing-weight

Syntax 
load-balancing-weight weight
no load-balancing-weight
Context 
config>router>mpls>fwd-policies>fwd-policy>nh-grp
Description 

This command configures the load balancing weight of an NHG entry in a forwarding policy.

A weight for each NHG of a policy must be assigned to the weighted ECMP forwarding to operate over the set of NHGs of the policy.

The no form of this command removes the load balancing weight from an NHG entry in a forwarding policy.

Parameters 
weight—
Specifies the load balancing weight value.
Values—
1 to 4294967295

 

primary-next-hop

Syntax 
[no] primary-next-hop
Context 
config>router>mpls>fwd-policies>fwd-policy>nh-grp
Description 

This command enters 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>fwd-policies>fwd-policy>nh-grp
Description 

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

When an NHG is shut down, it is removed from 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>fwd-policies>fwd-policy
Description 

This command configures the preference of an MPLS forwarding policy.

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

Default 

preference 255

Parameters 
preference-value—
Specifies the preference value.

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

Values—
1 to 255

 

revert-timer

Syntax 
revert-timer seconds
no revert-timer
Context 
config>router>mpls>fwd-policies>fwd-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.

A value of 0 disables the revert timer; meaning the policy reverts immediately.

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

Default 

revert-timer 0

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

 

shutdown

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

This command shuts down the forwarding policy.

The no form of this command enables the forwarding policy.

tunnel-table-pref

Syntax 
tunnel-table-pref preference-value
no tunnel-table-pref
Context 
config>router>mpls>fwd-policies>fwd-policy
Description 

This command configures the TTM preference value of an MPLS forwarding policy.

The preference-value parameter is used by applications to select one tunnel type to bind to in TTM when multiple tunnel types are enabled for the application.

If an active forwarding policy preference has the same value as another tunnel type for the same destination in TTM, then routes and services which are bound to both types of tunnels will use the default TTM preference for the two tunnel types to select the tunnel to bind to.

The no form of this command removes the configured TTM preference parameter value of the MPLS forwarding policy and assigns the default value.

Default 

tunnel-table-pref 255

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

 

reserved-label-block

Syntax 
reserved-label-block name
no reserved-label-block
Context 
config>router>mpls>fwd-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-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>fwd-policies
Description 

This command shuts down the forwarding-policies context; causing all forwarding policies to be removed from the data path, however they remain in the MPLS forwarding database.

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