- Table of Contents
-
- 07-MPLS Command Reference
- 00-Preface
- 01-Basic MPLS commands
- 02-SR-MPLS commands
- 03-Static LSP commands
- 04-LDP commands
- 05-MPLS TE commands
- 06-Static CRLSP commands
- 07-RSVP commands
- 08-Tunnel policy commands
- 09-MPLS L3VPN commands
- 10-MPLS L2VPN commands
- 11-VPLS commands
- 12-MPLS OAM commands
- 13-MCE commands
- Related Documents
-
Title | Size | Download |
---|---|---|
02-SR-MPLS commands | 185.41 KB |
display bgp egress-engineering ipv4
display bgp segment-routing label-range
display isis segment-routing adjacency
display isis segment-routing global-block
display isis segment-routing prefix-sid-map
display mpls static-sr-mpls prefix
display segment-routing mapping-server prefix-sid-map
fast-reroute microloop-avoidance enable
fast-reroute microloop-avoidance rib-update-delay
isis fast-reroute ti-lfa disable
segment-routing adjacency enable
segment-routing mapping-server advertise-local
segment-routing mapping-server receive
segment-routing microloop-avoidance enable
segment-routing microloop-avoidance rib-update-delay
SR-MPLS commands
display bgp egress-engineering ipv4
Use display bgp egress-engineering ipv4 to display BGP EPE adjacency segment information.
Syntax
display bgp [ instance instance-name ] egress-engineering ipv4 [ ipv4-address ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
instance instance-name: Specifies a BGP instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays information about the default BGP instance.
ipv4-address: Specifies the IPv4 address of an existing peer. If you do not specify this argument, the command displays information about all peers and peer groups.
Examples
# Display BGP EPE adjacency segment information.
<Sysname> display bgp egress-engineering ipv4
BGP peering segment type: Set
Nexthop : 192.168.1.2
Local AS number : 1
Remote AS number : 2
Local router ID : 1.1.1.3
Remote router ID : 1.1.1.4
OriginNextHop : 192.168.1.2
RelyNextHop : 192.168.1.2
Interface : Vlan10
Label : 24002
BGP peering segment type: Set
Nexthop : 192.168.1.3
Local AS number : 1
Remote AS number : 2
Local router ID : 1.1.1.3
Remote router ID : 1.1.1.5
OriginNextHop : 192.168.1.3
RelyNextHop : 192.168.1.3
Interface : Vlan20
Label : 24003
# Display BGP EPE adjacency segment information for a peer.
<Sysname> display bgp egress-engineering ipv4 192.168.1.2
BGP peering segment type: Node
Nexthop : 192.168.1.2
Local AS number : 1
Remote Asnumber : 2
Local router ID : 1.1.1.3
Remote router ID : 1.1.1.4
OriginNextHop : 192.168.1.2
RelyNextHop : 192.168.1.2
Label : 24002
# Display BGP EPE adjacency segment information for a peer.
<Sysname> display bgp egress-engineering ipv4 192.168.1.5
BGP peering segment type: Adjacency
NextHop : 192.168.1.5
Local AS number : 1
Remote AS number : 2
Local router ID : 1.1.1.3
Remote router ID : 1.1.1.5
OriginNextHop : 192.168.1.5
RelyNextHop : 192.168.1.5
Interface : Vlan50
Label : 24002
Table 1 Command output
Field |
Description |
Interface |
Interface on which the neighborship is established. |
OriginNextHop |
Original next hop. |
RelyNextHop |
Recursive next hop. |
display bgp segment-routing label-range
Use display bgp segment-routing label-range to display BGP SR label ranges.
Syntax
display bgp [ instance instance-name ] segment-routing label-range
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
instance instance-name: Specifies a BGP instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays information about the default BGP instance.
Examples
# Display BGP SR label ranges.
<Sysname> display bgp segment-routing label-range
BGP peering segment labels:
2048-15999
24001-599999
Prefix labels:
16000-24000
display isis segment-routing adjacency
Use display isis segment-routing adjacency to display IS-IS SR adjacency segment information.
Syntax
display isis segment-routing adjacency [ process-id ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
process-id: Specifies an IS-IS process ID in the range of 1 to 65535. If you do not specify this argument, the command displays SR adjacency segment information about all IS-IS processes.
Examples
# Display SR adjacency segment information about IS-IS process 1.
<Sysname> display isis segment-routing adjacency 1
Segment routing adjacency path information for IS-IS(1)
--------------------------------------------------
SystemID Interface Nexthop Label Type
-------------------------------------------------------------------------------
0000.0000.0011 Vlan1 10.123.110.21 24122 L1
0000.0000.0012 Vlan2 192.168.56.21 24121 L1
Table 2 Command output
Field |
Description |
SystemID |
System ID of the neighbor. |
Interface |
Interface connected to the neighbor. |
Nexthop |
Next hop of the adjacency segment. |
Label |
Incoming label. |
Type |
Link adjacency type of the interface. |
display isis segment-routing global-block
Use display isis segment-routing global-block to display IS-IS SRGB information.
Syntax
display isis segment-routing global-block [ level-1 | level-2 ] [ process-id ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
level-1: Specifies Level-1 SRGB.
level-2: Specifies Level-2 SRGB.
process-id: Specifies an IS-IS process ID in the range of 1 to 65535. If you do not specify this argument, the command displays the SRGBs of all IS-IS processes.
Usage guidelines
If you do not specify the level-1 or level-2 keyword, the command displays information about both the Level-1 SRGB and Level-2 SRGB.
Examples
# Display information about the SRGBs for IS-IS process 1.
<Sysname> display isis segment-routing global-block 1
Segment routing global block information for IS-IS(1)
-----------------------------------------------------
Level-1 SRGB
-------------------------
System ID Base Range
-------------------------------------------------------------------------------
0000.0000.0011 16666 5557
0000.0000.0012 18012 4001
Table 3 Command output
Field |
Description |
System ID |
System ID of the neighbor. |
Base |
Minimum label value of the SRGB. |
Range |
Number of labels in the SRGB. |
Related commands
segment-routing global-block
display isis segment-routing prefix-sid-map
Use display isis segment-routing prefix-sid-map to display IS-IS SR prefix-SID mappings.
Syntax
display isis segment-routing prefix-sid-map [ active-policy | backup-policy ] [ process-id ] [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
active-policy: Displays active prefix-SID mappings.
backup-policy: Displays inactive prefix-SID mappings.
process-id: Specifies an IS-IS process ID in the range of 1 to 65535. If you do not specify this argument, the command displays information about all IS-IS processes.
verbose: Displays detailed information. If you do not specify this keyword, the command displays brief information.
Usage guidelines
If you do not specify the active-policy or backup-policy keyword, the command displays information about both active and inactive prefix-SID mappings.
Examples
# Display active IS-IS SR prefix-SID mappings.
<Sysname> display isis segment-routing prefix-sid-map active-policy
ISIS 1 - Active policy
Number of mappings: 5
Prefix SID index Range Flags
2.2.2.2/32 10 10 -
3.3.3.3/32 300 1 -
8.8.8.8/32 600 20 -
11.11.11.11/32 100 10 -
12.12.12.1/32 44 3 -
# Display detailed information about active IS-IS SR prefix-SID mappings.
<Sysname> display isis segment-routing prefix-sid-map active-policy verbose
ISIS 1 - Active policy
Number of mappings: 2
Prefix 1.1.1.1 32
Source : Local
Router ID : 1010.1020.1030
Level : Not set
SID index : 100
Range : 1
Last prefix : 1.1.1.1/32
Last SID index: 100
Flags : -
Prefix 2.2.2.2 32
Source : Remote
Router ID : 1010.1020.1040
Level : L1
SID index : 200
Range : 1
Last prefix : 2.2.2.2/32
Last SID index: 200
Flags : -
# Display inactive IS-IS SR prefix-SID mappings.
<Sysname> display isis segment-routing prefix-sid-map backup-policy
ISIS 1 - Backup policy
Number of mappings: 4
Prefix SID index Range Flags
2.2.2.2/32 200 30 -
12.12.12.1/32 44 3 -
8.8.8.8/32 600 20 -
2.2.2.2/32 10 10 -
# Display all IS-IS SR prefix-SID mappings.
<Sysname> display isis segment-routing prefix-sid-map
ISIS 1 – Both active policy and backup policy
Number of mappings: 9
Prefix SID index Range Flags
2.2.2.2/32 10 10 -
2.2.2.2/32 10 10 -
2.2.2.2/32 200 30 -
3.3.3.3/32 300 1 -
8.8.8.8/32 600 20 -
8.8.8.8/32 600 20 -
11.11.11.11/32 100 10 -
12.12.12.1/32 44 3 -
12.12.12.1/32 44 3 -
Table 4 Command output
Field |
Description |
ISIS 1 – Active policy |
Active prefix-SID mappings in IS-IS process 1. |
ISIS 1 – Backup policy |
Inactive prefix-SID mappings in IS-IS process 1. |
ISIS 1 – Both active policy and backup policy |
All prefix-SID mappings in IS-IS process 1. |
SID index |
Start SID index value. |
Range |
Number of consecutive SIDs assigned. |
Flags |
Mapping flags. The A flag means attached, which indicates that the peer specified by the prefix is directly connected to the device. If no flags are set, this field displays a hyphen (-). |
Source |
Source of the prefix-SID mapping: · Local—The mapping is configured on the local device. · Remote—The mapping is configured on the remote device. |
Router ID |
ID of the route advertiser. |
Level |
Level of the route advertiser: · L1—Level-1 IS-IS route. · L2—Level-2 IS-IS route. · Not set—The route was locally advertised. |
display mpls static-sr-mpls
Use display mpls static-sr-mpls to display static SRLSP and adjacency segment information.
Syntax
display mpls static-sr-mpls { lsp [ lsp-name ] | adjacency [ adjacency-path-name ] }
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
lsp: Displays static SRLSP information.
lsp-name: Specifies a static SRLSP by its name, a case-sensitive string of 1 to 15 characters. If you do not specify this argument, the command displays information about all static SRLSPs.
adjacency: Displays static adjacency segment information.
adjacency-path-name: Specifies a static adjacency segment by its name, a case-sensitive string of 1 to 15 characters. If you do not specify this argument, the command displays information about all static adjacency segments.
Examples
# Display information about all static SRLSPs.
<Sysname> display mpls static-sr-mpls lsp lsp1
Name : lsp1
Type : LSP
In-Label : -
Out-Label : 60,70,80
Out-Interface : -
Nexthop : -
State : Up
Table 5 Command output
Field |
Description |
Name |
Name of the static SRLSP or adjacency segment. |
Type |
Information type: · LSP—Static SRLSP information. · Adjacency—Adjacency segment information. |
In-Label |
Incoming label. |
Out-Label |
Outgoing label. |
Out-Interface |
Outgoing interface. |
Nexthop |
Next hop address. |
State |
Status of the static SRLSP or adjacency segment: · Down—The static SRLSP or adjacency segment is not available. · Up—The static SRLSP or adjacency segment is available. |
Related commands
static-sr-mpls adjacency
static-sr-mpls lsp
display mpls static-sr-mpls prefix
Use display mpls static-sr-mpls prefix to display static prefix segment information.
Syntax
display mpls static-sr-mpls prefix [ path lsp-name | destination ip-address [ mask | mask-length ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
path lsp-name: Displays static prefix segment information for the specified static SRLSP. The lsp-name argument specifies a static SRLSP by its name, a case-sensitive string of 1 to 15 characters.
destination ip-address: Displays static prefix segment information for the specified destination address. The ip-address argument specifies a destination address.
mask: Specifies the destination address mask.
mask-length: Specifies the mask length, in the range of 0 to 32.
Usage guidelines
If you do not specify any parameters, this command displays information about all static prefix segments.
Examples
# Display information about all static prefix segments.
<Sysname> display mpls static-sr-mpls prefix
Prefix Name : prefixname
Destination : 2.2.2.2/32
In-Label : 1024
Active : Yes(1)
Out-Interface : Vlan2
Nexthop : 10.0.0.2
Out-Label : 600000
Status : up
Out-Interface : Vlan3
Nexthop : 11.0.0.2
Out-Label : 600002
Status : down(No Route)
Out-Interface : Vlan4
Nexthop : 12.0.0.2
Out-Label : 600001
Status : down(No Mpls)
Table 6 Command output
Field |
Description |
Prefix Name |
Name of the prefix segment. |
Destination |
Destination IP address of the prefix segment. |
In-Label |
Incoming label of the prefix segment. |
Active |
Status of the prefix segment: · Yes(count)—The prefix segment is active. The value of count represents the number of egresses in up status. · No—The prefix segment is inactive. |
Out-Interface |
Outgoing interface of the prefix segment. |
Nexthop |
Next hop of the prefix segment. |
Out-Label |
Outgoing label of the prefix segment. |
Status |
Status of the egress: · down—The egress is inactive. The cause is displayed in brackets, which can be No Route or No Mpls. No Route means that the device has no route to reach the destination IP address over the outgoing interface. No Mpls means that MPLS is disabled on the outgoing interface. · up—The egress is active. · duplicate—An egress conflict has occurred because the outgoing interface is already used by another prefix segment. |
Related commands
static-sr-mpls prefix
display segment-routing mapping-server prefix-sid-map
Use display segment-routing mapping-server prefix-sid-map to display prefix-SID mappings.
Syntax
display segment-routing mapping-server prefix-sid-map [ ip-address mask-length | verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
ip-address: Specifies an IPv4 address prefix in dotted decimal notation.
mask-length: Specifies the mask length, in the range of 1 to 32.
verbose: Displays detailed information about all configured prefix-SID mappings.
Usage guidelines
If you do not specify any parameters, this command displays brief information about all configured prefix-SID mappings.
Examples
# Display the prefix-SID mapping for prefix 1.1.1.1.
<Sysname> display segment-routing mapping-server prefix-sid-map 1.1.1.1 32
SRMS mappings
Prefix SID index Range Flags
1.1.1.1/32 10 100 A
# Display all configured prefix-SID mappings.
<Sysname> display segment-routing mapping-server prefix-sid-map
SRMS mappings
Number of mappings: 2
Prefix SID index Range Flags
1.1.1.1/32 10 100 A
2.2.2.2/32 256 520 -
# Display detailed information about all configured prefix-SID mappings.
<Sysname> display segment-routing mapping-server prefix-sid-map verbose
SRMS mappings
Number of mappings: 2
Prefix 1.1.1.1/32
SID index : 10
Range : 100
Last prefix : 1.1.1.100/24
Last SID index: 109
Flags : A
Prefix 2.2.2.2/32
SID index : 256
Range : 520
Last prefix : 2.2.4.9/24
Last SID index: 775
Flags : -
Table 7 Command output
Field |
Description |
SID index |
Start SID index value. |
Range |
Number of consecutive SIDs assigned. |
Flags |
Mapping flags. The A flag means attached, which indicates that the peer specified by the prefix is directly connected to the device. If no flags are set, this field displays a hyphen (-). |
Last Prefix |
Final prefix. |
Last SID index |
SID assigned to the final prefix. |
fast-reroute microloop-avoidance enable
Use fast-reroute microloop-avoidance enable to enable FRR microloop avoidance.
Use undo fast-reroute microloop-avoidance enable to disable FRR microloop avoidance.
Syntax
fast-reroute microloop-avoidance enable [ level-1 | level-2 ]
undo fast-reroute microloop-avoidance enable [ level-1 | level-2 ]
Default
FRR microloop avoidance is disabled.
Views
IS-IS IPv4 unicast address family view
Predefined user roles
network-admin
Parameters
level-1: Specifies FRR microloop avoidance for IS-IS Level-1.
level-2: Specifies FRR microloop avoidance for IS-IS Level-2.
Usage guidelines
Use this command only on the source node (the node prior to the node or link that failed).
On an network configured with TI-LFA FRR, if a node or link fails, traffic will be switched to the backup path calculated by TI-LFA. However, if a device along the backup path has not finished route convergence, traffic will be looped between the device and the source node. The loop stops only when the device finishes route convergence.
To resolve this problem, configure microloop avoidance on the source node. Then, when a node or link fails, traffic will be switched to the backup path calculated by TI-LFA. The source node waits for a period of time for other devices to finish route convergence. After the delay time elapses, the source node starts route convergence.
If you do not specify the level-1 or level-2 keyword, the command enables or disables FRR microloop avoidance on all IS-IS levels.
Examples
# Enable FRR microloop avoidance for IS-IS process 1.
<Sysname> system-view
[Sysname] isis 1
[Sysname-isis-1] address-family ipv4
[Sysname-isis-1-ipv4] fast-reroute microloop-avoidance enable
Related commands
fast-reroute microloop-avoidance rib-update-delay
fast-reroute microloop-avoidance rib-update-delay
Use fast-reroute microloop-avoidance rib-update-delay to set the FRR microloop avoidance RIB-update-delay time.
Use undo fast-reroute microloop-avoidance rib-update-delay to restore the default.
Syntax
fast-reroute microloop-avoidance rib-update-delay delay-time [ level-1 | level-2 ]
undo fast-reroute microloop-avoidance rib-update-delay [ level-1 | level-2 ]
Default
The FRR microloop avoidance RIB-update-delay time is 5000 ms.
Views
IS-IS IPv4 unicast address family view
Predefined user roles
network-admin
Parameters
delay-time: Specifies the FRR microloop avoidance RIB-update-delay time in milliseconds. The value range is 1 to 60000.
level-1: Specifies the FRR microloop avoidance RIB-update-delay time for IS-IS Level-1.
level-2: Specifies the FRR microloop avoidance RIB-update-delay time for IS-IS Level-2.
Usage guidelines
Use this command only on the source node (the node prior to the node or link that failed).
If you do not specify the level-1 or level-2 keyword, the command sets the FRR microloop avoidance RIB-update-delay time for all IS-IS levels.
Examples
# Set the FRR microloop avoidance RIB-update-delay time to 6000 ms for Level-1 of IS-IS process 1.
<Sysname> system-view
[Sysname] isis 1
[Sysname-isis-1] address-family ipv4
[Sysname-isis-1-ipv4] fast-reroute microloop-avoidance rib-update-delay 6000 level-1
Related commands
fast-reroute microloop-avoidance
fast-reroute ti-lfa
Use fast-reroute ti-lfa to enable Topology-Independent Loop-Free Alternate Fast Re-Route (TI-LFA FRR).
Use fast-reroute ti-lfa to disable TI-LFA FRR.
Syntax
fast-reroute ti-lfa [ per-prefix ] [ route-policy route-policy-name | host ] [ level-1 | level-2 ]
undo fast-reroute ti-lfa [ level-1 | level-2 ]
Default
TI-LFA FRR is disabled.
Views
IS-IS IPv4 unicast address family view
Predefined user roles
network-admin
Parameters
per-prefix: Calculates backup routing information for each advertising source of each route. If you do not specify this keyword, the device calculates backup routing information for each route.
route-policy route-policy-name: Enables TI-LFA FRR for prefixes identified by a routing policy. The route-policy-name argument specifies the routing policy name, a case-sensitive string of 1 to 63 characters.
host: Enables TI-LFA FRR for host routes.
level-1: Specifies TI-LFA FRR for IS-IS Level-1.
level-2: Specifies TI-LFA FRR for IS-IS Level-2.
Usage guidelines
TI-LFA FRR provides link and node protection for SR tunnels. When a link or node fails, TI-LFA FRR switches the traffic to the backup path to ensure continuous data forwarding.
Before configuring TI-LFA FRR, you must execute the following commands in IS-IS IPv4 unicast address family view:
· segment-routing mpls
· fast-reroute lfa
TI-LFA FRR takes effect only after you enable LFA FRR.
TI-LFA FRR operates in a level only after you enable LFA FRR for the level.
If you do not specify the route-policy route-policy-name or host option, the device enables TI-LFA FRR for all routes.
If you do not specify the level-1 or level-2 keyword, the command enables or disables TI-LFA FRR for all IS-IS levels.
Examples
# Enable TI-LFA FRR for IS-IS process 1.
<Sysname> system-view
[Sysname] isis 1
[Sysname-isis-1] address-family ipv4
[Sysname-isis-1-ipv4] fast-reroute ti-lfa
Related commands
fast-reroute (Layer 3—IP Routing Command Reference)
route-policy (Layer 3—IP Routing Command Reference)
segment-routing mpls
isis adjacency-sid
Use isis adjacency-sid to assign an IS-IS adjacency SID to an IS-IS adjacency.
Use undo isis adjacency-sid to reclaim an IS-IS adjacency SID.
Syntax
isis adjacency-sid { absolute absolute-value | index index-value } [ nexthop nexthop-address ]
undo isis adjacency-sid { absolute absolute-value | index index-value }
Default
An IS-IS adjacency does not have an adjacency SID.
Views
Interface view
Predefined user roles
network-admin
Parameters
absolute absolute-value: Specifies an absolute value as the adjacency SID. The value range for the absolute-value argument is 15000 to 15999.
index index-value: Specifies an adjacency SID index value. The value range for the index-value argument is 0 to 999.
nexthop nexthop-address: Specifies a next hop by its IP address. If the network type of the interface is broadcast, you must specify this option. If the network type of the interface is P2P, you cannot specify this option.
Usage guidelines
After you enable SR-MPLS adjacency label allocation, the device randomly allocates adjacency SIDs to the links to its IGP neighbors. If the link to an IGP neighbor flaps, the adjacency SID of the link keeps changing. For a link to always use the same adjacency SID, use this command to assign a specific adjacency SID to the link.
You can assign adjacency SID by using absolute values or index values. If you use index values, the adjacency SID of a link is the base value of the SRLB plus the index value for the link.
Before assigning adjacency SIDs, execute the display mpls label command to display the usage status of the labels that you want to assign as adjacency SIDs. Make sure the labels are in Idle state. A label that is not in Idle state is being used by another protocol. If you assign it to a link as an adjacency SID, the adjacency SID is not available even if the status of the label changes to Idle later. To use the adjacency SID, you must remove the adjacency SID assignment and assign the adjacency SID again.
Before executing this command on an interface, you must enable IS-IS on the interface.
If you execute this command on an interface multiple times, the most recent configuration takes effect.
This command takes effect only after you execute the segment-routing mpls and segment-routing adjacency enable commands.
If you execute this command on an interface after enabling SR-MPLS adjacency label allocation for an IGP, the interface prefers the assigned adjacency SID.
You can use the isis circuit-type p2p command to change the network type of an interface. To change the network type of an interface after you assign an adjacency SID on the interface, you must remove the assignment first.
Examples
# Set the absolute value of the adjacency SID to 20000 on interface VLAN-interface 10. Specify 1.1.1.1 as the next hop.
<Sysname> system-view
[Sysname] interface vlan-interface 10
[Sysname-Vlan-interface10] isis enable 1
[Sysname-Vlan-interface10] isis adjacency-sid absolute 20000 nexthop 1.1.1.1
Related commands
isis circuit-type p2p (Layer 3—IP Routing Command Reference)
isis enable (Layer 3—IP Routing Command Reference)
isis fast-reroute ti-lfa disable
Use isis fast-reroute ti-lfa disable to disable an IS-IS interface from participating in TI-LFA calculation.
Use undo isis fast-reroute ti-lfa disable to enable an IS-IS interface to participate in TI-LFA calculation.
Syntax
isis fast-reroute ti-lfa disable [ level-1 | level-2 ]
undo isis fast-reroute ti-lfa disable [ level-1 | level-2 ]
Default
An IS-IS interface participates in TI-LFA calculation.
Views
Interface view
Predefined user roles
network-admin
Parameters
level-1: Specifies TI-LFA calculation on IS-IS Level-1.
level-2: Specifies TI-LFA calculation on IS-IS Level-2.
Usage guidelines
Disable the outgoing interface to the primary next hop from participating in TI-LFA calculation.
If you do not specify the level-1 or level-2 keyword, the command disables or enables the interface to participate in TI-LFA calculation in any level.
Examples
# Disable VLAN-interface 10 from participating in TI-LFA calculation.
<Sysname> system-view
[Sysname] interface vlan-interface 10
[Sysname-Vlan-interface10] isis enable 1
[Sysname-Vlan-interface10] isis fast-reroute ti-lfa disable
Related commands
fast-reroute ti-lfa
isis prefix-sid
Use isis prefix-sid to configure an IS-IS prefix SID.
Use undo isis prefix-sid to restore the default.
Syntax
isis [ process-id process-id ] prefix-sid { absolute absolute-value | index index-value } [ n-flag-clear | { explicit-null | no-php } ] *
undo [ process-id process-id ] isis prefix-sid
Default
No IS-IS prefix SID is configured.
Views
Loopback interface view
Predefined user roles
network-admin
Parameters
process-id process-id: Specifies an IS-IS multi-instance process by its ID in the range of 1 to 65535. To configure an IS-IS prefix SID for a traditional IS-IS process, do not specify this option.
absolute absolute-value: Specifies an absolute value as the prefix SID. The absolute-value argument is in the range of 0 to 1048575.
index index-value: Specifies an index value. The index-value argument is in the range of 0 to 1048575.
n-flag-clear: Sets the Node-SID flag bit of the prefix SID to 0 to use the prefix SID for a group of SR nodes. If you do not specify this keyword, the flag bit is 1 and the prefix SID is used for a single SR node.
explicit-null: Sets the Explicit-null flag bit of the prefix SID to 1. This setting requires that the upstream neighbor uses an explicit null label to replace the prefix SID. If you do not specify this keyword, the flag bit is 0 and the upstream neighbor continues to forward the packet based on the prefix SID. For more information about the explicit null label, see MPLS basics configuration in MPLS Configuration Guide.
no-php: Sets the P-flag bit of the prefix SID to 1 so the penultimate hop does not pop out the SID. If you do not specify this keyword, the P-flag bit is 0 and the penultimate hop pops out the SID.
Usage guidelines
An absolute value used as the prefix SID must be in the SRGB of the node.
If you specify an index value, the sum of the index value and the SRGB base value is used as the prefix SID. The prefix SID must be in the SRGB of the node.
To use a prefix SID for a group of SR nodes in anycast scenarios, specify the n-flag-clear keyword to set the Node-SID flag bit of the prefix SID to 0.
To configure an IS-IS prefix SID, you must enable an IS-IS process on the loopback interface.
If you execute this command on an interface multiple times, the most recent configuration takes effect.
Examples
# Set the IS-IS prefix SID index to 20 on loopback interface 1.
<Sysname> system-view
[Sysname] interface loopback 1
[Sysname-LoopBack1] isis enable 1
[Sysname-LoopBack1] isis prefix-sid index 20
mapping-server prefix-sid-map
Use mapping-server prefix-sid-map to configure a prefix-SID mapping.
Use undo mapping-server prefix-sid-map to delete a prefix-SID mapping.
Syntax
mapping-server prefix-sid-map ip-address mask-length start-value [ range range-value ] [ attached ]
undo mapping-server prefix-sid-map ip-address mask-length
Default
No prefix-SID mappings exist.
Views
Segment routing view
Predefined user roles
network-admin
Parameters
ip-address: Specifies an IPv4 address prefix to be mapped or specifies the start IP prefix for a range of prefix-SID mappings, in dotted decimal notation.
mask-length: Specifies the mask length, in the range of 1 to 32.
start-value: Specifies the index value of the SID to be mapped to the specified prefix, or specifies the index value of the start SID for a range of prefix-SID mappings. The value range for this argument is 0 to 1048574.
range range-value: Specifies the number of prefix-SID mappings, in the range of 1 to 1048575. Specify this option if you want to configure more than one mapping by using a single command. The system creates the specified number of mappings, starting from the start IP prefix and SID index value. The increment step for the prefix and SID index value is 1.
attached: Specifies that the specified prefixes represent local networks.
Usage guidelines
The specified prefixes must not belong to any existing prefix-SID mappings.
Before you configure prefix-SID mappings in bulk, plan the number of mappings. Make sure there are enough mappings to use.
If you specify a value greater than 65535 for the range-value argument, the prefix-SID mappings cannot be advertised through IS-IS or OSPF.
Examples
# Map prefix 1.1.1.1/32 to SID index value 100.
<Sysname> system-view
[Sysname] segment-routing
[Sysname-segment-routing] mapping-server prefix-sid-map 1.1.1.1 32 100
# Configure two prefix-SID mappings, starting from prefix 10.1.1.1/32 and SID index value 200.
<Sysname> system-view
[Sysname] segment-routing
[Sysname-segment-routing] mapping-server prefix-sid-map 10.1.1.1 32 200 range 2
In the first mapping, the prefix is 10.1.1.1/32 and the SID is 200. In the second mapping, the prefix is 10.1.1.2/32 and the SID is 201.
mpls te static-sr-mpls
Use mpls te static-sr-mpls to bind a static SRLSP to an MPLS TE tunnel interface.
Use undo mpls te static-sr-mpls to unbind a static SRLSP from an MPLS TE tunnel interface.
Syntax
mpls te static-sr-mpls lsp-name [ backup ]
undo mpls te static-sr-mpls lsp-name
Default
An MPLS TE tunnel interface does not use any static SRLSPs.
Views
Tunnel interface view
Predefined user roles
network-admin
Parameters
lsp-name: Specifies a static SRLSP by its name, a case-sensitive string of 1 to 15 characters. The specified static SRLSP must be already created by using the static-sr-mpls lsp command.
backup: Specifies the backup static SRLSP. If you do not specify this keyword, this command specifies the main static SRLSP.
Usage guidelines
Execute this command only on the ingress node of a static SRLSP.
This command takes effect only if you have configured the mpls te signaling static command in tunnel interface view.
You can specify the backup keyword to bind a backup static SRLSP only if both the main and backup SRLSPs are established by using the adjacency segment method.
If you execute both the mpls te static-sr-mpls and mpls te static-cr-lsp commands on the device, only the mpls te static-cr-lsp command takes effect. For the mpls te static-sr-mpls command to take effect, execute the undo mpls te static-cr-lsp command.
Examples
# Bind static SRLSP static-sr-3 to MPLS TE tunnel interface 10.
<Sysname> system-view
[Sysname] interface tunnel 10 mode mpls-te
[Sysname-Tunnel10] mpls te static-sr-mpls static-sr-3
Related commands
display mpls te tunnel-interface (MPLS Command Reference)
mpls te signaling (MPLS Command Reference)
mpls te static-cr-lsp (MPLS Command Reference)
static-sr-mpls lsp
peer egress-engineering
Use peer egress-engineering to enable BGP EPE for a peer or peer group and specify a routing policy to assign a label (SID) to the peer or peer group.
Use undo peer egress-engineering to restore the default for a peer or peer group.
Syntax
peer { group-name | ipv4-address [ mask-length ] } egress-engineering [ adjacency | set ] [ route-policy policy-name ]
undo peer { group-name | ipv4-address [ mask-length ] } egress-engineering
Default
BGP EPE is disabled.
Views
BGP instance view
Predefined user roles
network-admin
Parameters
group-name: Specifies an existing peer group by its name, a case-sensitive string of 1 to 47 characters.
ipv4-address: Specifies the IPv4 address of an existing peer.
mask-length: Specifies the mask length, in the range of 0 to 32. This argument and the ipv4-address argument together specify a subnet. If you specify this argument, the command applies to dynamic peers on the specified subnet.
adjacency: Assigns a Peer-Adjacency-SID.
set: Assigns a Peer-Set-SID.
route-policy route-policy-name: Specifies a routing policy by its name, a case-sensitive string of 1 to 63 characters. If you do not specify this option, the device assigns SIDs to BGP peers randomly.
Usage guidelines
If you do not specify the adjacency or set keyword, the device assigns a Peer-Node-SID.
When you use BGP EPE to apply a routing policy to a peer or peer group, follow these restrictions and guidelines:
· You cannot specify the same routing policy for multiple BGP peers or peer groups when you assign a Peer-Node-SID or Peer-Adjacency-SID to the BGP peers or peer groups.
· You can specify the same routing policy for multiple peers or peer groups only when you assign a Peer-Set-SID to the BGP peers or peer groups.
· You can use if-match interface as a filtering condition only if the EBGP session is established by using a loopback interface.
Examples
# Enable BGP EPE for peer 1.1.1.1 and assign a Peer-Node-SID to the peer.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp-default] peer 1.1.1.1 egress-engineering
segment-routing
Use segment-routing to enable segment routing and enter segment routing view.
Use undo segment-routing to disable segment routing.
Syntax
segment-routing
undo segment-routing
Default
Segment routing is disabled.
Views
System view
Predefined user roles
network-admin
Usage guidelines
To configure the Segment Routing Mapping Server (SRMS) features, you must execute this command on the SRMS. The SRMS is an entity that advertises prefix-SID mappings in an IGP. By deploying an SRMS, you can allocate SIDs to devices that do not support SR-MPLS, allowing for SR-MPLS and LDP interworking.
Examples
# Enable segment routing and enter segment routing view.
<Sysname> system-view
[Sysname] segment-routing
[Sysname-segment-routing]
segment-routing adjacency enable
Use segment-routing adjacency enable to enable SR-MPLS adjacency label allocation.
Use undo segment-routing adjacency enable to disable SR-MPLS adjacency label allocation.
Syntax
segment-routing adjacency enable
undo segment-routing adjacency enable
Default
SR-MPLS adjacency label allocation is disabled.
Views
IS-IS IPv4 unicast address family view
Predefined user roles
network-admin
Usage guidelines
For this command to take effect, you must enable SR-MPLS.
Examples
# Enable SR-MPLS adjacency label allocation for IS-IS process 1.
<Sysname> system-view
[Sysname] isis 1
[Sysname-isis-1] address-family ipv4
[Sysname-isis-1-ipv4] segment-routing adjacency enable
Related commands
segment-routing mpls
segment-routing global-block
Use segment-routing global-block to configure the MPLS SRGB.
Use undo segment-routing global-block to restore the default.
Syntax
segment-routing global-block minimum-value maximum-value
undo segment-routing global-block
Default
The minimum label value is 16000. The maximum label value is 24000.
Views
IS-IS view
Predefined user roles
network-admin
Parameters
minimum-value: Specifies the minimum label value, in the range of 16000 to 23999.
maximum-value: Specifies the maximum label value, in the range of 16001 to 24000.
Usage guidelines
To configure the SRGB successfully, make sure the SRGB contains the configured prefix SID.
Examples
# Configure the MPLS SRGB to be from 17000 to 22000 for IS-IS process 1.
<Sysname> system-view
[Sysname] isis 1
[Sysname-isis-1] segment-routing global-block 17000 22000
segment-routing mapping-server advertise-local
Use segment-routing mapping-server advertise-local to enable advertisement of locally configured prefix-SID mappings.
Use undo segment-routing mapping-server advertise-local to disable advertisement of locally configured prefix-SID mappings.
Syntax
segment-routing mapping-server advertise-local
undo segment-routing mapping-server advertise-local
Default
Advertisement is disabled for locally configured prefix-SID mappings.
Views
IS-IS IPv4 unicast address family view
Predefined user roles
network-admin
Usage guidelines
In an SR to LDP interworking scenario, you must execute this command on the SRMS so the device advertises locally configured prefix-SID mappings to neighbors.
Examples
# Enable IS-IS to advertise locally configured prefix-SID mappings for IS-IS process 1.
<Sysname> system-view
[Sysname] isis 1
[Sysname-isis-1] address-family ipv4
[Sysname-isis-1-ipv4] segment-routing mapping-server advertise-local
Related commands
mapping-server prefix-sid-map
segment-routing mapping-server receive
Use segment-routing mapping-server receive to enable reception of prefix-SID mappings.
Use undo segment-routing mapping-server receive to disable reception of prefix-SID mappings.
Syntax
segment-routing mapping-server receive
undo segment-routing mapping-server receive
Default
Reception of prefix-SID mappings is enabled.
Views
IS-IS IPv4 unicast address family view
Predefined user roles
network-admin
Usage guidelines
In an SR to LDP interworking scenario, you must execute this command on the SRMCs so they can identify the prefix-SID mappings advertised by the SRMS.
Examples
# Disable reception of prefix-SID mappings for IS-IS process 1.
<Sysname> system-view
[Sysname] isis 1
[Sysname-isis-1] address-family ipv4
[Sysname-isis-1-ipv4] undo segment-routing mapping-server receive
Related commands
mapping-server prefix-sid-map
mapping-server prefix-sid-map advertise-local
segment-routing microloop-avoidance enable
Use segment-routing microloop-avoidance enable to enable SR microloop avoidance.
Use undo segment-routing microloop-avoidance enable to disable SR microloop avoidance.
Syntax
segment-routing microloop-avoidance enable [ level-1 | level-2 ]
undo segment-routing microloop-avoidance enable [ level-1 | level-2 ]
Default
SR microloop avoidance is disabled.
Views
IS-IS IPv4 unicast address family view
Predefined user roles
network-admin
Parameters
level-1: Specifies SR microloop avoidance for IS-IS Level-1.
level-2: Specifies SR microloop avoidance for IS-IS Level-2.
Usage guidelines
After a network failure occurs or recovers, route convergence occurs on relevant network devices. Because of non-simultaneous convergence on network devices, microloops might be formed. After you configure SR microloop avoidance, the devices will forward traffic along the specified path before route convergence is finished on all the relevant network devices. Because the forwarding path is independent of route convergence, microloops are avoided.
If you execute both this command and the fast-reroute microloop-avoidance enable command, this command takes effect.
If you do not specify the level-1 or level-2 keyword, the segment-routing microloop-avoidance enable command enables or disables SR microloop avoidance on all IS-IS levels.
Examples
# Enable SR microloop avoidance for IS-IS process 1.
<Sysname> system-view
[Sysname] isis 1
[Sysname-isis-1] address-family ipv4
[Sysname-isis-1-ipv4] segment-routing microloop-avoidance enable
Related commands
fast-reroute microloop-avoidance enable
segment-routing microloop-avoidance rib-update-delay
segment-routing microloop-avoidance rib-update-delay
Use segment-routing microloop-avoidance rib-update-delay to set the SR microloop avoidance RIB-update-delay time.
Use undo segment-routing microloop-avoidance rib-update-delay to restore the default.
Syntax
segment-routing microloop-avoidance rib-update-delay delay-time [ level-1 | level-2 ]
undo segment-routing microloop-avoidance rib-update-delay [ level-1 | level-2 ]
Default
The SR microloop avoidance RIB-update-delay time is 5000 ms.
Views
IS-IS IPv4 unicast address family view
Predefined user roles
network-admin
Parameters
delay-time: Specifies the SR microloop avoidance RIB-update-delay time in milliseconds. The value range is 1 to 60000.
level-1: Specifies the SR microloop avoidance RIB-update-delay time for IS-IS Level-1.
level-2: Specifies the SR microloop avoidance RIB-update-delay time for IS-IS Level-2.
Usage guidelines
To leave sufficient time for IGP to finish route convergence, specify a proper value for the SR microloop avoidance RIB-update-delay timer. Before the timer expires, failure relevant devices will forward traffic along the specified path. After the timer expires, traffic will traverse the usual path.
If you do not specify the level-1 or level-2 keyword, this command sets the SR microloop avoidance RIB-update-delay time for all IS-IS levels.
Examples
# Set the SR microloop avoidance RIB-update-delay time to 6000 ms for IS-IS process 1.
<Sysname> system-view
[Sysname] isis 1
[Sysname-isis-1] address-family ipv4
[Sysname-isis-1-ipv4] segment-routing microloop-avoidance rib-update-delay 6000
Related commands
segment-routing microloop-avoidance enable
segment-routing mpls
Use segment-routing mpls to enable SR-MPLS.
Use undo segment-routing mpls to disable SR-MPLS.
Syntax
segment-routing mpls
undo segment-routing mpls
Default
SR-MPLS is disabled.
Views
IS-IS IPv4 unicast address family view
BGP IPv4 unicast address family view
Predefined user roles
network-admin
Usage guidelines
For SR-MPLS to take effect, set the IS-IS cost style to wide, compatible, or wide-compatible before configuring IS-IS to support SR-MPLS. For more information about the cost style, see IS-IS configuration in Layer 3—IP Routing Configuration Guide.
Examples
# Enable SR-MPLS in IS-IS IPv4 unicast address family view of IS-IS process 1.
<Sysname> system-view
[Sysname] isis 1
[Sysname-isis-1] cost-style wide
[Sysname-isis-1] address-family ipv4
[Sysname-isis-1-ipv4] segment-routing mpls
# Enable SR-MPLS for the BGP IPv4 unicast address family.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp-default] address family ipv4 unicast
[Sysname-bgp-default-ipv4] segment-routing mpls
Related commands
cost-style (Layer 3—IP Routing Command Reference)
segment-routing sr-prefer
Use segment-routing sr-prefer to configure the device to prefer SRLSPs in traffic forwarding.
Use undo segment-routing sr-prefer to restore the default.
Syntax
segment-routing sr-prefer [ prefix-list prefix-list-name ]
undo segment-routing sr-prefer
Default
The device prefers LDP LSPs in traffic forwarding.
Views
IS-IS IPv4 unicast address family view
Predefined user roles
network-admin
Parameters
prefix-list prefix-list-name: Specifies an IP address prefix list by its name, a case-sensitive string of 1 to 63 characters. The device preferentially uses SRLSPs to forward traffic destined for addresses on the prefix list, and preferentially uses LDP LSPs to forward traffic destined for other addresses. If you do not specify an IP address prefix list, the device preferentially uses SRLSPs to forward all traffic.
Usage guidelines
This command determines whether the device prefers SRLSPs or LDP LSPs when both SRLSPs and LDP LSPs are available for traffic forwarding.
This command takes effect only when SR-MPLS is enabled and the SRLSPs use prefix SIDs.
Examples
# Configure the device to preferentially use SRLSPs established by IS-IS process 1 to forward traffic destined for the IPv4 unicast address family.
<Sysname> system-view
[Sysname] isis 1
[Sysname-isis-1] address-family ipv4
[Sysname-isis-1-ipv4] segment-routing sr-prefer
Related commands
ip prefix-list (Layer 3—IP Routing Command Reference)
segment-routing mpls
static-sr-mpls adjacency
Use static-sr-mpls adjacency to configure an adjacency segment for static SR-MPLS.
Use undo static-sr-mpls adjacency to delete an adjacency segment.
Syntax
static-sr-mpls adjacency adjacency-path-name in-label label-value { nexthop ip-address | outgoing-interface interface-type interface-number }
undo static-sr-mpls adjacency adjacency-path-name
Default
No adjacency segments exist.
Views
System view
Predefined user roles
network-admin
Parameters
adjacency-path-name: Specifies the adjacency segment name, a case-sensitive string of 1 to 15 characters.
in-label label-value: Specifies the incoming label, in the range of 16 to 1023.
nexthop ip-address: Specifies the next hop address.
outgoing-interface interface-type interface-number: Specifies an outgoing interface by its type and number. The outgoing interface must be a P2P interface.
Usage guidelines
Execute this command on all nodes of a static SRLSP.
If you specify the next hop address, make sure the following requirements are met:
· The device has a route to reach the next hop address.
· MPLS is enabled on the outgoing interface of the route.
If you specify an outgoing interface, make sure the following requirements are met:
· The interface is up.
· The interface can receive direct routes.
· MPLS is enabled on the interface.
The incoming label specified by this command must be different than existing static LSPs, static PWs, and static CRLSPs. If not, the configured adjacency segment is unavailable. The adjacency segment cannot become available even if you change the incoming label of the static LSP, static PW, or static CRLSP. To resolve this problem, you must delete the existing adjacency segment and configure a new one with a different incoming label.
Examples
# Configure an adjacency segment named adj1. Set the incoming label to 100 and the next hop address to 12.2.1.2.
<Sysname> system-view
[Sysname] static-sr-mpls adjacency adj1 in-label 100 nexthop 12.2.1.2
Related commands
display static-sr-mpls
static-sr-mpls lsp
static-sr-mpls lsp
Use static-sr-mpls lsp to configure a static SRLSP.
Use undo static-sr-mpls lsp to delete a static SRLSP.
Syntax
static-sr-mpls lsp lsp-name out-label out-label-value&<1-4>
undo static-sr-mpls lsp lsp-name
Default
No static SRLSPs exist.
Views
System view
Predefined user roles
network-admin
Parameters
lsp-name: Specifies the static SRLSP name, a case-sensitive string of 1 to 15 characters.
out-label out-label-value&<1-4>: Specifies a space-separated list of up to 4 outgoing labels, corresponding to the labels from top to bottom in the label stack. The value range for the out-label-value argument is 0, 3, and 16 to 1048575.
Usage guidelines
Execute this command only on the ingress node of a static SRLSP.
The outgoing labels represent an ordered list of labels allocated for the adjacencies or nodes that a static SRLSP traverses. The top label is the label that the ingress node allocates for the adjacency or destination prefix.
Examples
# Configure a static SRLSP named lsp1. Specify outgoing labels 100 and 200 for the SRLSP.
<Sysname> system-view
[Sysname] static-sr-mpls lsp lsp1 out-label 100 200
Related commands
static-sr-mpls adjacency
static-sr-mpls prefix
Use static-sr-mpls prefix to configure a prefix segment for static SR-MPLS.
Use undo static-sr-mpls prefix to delete a prefix segment.
Syntax
static-sr-mpls prefix prefix-path-name destination ip-address { mask | mask-length } in-label in-label-value [ { nexthop ip-address | outgoing-interface interface-type interface-number } out-label out-label-value ]
undo static-sr-mpls prefix prefix-path-name [ destination ip-address { mask | mask-length } in-label in-label-value [ nexthop ip-address | outgoing-interface interface-type interface-number ] ]
Default
No prefix segments exist.
Views
System view
Predefined user roles
network-admin
Parameters
prefix-path-name: Specifies the prefix segment name, a case-sensitive string of 1 to 15 characters.
destination ip-address: Specifies the destination IP address.
mask: Specifies the mask.
mask-length: Specifies the mask length, in the range of 0 to 32.
in-label label-value: Specifies the incoming label, in the range of 16000 to 24000.
nexthop ip-address: Specifies the next hop address.
outgoing-interface interface-type interface-number: Specifies an outgoing interface by its type and number. The outgoing interface must be a P2P interface.
out-label out-label-value: Specifies the outgoing label, in the range of 0, 3, and 16 to 1048575.
Usage guidelines
Execute this command on all nodes of a static SRLSP.
A prefix segment must use the next hop or outgoing interface of the optimal route (non-BGP route) to the destination address of the prefix segment. You can configure multiple prefix segments to the destination address for load sharing if the optimal route has more than one next hops or outgoing interfaces. To avoid configuration failure, make sure all prefix segments use the same prefix segment name, and incoming label.
If you specify only the prefix-path-name argument, the undo static-sr-mpls prefix command deletes all prefix segments with the specified name. If you specify all parameters, only the prefix segment that matches the specified name, destination IP address, and next hop or outgoing interface is deleted.
Examples
# Configure a prefix segment named prefix1. Set the destination IP address, incoming label, outgoing label, and next hop to 2.2.2.2, 16000, 16001, and 10.0.0.2, respectively.
<Sysname> system-view
[Sysname] static-sr-mpls prefix prefix1 destination 2.2.2.2 32 in-label 16000 nexthop 10.0.0.2 out-label 16001
Related commands
display mpls static-sr-mpls prefix