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.
This command creates an MPLS forwarding policy.
There are two types of MPLS forwarding 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:
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.
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.
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.
| 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 |
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.
This command shuts down the ingress statistics in a forwarding policy.
The no form of this command enables ingress statistics in a forwarding policy.
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.
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.
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.
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.
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 |
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.
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.
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.
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.
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.
preference 255
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.
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.
revert-timer 0
This command shuts down the forwarding policy.
The no form of this command enables the forwarding policy.
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.
tunnel-table-pref 255
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.
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.