Cisco ASR 9000 Series User manual

Cisco ASR 9000 Series Aggregation Services Router System
Management Configuration Guide, Release 5.1.x
First Published: 2013-09-01
Last Modified: 2014-04-01
Americas Headquarters
Cisco Systems, Inc.
170 West Tasman Drive
San Jose, CA 95134-1706
USA
http://www.cisco.com
Tel: [phone]
800 553-NETS (6387)
Fax: [phone]

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)
©2014 Cisco Systems, Inc. All rights reserved.

CONTENTS
Preface Preface xvii
Changes to this Document xvii
Obtaining Documentation and Submitting a Service Request xvii
CHAPTER 1 New and Changed System Management Features 1
New and changed System Management features, R51 1
CHAPTER 2 Configuring Profiles 3
Restrictions of Scale Profiles 3
Information About Profiles 4
Information About Scale Profiles 4
Information About Feature Profiles 4
Relationship Between Scale and Feature Profiles 5
How to Configure Profiles 5
Configuring the Scale Profile 5
Configuring the Feature Profile 7
Removing the Scale Profile from the Global Configuration 9
Additional References 10
CHAPTER 3 Secure Domain Routers on the Cisco ASR 9000 Series Router 13
Prerequisites for Working with Secure Domain Routers 13
Information About Configuring Secure Domain Routers 14
What Is a Secure Domain Router? 14
Owner SDR and Administration Configuration Mode 14
SDR Access Privileges 14
Root-System Users 15
root-lr Users 15
Cisco ASR 9000 Series Aggregation Services Router System Management Configuration Guide, Release 5.1.x
iii

Other SDR Users 16
Designated Shelf Controller (DSC) 16
Default Configuration of the Router 16
Cisco IOS XR Software Package Management 16
Additional References 17
CHAPTER 4 Upgrading and Managing Cisco IOS XR Software 19
Overview of Cisco IOS XR Software Packages 20
Package Installation Envelopes 20
Summary of Cisco IOS XR Software Packages 21
Packages in the Cisco IOS XR Unicast Routing Core Bundle 21
Software Maintenance Upgrades 21
PIE Filenames and Version Numbers 22
Filename Component Description 22
Copying the PIE File to a Local Storage Device or Network Server 24
Information About Package Management 25
Summary of Package Management 25
Adding Packages 25
Verifying Package Details 26
Activating Packages 27
Activating Multiple Packages or SMUs 27
Activating All Packages Added in a Specific Operation 27
Adding and Activating a Package with a Single Command 27
Upgrading and Downgrading Packages 27
Committing the Active Software Set 28
Rolling Back to a Previous Installation Operation 28
Multiple Disks Support during Installations 28
Restrictions 28
Deactivation of fully superseded SMUs 29
Support for the Ignore Package Presence Check Option 29
Upgrading Packages 30
Downgrading Packages 30
Impact of Package Version Changes 31
Impact of Package Activation and Deactivation 31
Delaying the Return of the CLI Prompt 32
Cisco ASR 9000 Series Aggregation Services Router System Management Configuration Guide, Release 5.1.x
iv
Contents

Displaying Installation Log Information 32
Examples 32
Package Management Procedures 34
Activation and Deactivation Prerequisites 34
Obtaining and Placing Cisco IOS XR Software 35
Transferring Installation Files from a Network File Server to a Local Storage Device 36
Preparing for Software Installation Operations 38
Examples 41
Adding and Activating Packages 48
Examples 54
Committing the Active Package Set 56
Examples 57
Upgrading to Cisco IOS XR Software Release 4.0 58
Deactivating and Removing Cisco IOS XR Software Packages 64
Examples 68
Rolling Back to a Previous Software Set 69
Displaying Rollback Points 69
Displaying the Active Packages Associated with a Rollback Point 70
Rolling Back to a Specific Rollback Point 71
Rolling Back to the Last Committed Package Set 71
Additional References 72
CHAPTER 5 Configuring Disk Mirroring 75
Disk Mirroring Prerequisites 75
Information About Disk Mirroring 76
How to Enable Disk Mirroring 77
Enabling Disk Mirroring 77
Replacing the Secondary Mirroring Device 78
Replacing the Primary Mirroring Device 80
Configuration Examples for Enabling Disk Mirroring 82
Additional References 83
CHAPTER 6 Software Entitlement 85
What Is Software Entitlement? 85
Implementing Default Licensing 87
Cisco ASR 9000 Series Aggregation Services Router System Management Configuration Guide, Release 5.1.x
v
Contents

Prerequisites for Configuring Software Entitlement 87
Information About Default (Traditional) Licensing 87
Types of Licenses 87
Router License Pools 87
Chassis-Locked Licenses 87
Slot-Based Licenses 88
Configure Licenses Using Default Licensing 88
Adding a License for a New Feature 88
Backing Up Licenses 90
Examples 91
Restoring Licenses 92
Examples 92
Transferring Licenses to a new Route Switch Processor 440 93
Upgrading Line Cards and Licenses 94
Troubleshooting License Issues after a Software Upgrade 95
Additional References 95
CHAPTER 7 Managing the Router Hardware 99
Prerequisites for Managing Router Hardware 100
Displaying Hardware Status 100
Displaying SDR Hardware Version Information 100
Displaying System Hardware Version Information 103
Displaying Software and Hardware Information 106
Displaying SDR Node IDs and Status 107
Displaying Router Node IDs and Status 108
Displaying Router Environment Information 109
Configuring the Chassis Altitude 112
Displaying RP Redundancy Status 112
Displaying Field-Programmable Device Compatibility 113
RSP Redundancy and Switchover 115
Establishing RSP Redundancy 115
Determining the Active RP in a Redundant Pair 116
Role of the Standby RSP 117
Summary of Redundancy Commands 117
Automatic Switchover 118
Cisco ASR 9000 Series Aggregation Services Router System Management Configuration Guide, Release 5.1.x
vi
Contents

RSP Redundancy During RSP Reload 118
Manual Switchover 118
Communicating with a Standby RP 119
Reloading, Shutting Down, or Power Cycling a Node 119
Reloading the Active RSP 120
Flash Disk Recovery 122
Using Controller Commands to Manage Hardware Components 123
Formatting Hard Drives, Flash Drives, and Other Storage Devices 123
Removing and Replacing Cards 124
Removing Line Cards 124
Replacing a Line Card with the Same Media Type and Port Count 125
Replacing a Line Card with the Same Media Type and a Different Port Count 125
Replacing a Line Card or PLIM with a Different Media Type 126
Upgrading the CPU Controller Bits 126
Examples 126
Additional References 127
CHAPTER 8 Configuring Flexible Command Line Interface Configuration Groups 129
Information About Flexible CLI Configuration Groups 129
Flexible Configuration Restrictions 130
Configuring a Configuration Group 131
Simple Configuration Group: Example 133
Configuration Group Applied to Different Places: Example 133
Verifying the Configuration of Configuration Groups 133
Apply Groups Priority Inheritance 135
Regular Expressions in Configuration Groups 136
Configuration Examples Using Regular Expressions 138
Configuration Group with Regular Expression: Example 138
Configuration Group Inheritance with Regular Expressions: Example 140
Layer 2 Transport Configuration Group: Example 141
Configuration Group Precedence: Example 142
Changes to Configuration Group are Automatically Inherited: Example 142
Configuration Examples for Flexible CLI Configuration 143
Basic Flexible CLI Configuration: Example 143
Interface MTU Settings for Different Interface Types: Example 144
Cisco ASR 9000 Series Aggregation Services Router System Management Configuration Guide, Release 5.1.x
vii
Contents

ACL Referencing: Example 146
Local Configuration Takes Precedence: Example 147
ISIS Hierarchical Configuration: Example 148
OSPF Hierarchy: Example 151
Link Bundling Usage: Example 154
CHAPTER 9 Upgrading FPD 157
Prerequisites for FPD Image Upgrades 158
Overview of FPD Image Upgrade Support 158
Automatic FPD Upgrade 158
How to Upgrade FPD Images 159
Configuration Examples for FPD Image Upgrade 163
show hw-module fpd Command Output: Example 163
show fpd package Command Output: Example 165
upgrade hw-module fpd Command Output: Example 187
show platform Command Output: Example 187
Troubleshooting Problems with FPD Image Upgrades 188
Power Failure or Removal of a SPA During an FPD Image Upgrade 188
Performing a SPA FPD Recovery Upgrade 188
Performing a SIP FPD Recovery Upgrade 188
Additional References 189
CHAPTER 10 Configuring Frequency Synchronization 191
Information About Frequency Synchronization 191
Frequency Synchronization Timing Concepts 192
Sources 192
Selection Points 192
Configuring Frequency Synchronization 193
Enabling Frequency Synchronization on the Router 193
Configuring Frequency Synchronization on an Interface 195
Configuring Frequency Synchronization on a Clock Interface 198
Verifying the Frequency Synchronization Configuration 202
Additional References 205
CHAPTER 11 Implementing NTP 207
Cisco ASR 9000 Series Aggregation Services Router System Management Configuration Guide, Release 5.1.x
viii
Contents

Prerequisites for Implementing NTP on Cisco IOS XR Software 208
Information About Implementing NTP 208
NTP-PTP Interworking 209
How to Implement NTP 209
Configuring Poll-Based Associations 209
Configuring Broadcast-Based NTP Associates 212
Configuring NTP Access Groups 214
Configuring NTP Authentication 215
Disabling NTP Services on a Specific Interface 217
Configuring the Source IP Address for NTP Packets 219
Configuring the System as an Authoritative NTP Server 220
Configuring NTP-PTP Interworking 222
Updating the Hardware Clock 223
Verifying the Status of the External Reference Clock 225
Examples 225
Configuration Examples for Implementing NTP 226
Configuring NTP server inside VRF interface 228
Additional References 230
CHAPTER 12 Configuring PTP 233
Prerequisites for Implementing PTP on Cisco IOS XR Software 234
Information About Configuring PTP 234
PTP Implementation 234
1588 Packet Types 236
PTP Hybrid Mode 236
ITU-T Telecom Profiles for PTP 236
G.8265.1 Profile 236
States of Ports 237
How to Configure PTP 238
Configuring Frequency and Quality Settings for PTP 238
Configuring Global Profile Settings for PTP 239
Configuring a PTP Slave Interface 241
Configuring the Clock Interface for a PTP Master 243
Configuring a PTP Master Interface 245
Configuring GPS Settings for the Grand Master Clock 247
Cisco ASR 9000 Series Aggregation Services Router System Management Configuration Guide, Release 5.1.x
ix
Contents

Configuring PTP Hybrid Mode 250
How to Configure PTP Telecom Profile 252
Configuring an Interface for the PTP Telecom Profile 252
Configuring PTP Clock Settings for the Telecom Profile 255
Configuration Examples for Implementing PTP 257
Configuring Slave Settings: Example 257
Configuring Master Settings: Example 257
Configuring GPS Settings: Example 257
PTP Hybrid Mode: Example 258
Additional References 259
CHAPTER 13 Implementing OnePK 261
Information About onePK 261
Understanding the OnePK system architecture 262
Supported Platforms and Linecards 263
Supported Actions 264
Service sets 264
Hosting Models 265
OnePK Transport 266
Data Path Service Set 266
Data Path Service Set Components 266
DPSS flows 267
Developing OnePK applications 267
Enabling onePK 269
Configuring onePK 269
Example: 1P Data Path configuration 271
CHAPTER 14 Implementing Open Flow Agent 273
OpenFlow 274
An overview of OFA 274
Prerequisites for OpenFlow Agent 274
Restrictions for OpenFlow Agent 275
Advantages 275
About OpenFlow 275
Openflow Mode for ASR9000 276
Cisco ASR 9000 Series Aggregation Services Router System Management Configuration Guide, Release 5.1.x
x
Contents

OpenFlow Table Types 276
OpenFlow Agent Packet In and Out Feature 277
OpenFlow Agent with NetFlow Collection and Analytics 277
OFA on Cisco Routers and Switches 278
Functional Components 279
OFA on ASR 9000 series routers 279
OFA on OnePK 279
OpenFlow Matches 279
OpenFlow Actions 282
Cisco Extension Actions 284
Set Field Actions 284
Configuring OneP for Openflow 287
Configuring a Layer 2 Logical Switch for the OpenFlow Agent 287
Configuring a Layer 2_Layer 3 Logical Switch for the OpenFlow Agent 289
Configuring a Layer 3_VRF Logical Switch for the OpenFlow Agent 290
Configuring a Layer 3_Dual-stack Logical Switch for the OpenFlow Agent 292
Enabling TLS 293
Configuring NetFlow for the OpenFlow Agent 294
Configuration Examples: Openflow 297
Attaching a bridge domain to an Openflow Switch: Examples 297
OpenFlow Agent with NetFlow Collection and Analytics Configuration: Example 298
Usecase for Layer2 299
Usecase for Layer3 299
CHAPTER 15 Configuring Manageability 301
Information About XML Manageability 302
How to Configure Manageability 302
Configuring the XML Agent 302
Configuration Examples for Manageability 303
Enabling VRF on an XML Agent: Examples 303
Additional References 304
CHAPTER 16 Configuring Call Home 307
About Call Home 308
Destination Profiles 308
Cisco ASR 9000 Series Aggregation Services Router System Management Configuration Guide, Release 5.1.x
xi
Contents

Call Home Alert Groups 309
Call Home Message Levels 310
Obtaining Smart Call Home 311
Anonymous Reporting 311
Configuring Call Home 312
Configuring Contact Information 312
Configuring and Activating Destination Profiles 314
Associating an Alert Group with a Destination Profile 315
Configuring Email 318
Enabling Call Home 320
Configuring Smart Call Home (single command) 320
Configuring Call Home Data Privacy 321
Configuring Syslog Throttling 322
Enabling AAA Authorization 322
Sending Call Home Alert group Messages Manually 323
Manually sending command output message for a Command List 324
Configuring a HTTP Proxy Server 325
Configuring Snapshot alert group 326
Configuring Anonymous Reporting 327
Configuring Call Home to use VRF 327
Configuring Source Interface 328
CHAPTER 17 Implementing Object Tracking 329
Prerequisites for Implementing Object Tracking 329
Information About Object Tracking 330
How to Implement Object Tracking 330
Tracking the Line Protocol State of an Interface 330
Tracking IP Route Reachability 332
Building a Track Based on a List of Objects 333
Building a Track Based on a List of Objects - Threshold Percentage 335
Building a Track Based on a List of Objects - Threshold Weight 337
Tracking IPSLA Reachability 339
Configuration Examples for Configuring Object Tracking 340
Additional References 340
Cisco ASR 9000 Series Aggregation Services Router System Management Configuration Guide, Release 5.1.x
xii
Contents

CHAPTER 18 Implementing Physical and Virtual Terminals 343
Prerequisites for Implementing Physical and Virtual Terminals 344
Information About Implementing Physical and Virtual Terminals 344
Line Templates 344
Line Template Configuration Mode 344
Line Template Guidelines 345
Terminal Identification 345
vty Pools 345
How to Implement Physical and Virtual Terminals on Cisco IOS XR Software 346
Modifying Templates 346
Creating and Modifying vty Pools 347
Monitoring Terminals and Terminal Sessions 349
Craft Panel Interface 350
Configuration Examples for Implementing Physical and Virtual Terminals 350
Additional References 352
CHAPTER 19 Implementing SNMP 355
Prerequisites for Implementing SNMP 356
Restrictions for SNMP Use on Cisco IOS XR Software 356
Information About Implementing SNMP 356
SNMP Functional Overview 356
SNMP Manager 356
SNMP Agent 356
MIB 357
SNMP Notifications 357
SNMP Versions 358
Comparison of SNMPv1, v2c, and v3 359
Security Models and Levels for SNMPv1, v2, v3 360
SNMPv3 Benefits 361
SNMPv3 Costs 362
User-Based Security Model 362
View-Based Access Control Model 363
MIB Views 363
Access Policy 363
Cisco ASR 9000 Series Aggregation Services Router System Management Configuration Guide, Release 5.1.x
xiii
Contents

IP Precedence and DSCP Support for SNMP 363
Session MIB support on subscriber sessions 363
SNMP Notifications 364
Session Types 365
How to Implement SNMP on Cisco IOS XR Software 365
Configuring SNMPv3 365
Configuring SNMP Trap Notifications 366
Setting the Contact, Location, and Serial Number of the SNMP Agent 368
Defining the Maximum SNMP Agent Packet Size 369
Changing Notification Operation Values 370
Setting IP Precedence and DSCP Values 371
Configuring MIB Data to be Persistent 372
Configuring LinkUp and LinkDown Traps for a Subset of Interfaces 373
Configuration Examples for Implementing SNMP 375
Configuring SNMPv3: Examples 375
Configuring Trap Notifications: Example 379
Setting an IP Precedence Value for SNMP Traffic: Example 380
Setting an IP DSCP Value for SNMP Traffic: Example 380
Additional References 380
CHAPTER 20 Configuring Periodic MIB Data Collection and Transfer 383
Prerequisites for Periodic MIB Data Collection and Transfer 383
Information About Periodic MIB Data Collection and Transfer 384
SNMP Objects and Instances 384
Bulk Statistics Object Lists 384
Bulk Statistics Schemas 384
Bulk Statistics Transfer Options 384
Benefits of Periodic MIB Data Collection and Transfer 385
4arg 385
4arg Messages: Example 385
How to Configure Periodic MIB Data Collection and Transfer 385
Configuring a Bulk Statistics Object List 385
Configuring a Bulk Statistics Schema 386
Configuring Bulk Statistics Transfer Options 388
Monitoring Periodic MIB Data Collection and Transfer 391
Cisco ASR 9000 Series Aggregation Services Router System Management Configuration Guide, Release 5.1.x
xiv
Contents

Periodic MIB Data Collection and Transfer: Example 392
CHAPTER 21 Implementing CDP 395
Prerequisites for Implementing CDP 395
Information About Implementing CDP 396
How to Implement CDP on Cisco IOS XR Software 397
Enabling CDP 397
Modifying CDP Default Settings 398
Monitoring CDP 399
Examples 400
Configuration Examples for Implementing CDP 402
Additional References 402
Cisco ASR 9000 Series Aggregation Services Router System Management Configuration Guide, Release 5.1.x
xv
Contents

Cisco ASR 9000 Series Aggregation Services Router System Management Configuration Guide, Release 5.1.x
xvi
Contents

Preface
From Release 6.1.2 onwards, Cisco introduces support for the 64-bit Linux-based IOS XR operating system.
Extensive feature parity is maintained between the 32-bit and 64-bit environments. Unless explicitly marked
otherwise, the contents of this document are applicable for both the environments. For more details on Cisco
IOS XR 64 bit, refer to the Release Notes for Cisco ASR 9000 Series Routers, Release 6.1.2 document.
This guide describes the System Management configuration details for Cisco IOS XR software. This chapter
contains details on the changes made to this document.
•Changes to this Document, page xvii
•Obtaining Documentation and Submitting a Service Request, page xvii
Changes to this Document
This table lists the technical changes made to this document since it was first printed.
Table 1: Changes to This Document
Change SummaryDateRevision
Initial release of this document.September 2013OL-30424-01
Republished with documentation
updates for Release 5.1.1
January 2014OL-30424-02
Republished with documentation
updates for Release 5.1.2
May 2014OL-30424-03
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.
Cisco ASR 9000 Series Aggregation Services Router System Management Configuration Guide, Release 5.1.x
xvii

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 System Management Configuration Guide, Release 5.1.x
xviii
Preface
Obtaining Documentation and Submitting a Service Request

CHAPTER 1
NewandChangedSystemManagementFeatures
This chapter lists all the features that have been added or modified in this guide. The table also contains
references to these feature documentation sections.
•New and changed System Management features, R51, page 1
New and changed System Management features, R51
Where DocumentedIntroduced/Changed in
Release
DescriptionFeature
Information About onePK, on page
261
Release 5.1.2This feature was introduced.OnePK
An overview of OFA, on page 274Release 5.1.2This feature was introduced.Open Flow Agent
Refer to the Cisco IOS XR System
Management Command Reference.
Release 5.1.1Commands were updated/ added.Flexible CLI
4arg, on page 385Release 5.1This feature was introduced.4arg
Session MIB support on subscriber
sessions , on page 363
Release 5.1This feature was modified.SNMP updates
Cisco ASR 9000 Series Aggregation Services Router System Management Configuration Guide, Release 5.1.x
1

Cisco ASR 9000 Series Aggregation Services Router System Management Configuration Guide, Release 5.1.x
2
New and Changed System Management Features
New and changed System Management features, R51