Route next-hop policy commands

route-next-hop-policy

Syntax

route-next-hop-policy

Context

config>router

Platforms

7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C

Description

Commands in this context configure route next-hop policies.

abort

Syntax

abort

Context

config>router>route-next-hop-policy

Platforms

7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C

Description

This command discards the changes that have been made to route next-hop templates during the current session.

begin

Syntax

begin

Context

config>router>route-next-hop-policy

Platforms

7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C

Description

This command enables the editing mode for route next-hop templates. Use the commit command to save edits made during the current session. Use the abort command to discard edits made during the current session.

commit

Syntax

commit

Context

config>router>route-next-hop-policy

Platforms

7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C

Description

This command saves the changes that have been made to route next-hop templates during the current session.

template

Syntax

[no] template-name name

Context

config>router>route-next-hop-policy

Platforms

7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C

Description

This command creates a template to configure the attributes of a Loop-Free Alternate (LFA) Shortest Path First (SPF) policy. An LFA SPF policy allows the user to apply specific criteria, such as admin group and SRLG constraints, to the selection of an LFA backup next-hop for a subset of prefixes which resolve to a specific primary next-hop.

First, the user creates a route next-hop policy template under the global router context and then applies it to a specific OSPF or ISIS interface in the global routing instance.

A policy template can be used in both IS-IS and OSPF to apply the specific criteria to prefixes protected by LFA. Each instance of IS-IS or OSPF can apply the same policy template to one or more interfaces.

The commands within the route next-hop policy template use the begin-commit-abort model. The following are the steps needed to create and modify the template.

  1. To create a template, the user enters the name of the new template directly under the route-next-hop-policy context.

  2. To delete a template which is not in use, the user enters the no form for the template name under the route-next-hop-policy context.

  3. The user enters the editing mode by executing the begin command under the route-next-hop-policy context. The user can then edit and change any number of route next-hop policy templates. However, the parameter value is still stored temporarily in the template module until the commit command is executed under the route-next-hop-policy context. Any temporary parameter changes are lost if the user enters the abort command before the commit command.

  4. The user is allowed to create or delete a template instantly when in the editing mode without the need to enter the commit command. Also, if the abort command is executed, it has no effect on the prior deletion or creation of a template.

After the commit command is executed, IS-IS or OSPF reevaluates the templates. If there are any net changes, IS-IS or OSPF schedule a new LFA SPF to recompute the LFA next-hop for the prefixes associated with these templates.

The no form of this command deletes a template.

Parameters

template-name

Specifies the name of the template, up to 32 characters.

description

Syntax

description description-string

no description

Context

config>router>route-next-hop-policy>template

Platforms

7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C

Description

This command configures the description of the next-hop template.

Parameters

description-string

Specifies the description of the next-hop template. 80 characters maximum.

exclude-group

Syntax

[no] exclude-group ip-admin-group-name

Context

config>router>route-next-hop-policy>template

Platforms

7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C

Description

This command prunes all links belonging to the specified admin group before making the LFA backup next-hop selection for a prefix.

If the same group name is part of both include-group and exclude-group configurations, the exclude-group configuration takes precedence. It other words, the exclude-group statement can be viewed as having an implicit preference value of 0.

Note:

The admin group criteria are applied before running the LFA next-hop selection algorithm.

The no form of this command deletes the admin group exclusion constraint from the route next-hop policy template.

Parameters

ip-admin-group-namec d

Specifies the name of the admin group to be excluded, up to 32 characters.

include-group

Syntax

include-group ip-admin-group-name [pref preferences]

no include-group ip-admin-group-name

Context

config>router>route-next-hop-policy>template

Platforms

7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C

Description

This command instructs the LFA SPF selection algorithm to pick up a subset of LFA next-hops among the links which belong to one or more of the specified admin groups. A link which does not belong to at least one of the admin groups is excluded. However, a link can still be selected if it belongs to one of the groups in an include-group configuration but also belongs to other groups which are not part of any include-group configuration in the route next-hop policy.

The pref option is used to provide a relative preference for the admin group to select. A lower preference value means that LFA SPF will first attempt to select an LFA backup next-hop which is a member of the corresponding admin group. If none is found, then the admin group with the next higher preference value is evaluated. If no preference is configured for a specific admin group name, then it is supposed to be the least preferred, or numerically the highest preference value.

When evaluating multiple include-group configurations within the same preference, any link which belongs to one or more of the included admin groups can be selected as an LFA next-hop. There is no relative preference based on how many of those included admin groups the link is a member of.

If the same group name is part of both include-group and exclude-group configurations, the exclude-group configuration takes precedence. It other words, the exclude-group statement can be viewed as having an implicit preference value of 0.

Note:

The admin group criteria are applied before running the LFA next-hop selection algorithm.

The no form deletes the admin group constraint from the route next-hop policy template.

Parameters

ip-admin-group-name

Specifies the name of the admin group to be included, up to 32 characters.

preferences

Specifies the relative preference of a group, with 1 corresponding to the highest preference and 255 corresponding to the lowest preference.

Values

1 to 255

nh-type

Syntax

nh-type {ip | tunnel}

no nh-type

Context

config>router>route-next-hop-policy>template

Platforms

7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C

Description

This command configures the next-hop type for the route next-hop policy template.

The user can select IP backup next-hop is preferred.

When the route next-hop policy template is applied to an IP interface, all prefixes using this interface as a primary next-hop follow the next-hop type preference specified in the template.

The no form deletes the next-hop type constraint from the route next-hop policy template.

Default

ip

Parameters

{ip | tunnel}

Specifies the two possible values for the next-hop type.

protection-type

Syntax

protection-type {link | node}

no protection-type

Context

config>router>route-next-hop-policy>template

Platforms

7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C

Description

This command configures the protection type for the route next-hop policy template.

The user can select if link protection or node protection is preferred in the selection of a LFA next-hop for all IP prefixes and LDP FEC prefixes to which a route next-hop policy template is applied. The default in SR OS implementation is node protection. The implementation falls back to the other type if no LFA next-hop of the preferred type is found.

When the route next-hop policy template is applied to an IP interface, all prefixes using this interface as a primary next-hop follow the protection type preference specified in the template.

The no form deletes the protection type constraint from the route next-hop policy template.

Parameters

link

Specifies that link protection is preferred.

node

Specifies that node protection is preferred.

srlg-enable

Syntax

[no] srlg-enable

Context

config>router>route-next-hop-policy>template

Platforms

7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C

Description

This command configures the SRLG constraint for the route next-hop policy template.

When this command is applied to a prefix, the LFA SPF attempts to select an LFA next-hop from the computed ones, which uses an outgoing interface that does not participate in any of the SLRGs of the outgoing interface used by the primary next-hop.

Note:

The SRLG criterion is applied before running the LFA next-hop selection algorithm.

The no form of this command deletes the SRLG constraint from the route next-hop policy template.