display mpls te cspf destination

Function

The display mpls te cspf destination command checks for paths that satisfy specified constraints. The constraints are specified using parameters.

Format

display mpls te cspf destination ip-address [ bandwidth { ct0 ct0-bandwidth | ct1 ct1-bandwidth | ct2 ct2-bandwidth | ct3 ct3-bandwidth | ct4 ct4-bandwidth | ct5 ct5-bandwidth | ct6 ct6-bandwidth | ct7 ct7-bandwidth } | metric-type { igp | te } | priority setup-priority | srlg-strict exclude-path-name | tie-breaking { random | most-fill | least-fill } | explicit-path pri-path-name | affinity { pri-properties [ mask pri-mask-value ] | { { include-all | include-any } { pri-in-name-string } &<1-32> | exclude { pri-ex-name-string } &<1-32> } ^* } | hop-limit pri-hop-limit-number ] ^* [ hot-standby [ explicit-path hsb-path-name | overlap-path | affinity { hsb-properties [ mask hsb-mask-value ] | { { hsb-include-all | hsb-include-any } { hsb-in-name-string } &<1-32> | hsb-exclude { hsb-ex-name-string } &<1-32> } ^* } | hop-limit hsb-hop-limit-number | srlg { strict | preferred } ] ^* ]

display mpls te cspf destination ip-address [ bandwidth { ct0 ct0-bandwidth | ct1 ct1-bandwidth | ct2 ct2-bandwidth | ct3 ct3-bandwidth | ct4 ct4-bandwidth | ct5 ct5-bandwidth | ct6 ct6-bandwidth | ct7 ct7-bandwidth } | metric-type { igp | te } | priority setup-priority | tie-breaking { random | most-fill | least-fill } | computation-mode disjoint | affinity { pri-properties [ mask pri-mask-value ] | { { include-all | include-any } { pri-in-name-string } &<1-32> | exclude { pri-ex-name-string } &<1-32> } ^* } ] ^* [ hot-standby [ affinity { hsb-properties [ mask hsb-mask-value ] | { { hsb-include-all | hsb-include-any } { hsb-in-name-string } &<1-32> | hsb-exclude { hsb-ex-name-string } &<1-32> } ^* } ] ]

Parameters

Parameter	Description	Value
ip-address	Specifies the destination IP address of a tunnel.	The value is in dotted decimal notation.
bandwidth	Indicates the bandwidth constraints.	-
ct0 ct0-bandwidth	Specifies the bandwidth to be reserved for CT0.	The value is an integer ranging from 1 to 4000000000, in kbit/s.
ct1 ct1-bandwidth	Specifies the bandwidth to be reserved for CT1.	The value is an integer ranging from 1 to 4000000000, in kbit/s.
ct2 ct2-bandwidth	Specifies the bandwidth to be reserved for CT2.	The value is an integer ranging from 1 to 4000000000, in kbit/s.
ct3 ct3-bandwidth	Specifies the bandwidth to be reserved for CT3.	The value is an integer ranging from 1 to 4000000000, in kbit/s.
ct4 ct4-bandwidth	Specifies the bandwidth to be reserved for CT4.	The value is an integer ranging from 1 to 4000000000, in kbit/s.
ct5 ct5-bandwidth	Specifies the bandwidth to be reserved for CT5.	The value is an integer ranging from 1 to 4000000000, in kbit/s.
ct6 ct6-bandwidth	Specifies the bandwidth to be reserved for CT6.	The value is an integer ranging from 1 to 4000000000, in kbit/s.
ct7 ct7-bandwidth	Specifies the bandwidth to be reserved for CT7.	The value is an integer ranging from 1 to 4000000000, in kbit/s.
metric-type	Indicates the metric type.	-
igp	Indicates the IGP metric.	-
te	Indicates the TE metric.	-
priority setup-priority	Specifies the setup priority.	The value is an integer ranging from 0 to 7, the default value is 7.
srlg-strict exclude-path-name	Specifies the name of a path based on an SRLG.	The value is a string of characters, spaces are not supported, and the length is 1 to 128.
tie-breaking	Indicates the tie-breaking strategy is adopted when the path is pre-computed.	-
random	Randomly selects a path for a tunnel.	-
most-fill	Randomly selects a path for a tunnel.	-
least-fill	Selects a route with the lowest ratio of the used bandwidth to the maximum reservable bandwidth.	-
explicit-path pri-path-name	Specifies the name of an explicit path.	The value is a string of characters, spaces are not supported, and the length is 1 to 128.
explicit-path hsb-path-name	Specifies the name of an explicit path over which a hot-standby LSP is established.	The value is a string of 1 to 128 case-insensitive characters, spaces not supported.
affinity pri-properties	Specify affinity parameters.	The value ranges from 0 to ffffffff, in hexadecimal notation. The default value is 0.
mask pri-mask-value	Specifies the mask of an affinity.	The value is in dotted decimal notation.
mask hsb-mask-value	Specifies the mask of an affinity of a hot-standby LSP.	The value is in dotted decimal notation.
include-all	Allows CSPF to include a link when calculating a path, only if each link administrative group bit has the same name as each affinity bit.	-
include-any	Allows CSPF to include a link when calculating a path, if at least one link administrative group bit has the same name as an affinity bit.	-
pri-in-name-string	Specifies a name of an included affinity.	The value is a string of 1 to 31 case-sensitive characters, spaces not supported.
exclude	Allows CSPF to exclude a link when calculating a path, if any link administrative group bit has the same name as an affinity bit.	-
pri-ex-name-string	Specifies a name of an excluded affinity.	The value is a string of 1 to 31 case-sensitive characters, spaces not supported.
hop-limit pri-hop-limit-number	Specifies the number of hops on a path.	The value is an integer ranging from 1 to 32.
hop-limit hsb-hop-limit-number	Specifies the maximum number of hops on a path over which a hot-standby LSP is established.	The value is an integer ranging from 1 to 32.
hot-standby	Indicates a hot-standby path.	-
overlap-path	Indicates that a hot-standby LSP can overlap the primary LSP.	-
hsb-properties	Specifies the affinity name of a hot-standby LSP.	The value ranges from 0 to ffffffff, in hexadecimal notation. The default value is 0.
hsb-include-all	Allows CSPF to include a link when calculating a hot-standby path, only if each link administrative group bit has the same name as each affinity bit.	-
hsb-include-any	Allows CSPF to include a link when calculating a hot-standby path, if at least one link administrative group bit has the same name as an affinity bit.	-
hsb-in-name-string	Specifies a name of an included affinity of a hot-standby LSP.	The value is a string of 1 to 31 case-sensitive characters, spaces not supported.
hsb-exclude	Allows CSPF to exclude a link when calculating a hot-standby path, if any link administrative group bit has the same name as an affinity bit.	-
hsb-ex-name-string	Specifies a name of an excluded affinity of a hot-standby LSP.	The value is a string of 1 to 31 case-sensitive characters, spaces not supported.
srlg	Indicates the SRLG attribute.	-
strict	Indicates that the links calculated by CSPF for a hot-standby LSP must in a different SRLG from those of the primary LSP.	-
preferred	Preferentially selects the SRLG attribute as an optional constraint used by CSPF to calculate a path for a hot-standby LSP. If CSPF fails to calculate a path for a hot-standby CR-LSP based on the SRLG attribute, CSPF recalculates the path, regardless of the SRLG attribute.	-
computation-mode	Enables the algorithm for CSPF.	-
disjoint	Enables the disjoint algorithm for CSPF.	-

Views

All views

Default Level

1: Monitoring level

Task Name and Operations

Task Name	Operations
mpls-te	read

Usage Guidelines

Usage Scenario

To check for a path that satisfies specified constraints between the specified ingress and egress, run the display mpls te cspf destination command.

Precautions

Perform the following operations to prevent a failure to displaying command output:

CSPF has been enabled using the mpls te cspf command.
IS-IS TE or OSPF TE has been enabled.
Configure an explicit path to define nodes to be included or excluded for a tunnel to a specified destination.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display the path of an LSP that CSPF uses affinities and the primary/backup disjoint algorithm to compute.

<HUAWEI> display mpls te cspf destination 10.5.5.5 computation-mode disjoint affinity include-all red hot-standby affinity hsb-include-all red
Main path for the given constraints is:
10.2.2.2                         Include          LSR-ID
10.2.1.1                         Include 
10.2.1.2                         Include 
10.1.1.1                         Include          LSR-ID
10.3.1.1                         Include 
10.3.1.2                         Include 
10.3.3.3                         Include          LSR-ID
10.4.1.1                         Include 
10.4.1.2                         Include 
10.5.5.5                         Include          LSR-ID
The total metrics of the calculated path is :   111
  
  
Hot-standby path for the given constraints is:
10.2.2.2                         Include          LSR-ID
10.1.1.1                         Include 
10.1.1.2                         Include 
10.4.4.4                         Include          LSR-ID
10.6.1.1                         Include 
10.6.1.2                         Include 
10.6.6.6                         Include          LSR-ID
10.7.1.1                         Include 
10.7.1.2                         Include 
10.5.5.5                         Include          LSR-ID
Complete disjoint path computed and the total metrics of the calculated path is :   210

# Run the display mpls te cspf destination 6.6.6.6 computation-mode disjoint command to view the computed primary and hot-standby LSPs after the disjoint algorithm is enabled for CSPF.

<HUAWEI> display mpls te cspf destination 10.6.6.6 computation-mode disjoint
Main path for the given constraints is:
1.1.1.1                          Include          LSR-ID
10.1.1.1                         Include 
10.1.1.2                         Include 
10.3.3.3                         Include          LSR-ID
10.1.4.1                         Include 
10.1.4.2                         Include 
10.5.5.5                         Include          LSR-ID
10.1.5.1                         Include 
10.1.5.2                         Include 
10.6.6.6                         Include          LSR-ID
The total metrics of the calculated path is :   16
  
Hot-standby path for the given constraints is:
1.1.1.1                          Include          LSR-ID
10.1.2.1                         Include 
10.1.2.2                         Include 
10.2.2.2                         Include          LSR-ID
10.1.6.1                         Include 
10.1.6.2                         Include 
10.4.4.4                         Include          LSR-ID
10.1.7.1                         Include 
10.1.7.2                         Include 
10.6.6.6                         Include          LSR-ID
Complete disjoint path computed and the total metrics of the calculated path is :   21

# Display paths that CSPF computes and satisfy the specified constraints.

<HUAWEI> display mpls te cspf destination 10.2.2.9
Path for the given constraints is:
1.1.1.9                          Include          LSR-ID
192.168.1.1                      Include 
192.168.1.2                      Include 
10.2.2.9                         Include          LSR-ID
The total metrics of the calculated path is :   10
<HUAWEI> display mpls te cspf destination 10.2.2.9 explicit-path path1
Path for the given constraints is:
1.1.1.9                          Include          LSR-ID
192.168.1.1                      Include 
192.168.1.2                      Include 
10.2.2.9                          Include          LSR-ID
The total metrics of the calculated path is :   10
<HUAWEI> display mpls te cspf destination 10.2.2.19 explicit-path path1
System is busy try it later.
<HUAWEI> display mpls te cspf destination 10.2.2.19 explicit-path path1
CSPF compute time out.
<HUAWEI> display mpls te cspf destination 3.3.3.3 hot-standby
Main path for the given constraints is:
1.1.1.1                          Include         LSR-ID
10.1.1.1                         Include
10.1.1.3                         Include
3.3.3.3                          Include         LSR-ID
The total metrics of the calculated path is :    10

Hot-standby path for the given constraints is:
1.1.1.1                          Include         LSR-ID
10.10.1.1                        Include
10.10.1.2                        Include
4.4.4.4                          Include         LSR-ID
10.11.1.2                        Include
10.11.1.1                        Include
3.3.3.3                          Include         LSR-ID
Complete disjoint path computed and the total metrics for the calculated path is : 20

**Table 1** Description of the **display mpls te cspf destination** command output
Item	Description
Main path for the given constraints is	Information about all primary LSPs satisfying the constraints is displayed.
LSR-ID	The local node is an LSR on an LSP, not a link node.
The total metrics of the calculated path is	Metric value of the computed path.
Hot-standby path for the given constraints is	Information about all hot-standby LSPs satisfying the constraints is displayed.
Complete disjoint path computed and the total metrics of the calculated path is	CSPF computes a path that never overlaps with a primary LSP and displays the path metric.
Complete disjoint path computed and the total metrics for the calculated path is	Disjoint path was computed and the total metrics for the calculated path was got.
Path for the given constraints is	Computed path information.
System is busy try it later	The system is processing path pre-computation and can repeat the operation only after the existing pre-computation finishes.
CSPF compute time out	CSPF computation times out, or the system pre-computation times out.