Tools commands

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] [srlggroup grp-id...(up to 8 max)] [skip-interface interface-name]

Context

tools>perform>router>mpls

Platforms

Supported on all 7210 SAS platforms as described in this document.

Description

This command computes a CSPF path with specified user constraints.

Parameters

to ip-addr

Specifies the destination IP address.

from ip-addr

Specifies the originating IP address.

bandwidth bandwidth

Specifies the amount of bandwidth in mega-bits per second (Mbps) to be reserved.

include-bitmap bitmap

Specifies to include a bit-map that specifies a list of admin groups that should be included during setup.

exclude-bitmap bitmap

Specifies to exclude a bit-map that specifies a list of admin groups that should be included during setup.

hop-limit limit

Specifies the total number of hops a detour LSP can take before merging back onto the main LSP path.

exclude-address ip-addr

Specifies IP addresses, up to 8, that should be included during setup.

use-te-metric

Keyword to specify the use of the traffic engineering metric used on the interface.

strict-srlg

Keyword to specify whether to associate the LSP with a bypass or signal a detour if a bypass or detour satisfies all other constraints except the SRLG constraints.

srlg-group grp-id

Specifies up to 8 Shared Risk Link Groups (SRLGs). An SRLG group represents a set of interfaces which could be subject to the same failures or defects and therefore, share the same risk of failing.

Values

0 to 4294967295

skip-interface interface-name

Specifies an interface name that should be skipped during setup.

Output

Sample output
*A:Dut-C# tools perform router mpls cspf to 10.20.1.6 

Req CSPF for all ECMP paths
    from: this node to: 10.20.1.6 w/
(no Diffserv) class: 0 , setup Priority 7, Hold Priority 0 TE Class: 7 

CSPF Path
To        : 10.20.1.6 
Path 1    : (cost 2000)
    Src:   10.20.1.3   (= Rtr)
    Egr:   unnumbered lnkId 4               -
> Ingr:   unnumbered lnkId 2                 Rtr:   10.20.1.5          (met 1000)
    Egr:   unnumbered lnkId 3               -
> Ingr:   unnumbered lnkId 3                 Rtr:   10.20.1.6          (met 1000)
    Dst:   10.20.1.6   (= Rtr)

Path 2    : (cost 2000)
    Src:   10.20.1.3   (= Rtr)
    Egr:   unnumbered lnkId 5               -
> Ingr:   unnumbered lnkId 5                 Rtr:   10.20.1.4          (met 1000)
    Egr:   unnumbered lnkId 3               -
> Ingr:   unnumbered lnkId 2                 Rtr:   10.20.1.6          (met 1000)
    Dst:   10.20.1.6   (= Rtr)

*A:Dut-C#

resignal

Syntax

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

Context

tools>perform>router>mpls

Platforms

Supported on all 7210 SAS platforms as described in this document.

Description

This command resignals specified LSP paths. The minutes parameter configures the global timer to resignal all LSPs. If only lsp-name and path-name are provided, the specified LSP is resignaled immediately.

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 {lsp bypass-lsp-name [force] | delay minutes}

Context

tools>perform>router>mpls

Platforms

7210 SAS-Mxp, 7210 SAS-R6, and 7210 SAS-R12

Description

This command performs a manual re-optimization of a specific dynamic or manual bypass LSP, or of all dynamic bypass LSPs.

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

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 has no effect on a manual bypass LSP.

However, when bypass-lsp-name is specified, the named dynamic or manual bypass LSP is signaled, and the associations are moved only if the new bypass LSP path has a lower cost than the current path. This behavior is different from that of the tools>perform>router>mpls>resignal command for the primary or secondary active path of an LSP, which signals and switches to the new path, regardless of the cost comparison. This handling is required because a bypass LSP may have a large number of PSB associations and the processing churn is much higher.

In the specific case where the name corresponds to a manual bypass LSP, the LSP is torn down and resignaled using the new path provided by CSPF if no PSB associations exist. If one or more PSB associations exist but no PLR is active, the command fails and the user is required to explicitly enter the force option. In this case, the manual bypass LSP is torn down and resignaled, temporarily leaving the associated LSP primary paths unprotected. If one or more PLRs associated with the manual bypass LSP is active, the command fails.

Finally, and as with the timer-based resignal, the PSB associations are checked for the SRLG and admin-group constraints using the updated information provided by CSPF for the current path and new path of the bypass LSP.

Parameters

lsp bypass-lsp-name [force]

Specifies the name, up to 160 characters, of the dynamic or manual bypass LSP. The force option is required when the name corresponds to a manual bypass LSP and the LSP has PSB associations.

delay minutes

Specifies the time, in minutes, that MPLS waits before attempting to resignal dynamic bypass LSP paths originated on the system.

Values

0 to 30

tp-tunnel

Syntax

tp-tunnel

Context

tools>perform>router>mpls

Platforms

7210 SAS-T, 7210 SAS-R6, and 7210 SAS-R12

Description

Commands in this context perform linear protection operations on an MPLS-TP LSP.

clear

Syntax

clear id tunnel-id lsp-name

Context

tools>perform>router>mpls>tp-tunnel

Platforms

Supported on all 7210 SAS platforms as described in this document.

Description

This command clears all MPLS-TP linear protection operational commands for the specified LSPs that are currently active.

Parameters

tunnel-id

Specifies the tunnel number of the MPLS-TP LSP, up to 32 characters.

lsp-name

Specifies the name of the MPLS-TP LSP.

Values

1 to 61440

force

Syntax

force id tunnel-id lsp-name

Context

tools>perform>router>mpls>tp-tunnel

Platforms

Supported on all 7210 SAS platforms as described in this document.

Description

This command performs a force switchover of the MPLS-TP LSP from the active path to the protect path.

Parameters

tunnel-id

Specifies the tunnel number of the MPLS-TP LSP, up to 32 characters.

lsp-name

Specifies the name of the MPLS-TP LSP.

Values

1 to 61440

lockout

Syntax

lockout tunnel-id lsp-name

Context

tools>perform>router>mpls>tp-tunnel

Platforms

Supported on all 7210 SAS platforms as described in this document.

Description

This command performs a lockout of protection for an MPLS-TP LSP. This prevents a switchover to the protect path.

Parameters

tunnel-id

Specifies the tunnel number of the MPLS-TP LSP, up to 32 characters.

lsp-name

Specifies the name of the MPLS-TP LSP.

Values

1 to 61440

manual

Syntax

manual tunnel-id lsp-name

Context

tools>perform>router>mpls>tp-tunnel

Platforms

Supported on all 7210 SAS platforms as described in this document.

Description

This command performs a manual switchover of the MPLS-TP LSP from the active path to the protect path.

Parameters

tunnel-id

Specifies the tunnel number of the MPLS-TP LSP, up to 32 characters.

lsp-name

Specifies the name of the MPLS-TP LSP.

Values

1 to 61440

trap-suppress

Syntax

trap-suppress number-of-traps time-interval

Context

tools>perform>router>mpls

Platforms

Supported on all 7210 SAS platforms as described in this document.

Description

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

Parameters

number-of-traps

Specifies the number of traps, in multiples of 100.

Values

100 to 1000

time-interval

Specifies the time interval, in seconds.

Values

1 to 300