Cisco CSR 1000v Series User manual

Cisco CSR 1000v Series Cloud Services Router Software Configuration
Guide
Last Modified: 2017-08-18
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]
Text Part Number:

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

CONTENTS
CHAPTER 1 Preface 1
Preface 1
Objectives 1
Related Documentation 1
Document Conventions 2
Obtaining Documentation and Submitting a Service Request 4
CHAPTER 2 Cisco CSR 1000v Series Cloud Services Router Overview 5
Introduction 5
Benefits of Virtualization Using the Cisco CSR 1000v Series Cloud Services Router 6
Software Configuration and Management Using the Cisco IOS XE CLI 6
Router Interfaces 7
Virtual Machine Requirements 7
Virtual Machines 8
Hypervisor Support 8
Hypervisor Versions—Cisco IOS XE Denali 16.3.1 and Later 9
Hypervisor Versions—Cisco IOS XE 3.x 9
Hypervisor vNIC Requirements 12
Hypervisor vNIC Requirements for Cisco IOS XE Everest 16.6 13
Hypervisor vNIC Requirements for Cisco IOS XE Everest 16.5 14
Hypervisor vNIC Requirements for Cisco IOS XE Everest 16.4 15
Hypervisor vNIC Requirements for Cisco IOS XE Denali 16.3 17
Hypervisor vNIC Requirements for Cisco IOS XE 3S Releases 18
Supported I/O Modes and Drivers 21
Cisco CSR 1000v and Hypervisor Limitations 24
Cisco CSR 1000v and Hypervisor Limitations for Cisco IOS XE Denali 16.3.1 and
Later 24
Cisco CSR 1000v and Hypervisor Limitations for Cisco IOS XE Denali 16.2 24
Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide
iii

Cisco CSR 1000v and Hypervisor Limitations for Cisco IOS XE Release
3.12S 24
Cisco CSR 1000v and Hypervisor Limitations for Cisco IOS XE Release
3.10S 25
Cisco CSR 1000v and Hypervisor Limitations for Cisco IOS XE Release 3.9S 25
Server Requirements 26
Cisco Software Licensing (CSL) 27
Evaluation Licenses—Cisco IOS XE 3.13S and Later, Cisco IOS XE Denali 16.3.1 and
Later 33
Evaluation Licenses—Cisco IOS XE 3.12S and Earlier 35
Cisco Smart Licensing 35
Differences Between Cisco CSR 1000v Series and ASR 1000 Series 35
Supported Cisco IOS XE Technologies 37
Management Support 48
Managing the Router Using Cisco Configuration Professional 48
Managing the Router Using the Cisco IOS XE REST API 49
Managing the Router Using Cisco Prime Network Services Controller 49
Cisco Unified Computing System (UCS) Products 50
Finding Support Information for Platforms and Cisco Software Images 51
Using Cisco Feature Navigator 51
Using the Software Advisor 51
Using the Software Release Notes 52
CHAPTER 3 Using Cisco IOS XE Software 53
Using Cisco IOS XE Software 53
Finding Command Options 56
NVRAM File Security 60
CHAPTER 4 Installation Overview 61
Introduction 61
Obtaining the Cisco CSR 1000v VM Image 63
Cisco CSR 1000v Installation Files 63
Cisco CSR 1000v Installation Options 64
Guidelines and Limitations 66
ROMMON and the Cisco CSR 1000v 66
Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide
iv
Contents

Where to Go Next 66
CHAPTER 5 Installing the Cisco CSR 1000v in VMware ESXi Environments 69
VMware ESXi Support Information 69
VMware Requirements—Cisco IOS XE Everest 16.6 70
Supported VMware Features and Operations 71
General Features (vCenter Server) 71
Operations (for vCenter Server and vSphere Web Client) 72
High Availability 74
Storage Options (for vCenter Server and vSphere Web Client) 75
Deploying the Cisco CSR 1000v OVA to the VM 76
Deploying the Cisco CSR 1000v OVA to the VM 76
Deploying the Cisco CSR 1000v OVA to the VM using vSphere 76
Deploying the Cisco CSR 1000v OVA to the VM using vSphere 76
Restrictions and Requirements 76
Deploying the OVA to the VM 77
Editing the Basic Properties of Cisco CSR 1000v using vSphere 81
Editing the Custom Properties of Cisco CSR 1000v using vSphere 83
Deploying the Cisco CSR 1000v to the VM using COT 84
Deploying the Cisco CSR 1000v OVA to the VM using COT 84
Downloading COT 85
Editing the Basic Properties of Cisco CSR 1000v using COT 85
Editing the Custom Properties of Cisco CSR 1000v using COT 86
cot edit-properties 86
cot inject-config 88
Deploying the Cisco CSR 1000v VM using COT 89
Example 90
Manually Creating the VM and Installing the Cisco CSR 1000v Software Using the .iso File
(VMware ESXi) 90
Overview of Tasks for Manually Creating the Cisco CSR 1000v VM 90
Manually Creating the Cisco CSR 1000v VM Using the .iso File (VMware ESXi) 92
Increasing Performance on VMware ESXi Configurations 94
VMware Requirements—Cisco IOS XE Everest 16.5 94
VMware Requirements—Cisco IOS XE Everest 16.4 95
VMware Requirements—Cisco IOS XE Denali 16.3 96
Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide
v
Contents

VMware Requirements—Cisco IOS XE 3.x 97
VMware VM Requirements—Cisco IOS XE 3.x 99
Installation Requirements—Cisco IOS XE 3.x 101
CHAPTER 6 Installing the Cisco CSR 1000v in Citrix XenServer Environments 105
Citrix XenServer Support Information 105
Installation Requirements for Citrix XenServer: Cisco IOS XE Everest 16.6 106
Manually Creating the Cisco CSR 1000v VM Using the .iso File (Citrix XenServer) 107
Installation Requirements for Citrix XenServer: Cisco IOS XE Everest 16.5 109
Installation Requirements for Citrix XenServer: Cisco IOS XE Everest 16.4 109
Installation Requirements for Citrix XenServer: Cisco IOS XE 16.3 110
Installation Requirements for Citrix XenServer: Cisco IOS XE 3.x 111
CHAPTER 7 Installing the Cisco CSR 1000v in KVM Environments 113
Kernel Virtual Machine Support Information 113
KVM Support on OpenStack 114
Installation Requirements for KVM—Cisco IOS XE Everest 16.6 114
Creating a Cisco CSR 1000v KVM Instance 115
Creating the Cisco CSR 1000v VM Using the Self-installing .Run Package 115
Installation Procedure 115
Creating the Cisco CSR 1000v VM Using the virt-manager GUI Tool 116
Creating the Cisco CSR 1000v VM Using virt-manager—Using .qcow2 or .iso
Image 116
Creating the Cisco CSR 1000v VM Using virt-manager—Add Serial Port 117
Creating the Cisco CSR 1000v VM Using virt-manager--Add Hard Disk 118
Creating a Bootstrap Day0 Configuration for virt-manager 119
Creating the Cisco CSR 1000v VM Using virt-install—Using .qcow2 Image 119
Creating the Cisco CSR 1000v VM Using virt-install—Using ISO Image 120
Creating a Bootstrap Day0 Configuration for virt-install 122
Creating the Cisco CSR 1000v on OpenStack 122
Selecting a Cisco CSR 1000v Installation Image 122
Creating the Instance Using the OpenStack Command Line Tool 123
Creating the Instance Using the OpenStack Dashboard 124
Troubleshooting for Creating the Instance using OpenStack 125
Bootstrapping the CSR Configuration 126
Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide
vi
Contents

Bootstrap Properties 126
Example ovf-env.xml File 128
Example iosxe_config.txt File 129
Increasing Performance on KVM Configurations 129
Cloning the VM 130
Installation Requirements for KVM—Cisco IOS XE Everest 16.5 130
Installation Requirements for KVM—Cisco IOS XE Denali 16.4 131
Installation Requirements for KVM—Cisco IOS XE Denali 16.3 131
Installation Requirements for KVM—Cisco IOS XE 3.x 132
CHAPTER 8 Installing the Cisco CSR 1000v in Microsoft Hyper-V Environments 135
Microsoft Hyper-V Support Information 135
Microsoft Hyper-V Limitations 136
Installation Requirements for Microsoft Hyper-V—Cisco IOS XE Everest 16.6 136
Manually Creating the Cisco CSR 1000v VM using the .iso File (Microsoft Hyper-V) 137
Prerequisites 137
Prerequisites for Manually Creating the CSR 1000v VM using the .iso File 137
Configuring the Server Manager Settings 137
Creating the VM 138
Configuring the VM Settings 139
Launching the VM to Boot the Cisco CSR 1000v 141
Installation Requirements for Microsoft Hyper-V—Cisco IOS XE Everest 16.5 141
Installation Requirements for Microsoft Hyper-V—Cisco IOS XE Everest 16.4 142
Installation Requirements for Microsoft Hyper-V—Cisco IOS XE Denali 16.3.1 143
Installation Requirements for Microsoft Hyper-V—Cisco IOS XE 3.x 143
CHAPTER 9 Booting the Cisco CSR 1000v and Accessing the Console 145
Booting the Cisco CSR 1000v as the VM 145
Accessing the Cisco CSR 1000v Console 148
Accessing the Cisco CSR 1000v Through the Virtual VGA Console 148
Accessing the Cisco CSR 1000v Through the Virtual Serial Port 148
Introduction to Accessing the Cisco CSR 1000v through the Virtual Serial Port 148
Creating Serial Console Access in VMware ESXi 148
Creating the Serial Console Access in KVM 150
Creating the Serial Console Access in Microsoft Hyper-V 151
Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide
vii
Contents

Opening a Telnet Session to the Cisco CSR 1000v Console on the Virtual Serial
Port 151
Changing the Console Port Access After Installation 152
License Installation 154
CHAPTER 10 Installing Cisco CSR 1000v Licenses 155
Activating Cisco CSR 1000v Licenses 156
Cisco Software Licensing (CSL) 156
Installing CSL Evaluation Licenses for Cisco IOS XE 3.13S and Later 156
Installing CSL Regular Licenses for Cisco IOS XE 3.13S and Later 159
Configuring an Interface for 10 Gbps Maximum Throughput 161
Installing CSL Feature Add-on Licenses for Cisco IOS XE 3.13S and Later 162
Understanding the Cisco CSR 1000v Memory Allocation 162
Installing Memory Add-on License 163
Information About Installing Broadband Feature License 166
Installing Broadband Feature License 167
Troubleshooting CSL License Issues 170
Determining the License Status 170
Migrating Technology Package Licenses to Cisco IOS XE 3.13S 170
Determining the AWS License Type 171
Cisco Smart Licensing 172
Prerequisites for Cisco Smart Licensing 172
Configuring Call Home for Smart Licensing 172
Enabling Cisco Smart Licensing 174
Registering the Router with the Cisco Licensing Cloud 175
Registering the Router with the Cisco Licensing Cloud (CSSM satellite) 176
Re-establishing Connectivity to the Cisco Smart Call Home Server when IPv6 is
Configured 178
Re-establishing Connectivity—Method 1 178
Re-establishing Connectivity—Method 2 179
Requesting Cisco Smart License Throughput Level Licenses 180
Requesting Memory Add-on License 182
Requesting Smart License Broadband license 182
Manually Renewing the ID Certificate 183
Manually Renewing the License 183
Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide
viii
Contents

Unregistering a Device from Cisco Smart Licensing 184
Disabling Cisco Smart Licensing 184
License Out-of-Compliance Behavior 185
License Behavior with no Connectivity to the Smart Licensing Server 185
Activating Permanent License Reservation 187
Introduction to Activating Permanent License Reservation 187
Activating Permanent License Reservation 187
Deactivating Permanent License Reservation 188
Troubleshooting Cisco Smart License Issues 189
Determining Device Registration Information 189
Additional show Commands Useful for Troubleshooting 189
Understanding the License-Based Restriction on Aggregate Bandwidth 190
Managing Throughput Notifications 191
Requesting a New Virtual UDI 192
Cisco Software Licensing (IOS XE 3.12 or Earlier) 193
Activating CSL Evaluation Licenses for Cisco IOS XE 3.12S and Earlier 193
Installing CSL Regular Licenses for Cisco IOS XE 3.12S and Earlier 195
CHAPTER 11 Upgrading the Cisco IOS XE Software 199
Prerequisites for the Software Upgrade Process 199
Saving Backup Copies of Your Old System Image and Configuration 200
Using TFTP or Remote Copy Protocol to Copy the System Image into Boot Flash Memory 202
Loading the New System Image from the Cisco IOS XE Software 205
Loading the New System Image from GRUB Mode 208
Saving Backup Copies of Your New System Image and Configuration 210
Rebooting the Cisco CSR 1000v 212
CHAPTER 12 Mapping Cisco CSR 1000v Network Interfaces to VM Network Interfaces 213
Mapping Cisco CSR 1000v Network Interfaces to VM Network Interfaces 213
Mapping the Router Network Interfaces to vNICs 213
Adding and Deleting Network Interfaces on the Cisco CSR 1000v 215
Cisco CSR 1000v Network Interfaces and VM Cloning 216
Mapping Cisco CSR 1000v Network Interfaces with vSwitch Interfaces 217
CHAPTER 13 Accessing and Using GRUB Mode 221
Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide
ix
Contents

About GRUB Mode and the Configuration Register 221
Accessing GRUB Mode 223
Using the GRUB Menu 223
Modifying the Configuration Register (confreg) 224
Changing the Configuration Register Settings 226
Displaying the Configuration Register Settings 227
CHAPTER 14 Configuring Call Home for the Cisco CSR 1000v 229
Prerequisites for Call Home 229
Information About Call Home 230
Benefits of Using Call Home 230
Obtaining Smart Call Home Services 231
Anonymous Reporting 231
How to Configure Call Home 232
How to Configure Call Home 232
Configuring Smart Call Home (Single Command) 232
Configuring and Enabling Smart Call Home 233
Enabling and Disabling Call Home 234
Configuring Contact Information 234
Information About Destination Profiles 236
Creating a New Destination Profile 237
Copying a Destination Profile 239
Setting Profiles to Anonymous Mode 240
Subscribing to Alert Groups 241
Periodic Notification 244
Message Severity Threshold 244
Configuring Snapshot Command List 245
Configuring General email Options 246
Example 248
Specifying Rate Limit for Sending Call Home Messages 249
Specifying HTTP Proxy Server 249
Enabling AAA Authorization to Run IOS Commands for Call Home Messages 250
Configuring Syslog Throttling 251
Configuring Call Home Data Privacy 252
Sending Call Home Communications Manually 253
Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide
x
Contents