Segment Routing Commands
• attribute-set , page 2
• autoroute announce, page 4
• autoroute destination, page 5
• explicit-path , page 6
• fast reroute, page 7
• index, page 9
• path-option, page 11
• path-selection, page 13
• prefix-sid index, page 15
• segment-routing, page 16
• tunnel-te, page 17
Cisco ASR 9000 Series Aggregation Services Router Segment Routing Command Reference Guide, Release 5.3.x
1
Segment Routing Commands
attribute-set
attribute-set
Configures the attribute set for an LSP.
attribute-set name [ isis | lockdown | ospf | protected-by index | segment-routing ]
Syntax Description
name
Specifies an identifier for the attribute set. The identifier
can be up to 64 characters in length.
isis [ lockdown | protected-by |
segment-routing]
Restricts the LSP to a single IS-IS instance and area.
lockdown [ isis | ospf | protected-by |
segment-routing]
Locks the LSP against reoptimization.
ospf [ lockdown | protected-by |
segment-routing]
Restricts the LSP to a single OSPF instance and area.
protected-by index
Protects the LSP specified by the index.
The index ranges from 1 to 1000.
segment-routing [ isis | ospf | lockdown |
protected-by ]
Command Default
None
Command Modes
Path option interface configuration mode
Command History
Enables segment routing for the LSP.
Release
Modification
4.2.0
This command was introduced
5.3.2
The segment routing option was introduced.
Usage Guidelines
Task ID
Task ID
Operation
mpls-te
read, write
Cisco ASR 9000 Series Aggregation Services Router Segment Routing Command Reference Guide, Release
5.3.x
2
Segment Routing Commands
attribute-set
Examples
RP/0/RSP0/CPU0:router(config)# interface tunnel-te22
RP/0/RSP0/CPU0:router(config-if)# ipv4 unnumbered loopback0
RP/0/RSP0/CPU0:router(config-if)# destination 192.168.0.2
RP/0/RSP0/CPU0:router(config-if)# path-selection segment-routing adjacency protected
RP/0/RSP0/CPU0:router(config-if)# path-option 30 dynamic attribute-set example protected-by
20
Cisco ASR 9000 Series Aggregation Services Router Segment Routing Command Reference Guide, Release 5.3.x
3
Segment Routing Commands
autoroute announce
autoroute announce
autoroute announce [ip2mpls]
no autoroute announce
Syntax Description
ip2mpls
(Optional) Specifies a non-tunnel interface as the outgoing interface to avoid looping
of the labeled packet back to the tunnel ingress (source).
Command Default
None
Command Modes
Tunnel interface configuration
Command History
Usage Guidelines
Release
Modification
3.7.2
This command was introduced.
5.3.2
The ip2mpls option was introduced to avoid labeled segments looping back
to the source at the SR-TE tunnel ingress.
To use this command, you must be in a user group associated with a task group that includes appropriate task
IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator
for assistance.
When more than one IGP is configured, the tunnel is announced as an auto route to the IGP that is used to
compute the TE tunnel path.
When the autoroute announce command is configured, the route metric of the tunnel path to the destination
equals the route metric of the shortest IGP path to that destination.
Task ID
Examples
Task ID
Operations
mpls-te
read, write
This example shows how to configure IGP to use the tunnel in its enhanced SPF calculation when the tunnel
is up:
RP/0/RSP0/CPU0:router# configure
RP/0/RSP0/CPU0:router(config)# interface tunnel-te 1
RP/0/RSP0/CPU0:router(config-if)# autoroute announce
Cisco ASR 9000 Series Aggregation Services Router Segment Routing Command Reference Guide, Release
5.3.x
4
Segment Routing Commands
autoroute destination
autoroute destination
To install multiple static routes in the routing information base (RIB) per SR TE tunnel, use the autoroute
destination command in the tunnel interface TE configuration mode.
To disable autoroute destination, use the no form of this command.
autoroute destination ip-address
no autoroute destination ip-address
Syntax Description
ip-address
Specifies the host address of the route to be installed in the RIB. A maximum of
six routes can be specified apart from the default route.
Command Default
Autoroute destination is disabled.
Command Modes
Tunnel interface configuration mode.
Command History
Task ID
Examples
Release
Modification
5.1.1
This command was introduced.
Task ID
Operation
mpls-te
read, write
This example shows how to configure installing four routes in RIB for SR-TE tunnel 10:
RP/0/RSP0/CPU0:router# configure
RP/0/RSP0/CPU0:router(config)# interface tunnel-te 10
RP/0/RSP0/CPU0:router(config-if)# autoroute destination
RP/0/RSP0/CPU0:router(config-if)# autoroute destination
RP/0/RSP0/CPU0:router(config-if)# autoroute destination
RP/0/RSP0/CPU0:router(config-if)# autoroute destination
192.168.1.2
192.168.2.2
192.168.3.2
192.168.4.2
Cisco ASR 9000 Series Aggregation Services Router Segment Routing Command Reference Guide, Release 5.3.x
5
Segment Routing Commands
explicit-path
explicit-path
Configures a fixed path through the network.
explicit-path name path_name
Syntax Description
path_name
Command Default
None
Command Modes
Global Configuration mode
Command History
Task ID
Examples
Specifies a name for an explicit path.
Release
Modification
5.3.2
This command was introduced.
Task ID
Operation
mpls-te
read, write
RP/0/RSP0/CPU0:router(config)# explicit-path name ABCD1_Nodes
Cisco ASR 9000 Series Aggregation Services Router Segment Routing Command Reference Guide, Release
5.3.x
6
Segment Routing Commands
fast reroute
fast reroute
fast-reroute { per-prefix ti-lfa }
no fast-reroute
Syntax Description
per-prefix ti-lfa
Command Default
FRR is disabled.
Command Modes
Interface configuration
Command History
Usage Guidelines
Specifies an alternate path for every prefix on the specified tunnel
interface.
Release
Modification
3.7.2
This command was introduced.
5.3.2
The per-prefix ti-lfa option was introduced for segment routing tunnels.
When a protected link used by the fast-reroutable label switched path (LSP) fails, the traffic is rerouted to a
previously assigned backup tunnel. Configuring FRR on the tunnel informs all the nodes that the LSP is
traversing that this LSP desires link/node/bandwidth protection.
You must allow sufficient time after an RSP RP switchover before triggering FRR on standby RSPs RPs to
synchronize with the active RSP RP (verified using the show redundancy command). All TE tunnels must
be in the recovered state and the database must be in the ready state for all ingress and egress line cards. To
verify this information, use the show mpls traffic-eng tunnels and show mpls traffic-eng fast-reroute
database commands.
Note
Task ID
Wait approximately 60 seconds before triggering FRR after verifying the database state.
Task ID
Operations
mpls-te
read, write
Cisco ASR 9000 Series Aggregation Services Router Segment Routing Command Reference Guide, Release 5.3.x
7
Segment Routing Commands
fast reroute
Examples
The following example shows how to enable FRR on an interface:
RP/0/RSP0/CPU0:R1(config)# router isis 1
RP/0/RSP0/CPU0:R1(config-isis)# interface TenGigE0/0/0/2/1
RP/0/RSP0/CPU0:R1(config-isis-if)# point-to-point
RP/0/RSP0/CPU0:R1(config-isis-if)# address-family ipv4 unicast
RP/0/RSP0/CPU0:R1(config-isis-if)# fast-reroute per-prefix
RP/0/RSP0/CPU0:R1(config-isis-if)# fast-reroute per-prefix ti-lfa
RP/0/RSP0/CPU0:R1(config-isis-if)# exit
Cisco ASR 9000 Series Aggregation Services Router Segment Routing Command Reference Guide, Release
5.3.x
8
Segment Routing Commands
index
index
Marks an explicit path. The index determines the order of path selection.
Index index_number
[ exclude-address | exclude-srlg | next-address | next-label ]
[ ipv4 | loose | strict ]
unicast IP_address
Syntax Description
index_number
Defines priority for the path to be selected.
Ranges from 1 to 65535.
exclude-address
Specifies the next IP address to be excluded.
exclude-srlg
Specifies the IP address from which Shared Risk Link Groups (SRLGs)
are derived for exclusion.
next-address
Specifies the next IP address to be excluded.
next-label
Specifies the next MPLS label in the path.
ipv4
Specifies the type of address family (IPv4).
loose
Specifies the next hop in the path as a flexible hop.
strict
Specifies the next hop in the path as a fixed hop
Command Default
None
Command Modes
Explicit path configuration mode
Command History
Task ID
Release
Modification
5.3.2
This command was introduced.
Task ID
Operation
mpls-te
read, write
Cisco ASR 9000 Series Aggregation Services Router Segment Routing Command Reference Guide, Release 5.3.x
9
Segment Routing Commands
index
Examples
RP/0/RSP0/CPU0:router(config)# explicit-path
RP/0/RSP0/CPU0:router(config-expl-path)# index
RP/0/RSP0/CPU0:router(config-expl-path)# index
RP/0/RSP0/CPU0:router(config-expl-path)# index
name ABCD1_Nodes
10 next-address strict ipv4 unicast 192.168.0.2
20 next-address strict ipv4 unicast 192.168.0.3
30 next-address strict ipv4 unicast 192.168.0.4
Cisco ASR 9000 Series Aggregation Services Router Segment Routing Command Reference Guide, Release
5.3.x
10
Segment Routing Commands
path-option
path-option
Configures the primary and backup LSPs.
path-option path_preference_value
[
dynamic
{ attribute-set | isis | lockdown | ospf | pce | protected-by | segment-routing } |
explicit [ identifier name ]
{ attribute-set | isis | lockdown | ospf | protected-by | segment-routing | verbatim } |
segment-routing { isis | lockdown | ospf | protected-by }
]
Syntax Description
path_preference_value
Specifies the preference for an LSP.
Ranges from 1 to 1000.
dynamic{ attribute-set | isis | lockdown Configures a dynamically allocated path based on the configured
options. See the attribute-set statement for a description of all the
| ospf | pce | protected-by |
attributes.
segment-routing }
explicit [ identifier name ] { attribute-set Configures a preset path, based on the configured options.
| isis | lockdown | ospf | protected-by | The verbatim option is required for disabling loop detection on
segment-routing | verbatim }
the path. When you configure this option, the topology database
is not referred by the source router while configuring the preset
path.
See the attribute-set statement for a description of all the
attributes.
segment-routing { isis | lockdown | ospf Configures a segment routing path, based on the configured
options. See the attribute-set statement for a description of all the
| protected-by }
attributes.
Command Default
None
Command Modes
Interface configuration mode
Command History
Release
Modification
3.7.2
This command was introduced.
Cisco ASR 9000 Series Aggregation Services Router Segment Routing Command Reference Guide, Release 5.3.x
11
Segment Routing Commands
path-option
Task ID
Examples
Release
Modification
5.2.0
This command was introduced for segment routing
Task ID
Operation
mpls-te
read, write
RP/0/RSP0/CPU0:router(config)# interface tunnel-te22
RP/0/RSP0/CPU0:router(config-if)# ipv4 unnumbered loopback0
RP/0/RSP0/CPU0:router(config-if)# destination 192.168.0.2
RP/0/RSP0/CPU0:router(config-if)# path-selection segment-routing adjacency protected
RP/0/RSP0/CPU0:router(config-if)# path-option 1 explicit name ABCD1_Nodes segment-routing
Cisco ASR 9000 Series Aggregation Services Router Segment Routing Command Reference Guide, Release
5.3.x
12
Segment Routing Commands
path-selection
path-selection
Configures the LSP to be selected for the SR-TE tunnel.
path-selection
[
cost-limit limit |
hop-limit limit |
invalidation timer tear | drop |
metric [ igp | te ]
segment-routing adjacency [ protected | unprotected ] |
tiebreaker [ max-fill | min-fill | random ]
]
Syntax Description
cost-limit limit
Configures the cost limit for the LSP.
Ranges from 1 to 4294967295.
hop-limit limit
Configures the hop limit for the LSP.
Ranges from 1 to 255.
invalidation timer tear | drop
Configures the path invalidation timer.
When the timer expires, the path is either torn down or just the segment
labeled data is dropped.
Ranges from 0 to 60000.
metric[ igp | te]
Configures the type of metric to be used for the LSP.
segment-routing adjacency [
protected | unprotected]
Configures the type of adjacency for segment routing.
tiebreaker [ max-fill | min-fill |
random]
Configures the tie breaker for path calculation of equal cost multiple
paths. Max-fill selects the path with the most-utilized links. Min-fill
selects the path with the least-utilized links. Random selects the path
with randomly utilized links.
Command Default
None
Command Modes
Tunnel interface configuration mode
Cisco ASR 9000 Series Aggregation Services Router Segment Routing Command Reference Guide, Release 5.3.x
13
Segment Routing Commands
path-selection
Command History
Task ID
Examples
Release
Modification
5.3.2
This command was introduced for segment routing.
Task ID
Operation
mpls-te
read, write
RP/0/RSP0/CPU0:router(config)# interface tunnel-te22
RP/0/RSP0/CPU0:router(config-if)# path-selection segment-routing adjacency protected
Cisco ASR 9000 Series Aggregation Services Router Segment Routing Command Reference Guide, Release
5.3.x
14
Segment Routing Commands
prefix-sid index
prefix-sid index
To specify or advertise prefix (node) segment ID (SID) on all routers, use the prefix-sid index command in
IPv4 address family configuration mode. To stop advertising prefix SID, use the no form of this command.
Segment routing must be configured on the ISIS instance before configuring prefix SID value.
prefix-sid index sid-value
no prefix-sid index sid-value
Syntax Description
sid-value
Specifies the prefix SID value. Value range is between 0 and 1048575.
Command Default
No default behavior or values.
Command Modes
IPv4 address family configuration
Command History
Task ID
Examples
Release
Modification
5.2.0
This command was introduced.
Task ID
Operations
isis
read, write
This example shows how to configure a prefix SID.
RP/0/RSP0/CPU0:router # configure
RP/0/RSP0/CPU0:router(config)# router isis 100
RP/0/RSP0/CPU0:router(config-isis)# interface loopback0
RP/0/RSP0/CPU0:router(config-isis-if)# address-family ipv4 unicast
RP/0/RSP0/CPU0:router(config-isis-if-af)# prefix-sid index 16041
Cisco ASR 9000 Series Aggregation Services Router Segment Routing Command Reference Guide, Release 5.3.x
15
Segment Routing Commands
segment-routing
segment-routing
Enables segment routing on the router.
segment-routing
[
global-block starting_value ending_value |
mapping-server
prefix-sid-map address-family ipv4 IP_address / subnet mask
SID_start_value
{ attached | range number_of_allocated_SIDs }
]
Syntax Description
global-block starting_value ending_value
Specifies the block of segment routing IDs that are
allocated for the routers in the network. Ranges from
16000 to 1048574.
mapping-server prefix-sid-map address-family Specifies the router as a segment routing mapping server
with a specified prefix segment ID range.
ipv4 IP_address/subnet mask SID_start_value{
attached | range number_of_allocated_SIDs}
Command Default
None
Command Modes
Global Configuration mode
Command History
Task ID
Examples
Release
Modification
5.2.0
This command was introduced.
Task ID
Operation
mpls-te
read, write
RP/0/RSP0/CPU0:router(config)# segment-routing global-block 17000 20000
RP/0/RSP0/CPU0:router(config)# segment-routing mapping-server prefix-sid-map address-family
ipv4 10.10.10.0/24 17000 range 100
Cisco ASR 9000 Series Aggregation Services Router Segment Routing Command Reference Guide, Release
5.3.x
16
Segment Routing Commands
tunnel-te
tunnel-te
Configures a segment routing traffic engineering tunnel.
tunnel-te tunnel_number
Syntax Description
tunnel_number
Specifies an identifier for the SR-TE tunnel.
Ranges from 1 to 65535.
Command Default
None
Command Modes
Interface configuration mode
Command History
Task ID
Examples
Release
Modification
5.3.2
This command was introduced.
Task ID
Operation
interface
read, write
RP/0/RSP0/CPU0:router(config)# interface tunnel-te22
Cisco ASR 9000 Series Aggregation Services Router Segment Routing Command Reference Guide, Release 5.3.x
17
Segment Routing Commands
tunnel-te
Cisco ASR 9000 Series Aggregation Services Router Segment Routing Command Reference Guide, Release
5.3.x
18