Perform Router Commands

router

Syntax

router router-instance

router service-name service-name

Context

tools>perform

Description

This command enables tools for the router instance.

Default

n/a

Parameters

router-instance

specifies the router name and service ID

Values

router-name:      Base, management

service-id:           1 to 2147483647

Default

Base

service-name

specifies the service name

isis

Syntax

isis [isis-instance]

Context

tools>perform>router

Description

This command enables the context to perform specific IS-IS tasks.

Default

n/a

Parameters

isis-instance

specifies the IS-IS protocol instance ID. If no isis-instance is specified, instance 0 is used.

Values

1 to 31

mpls

Syntax

mpls

Context

tools>perform>router

Description

This command enables the context to perform specific MPLS tasks.

Default

n/a

cspf

Syntax

cspf to ip-addr [from ip-addr] [bandwidth bandwidth] [include-bitmap bitmap] [exclude-bitmap bitmap] [hop-limit limit] [exclude-address excl-addr [excl-addr...(up to 8 max)]] [use-te-metric] [strict-srlg] [srlg-group grp-id...(up to 8 max)] [exclude-node excl-node-id [excl-node-id...(up to 8 max)]] [skip-interface interface-name] [cspf-req-type req-type] [least-fill-min-thd thd]

Context

tools>perform>router>mpls

Description

This command computes a CSPF path with specified user constraints.

Default

n/a

Parameters

to ip-addr

the destination IP address

Values

a.b.c.d

from ip-addr

the originating IP address

Values

a.b.c.d

bandwidth

the amount of bandwidth in megabits per second (Mb/s) to be reserved

Values

0 to 4294967295 (values can be expressed in decimal, hexadecimal, or binary)

include-bitmap bitmap

specifies to include a bitmap that lists the admin groups that should be included during the CSPF computation

exclude-bitmap bitmap

specifies to exclude a bitmap that lists the admin groups that should be included during the CSPF computation

limit

the total number of hops an FRR bypass or detour LSP can take before merging back onto the main LSP path

Values

1 to 255

excl-addr

an IP address to exclude from the CSPF computation (up to a maximum of eight addresses in one command)

Values

a.b.c.d (outbound interface)

use-te-metric

specifies to use the traffic engineering metric used on the interface

strict-srlg

specifies to use strict frr-srlg to compute a new CSPF path

grp-id

specifies to use up to eight SRLGs to compute a new CSPF path

Values

0 to 4294967295

excl-node-id

a node to exclude from the CSPF computation (up to a maximum of eight nodes in one command)

Values

a.b.c.d (outbound interface)

interface-name

a local interface name (rather than the address) to exclude from the CSPF computation

Values

max 32 characters

req-type

the CSPF request type

Values

all – all ECMP paths

random – random ECMP paths

least-fill – specifies whether the use of the least-fill path selection method for the computation of the path for this CSPF request is enabled

thd

the percentage difference below which two links are considered equal for least-fill bandwidth comparison. When comparing the percentages of least available link bandwidth across available paths, whenever two percentages differ by less than the value configured as the least-fill minimum threshold, CSPF considers them to be equal and applies a random number generator to select the path.

Values

1 to 100

resignal

Syntax

resignal {lsp lsp-name path path-name | delay minutes}

Context

tools>perform>router>mpls

Description

This command resignals specified LSP paths. The minutes parameter is used to configure the global timer to resignal all LSPs. The resignal timer is the time before resignaling occurs after the resignal condition occurs. If only lsp-name and path-name are provided, the specified LSP is resignaled immediately. For the delay option to work, the resignal time in the config>router>mpls context must be set.

Default

n/a

Parameters

lsp-name

specifies a unique LSP name, up to 32 characters

path-name

specifies the name for the LSP path, up to 32 characters

minutes

specifies the delay interval, in minutes, before all LSPs are resignaled. If the value 0 is entered, all LSPs are resignaled immediately.

Values

0 to 30

resignal-bypass

Syntax

resignal-bypass delay minutes

resignal-bypass lsp bypass-lsp-name [force]

Context

tools>perform>router>mpls

Description

This command performs a manual reoptimization of a specific dynamic or manual bypass LSP or of all dynamic bypass LSPs.

The manual bypass LSP name is user-configured. The dynamic bypass LSP name is shown in the output of the show>router>mpls>bypass-tunnel dynamic detail command.

The delay option triggers the global reoptimization of all dynamic bypass LSPs at the expiry of the specified delay. This option forces the global bypass resignal timer to expire after an amount of time equal to the value of the delay parameter. This option does not apply to a manual bypass LSP.

When a bypass LSP name is specified, that dynamic or manual bypass LSP is not signaled and the associations are not evaluated even if the new bypass LSP path has the same cost as the current one. This is a different behavior from the resignal command for the primary or secondary path of an LSP, because a bypass LSP can have a large number of PSB associations.

If the specified LSP is a manual bypass LSP with no PSB associations, the LSP is torn down and resignaled using the new path provided by CSPF. If there are one or more PSB associations but the PLR is not active, the command fails and the user is asked to explicitly enter the force option. In this case, the manual bypass LSP is torn down and resignaled, leaving the associated LSP primary paths temporarily unprotected. If there are any active PLRs associated with the manual bypass LSP, the command fails

Default

n/a

Parameters

minutes

the time that MPLS waits before attempting to resignal dynamic bypass LSP paths originated on the system

Values

0 to 30

bypass-lsp-name

the name of the dynamic or manual bypass LSP

force

required when the LSP is a manual bypass LSP with PSB associations

sr-te-cspf

Syntax

sr-te-cspf to ip-address [path path-name] [from ip-address]

Context

tools>perform>router>mpls

Description

This command computes and returns the segment routing label stack for any user-specified MPLS path to a destination router.

MPLS passes the specified path information to the TE-DB, which converts the list of hops into a label stack by scanning the database for adjacency and node SID information that belongs to the router or link identified by each hop address. If the conversion is successful, the database will return the actual selected hop SIDs plus labels, as well as the configured path hop addresses that were used as the input for this conversion.

Parameters

to ip-address

specifies the destination IP address

path-name

specifies the path name

from ip-address

specifies the originating IP address

trap-suppress

Syntax

trap-suppress number-of-traps time-interval

Context

tools>perform>router>mpls

Description

This command modifies thresholds for trap suppression. The command is used to suppress traps after the specified number of traps has been raised within the specified period of time.

Default

n/a

Parameters

number-of-traps

specifies the number of traps in multiples of 100. An error message is generated if an invalid value is entered.

Values

100 to 1000

time-interval

specifies the time interval in seconds

Values

1 to 300

update-path

Syntax

update-path {lsp lsp-name path current-path-name new-path new-path-name}

Context

tools>perform>router>mpls

Description

This command instructs MPLS to replace the path of a primary or secondary LSP. The primary or secondary LSP path is indirectly identified with the current-path-name value. The same path name cannot be used more than once for an LSP name.

This command applies to both a CSPF LSP and a non-CSPF LSP. The command only works when the specified current-path-name has the adaptive option enabled. The adaptive option can be enabled at the LSP level or the path level.

The new path must have been configured in the CLI or provided via SNMP. The CLI command for entering the path is config>router>mpls>path path-name.

The command fails if any of the following conditions exist:

  • the specified current-path-name of this LSP does not have the adaptive option enabled

  • the specified new-path-name value does not correspond to a previously defined path

  • the specified new-path-name value exists but is being used by any path of the same LSP, including this one

When you execute this command, MPLS performs the following procedures.

  • MPLS performs a single MBB attempt to move the LSP path to the new path.

  • If the MBB is successful, MPLS updates the new path.

    • MPLS writes the corresponding NHLFE in the data path if this path is the current backup path for the primary path.

    • If the current path is the active LSP path, MPLS will update the path and write the new NHLFE in the data path, which will cause traffic to switch to the new path.

  • If the MBB is not successful, the path retains its current value.

    The update-path MBB has the same priority as the manual resignal MBB.

Parameters

lsp-name

specifies the administrative name for this LSP

current-path-name

specifies the name of the current path

new-path-name

specifies the name of the new path

ospf

Syntax

ospf

Context

tools>perform>router

Description

This command enables the context to perform specific OSPF tasks.

Default

n/a

ldp-sync-exit

Syntax

ldp-sync-exit

Context

tools>perform>router>ospf

tools>perform>router>isis

Description

This command terminates IGP-LDP synchronization. OSPF or IS-IS then advertises the actual cost value of the link for all interfaces that have IGP-LDP synchronization enabled, if the currently advertised cost is different.

Default

n/a

refresh-lsas

Syntax

refresh-lsas [lsa-type] [area-id]

Context

tools>perform>router>ospf

Description

This command refreshes LSAs for OSPF.

Default

n/a

Parameters

lsa-type

the specified LSA type

Values

router, network, summary, asbr, extern, nssa, opaque

area-id

the OSPF area ID expressed in dotted-decimal notation or as a 32-bit integer

Values

0.0.0.0 to 255.255.255.255 (dotted-decimal), 0 to 4294967295 (decimal integer)

run-manual-spf

Syntax

run-manual-spf [externals-only]

Context

tools>perform>router>ospf

tools>perform>router>isis

Description

This command runs the shortest path first (SPF) algorithm for OSPF or IS-IS.

The externals-only parameter applies only to OSPF.

Default

n/a

Parameters

externals-only

specifies the route preference for OSPF external routes