Cisco ASR 9000 Series Aggregation Services Router Segment Routing
Command Reference Guide
First Published: September 01, 2015
Last Modified: April 28, 2016
Americas Headquarters
Cisco Systems, Inc.
170 West Tasman Drive
San Jose, CA 95134-1706
USA
http://www.cisco.com
Tel: 408 526-4000
800 553-NETS (6387)
Fax: 408 527-0883
THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL STATEMENTS,
INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.
THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT SHIPPED WITH
THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY,
CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.
The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB's public domain version
of the UNIX operating system. All rights reserved. Copyright © 1981, Regents of the University of California.
NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS" WITH ALL FAULTS.
CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THOSE OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF DEALING, USAGE, OR TRADE PRACTICE.
IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING, WITHOUT
LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO OR ITS SUPPLIERS
HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network
topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional
and coincidental.
Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: http://
www.cisco.com/go/trademarks. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership
relationship between Cisco and any other company. (1110R)
© 2016
Cisco Systems, Inc. All rights reserved.
CONTENTS
Preface
Preface v
Changes to This Document v
Obtaining Documentation and Submitting a Service Request v
CHAPTER 1
Segment Routing Commands 1
attribute-set 2
autoroute announce 4
autoroute destination 5
explicit-path 6
fast reroute 7
index 9
path-option 11
path-selection 13
prefix-sid index 15
segment-routing 16
traffic collector 17
traffic collector interface 18
traffic collector statistics collection interval 20
traffic-collector statistics history-size 21
traffic collector statistics history-timeout 22
clear traffic-collector ipv4 counters prefix 23
clear traffic-collector ipv4 counters tunnels 24
show traffic-collector 25
show traffic-collector ipv4 counter label label 26
show traffic-collector ipv4 counter tunnel 28
tunnel-te 30
Cisco ASR 9000 Series Aggregation Services Router Segment Routing Command Reference Guide
iii
Contents
Cisco ASR 9000 Series Aggregation Services Router Segment Routing Command Reference Guide
iv
Preface
The Cisco ASR 9000 Series Aggregation Services Router Segment Routing Command Reference Guide
preface contains these sections:
• Changes to This Document, page v
• Obtaining Documentation and Submitting a Service Request, page v
Changes to This Document
This table lists the changes made to this document since it was first printed.
Date
Change Summary
April 2016
Republished with documentation updates for Cisco
IOS XR Release 6.0.1 features.
September 2015
Republished with documentation updates for Cisco
IOS XR Release 5.3.2 features.
May 2015
Republished with documentation updates for Cisco
IOS XR Release 5.3.1 features.
January 2015
Initial release of this document.
Obtaining Documentation and Submitting a Service Request
For information on obtaining documentation, using the Cisco Bug Search Tool (BST), submitting a service
request, and gathering additional information, see What's New in Cisco Product Documentation.
To receive new and revised Cisco technical content directly to your desktop, you can subscribe to the What's
New in Cisco Product Documentation RSS feed. RSS feeds are a free service.
Cisco ASR 9000 Series Aggregation Services Router Segment Routing Command Reference Guide
v
Preface
Obtaining Documentation and Submitting a Service Request
Cisco ASR 9000 Series Aggregation Services Router Segment Routing Command Reference Guide
vi
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
• traffic collector, page 17
• traffic collector interface, page 18
• traffic collector statistics collection interval, page 20
• traffic-collector statistics history-size, page 21
• traffic collector statistics history-timeout, page 22
• clear traffic-collector ipv4 counters prefix, page 23
• clear traffic-collector ipv4 counters tunnels, page 24
• show traffic-collector, page 25
• show traffic-collector ipv4 counter label label, page 26
• show traffic-collector ipv4 counter tunnel , page 28
• tunnel-te, page 30
Cisco ASR 9000 Series Aggregation Services Router Segment Routing Command Reference Guide
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
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
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
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
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
RP/0/0/CPU0:rtrA(config-expl-path)#index 10 next-label
<value> MPLS label
Cisco ASR 9000 Series Aggregation Services Router Segment Routing Command Reference Guide
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
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
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
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
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
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
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
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
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
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
16
Segment Routing Commands
traffic collector
traffic collector
Enables traffic collector feature.
traffic-collector
no traffic-collector
Syntax Description
Command Default
None
Command Modes
Command History
Task ID
Release
Modification
Release 6.0.1
This command was introduced.
Task ID
Operation
read, write
Examples
RP/0/RSP0/CPU0:router(config)# traffic-collector
RP/0/RSP0/CPU0:router(config-tc)#
Cisco ASR 9000 Series Aggregation Services Router Segment Routing Command Reference Guide
17
Segment Routing Commands
traffic collector interface
traffic collector interface
Marks an interface as external for traffic matrix counters.
traffic-collector interface type l3 address
no traffic-collector interface type l3 address
Syntax Description
Command Default
Bundle-Ether
Allows you to specify the Ethernet bundle that you want to mark as external for
traffic matrix counters. Only one interface can be listed at a time.
Bundle-POS
Allows you to specify the POS bundle that you want to mark as external for traffic
matrix counters. Only one interface can be listed at a time.
FastEthernet
Allows you to specify the FastEthernet connector that you want to mark as external
for traffic matrix counters. Only one interface can be listed at a time.
FortyGigE
Allows you to specify the 40G connector that you want to mark as external for
traffic matrix counters. Only one interface can be listed at a time.
GigabitEthernet
Allows you to specify the 1G connector that you want to mark as external for traffic
matrix counters. Only one interface can be listed at a time.
HundredGigE
Allows you to specify the 100G connector that you want to mark as external for
traffic matrix counters. Only one interface can be listed at a time.
POS
Allows you to specify the POS connector that you want to mark as external for
traffic matrix counters. Only one interface can be listed at a time.
TenGigE
Allows you to specify the 10G connector that you want to mark as external for
traffic matrix counters. Only one interface can be listed at a time.
None
Command Modes
Command History
Task ID
Release
Modification
Release 6.0.1
This command was introduced.
Task ID
Operation
write:cef
Cisco ASR 9000 Series Aggregation Services Router Segment Routing Command Reference Guide
18
Segment Routing Commands
traffic collector interface
Examples
RP/0/0/CPU0:pe1(config)#traffic-collector interface gigabitEthernet 0/0/0/2
Cisco ASR 9000 Series Aggregation Services Router Segment Routing Command Reference Guide
19
Segment Routing Commands
traffic collector statistics collection interval
traffic collector statistics collection interval
Sets the interval in which statistics are collected in whole minutes only.
traffic-collector statistics collection-interval minutes
Syntax Description
Command Default
minutes
Sets the interval in minutes that the statistics are updated. Only a select set of values can
be used to set the interval. The following values can be used: 1, 2, 3, 4, 5, 6, 10,12, 15,
20, 30, or 60. The default value is 1 for a one minute period.
1
Command Modes
Command History
Task ID
Release
Modification
Release 6.0.1
This command was introduced.
Task ID
Operation
write:cef
Examples
RP/0/RSP0/CPU0:pe1(config)#traffic-colletor statistics collection-interval 5
Cisco ASR 9000 Series Aggregation Services Router Segment Routing Command Reference Guide
20
Segment Routing Commands
traffic-collector statistics history-size
traffic-collector statistics history-size
Specifies the number of collected counter intervals to keep in history and to use in calculating the average
byte and packet rates.
traffic-collector statistics history-size number
no traffic-collector statistics history-size number
Syntax Description
Command Default
number
Specifies the number of records that display in the show history command. The minimum
is one, the maximum is ten. The default value is five.
Five
Command Modes
Command History
Task ID
Release
Modification
Release 6.0.1
This command was introduced.
Task ID
Operation
write:cef
Examples
RP/0/RSP0/CPU0:pe1(config)#traffic-collector statistics history-size 8
Cisco ASR 9000 Series Aggregation Services Router Segment Routing Command Reference Guide
21
Segment Routing Commands
traffic collector statistics history-timeout
traffic collector statistics history-timeout
Specifies how long a deleted entry remains visible in history.
traffic-collector statistics history-timeout hour
Syntax Description
Command Default
hour
Sets the length of time that histories appear for the show command before they are deleted.
The duration range is 0-720 hours. The default duration is 48 hours. Zero specifies an
immediate time out.
48 hours
Command Modes
Command History
Task ID
Release
Modification
Release 6.0.1
This command was introduced.
Task ID
Operation
write:cef
Examples
RP/0/RSP0/CPU0:pe1(config)#traffic-collector statistics history-timeout 100
Cisco ASR 9000 Series Aggregation Services Router Segment Routing Command Reference Guide
22
Segment Routing Commands
clear traffic-collector ipv4 counters prefix
clear traffic-collector ipv4 counters prefix
Clears all statistical counters of all IPV4 prefixes.
clear traffic-collector ipv4 counters prefix
Syntax Description
prefix-ID
Command Default
None
Command Modes
EXEC
Command History
Task ID
Use to specify a particular prefix to clear.
Release
Modification
Release 6.0.1
This command was introduced.
Task ID
Operation
execute: cef
Examples
RP/0/RSP0/CPU0:router(config)# clear traffic-collector ipv4 counters prefix
Cisco ASR 9000 Series Aggregation Services Router Segment Routing Command Reference Guide
23
Segment Routing Commands
clear traffic-collector ipv4 counters tunnels
clear traffic-collector ipv4 counters tunnels
Clears all statistical counters for all IPV4 tunnels.
clear traffic-collector ipv4 counters tunnels
Syntax Description
Command Default
None
Command Modes
Command History
Task ID
Release
Modification
Release 6.0.1
This command was introduced.
Task ID
Operation
read, write
Examples
RP/0/RSP0/CPU0:router(config)# clear traffic-collector ipv4 counters tunnel
Cisco ASR 9000 Series Aggregation Services Router Segment Routing Command Reference Guide
24
Segment Routing Commands
show traffic-collector
show traffic-collector
Retrieves data about traffic routed through the system.
show traffic-collector
Syntax Description
Command Default
external-interface
Use this option to list configured external interfaces.
ipv4
Use this option to access information about the ipv4 address family.
None
Command Modes
Command History
Task ID
Release
Modification
Release 6.0.1
This command was introduced.
Task ID
Operation
read: cef
Examples
RP/0/0/CPU0:pe1#show traffic-collector external-interface
Fri Nov 6 09:02:13.025 EST
Interface
Status
-------------------- ---------------Gi0/0/0/1
Enabled
Gi0/0/0/3
Enabled
Cisco ASR 9000 Series Aggregation Services Router Segment Routing Command Reference Guide
25
Segment Routing Commands
show traffic-collector ipv4 counter label label
show traffic-collector ipv4 counter label label
Displays base and demand matrix statistics for the specified prefix label.
show traffic-collector ipv4 counter label label
Syntax Description
Command Default
base
Use this option to display packet
rates for base counters averaged
over a defined number of histories.
detail
Use this option to display packet
and byte rates for base traffic
matrix counters averaged over a
defined number of histories. The
histories are also listed.
Note
The detail option can be
used with the base or tm
options separately to show
history information for the
respective counter.
tm
Use this option to display packet
and byte rates for traffic matrix
counters (which cover traffic from
interfaces marked as external sent
to SR prefixes and labels) averaged
over a defined number of histories.
None
Command Modes
Command History
Task ID
Release
Modification
Release 6.0.1
This command was introduced.
Task ID
Operation
read: cef
Cisco ASR 9000 Series Aggregation Services Router Segment Routing Command Reference Guide
26
Segment Routing Commands
show traffic-collector ipv4 counter label label
Examples
Examples
Examples
RP/0/0/CPU0:pe1#show traffic-collector ipv4 counters label 20001 base
Fri Nov 6 09:09:13.102 EST
Prefix
Label
Base rate
Base rate
State
(Packet/sec) (Bytes/sec)
------------------------------ -------- ------------ ------------ ---------192.168.0.1/32
20001
0
0
Active
RP/0/0/CPU0:pe1#show traffic-collector ipv4 counters label 20001 tm
Fri Nov 6 09:08:55.537 EST
Prefix
Label
TM rate
TM rate
(Packet/sec) (Bytes/sec)
------------------------------ -------- ------------ -----------192.168.0.1/32
20001
0
0
State
---------Active
RP/0/0/CPU0:pe1#show traffic-collector ipv4 counters label 20001 detail
Fri Nov 6 09:08:36.201 EST
Prefix: 192.168.0.1/32 Label: 20001 State: Active
Base:
Average over the last 3 collection intervals:
Packet rate: 0 pps, Byte rate: 0 Bps
History of counters:
09:07 - 09:08: Packets
0, Bytes:
09:06 - 09:07: Packets
0, Bytes:
09:05 - 09:06: Packets
0, Bytes:
TM Counters:
Average over the last 3 collection intervals:
Packet rate: 0 pps, Byte rate: 0 Bps
History of counters:
09:07 - 09:08: Packets
09:06 - 09:07: Packets
09:05 - 09:06: Packets
Examples
0
0
0
RP/0/0/CPU0:pe1#show traffic-collector ipv4 counters label 20001 base detail
Fri Nov 6 09:09:51.973 EST
Prefix: 192.168.0.1/32 Label: 20001 State: Active
Base:
Average over the last 3 collection intervals:
Packet rate: 0 pps, Byte rate: 0 Bps
History of counters:
09:08 - 09:09: Packets
09:07 - 09:08: Packets
09:06 - 09:07: Packets
Examples
0, Bytes:
0, Bytes:
0, Bytes:
0
0
0
0, Bytes:
0, Bytes:
0, Bytes:
0
0
0
RP/0/0/CPU0:pe1#show traffic-collector ipv4 counters label 20001 tm detail
Fri Nov 6 09:09:40.126 EST
Prefix: 192.168.0.1/32 Label: 20001 State: Active
TM Counters:
Average over the last 3 collection intervals:
Packet rate: 0 pps, Byte rate: 0 Bps
History of counters:
09:08 - 09:09: Packets
09:07 - 09:08: Packets
09:06 - 09:07: Packets
0, Bytes:
0, Bytes:
0, Bytes:
0
0
0
Cisco ASR 9000 Series Aggregation Services Router Segment Routing Command Reference Guide
27
Segment Routing Commands
show traffic-collector ipv4 counter tunnel
show traffic-collector ipv4 counter tunnel
Displays base and traffic matrix statistics for the tunnels.
show traffic-collector ipv4 counter tunnels
Syntax Description
detail
Use this option to display rates and
status information for configured
tunnels.
tunnel-te interface-name
tt
Use to examine records for a
specific MPLS traffic engineering
tunnel interface.
You can use tt in place of tunnel-te.
Command Default
None
Command Modes
Command History
Task ID
Release
Modification
Release 6.0.1
This command was introduced.
Task ID
Operation
read: cef
Examples
RP/0/0/CPU0:pe1#show traffic-collector ipv4 counters tunnels detail
Fri Nov 6 09:17:10.998 EST
Tunnel: tt210 State: Active
Average over the last 3 collection intervals:
Packet rate: 0 pps, Byte rate: 0 Bps
History of counters:
09:16 - 09:17: Packets
09:15 - 09:16: Packets
09:14 - 09:15: Packets
0, Bytes:
0, Bytes:
0, Bytes:
0
0
0
0, Bytes:
0, Bytes:
0
0
Tunnel: tt211 State: Active
Average over the last 3 collection intervals:
Packet rate: 0 pps, Byte rate: 0 Bps
History of counters:
09:16 - 09:17: Packets
09:15 - 09:16: Packets
Cisco ASR 9000 Series Aggregation Services Router Segment Routing Command Reference Guide
28
Segment Routing Commands
show traffic-collector ipv4 counter tunnel
00:00 - 00:00: Packets
Examples
0, Bytes:
0
RP/0/0/CPU0:pe1#show traffic-collector ipv4 counters tunnels tunnel-te 210
Fri Nov 6 09:18:06.196 EST
Interface
Base rate
Base rate
State
(Packet/sec) (Bytes/sec)
------------------------------ ------------ ------------ ---------tt210
0
0
Active
RP/0/0/CPU0:pe1#show traffic-collector ipv4 counters tunnels tunnel-te 210 detail
Fri Nov 6 09:18:19.140 EST
Tunnel: tt210 State: Active
Average over the last 3 collection intervals:
Packet rate: 0 pps, Byte rate: 0 Bps
History of counters:
09:17 - 09:18: Packets
09:16 - 09:17: Packets
09:15 - 09:16: Packets
0, Bytes:
0, Bytes:
0, Bytes:
0
0
0
Cisco ASR 9000 Series Aggregation Services Router Segment Routing Command Reference Guide
29
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
30