Generic commands

isis

Syntax

isis [isis-instance]

no isis [isis-instance]

Context

config>router

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

Commands in this context configure the Intermediate-System-to-Intermediate-System (IS-IS) protocol instance.

The IS-IS protocol instance is enabled with the no shutdown command in the config>router>isis context. Alternatively, the IS-IS protocol instance is disabled with the shutdown command in the config>router>isis context.

The no form of this command deletes the IS-IS protocol instance. Deleting the protocol instance removes all configuration parameters for this IS-IS instance.

Note:

The number of IS-IS instances supported on different 7210 platforms are different. Contact a Nokia representative about the supported scaling limits.

Parameters

isis-instance

Specifies the IS-IS instance.

Values

0 to 31

Default

0

shutdown

Syntax

[no] shutdown

Context

config>router>isis

config>router>isis>interface

config>router>isis>if>level

config>router>isis>segment-routing

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

Note:

The config>router>isis>segment-routing context is supported only on the 7210 SAS-Mxp, 7210 SAS-R6, 7210 SAS-R12, and 7210 SAS-Sx/S 1/10GE.

This command administratively disables an entity. When disabled, an entity does not change, reset, or remove any configuration settings or statistics.

The operational state of the entity is disabled as well as the operational state of any entities contained within. Many objects must be shut down before they may be deleted.

The no form of this command administratively enables an entity.

Default

no shutdown

Special Cases

IS-IS Global

In the config>router>isis context, the shutdown command disables the IS-IS protocol instance. By default, the protocol is enabled (no shutdown).

IS-IS Protocol Handling

On all 7210 SAS platforms, IS-IS is created in the no shutdown state.

On the 7210 SAS-Mxp, the protocol is handled as follows.

  • The config>router>isis command instantiates the protocol in the no shutdown state, and resources are allocated to enable the node to process the protocol.

  • To deallocate resources, you must issue the configure router isis shutdown and configure router no isis commands to allow the node to boot up correctly after the reboot. It is not sufficient to issue only a configure router isis shutdown command.

  • The resources are allocated when the first instance of IS-IS is configured, and resources are deallocated when the last instance of the configuration for IS-IS is removed or shut down.

IS-IS Interface

In the config>router>isis>interface context, the command disables the IS-IS interface. By default, the IS-IS interface is enabled (no shutdown).

IS-IS Interface and Level

In the config>router>isis>interface>level context, the command disables the IS-IS interface for the level. By default, the IS-IS interface at the level is enabled (no shutdown).

tag

Syntax

tag tag

no tag

Context

config>router>isis>interface

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures a route tag to the specified IP address of an interface.

Parameters

tag

Specifies the route tag.

Values

1to 4294967295

authentication-check

Syntax

[no] authentication-check

Context

config>router>isis

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command sets an authentication check to reject PDUs that do not match the type or key requirements.

The default behavior when authentication is configured is to reject all IS-IS protocol PDUs that have a mismatch in either the authentication type or authentication key.

When no authentication-check is configured, authentication PDUs are generated and IS-IS PDUs are authenticated on receipt. However, mismatches cause an event to be generated and will not be rejected.

The no form of this command allows authentication mismatches to be accepted and generate a log event.

Default

authentication-check

authentication-key

Syntax

authentication-key [authentication-key | hash-key] [hash | hash2]

no authentication-key

Context

config>router>isis

config>router>isis>level

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the authentication key used to verify PDUs sent by neighboring routers on the interface.

Neighboring routers use passwords to authenticate PDUs sent from an interface. For authentication to work, both the authentication key and the authentication type on a segment must match. The authentication-type statement must also be included.

To configure authentication at the global level, configure this command in the config>router>isis context. When this parameter is configured at the global level, all PDUs are authenticated, including the hello PDU.

To override the global setting for a specific level, configure the authentication-key command in the config>router>isis>level context. When configured within the specific level, hello PDUs are not authenticated.

The no form of this command removes the authentication key.

Default

no authentication-key

Parameters

authentication-key

Specifies the authentication key. The key can be any combination of ASCII characters up to 255 characters (unencrypted). If spaces are used in the string, enclose the entire string in quotation marks (‟ ”).

hash-key

Specifies the hash key. The key can be any combination of ASCII characters up to 342 characters (encrypted). If spaces are used in the string, enclose the entire string in quotation marks (‟ ”).

This is useful when a user must configure the parameter, but, for security purposes, the actual unencrypted key value is not provided.

hash

Keyword to specify the key is entered in an encrypted form. If the hash parameter is not used, the key is assumed to be in a non-encrypted, clear text form. For security, all keys are stored in encrypted form in the configuration file with the hash parameter specified.

hash2

Keyword to specify the key is entered in a more complex encrypted form. If the hash2parameter is not used, the less encrypted hash form is assumed.

authentication-type

Syntax

authentication-type {password | message-digest}

no authentication

Context

config>router>isis

config>router>isis>level

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables either simple password or message digest authentication in the global IS-IS or IS-IS level context. Both the authentication key and the authentication type on a segment must match. The authentication-key statement must also be entered.

Configure the authentication type at the global level in the config>router>isis context. Configure or override the global setting by configuring the authentication type using the config>router>isis>level context

The no form of this command disables authentication.

Default

no authentication-type

Parameters

password

Keyword to specify that simple password (plain text) authentication is required.

message-digest

Keyword to specify that MD5 authentication in accordance with RFC2104 is required.

bfd-enable

Syntax

[no] bfd-enable {ipv4}

Context

config>router>isis>interface

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables the use of bidirectional forwarding (BFD) to control IPv4 adjacencies. By enabling BFD on an IPv4 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.

For more information about the protocols and platforms that support BFD, see the 7210 SAS-Mxp, R6, R12, S, Sx, T Router Configuration Guide.

The no form of this command removes BFD from the associated adjacency.

Default

no bfd-enable ipv4

csnp-authentication

Syntax

[no] csnp-authentication

Context

config>router>isis

config>router>isis>level

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables authentication of individual IS-IS packets of complete sequence number PDUs (CSNP) type.

The no form of this command suppresses authentication of CSNP packets.

csnp-interval

Syntax

csnp-interval seconds

no csnp-interval

Context

config>router>isis>interface

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the time interval, in seconds, to send complete sequence number (CSN) PDUs from the interface. IS-IS must send CSN PDUs periodically.

The no form of this command reverts to the default value.

Default

csnp-interval 10 — CSN PDUs are sent every 10 seconds for LAN interfaces.

csnp-interval 5 — CSN PDUs are sent every 5 seconds for point-to-point interfaces.

Parameters

seconds

Specifies the time interval, in seconds, between successive CSN PDUs sent from this interface, expressed as a decimal integer.

Values

1 to 65535

default-ipv6-unicast-metric

Syntax

default-ipv6-unicast-metric metric

no default-ipv6-unicast-metric

Context

config>router>isis>if>

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the default metric used for IPv6 routes for both level 1 and level 2 on the interface, only when IS-IS multi-topology is configured.

To calculate the lowest cost to reach a specific destination, each configured level on each interface must have a cost. The costs for each level on an interface may be different. The value specified with this command is used only if the metric is not specified using the ipv6-unicast-metric CLI command under the specific level.

If the metric is not configured, the default of 10 is used unless reference bandwidth is configured.

The no form of this command reverts to the default value.

Default

default-ipv6-unicast-metric 10

Parameters

metric

Specifies the metric assigned for this level on this interface.

Values

1 to 16777215

disable-ldp-sync

Syntax

[no] disable-ldp-sync

Context

config>router>isis

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command disables the IGP-LDP synchronization feature on all interfaces participating in the OSPF or IS-IS routing protocol.

When this command is executed, IGP immediately advertises the actual value of the link cost for all interfaces which have the IGP-LDP synchronization enabled if the currently advertised cost is different. It then disables IGP-LDP synchronization for all interfaces. This command does not delete the interface configuration. The no form of this command has to be entered to re-enable IGP-LDP synchronization for this routing protocol.

The no form of this command reverts to the default value and re-enables IGP-LDP synchronization on all interfaces participating in the OSPF or IS-IS routing protocol and for which the ldp-sync-timer is configured.

Default

no disable-ldp-sync

export

Syntax

[no] export policy-name [policy-name...up to 32 max]

Context

config>router>isis

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures export routing policies that determine the routes exported from the routing table to IS-IS.

If no export policy is defined, non IS-IS routes are not exported from the routing table manager to IS-IS.

If multiple policy names are specified, the policies are evaluated in the order they are specified. The first policy that matches is applied. If multiple export commands are issued, the last command entered overrides the previous command. A maximum of five policy names can be specified.

If an aggregate command is also configured in the config>router context, the aggregation is applied before the export policy is applied.

Routing policies are created in the config>router>policy-options context.

The no form of this command removes the specified policy-name, or all policies from the configuration if no policy-name is specified.

Default

no export

Parameters

policy-name

Specifies the export policy name. Up to five policy names can be specified.

export-limit

Syntax

export-limit number [log percentage]

no export-limit

Context

config>router>isis

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the maximum number of routes (prefixes) that can be exported into IS-IS from the route table.

The no form of this command removes the parameters from the configuration.

Default

no export-limit

Parameters

number

Specifies the maximum number of routes (prefixes) that can be exported into IS-IS from the route table.

Values

1 to 4294967295

log percentage

Specifies the percentage of the export limit, at which a warning log message and SNMP notification are sent.

Values

1 to 100

external-preference

Syntax

external-preference external-preference

no external-preference

Context

config>router>isis>level

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the external route preference for the IS-IS level. This command configures the preference level of either IS-IS level 1 or IS-IS level 2 external routes.

A route can be learned by the router by different protocols, in which case, the costs are not comparable. When this occurs, the preference is used to decide the route to use.

Different protocols should not be configured with the same preference, if this occurs the tiebreaker is base on the default preferences. The following table lists the default preferences.

Table: Default preferences

Route type

Preference

Configurable

Direct attached

0

No

Static-route

5

Yes

OSPF internal routes

10

No

IS-IS Level 1 internal

15

Yes 1

IS-IS Level 2 internal

18

Yes 1

OSPF external

150

Yes

IS-IS Level 1 external

160

Yes

IS-IS Level 2 external

165

Yes

BGP

170

Yes

If multiple routes are learned with an identical preference using the same protocol, the lowest cost route is used. If multiple routes are learned with an identical preference using the same protocol and the costs (metrics) are equal, the decision of the route to use is determined by the configuration of the ecmp in the config>router context.

Parameters

external-preference

Specifies the preference for external routes at this level, expressed as a decimal integer.

Values

1 to 255

graceful-restart

Syntax

[no] graceful-restart

Context

config>router>isis

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables graceful restart helper support for IS-IS. The router acts as a helper to neighbors who are graceful-restart-capable and are restarting.

When the control plane of a graceful-restart-capable router fails, the neighboring routers (graceful-restart helpers) temporarily preserve adjacency information so packets continue to be forwarded through the failed graceful-restart router using the last known routes. If the control plane of the graceful-restart router comes back up within the timer limits, then the routing protocols reconverge to minimize service interruption.

The no form of this command disables graceful restart and removes all graceful restart configurations in the IS-IS instance.

Default

no graceful-restart

helper-disable

Syntax

[no] helper-disable

Context

config>router>isis>graceful-restart

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command disables the helper support for graceful restart.

When graceful-restart is enabled, the router can be a helper (meaning that the router is helping a neighbor to restart) or be a restarting router or both. The router supports only helper mode. This facilitates the graceful restart of neighbors but does not act as a restarting router (meaning that the router does not help the neighbors to restart).

The no form of this command enables helper support and is the default when the graceful-restart command is enabled.

Default

no helper-disable

loopfree-alternate-exclude

Syntax

[no] loopfree-alternate

Context

configure>router>isis>level

configure>router>isis>interface

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command instructs IGP to exclude a specific interface or all interfaces participating in a specific IS-IS level from the SPF LFA computation. The LFA SPF calculation can therefore be run only where it is not needed.

If an interface is excluded from the LFA SPF in IS-IS, it is excluded in both level 1 and level 2.

The no form of this command reverts to the default value.

Default

no loopfree-alternate-exclude

loopfree-alternate

Syntax

loopfree-alternate [remote-lfa]

loopfree-alternate remote-lfa [max-pq-cost value]

no loopfree-alternate

Context

config>router>isis

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables the Loop-Free Alternate (LFA) computation by SPF for the IS-IS routing protocol instance.

The IGP SPF is instructed to precompute both a primary next hop and an LFA next hop for every learned prefix. When found, the LFA next-hop is populated into the routing table along with the primary next hop for the prefix.

The IGP LFA SPF uses the remote-lfa option to enable the remote LFA next-hop calculation. When this option is enabled in an IGP instance, SPF performs the remote LFA additional computation following the regular LFA next-hop calculation when the latter results in no protection for one or more prefixes that are resolved to a specific interface.

Remote LFA extends the protection coverage of LFA-FRR to any topology by automatically computing and establishing or tearing down shortcut tunnels (repair tunnels) to a remote LFA node (PQ node). This puts the packets back into the shortest path without looping them to the node that forwarded them over the repair tunnel. A repair tunnel can be an RSVP LSP, an LDP-in-LDP tunnel, or a segment routing tunnel. The use of segment routing repair tunnels is restricted to the remote LFA node.

Unlike the regular LFA algorithm, which is per-prefix, the remote LFA algorithm is a per-link LFA SPF calculation. It provides protection to all destination prefixes that share the protected link by using the neighbor on the other side of the protected link as a proxy for those prefixes.

Default

no loopfree-alternate

Parameters

remote-lfa

Keyword to enable the remote LFA next-hop calculation by the IGP LFA SPF.

max-pq-lfa value

Specifies the maximum IGP cost from the router that is performing the remote LFA calculation to the candidate P or Q node.

Values

0 to 4294967295

hello-authentication

Syntax

[no] hello-authentication

Context

config>router>isis

config>router>isis>level

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables authentication of individual IS-IS packets of the Hello type.

The no form of this command suppresses authentication of Hello packets.

iid-tlv-enable

Syntax

[no] iid-tlv-enable

Context

config>router>isis>graceful-restart

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command specifies whether Instance Identifier (IID) TLV is enabled or disabled for this IS-IS instance.

hello-authentication-key

Syntax

hello-authentication-key [authentication-key | hash-key] [hash | hash2]

no hello-authentication-key

Context

config>router>isis>interface

config>router>isis>if>level

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the authentication key (password) for hello PDUs. Neighboring routers use the password to verify the authenticity of hello PDUs sent from this interface. Both the hello authentication key and the hello authentication type on a segment must match. The hello-authentication-type must be specified.

To configure the hello authentication key in the interface context use the hello-authentication-key command in the config>router>isis>interface context.

To configure or override the hello authentication key for a specific level, configure the hello-authentication-key in the config>router>isis>interface>level context.

If both IS-IS and hello authentication are configured, hello messages are validated using hello authentication. If only IS-IS authentication is configured, it is used to authenticate all IS-IS (including hello) protocol PDUs.

When the hello authentication key is configured in the config>router>isis>interface context, it applies to all levels configured for the interface.

The no form of this command removes the authentication key from the configuration.

Default

no hello-authentication-key

Parameters

authentication-key

Specifies the hello authentication key (password). The key can be any combination of ASCII characters up to 254 characters (unencrypted). If spaces are used in the string, enclose the entire string in quotation marks (‟ ”).

hash-key

Specifies the hash key. The key can be any combination of ASCII characters up to 352 characters (encrypted). If spaces are used in the string, enclose the entire string in quotation marks (‟ ”).

This is useful when a user must configure the parameter, but, for security purposes, the actual unencrypted key value is not provided.

hash

Keyword to specify the key is entered in an encrypted form. If the hash parameter is not used, the key is assumed to be in a non-encrypted, clear text form. For security, all keys are stored in encrypted form in the configuration file with the hash parameter specified.

hash2

Keyword to specify the key is entered in a more complex encrypted form. If the hash2parameter is not used, the less encrypted hashform is assumed.

hello-authentication-type

Syntax

hello-authentication-type {password | message-digest}

no hello-authentication-type

Context

config>router>isis>interface

config>router>isis>if>level

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables hello authentication at either the interface or level context. Both the hello authentication key and the hello authentication type on a segment must match. The hello authentication-key statement must also be included.

To configure the hello authentication type at the interface context, use hello-authentication-type in the config>router>isis>interface context.

To configure or override the hello authentication setting for a specific level, configure the hello-authentication-type in the config>router>isis>interface>level context.

The no form of this command disables hello authentication.

Default

no hello-authentication-type

Parameters

password

Keyword to specify the simple password (plain text) authentication is required.

message-digest

Keyword to specify that MD5 authentication in accordance with RFC2104 (HMAC: Keyed-Hashing for Message Authentication) is required.

hello-interval

Syntax

hello-interval seconds

no hello-interval

Context

config>router>isis>if>level

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the interval between IS-IS Hello PDUs issued on the interface at this level. The hello-interval command, along with the hello-multiplier command, is used to calculate a hold time, which is communicated to a neighbor in a Hello PDU.

Note:

The neighbor hold time is (hello multiplier ✕ hello interval) on non-designated intermediate system broadcast interfaces and point-to-point interfaces and is (hello multiplier ✕ hello interval / 3) on designated intermediate system broadcast interfaces. Hello values can be adjusted for faster convergence, but the hold time should always be > 3 to reduce routing instability.

The no form of this command to reverts to the default value.

Default

hello-interval 3 — Hello interval default for the designated intersystem.

hello-interval 9 — Hello interval default for non-designated intersystems.

Parameters

seconds

Specifies the hello interval in seconds, expressed as a decimal integer.

Values

1 to 20000

hello-multiplier

Syntax

hello-multiplier multiplier

no hello-multiplier

Context

config>router>isis>if>level

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures a hello multiplier. The hello-multiplier command, along with the hello-interval command, is used to calculate a hold time, which is communicated to a neighbor in a Hello PDU.

The hold time is the time during which the neighbor expects to receive the next Hello PDU. If the neighbor receives a Hello within this time, the hold time is reset. If the neighbor does not receive a Hello within the hold time, it brings the adjacency down.

Note:

The neighbor hold time is (hello multiplier ✕ hello interval) on non-designated intermediate system broadcast interfaces and point-to-point interfaces and is (hello multiplier ✕ hello interval / 3) on designated intermediate system broadcast interfaces. Hello values can be adjusted for faster convergence, but the hold time should always be > 3 to reduce routing instability.

The no form of this command reverts to the default value.

Default

hello-multiplier 3

Parameters

multiplier

Specifies the multiplier for the hello interval, expressed as a decimal integer.

Values

2 to 100

ipv6-unicast-metric

Syntax

ipv6-unicast-metric metric

no ipv6-unicast-metric

Context

config>router>isis>if>level

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the default metric used for IPv6 routes for both level 1 and level 2 on the interface, only when IS-IS multi-topology is configured.

To calculate the lowest cost to reach a specific destination, each configured level on each interface must have a cost. The costs for each level on an interface may be different.

If the metric is not configured, the default of 10 is used unless reference bandwidth is configured.

The no form of this command reverts to the default value.

Default

ipv6-unicast-metric 10

Parameters

metric

Specifies the metric assigned for this level on this interface.

Values

1 to 16777215

interface

Syntax

[no] interface ip-int-name

Context

config>router>isis

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

Commands in this context configure an IS-IS interface.

When an area is defined, the interfaces belong to that area. Interfaces cannot belong to separate areas.

When the interface is a POS channel, the OSINCP is enabled when the interface is created and removed when the interface is deleted.

The no form of this command removes IS-IS from the interface.

The shutdown command in the config>router>isis>interface context administratively disables IS-IS on the interface without affecting the IS-IS configuration.

Default

no interface

Parameters

ip-int-name

Specifies the IP interface name created in the config>router>interface context. The IP interface name must already exist.

interface-type

Syntax

interface-type {broadcast | point-to-point}

no interface-type

Context

config>router>isis>interface

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the IS-IS interface type as either broadcast or point-to-point.

Use this command to set the interface type of an Ethernet link to point-to-point to avoid having to carry the designated IS-IS overhead if the link is used as a point-to-point.

If the interface type is not known at the time the interface is added to IS-IS, and subsequently the IP interface is bound (or moved) to a different interface type, this command must be entered manually.

The no form of this command reverts to the default value.

Default

interface-type point-to-point — for IP interfaces on SONET channels

interface-type broadcast — for IP interfaces on Ethernet or unknown type physical interfaces

Special Cases

SONET

Interfaces on SONET channels default to the point-to-point type.

Ethernet or Unknown

Physical interfaces that are Ethernet or unknown default to the broadcast type.

Parameters

broadcast

Keyword to configure the interface to maintain this link as a broadcast network.

point-to-point

Keyword to configure the interface to maintain this link as a point-to-point link.

ipv6-unicast-disable

Syntax

[no] ipv6-unicast-disable

Context

config>router>isis>interface

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command disables IS-IS IPv6 unicast routing for the interface.

By default, IPv6 unicast on all interfaces is enabled. However, IPv6 unicast routing on IS-IS is in effect when the config>router>isis>ipv6-routing mt command is configured.

The no form of this command enables IS-IS IPv6 unicast routing for the interface.

ipv4-routing

Syntax

[no] ipv4-routing

Context

config>router>isis

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command specifies whether this IS-IS instance supports IPv4.

The no form of this command disables IPv4 on the IS-IS instance.

Default

ipv4-routing

ipv6-routing

Syntax

[no] ipv6-routing {native | mt}

Context

config>router>isis

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables IPv6 routing.

The no form of this command disables support for IS-IS IPv6 TLVs for IPv6 routing.

Default

no ipv6-routing

Parameters

native

Keyword that enables IS-IS IPv6 TLVs for IPv6 routing and enables support for native IPv6 TLVs.

mt

Keyword that enables IS-IS multi-topology TLVs for IPv6 routing. When this parameter is specified, the support for native IPv6 TLVs is disabled.

ldp-over-rsvp

Syntax

[no] ldp-over-rsvp

Context

config>router>isis

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables LDP over RSVP processing in IS-IS.

The no form of this command disables LDP over RSVP processing.

Default

no ldp-over-rsvp

level

Syntax

level level-number

Context

config>router>isis

config>router>isis>interface

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

Commands in this context configure IS-IS level 1 or level 2 area attributes.

A router can be configured as a level 1, level 2, or level 1-2 system. A level 1 adjacency can be established if there is at least one area address shared by this router and a neighbor. A level 2 adjacency cannot be established over this interface.

Level 1/2 adjacency is created if the neighbor is also configured as a level 1/2 router and has at least one area address in common. A level 2 adjacency is established if there are no common area IDs.

A level 2 adjacency is established if another router is configured as level 2 or a level 1/2 router with interfaces configured as level 1/2 or level 2. Level 1 adjacencies are not established over this interface.

To reset global or interface level parameters to the default, the following commands must be entered independently:

  • level>no hello-authentication-key

  • level>no hello-authentication-type

  • level>no hello-interval

  • level>no hello-multiplier

  • level>no metric

  • level>no passive

  • level>no priority

Default

level 1 or level 2

Special Cases

Global IS-IS Level

The config>router>isis context configures default global parameters for both level 1 and level 2 interfaces.

IS-IS Interface Level

The config>router>isis>interface context configures IS-IS operational characteristics of the interface at level 1 and/or level 2. A logical interface can be configured on one level 1 and one level 2. In this case, each level can be configured independently and parameters must be removed independently.

By default, an interface operates in both level 1 and level 2 modes.

Parameters

level-number

Specifies the IS-IS level number.

Values

1, 2

level-capability

Syntax

level-capability {level-1 | level-2 | level-1/2}

no level-capability

Context

config>router>isis

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the routing level for an instance of the IS-IS routing process.

An IS-IS router and an IS-IS interface can operate at level 1, level 2, or both level 1 and level 2.

The following table displays configuration combinations and the potential adjacencies that can be formed.

Table: Potential adjacency capabilities

Global level

Interface level

Potential adjacency

L 1/2

L 1/2

Level 1 and/or Level 2

L 1/2

L 1

Level 1 only

L 1/2

L 2

Level 2 only

L 2

L 1/2

Level 2 only

L 2

L 2

Level 2 only

L 2

L 1

none

L 1

L 1/2

Level 1 only

L 1

L 2

none

L 1

L 1

Level 1 only

The no form of this command removes the level capability from the configuration.

Default

level-capability level-1/2

Special Cases

IS-IS Router

In the config>router>isis context, changing the level capability performs a restart on the IS-IS protocol instance.

IS-IS Interface

In the config>router>isis>interface context, changing the level capability performs a restart of IS-IS on the interface.

Parameters

level-1

Keyword to specify the router or interface can operate at level 1only.

level-2

Keyword to specify the router or interface can operate at level 2 only.

level-1/2

Keyword to specify the router or interface can operate at both level 1 and level 2.

lsp-pacing-interval

Syntax

lsp-pacing-interval milliseconds

no lsp-pacing-interval

Context

config>router>isis>interface

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the interval between LSP PDUs sent from this interface.

To avoid bombarding adjacent neighbors with excessive data, pace the Link State Protocol Data Units (LSPs). If a value of zero is configured, no LSPs are sent from the interface.

The no form of this command reverts to the default value.

Default

lsp-pacing-interval 100

Parameters

milliseconds

Specifies the interval in milliseconds that IS-IS LSPs can be sent from the interface, expressed as a decimal integer.

Values

0 to 65535

lsp-lifetime

Syntax

lsp-lifetime seconds

no lsp-lifetime

Context

config>router>isis

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command specifies the time interval that LSPs originated by the router are considered valid by other routers in the domain.

Each LSP received is maintained in an LSP database until the LSP lifetime expires, unless the originating router refreshes the LSP. By default, each router refreshes its LSPs every 20 minutes (1200 seconds), to ensure that other routers do not age out the LSP.

The LSP refresh timer is derived using the following formula: lsp-lifetime value / 2

The no form of this command reverts to the default value.

Default

lsp-lifetime 1200

Parameters

seconds

Specifies the interval, in seconds, that LSPs originated by the router are considered valid by other routers in the domain.

Values

350 to 65535

lsp-mtu-size

Syntax

lsp-mtu-size size

no lsp-mtu-size

Context

config>router>isis

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the LSP MTU size. If the MTU size is changed from the default using the CLI or SNMP, IS-IS must be restarted for the change to take effect. This can be done by performing a shutdown command and then a no shutdown command in the config>router>isis context.

Note:

If the MTU size is changed from the default value by using the exec command to execute a configuration file with the changed value, IS-IS automatically bounces before the change takes effect.

The no form of this command reverts to the default value.

Default

lsp-mtu-size 1492

Parameters

size

Specifies the LSP MTU size.

Values

490 to 9190

lsp-refresh-interval

Syntax

lsp-refresh-interval [seconds]

no lsp-refresh-interval

Context

config>router>isis

Description

This command configures the IS-IS LSP refresh timer interval. The value specified for lsp-lifetime must be considered when configuring the lsp-refresh-interval. The LSP refresh interval cannot be greater than 90% of the LSP lifetime.

The no form of this command reverts to the default (600 seconds); however, if the configured value is greater than 90% of the LSP lifetime, the command is rejected. For example, if the LSP lifetime is 400, the no lsp-refresh-interval command is rejected.

Default

lsp-refresh-interval 600

Parameters

seconds

Specifies the refresh interval.

Values

150 to 65535

lsp-wait

Syntax

lsp-wait lsp-wait [lsp-initial-wait [lsp-second-wait]]

Context

config>router>isis

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command customizes the throttling of IS-IS LSP-generation. Timers that determine when to generate the first, second, and subsequent LSPs can be controlled using this command.

Subsequent LSPs are generated at increasing intervals of the lsp-second-wait timer until a maximum value is reached.

Parameters

lsp-max-wait

Specifies the maximum interval, in seconds, between two consecutive occurrences of an LSP being generated.

Values

1 to 120

Default

5

lsp-initial-wait

Specifies the initial LSP generation delay, in seconds.

Values

0 to 100

Default

0

lsp-second-wait

Specifies the hold time, in seconds, between the first and second LSP generation.

Values

1 to 100

Default

1

mesh-group

Syntax

mesh-group {value | blocked}

no mesh-group

Context

config>router>isis>interface

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command assigns an interface to a mesh group. Mesh groups limit the amount of flooding that occurs when a new or changed LSP is advertised throughout an area.

All routers in a mesh group should be fully meshed. When LSPs need to be flooded, only a single copy is received instead of a copy for each neighbor.

To create a mesh group, configure the same mesh group value for each interface that is part of the mesh group. All routers must have the same mesh group value configured for all interfaces that are part of the mesh group.

To prevent an interface from flooding LSPs, the optional blocked parameter can be specified.

Caution:

Configure mesh groups carefully. It is easy to created isolated islands that do not receive updates as (other) links fail.

The no form of this command removes the interface from the mesh group.

Default

no mesh-group

Parameters

value

Specifies the unique decimal integer value distinguishes this mesh group from other mesh groups on this or any other router that is part of this mesh group.

Values

1 to 2000000000

blocked

Keyword that prevents an interface from flooding LSPs.

multi-topology

Syntax

[no] multi-topology

Context

config>router>isis

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables IS-IS multi-topology support.

The no form of this command disables multi-topology support.

Default

no multi-topology

ipv6-unicast

Syntax

[no] ipv6-unicast

Context

config>router>isis>multi-topology

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables multi-topology TLVs.

The no form of this command disables multi-topology TLVs.

metric

Syntax

metric ipv4-metric

no metric

Context

config>router>isis>if>level

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the metric used for the level on the interface.

To calculate the lowest cost to reach a specific destination, each configured level on each interface must have a cost. The costs for each level on an interface may be different.

If the metric is not configured, the default of 10 is used unless reference bandwidth is configured.

The no form of this command reverts to the default value.

Default

metric 10

Parameters

ipv4-metric

Specifies the metric assigned for this level on this interface.

Values

1 to16777215

advertise-passive-only

Syntax

[no] advertise-passive-only

Context

config>router>isis

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables IS-IS to advertise only prefixes that belong to passive interfaces.

The no form of this command disables IS-IS to advertise only prefixes that belong to passive interfaces.

advertise-router-capability

Syntax

advertise-router-capability {area | as}

no advertise-router-capability

Context

config>router>isis

Platforms

7210 SAS-Mxp

Description

This command enables advertisement of the capabilities of a router to its neighbors for informational and troubleshooting purposes. A TLV, as defined in RFC 4971, advertises the TE Node Capability Descriptor capability.

The area and as parameters control the scope of the capability advertisements.

The no form of this command disables this advertisement capability.

Default

no advertise-router-capability

Parameters

area

Keyword specifying advertisement only within the area of origin.

as

Keyword specifying advertisement throughout the entire autonomous system.

all-l1isis

Syntax

[no] all-l1isis ieee-address

Context

config>router>isis

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command specifies the MAC address to use for all layer 1 IS-IS routers. The MAC address should be a multicast address. Run the /no shutdown command on the IS-IS instance to make the change operational.

Default

no all-l1isis

(The MAC address, 01-80-C2-00-02-11, is used in the IS-IS base instance ID (ID==0). This cannot be modified by the user.)

Parameters

ieee-address

Specifies the destination MAC address for all layer 1 IS-IS neighbors on the link for this IS-IS instance.

all-l2isis

Syntax

[no] all-l2isis ieee-address

Context

config>router>isis

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command specifies the MAC address to use for all layer 2 IS-IS routers. The MAC address should be a multicast address. Run the shutdown/no shutdown command on the IS-IS instance to make the change operational.

Default

no all-l2isis

(The MAC address, 01-80-C2-00-01-00, is used in the IS-IS base instance ID (ID==0). This cannot be modified by the user.)

Parameters

ieee-address

Specifies the destination MAC address for all layer 2 IS-IS neighbors on the link for this IS-IS instance.

area-id

Syntax

[no] area-id area-address

Context

config>router>isis

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the area ID portion of NSAP addresses, which identifies a point of connection to the network, such as a router interface, and is called a Network Service Access Point (NSAP). Addresses in the IS-IS protocol are based on the ISO NSAP addresses and Network Entity Titles (NETs), not IP addresses. This command was previously named the net network-entity-title command.

A maximum of 3 area addresses can be configured.

NSAP addresses are divided into the following parts (only the area ID is configurable):

  • Area ID

    This is a field of variable length, between 1 and 13 bytes. This includes the Authority and Format Identifier (AFI) as the most significant byte and the area ID.

  • System ID

    This is a six-byte system identification. This value is not configurable. The system ID is derived from the system or router ID.

  • Selector ID

    This is a one-byte selector identification that must contain zeros when configuring a NET. This value is not configurable. The selector ID is always 00.

The NET is constructed like an NSAP, but the selector byte contains a 00 value. NET addresses are exchanged in hello and LSP PDUs. All net addresses configured on the node are advertised to its neighbors.

For level 1 interfaces, neighbors can have different area IDs, but they must have at least one area ID (AFI + area) in common. Sharing a common area ID, they become neighbors and area merging between the potentially different areas can occur.

For level 2 (only) interfaces, neighbors can have different area IDs. However, if they have no area IDs in common, they become only level 2 neighbors, and level 2 LSPs are exchanged.

For level 1 and level 2 interfaces, neighbors can have different area IDs. If they have at least one area ID (AFI + area) in common, they become neighbors. In addition to exchanging level 2 LSPs, area merging between potentially different areas can occur.

If multiple area-id commands are entered, the system ID of all subsequent entries must match the first area address.

The no form of this command removes the area address.

Parameters

area-address

Specifies the 1- to 13-byte address. Of the total 20 bytes comprising the NET, only the first 13 bytes can be manually configured. As few as one byte can be entered or, at most, 13 bytes. If less than 13 bytes are entered, the rest is padded with zeros.

overload

Syntax

overload [timeout seconds]

no overload

Context

config>router>isis

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command administratively sets the IS-IS router to operate in the overload state for a specific time period or indefinitely.

During normal operation, the router may be forced to enter an overload state because of a lack of resources. When in the overload state, the router is only used if the destination is reachable by the router and is not used for other transit traffic.

If a time period is specified, the overload state persists for the configured length of time. If no time is specified, the overload state operation is maintained indefinitely.

The overload command can be useful in circumstances where the router is overloaded or used before executing a shutdown command to divert traffic around the router.

The no form of this command causes the router to exit the overload state.

Default

no overload

Parameters

seconds

Specifies the time, in seconds, that this router must operate in overload state.

Values

60 to 1800

Default

infinity (overload state maintained indefinitely)

overload-on-boot

Syntax

overload-on-boot [timeout seconds]

no overload-on-boot

Context

config>router>isis

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

When in an overload state, the router is used only if there is no other router to reach the destination. This command configures the IGP upon bootup in the overload state until one of the following events occurs:

  • the timeout timer expires

  • a manual override of the current overload state is entered using the config router isis no overload command

The no overload command does not affect the overload-on-boot command function.

If no timeout is specified, IS-IS goes into overload indefinitely after a reboot. After the reboot, the IS-IS status displays a permanent overload state:

  • Layer 1 LSDB Overload: Manual on boot (Indefinitely in overload)

  • Layer 2 LSDB Overload: Manual on boot (Indefinitely in overload)

This state can be cleared using the no overload command.

When specifying a timeout value, IS-IS goes into overload for the configured timeout after a reboot. After the reboot, the IS-IS status displays the remaining time the system stays in overload:

  • Layer 1 LSDB Overload: Manual on boot (Overload Time Left: 17)

  • Layer 2 LSDB Overload: Manual on boot (Overload Time Left: 17)

The overload state can be cleared before the timeout expires using the no overload command.

Use the show router ospf status or show router isis status commands to display the administrative and operational state, as well as all timers.

The no form of this command removes the overload-on-boot functionality from the configuration.

Default

no overload-on-boot

Parameters

timeout seconds

Specifies the number of seconds the router remains in the overload state after rebooting.

Values

60 to 1800

ipv4-node-sid

Syntax

ipv4-node-sid index value

ipv4-node-sid label value

no ipv4-node-sid

Context

config>router>isis>interface

Platforms

7210 SAS-Mxp, 7210 SAS-R6, 7210 SAS-R12, and 7210 SAS-Sx/S 1/10GE

Description

This command assigns a node SID index or label value to the prefix representing the primary address of an IPv4 network interface of type loopback. Only a single node SID can be assigned to an interface. The secondary address of an IPv4 interface cannot be assigned a node SID index and does not inherit the SID of the primary IPv4 address.

This command fails if the network interface is not of type loopback, or if the interface is defined in an IES or a VPRN context. Assigning an identical SID index or label value to the same interface in two different IGP instances is not allowed within the same node.

The value of the label or index SID is extracted from the range configured for this IGP instance. When using the global mode of operation, a new segment routing module checks that the same index or label value is not assigned to more than one loopback interface address. When using the per-instance mode of operation, this check is not required because the index and label ranges of the various IGP instances are not allowed to overlap.

The no form of this command reverts to the default value.

Default

no ipv4-node-sid

Parameters

index value

Specifies the IPv4 SID node index value.

Values

0 to 4294967295

label value

Specifies the IPv4 SID node label value.

Values

0 to 4294967295

passive

Syntax

[no] passive

Context

config>router>isis>interface

config>router>isis>if>level

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command adds the passive attribute, with which the interface is advertised as an IS-IS interface without running the IS-IS protocol. Normally, only interface addresses that are configured for IS-IS are advertised as IS-IS interfaces at the level that they are configured.

When the passive mode is enabled, the interface or the interface at the level ignores ingress IS-IS protocol PDUs and does not transmit IS-IS protocol PDUs.

The no form of this command removes the passive attribute.

Default

passive — service interfaces are passive no passive — all other interfaces are not passive

Special Cases

Service Interfaces

Service interfaces (defined using the service-prefix command in the config>router context) are passive by default.

All other Interfaces

All other interfaces are not passive by default.

preference

Syntax

preference preference

no preference

Context

config>router>isis>level

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the preference level of either IS-IS level 1 or IS-IS level 2 internal routes.

A route can be learned by the router from different protocols, in which case the costs are not comparable. When this occurs, the preference is used to decide which route is used.

Different protocols should not be configured with the same preference. If this occurs the tiebreaker is based on the default preferences listed in the following table.

Table: Route preference defaults by route type

Route type

Preference

Configurable

Direct attached

0

No

Static-route

5

Yes

OSPF internal routes

10

No

IS-IS level 1 internal

15

Yes

IS-IS level 2 internal

18

Yes

OSPF external

150

Yes

IS-IS level 1 external

160

Yes 2

IS-IS level 2 external

165

Yes 2

BGP

170

Yes

If multiple routes are learned with an identical preference using the same protocol, the lowest cost route is used. If multiple routes are learned with an identical preference using the same protocol and the costs (metrics) are equal, the decision of what route to use is determined by the configuration of ECMP in the config>router context.

Parameters

preference

Specifies the preference for external routes at this level, expressed as a decimal integer.

Values

1 to 255

priority

Syntax

priority number

no priority

Context

config>router>isis>if>level

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the priority of the IS-IS router interface for designated router election on a multi-access network.

This priority is included in hello PDUs transmitted by the interface on a multi-access network. The router with the highest priority is the preferred designated router. The designated router is responsible for sending LSPs with regard to this network and the routers that are attached to it.

The no form of this command reverts to the default value.

Default

priority 64

Parameters

number

Specifies the priority for this interface at this level.

Values

0 to 127

psnp-authentication

Syntax

[no] psnp-authentication

Context

config>router>isis

config>router>isis>level

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures authentication of individual IS-IS packets of partial sequence number PDU (PSNP) type.

The no form of this command suppresses authentication of PSNP packets.

reference-bandwidth

Syntax

reference-bandwidth reference-bandwidth

no reference-bandwidth

Context

config>router>isis

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the reference bandwidth that provides the basis of bandwidth relative costing.

To calculate the lowest cost to reach a specific destination, each configured level on each interface must have a cost. If the reference bandwidth is defined, the cost is calculated using the following formula:

cost = reference-bandwidthbandwidth

If the reference bandwidth is configured as 10 Gbytes (10 000 000 000), a 100 Mb/s interface has a default metric of 100. For metrics in excess of 63 to be configured, wide metrics must be deployed (see the wide-metrics-only command).

If the reference bandwidth is not configured, all interfaces have a default metric of 10.

The no form of this command reverts to the default value.

Default

no reference-bandwidth

Parameters

reference-bandwidth

Specifies the reference bandwidth in kilobits per second, expressed as a decimal integer.

Values

0 to 1000000000

retransmit-interval

Syntax

retransmit-interval seconds

no retransmit-interval

Context

config>router>isis>interface

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the minimum time between LSP PDU retransmissions on a point-to-point interface.

The no form of this command reverts to the default value.

Default

retransmit-interval 100

Parameters

seconds

Specifies the interval, in seconds, that IS-IS LSPs can be sent on the interface.

Values

1 to 65535

segment-routing

Syntax

segment-routing

no segment-routing

Context

config>router>isis

Platforms

7210 SAS-Mxp, 7210 SAS-R6, 7210 SAS-R12, and 7210 SAS-Sx/S 1/10GE

Description

Commands in this context configure segment routing (SR) parameters within an IGP instance.

SR adds to IS-IS routing protocols the ability to perform shortest path routing and source routing using the concept of abstract segment. A segment can represent a local prefix of a node, a specific adjacency of the node (interface/next-hop), a service context, or a specific explicit path over the network. For each segment, the IGP advertises a segment identifier (SID).

When SR is used with the MPLS data plane, the SID is used as a standard MPLS label. A router forwarding a packet using segment routing pushes one or more MPLS labels.

SR using MPLS labels is used in both shortest path routing applications and in traffic engineering applications. The commands in the segment-routing context configure the shortest path forwarding application.

After SR is configured in the IS-IS instance, the router performs the following operations.

  1. Advertises the SR capability sub-TLV to routers in all areas and levels of this IGP instance. However, only neighbors with which it established an adjacency interpret the SID/label range information and use it to calculate the label to swap to or push for a specific resolved prefix SID.

  2. Advertises the assigned index for each configured node SID in the new prefix SID sub-TLV with the N-flag (node-SID flag) set. The SR module then programs the incoming label map (ILM) with a pop operation for each local node SID in the datapath.

  3. Assigns and advertises automatically an adjacency SID label for each formed adjacency over a network IP interface in the new adjacency SID sub-TLV. The SR module programs the incoming label map (ILM) with a pop operation, with a swap to an implicit null label operation, for each advertised adjacency SID.

  4. Resolves received prefixes, and if a prefix SID sub-TLV exists, the SR module programs the ILM with a swap operation and also an LTN with a push operation both pointing to the primary/LFA NHLFE. An SR tunnel is also added to the TTM.

When SR is enabled in an IGP instance, the main SPF and LFA SPF are computed and the primary next hop and LFA backup next hop for a received prefix are added to the RTM without the label information advertised in the prefix SID sub-TLV.

The no form of this command reverts to the default value.

prefix-sid-range

Syntax

prefix-sid-range {global | start-label label-value max-index index-value}

no prefix-sid-range

Context

config>router>isis>segment-routing

Platforms

7210 SAS-Mxp, 7210 SAS-R6, 7210 SAS-R12, and 7210 SAS-Sx/S 1/10GE

Description

This command configures the prefix SID index range and offset label value for an IGP instance.

The user must configure the prefix SID index range and the offset label value that this IGP instance uses. Because each prefix SID represents a network global IP address, the SID index for a prefix must be unique in the network. Therefore, all routers in the network configure and advertise the same prefix SID index range for an IGP instance. However, the label value used by each router to represent this prefix, that is, the label programmed in the ILM, can be local to that router by the use of an offset label, referred to as a start label, as in the following:

Local Label (Prefix SID) = start-label + {SID index}

The label operation in the network becomes similar to LDP when operating in the independent label distribution mode (RFC 5036), with the difference that the label value used to forward a packet to each downstream router is computed by the upstream router based on the advertised prefix SID index using the preceding formula.

There are two mutually exclusive modes of operation for the prefix SID range on the router.

In the global mode of operation, the global value is configured and this IGP instance assumes that the start label value is the lowest label value in the SRGB, and the prefix SID index range size is equal to the range size of the SRGB. When one IGP instance selects the global option for the prefix SID range, all IGP instances on the system are restricted to do the same. The user must shut down the SR context and delete the prefix-sid-range command in all IGP instances to change the SRGB. After the SRGB is changed, the user must re-enter the prefix-sid-range command. The SRGB range change fails if an already allocated SID index or label goes out of range.

In the per-instance mode of operation, the user partitions the SRGB into non-overlapping sub-ranges among the IGP instances. The user therefore configures a subset of the SRGB by specifying the start label value and the prefix SID index range size. All resulting net label values (start-label + index} must be within the SRGB or the configuration fails.

The code checks for overlaps of the resulting net label value range across IGP instances and strictly enforces that these ranges do not overlap. The user must shut down the SR context of an IGP instance to change the SID index or label range of that IGP instance using theprefix-sid-range command.

Any range change fails if an already allocated SID index or label goes out of range. The user can, however, change the SRGB on the fly as long as it does not reduce the current per-IGP instance SID index or label range defined in the prefix-sid-range command. Otherwise, the user must shut down the SR context of the IGP instance and delete and reconfigure the prefix-sid-range command.

The no form of this command reverts to the default value.

Default

no prefix-sid-range

Parameters

global

Keyword to enable global operation mode.

start-label label-value

Specifies the label offset for the SR label range of this IGP instance.

Values

0 to 524287

max-index index-value

Specifies the maximum value of the prefix SID index range for this IGP instance.

Values

1 to 524287

tunnel-mtu

Syntax

tunnel-mtu bytes

no tunnel-mtu

Context

config>router>isis>segment-routing

Platforms

7210 SAS-Mxp, 7210 SAS-R6, 7210 SAS-R12, and 7210 SAS-Sx/S 1/10GE

Description

This command configures the MTU of all SR tunnels within each IGP instance.

The MTU of an SR tunnel populated into the TTM is determined in the same way as for an IGP tunnel; for example, LDP LSP, based on the outgoing interface MTU minus the label stack size. Remote LFA can add at least two more labels to the tunnel for a total of three labels. There is no default value. If the user does not configure an SR tunnel MTU, IGP determines the MTU.

The MTU of the SR tunnel in bytes is determined as follows:

SR_Tunnel_MTU = MIN {Cfg_SR_MTU, IGP_Tunnel_MTU- (1+ frr-overhead)*4}

Where:

  • Cfg_SR_MTU is the MTU configured by the user for all SR tunnels within a specific IGP instance using this CLI command. If no value is configured, the SR tunnel MTU is determined by the IGP_Tunnel_MTU calculated value.

  • IGP_Tunnel_MTU is the minimum of the IS-IS or OSPF interface MTU among all the ECMP paths or among the primary and LFA backup paths of this SR tunnel.

  • frr-overhead is set to 1 if segment-routing and remote-lfa options are enabled in the IGP instance. Otherwise, it is set to 0.

The SR tunnel MTU is dynamically updated when any of the preceding parameters that are used in its calculation change. This includes when the set of the tunnel next hops changes, or the user changes the configured SR MTU or interface MTU value.

The no form of this command reverts to the default value.

Default

no tunnel-mtu

Parameters

bytes

Specifies the size of the MTU in bytes.

Values

512 to 9198

tunnel-table-pref

Syntax

tunnel-table-pref preference

no tunnel-table-pref

Context

config>router>isis>segment-routing

Platforms

7210 SAS-Mxp, 7210 SAS-R6, 7210 SAS-R12, and 7210 SAS-Sx/S 1/10GE

Description

This command configures the TTM preference of the shortest path SR tunnels created by the IGP instance. The TTM preference is used in the case of VPRN auto-bind or BGP transport tunnels when the new tunnel binding commands are configured to the any value, which parses the TTM for tunnels in the protocol preference order. Either use the global TTM preference or list the tunnel types to use. When listing the tunnel types, the TTM preference is used to select one type over the other. In both cases, a fall-back to the next preferred tunnel type is performed if the selected one fails. A reversion to a more preferred tunnel type is performed as soon as one is available.

The segment routing module adds an SR tunnel entry to the TTM for each resolved remote node SID prefix and programs the datapath that has the corresponding LTN with the push operation pointing to the primary and LFA backup NHLFEs.

The default preference for shortest path SR tunnels in the TTM is set lower than LDP tunnels but higher than BGP tunnels to allow controlled migration of customers without disrupting their current deployment when they enable segment routing. The following is the setting of the default preference of the various tunnel types. This includes the preference of SR tunnels based on the shortest path (referred to as SR-ISIS).

The global default TTM preference for the tunnel types is as follows:

  • ROUTE_PREF_RSVP 7

  • ROUTE_PREF_SR_TE 8

  • ROUTE_PREF_LDP 9

  • ROUTE_PREF_OSPF_TTM 10

  • ROUTE_PREF_ISIS_TTM 11

  • ROUTE_PREF_BGP_TTM 12

  • ROUTE_PREF_GRE 255

The default value for SR-ISIS is the same regardless of whether one or more IS-IS instances programmed a tunnel for the same prefix. The selection of an SR tunnel in this case is based on the lowest IGP instance ID.

The no form of this command reverts to the default value.

Default

no tunnel-table-pref

Parameters

preference

Specifies an integer value that represents the preference of IS-IS SR tunnels in the TTM.

Values

1 to 255

Default

11

spf-wait

Syntax

[no] spf-wait spf-wait [spf-initial-wait [spf-second-wait]]

Context

config>router>isis

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command defines the maximum interval between two consecutive SPF calculations.

Timers that determine when to initiate the first, second, and subsequent SPF calculations after a topology change occurs can be controlled using this command. Subsequent SPF runs (if required) occur at exponentially increasing intervals of the spf-second-wait interval. For example, if the spf-second-wait interval is 1000, the next SPF runs after 2000 milliseconds, and the next SPF runs after 4000 milliseconds, and so on, until it reaches the spf-wait value. The SPF interval stays at the spf-wait value until there are no more SPF runs scheduled in that interval. After a full interval without any SPF runs, the SPF interval drops back to spf-initial-wait.

Default

no spf-wait

Parameters

spf-wait

Specifies the maximum interval, in seconds, between two consecutive SPF calculations.

Values

1 to 120

Default

10

spf-initial-wait

Specifies the initial SPF calculation delay, in milliseconds, after a topology change.

Values

10 to 100000

Default

1000

spf-second-wait

Specifies the hold time, in milliseconds, between the first and second SPF calculation.

Values

0 to 100000

Default

1000

strict-adjacency-check

Syntax

[no] strict-adjacency-check

Context

config>router>isis

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables strict checking of address families (IPv4 and IPv6) for IS-IS adjacencies.

When enabled, adjacencies do not come up unless both routers have exactly the same address families configured. An existing adjacency that has unmatched address families is torn down. This command is used to prevent black-holing traffic when IPv4 and IPv6 topologies are different. When disabled (no strict-adjacency-check) a BFD session failure for either IPv4 or Ipv6 causes the routes for the other address family to be removed as well.

When disabled, both routers only need to have one common address family to establish the adjacency.

Default

no strict-adjacency-check

summary-address

Syntax

summary-address {ip-prefix/mask | ip-prefix [netmask]} level [tag tag]

no summary-address {ip-prefix/mask | ip-prefix [netmask]}

Context

config>router>isis

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables summary addresses.

Parameters

ip-prefix/mask

Specifies information for the specified IP prefix and mask length.

Values

ipv4-address:

a.b.c.d (host bits must be 0)

ipv4-prefix-length:

0 to 32

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 to FFFF]H

d: [0 to 255]D

ipv6-prefix-length:

[0 to 128]

netmask

Specifies the subnet mask, in dotted decimal notation.

Values

a.b.c.d (network bits all 1 and host bits all 0)

level

Specifies IS-IS level area attributes.

Values

level-1, level-2, level-1/2

tag tag

Assigns an OSPF, RIP, or IS-IS tag to routes matching the entry.

Values

Accepts decimal or hex formats: 1 to 4294967295

OSPF and IS-IS:

[0x0 to 0xFFFFFFFF]H

ignore-attached-bit

Syntax

[no] ignore-attached-bit

Context

config>router>isis

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures IS-IS to suppress the installation of default routes.

The no form of this command removes suppression of default route installation.

Default

no ignore-attached-bit

import

Syntax

import policy-name [policy-name...(up to 5 max)]

no import

Context

config>router>isis

Platforms

7210 SAS-Mxp

Description

This command specifies up to five route polices as IS-IS import policies.

When a prefix received in an IS-IS LSP is accepted by an entry in an IS-IS import policy, it is installed in the routing table if it is the most preferred route to the destination.

When a prefix received in an IS-IS LSP is rejected by an entry in an IS-IS import policy, it is not installed in the routing table, even if it has the lowest preference value among all the routes to that destination.

The flooding of LSPs is unaffected by IS-IS import policy actions.

The no form of this command removes all policies from the configuration.

Default

no import

Parameters

policy-name

Specifies the import route policy name. Allowed values are any string up to 32 characters, composed of printable, 7-bit ASCII characters. If the string contains special characters (#, $, spaces, and so on), the entire string must be enclosed within double quotes. The specified names must already be defined.

traffic-engineering

Syntax

[no] traffic-engineering

Context

config>router>isis

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures traffic-engineering and determines if IGP shortcuts are required.

The no form of this command disables traffic-engineered route calculations.

Default

no traffic-engineering

wide-metrics-only

Syntax

[no] wide-metrics-only

Context

config>router>isis>level

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables the exclusive use of wide metrics in the LSPs for the level number. Narrow metrics can have values between 1 and 63. IS-IS can generate two TLVs, one for the adjacency and one for the IP prefix. To support traffic engineering, wider metrics are required. When wide metrics are used, a second pair of TLVs are added for the adjacency and the IP prefix.

By default, both sets of TLVs are generated. When the wide-metrics-only command is configured, IS-IS only generates the pair of TLVs with wide metrics for that level.

The no form of this command reverts to the default value.

1 Change internal preferences using the preference command in the config>router>isis>level context.
2 External preferences are changed using the external-preference command in the config>router>isis>level context.