The display mpls te cspf destination command helps you check whether the specified path is available or not. You can specify relevant parameters in the command to set constraint conditions.
display mpls te cspf destination ip-address [ affinity properties [ mask mask-value ] | bandwidth { ct0 ct0-bandwidth | ct1 ct1-bandwidth } * | explicit-path path-name | hop-limit hop-limit-number | metric-type { igp | te } | priority setup-priority | srlg-strict exclude-path-name | tie-breaking { random | most-fill | least-fill } ] * [ hot-standby [ explicit-path path-name | overlap-path | affinity properties [ mask mask-value ] | hop-limit hop-limit-number | srlg { preferred | strict } ] * ]
| Parameter | Description | Value |
|---|---|---|
| destination ip-address | Specifies the destination IP address of an MPLS TE tunnel. | The value is in dotted decimal notation. |
| affinity properties | Specifies the affinity property of an MPLS TE tunnel. | The value is a hexadecimal number that ranges from 0 to FFFFFFFF. |
| mask mask-value | Specifies the value of the affinity property mask. | The value is a hexadecimal number that ranges from 0 to FFFFFFFF. |
| bandwidth | Specifies the required bandwidth of an MPLS TE tunnel. | - |
| ct0 ct0-bandwidth | ct1 ct1-bandwidth | Specifies the bandwidth values of CR-LSPs of CT0 to CT1. | The value is an integer that ranges from 1 to 4000000000. |
| explicit-path path-name | Specifies the explicit path of an MPLS TE tunnel. | The value is an existing explicit path name. |
| hop-limit hop-limit-number | Specifies the maximum number of hops on an MPLS TE tunnel. | The value is an integer that ranges from 1 to 32. By default, the maximum number of hops is 32. |
| metric-type | Specifies the metric type for the CSPF calculation. | - |
| igp | Specifies the metric type as IGP. | - |
| te | Specifies the metric type as TE. | - |
| priority setup-priority | Specifies the setup priority of an MPLS TE tunnel. | The value is an integer that ranges from 0 to 7. |
| srlg-strict exclude-path-name | Specifies the path of a specified SRLG. | The value is an existing explicit path name. |
| tie-breaking | Configures a tie-breaking mode for CSPF. | - |
| random | Configures the random mode. | - |
| most-fill | Configures the most-fill mode, meaning the path with the highest ratio of used bandwidth to maximum reservable bandwidth is selected. | - |
| least-fill | Configures the least-fill mode, meaning the path with the lowest ratio of used bandwidth to the maximum capacity of reservable bandwidth is selected. | - |
| hot-standby | Configures hot-standby path excluding primary path. | - |
| overlap-path | Specifies that if a completely disjoint path is not available, a maximally disjoint path should be computed for the Hot-standby. | - |
| srlg preferred | Specifies that the SRLG attribute is an optional constraint used by CSPF to calculate the path for the hot-standby CR-LSP. If CSPF fails to calculate the path for the hot-standby CR-LSP based on the SRLG attribute, CSPF recalculates the path, regardless of the SRLG attribute. | - |
| srlg strict | Specifies that the SRLG attribute is a required constraint used by CSPF to calculate the path for the hot-standby CR-LSP. The links of the hot-standby CR-LSP and the primary CR-LSP cannot be in the same SRLG. | - |
Prerequisites
Before running this command, the CSPF function must have been enabled by using the mpls te cspf command.
Precautions
When this command is run, the device uses CSPF to check whether there is a path satisfying the specified constraints. If such a path exists, its information is displayed; otherwise, the display is empty.
# Display the path with the destination address being 10.3.3.9 by performing the CSPF calculation.
<HUAWEI> display mpls te cspf destination 10.3.3.9
Path for the given constraints is:
10.1.1.9 Include LSR-ID
172.16.1.1 Include
172.16.1.2 Include
10.2.2.9 Include LSR-ID
172.17.1.1 Include
172.17.1.2 Include
10.3.3.9 Include LSR-ID
The total metrics of the calculated path is : 2
# Display the explicit path named path1 with the destination address being 10.3.3.9 by performing the CSPF calculation.
<HUAWEI> display mpls te cspf destination 10.3.3.9 explicit-path path1
Path for the given constraints is:
10.1.1.9 Include LSR-ID
172.16.1.1 Include
172.16.1.2 Include
10.2.2.9 Include LSR-ID
172.17.1.1 Include
172.17.1.2 Include
10.3.3.9 Include LSR-ID
The total metrics of the calculated path is : 2
# Display the hot standby path with the destination address being 10.3.3.9 by performing the CSPF calculation.
<HUAWEI> display mpls te cspf destination 10.3.3.9 hot-standby
Path for the given constraints is:
10.1.1.9 Include LSR-ID
172.16.1.1 Include
172.16.1.2 Include
10.2.2.9 Include LSR-ID
172.17.1.1 Include
172.17.1.2 Include
10.3.3.9 Include LSR-ID
The total metrics of the calculated path is : 2
Hot-standby path for the given constraints is:
10.1.1.9 Include LSR-ID
172.19.1.1 Include
172.19.1.2 Include
10.6.6.9 Include LSR-ID
172.20.1.1 Include
172.20.1.2 Include
10.3.3.9 Include LSR-ID
Complete disjoint path computed and the total metrics of the calculated path is : 2
<HUAWEI> display mpls te cspf destination 10.4.4.9 hot-standby overlap-path
Main path for the given constraints is:
10.1.1.9 Include LSR-ID
172.16.1.1 Include
172.16.1.2 Include
10.2.2.9 Include LSR-ID
172.17.1.1 Include
172.17.1.2 Include
10.3.3.9 Include LSR-ID
172.18.1.1 Include
172.18.1.2 Include
10.4.4.9 Include LSR-ID
The total metrics of the calculated path is : 3
Hot-standby path for the given constraints is:
10.1.1.9 Include LSR-ID
172.21.1.1 Include
172.21.1.2 Include
10.6.6.9 Include LSR-ID
172.22.1.1 Include
172.22.1.2 Include
10.3.3.9 Include LSR-ID
172.18.1.1 Include
172.18.1.2 Include
10.4.4.9 Include LSR-ID
Partial Overlap path computed and the total metrics of the calculated path is :
3
Item |
Description |
|---|---|
Path for the given constraints is |
Path calculated by CSPF. If * is displayed, it indicates the node does not exist on the explicit path calculated by CSPF. If * is not displayed, it indicates that the node exists on the path calculated by CSPF. |
10.1.1.9 Include LSR-ID |
Path information. 10.1.1.9 is the next hop address, Include is the node name, and LSR-ID indicates that the LSR ID is used as the address. |
The total metrics of the calculated path is |
Calculated metric value of a path. |
Main path for the given constraints is |
Path for the main request, when both main and hot-standby is requested. |
Hot-standby path for the given constraints is |
Path calculated by CSPF for the hot-standby. |
Complete disjoint path computed and the total metrics of the calculated path is |
CSPF has calculated complete disjoint path from main path for hot-standby. |
Partial Overlap path computed and the total metrics of the calculated path is |
CSPF has calculated partial overlap path from main path for hot-standby. |