Cisco CSR 1000v Series Software Configuration 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: 408 526-4000
800 553-NETS (6387)
Fax: 408 527-0883
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
CHAPTER 2
Preface 1
Preface 1
Objectives 1
Related Documentation 1
Document Conventions 2
Obtaining Documentation and Submitting a Service Request 4
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
Contents
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
CHAPTER 3
CHAPTER 4
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
Using Cisco IOS XE Software 53
Using Cisco IOS XE Software 53
Finding Command Options 56
NVRAM File Security 60
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
CHAPTER 7
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
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
viii
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
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
CHAPTER 11
CHAPTER 12
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
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
Mapping Cisco CSR 1000v Network Interfaces to VM Network Interfaces 213
CHAPTER 13
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
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
Sending Call Home Communications Manually 253
Sending a Call Home Test Message Manually 253
Sending Call Home Alert Group Messages Manually 253
Submitting Call Home Analysis and Report Requests 255
Manually Sending Command Output Message for One Command or a Command List 256
Configuring Diagnostic Signatures 257
Configuring Diagnostic Signatures 257
Prerequisites for Diagnostic Signatures 257
Information About Diagnostic Signatures 258
Diagnostic Signatures Overview 258
Diagnostic Signature Downloading 258
Diagnostic Signature Workflow 259
CHAPTER 15
Diagnostic Signature Events and Actions 259
Diagnostic Signature Event Detection 259
Diagnostic Signature Actions 259
Diagnostic Signature Variables 260
How to Configure Diagnostic Signatures 260
Configuring the Call Home Service for Diagnostic Signatures 260
Configuring Diagnostic Signatures 262
Configuration Examples for Diagnostic Signatures 262
Displaying Call Home Configuration Information 263
Examples 264
Default Settings 268
Alert Group Trigger Events and Commands 268
Message Contents 270
Sample Syslog Alert Notification in XML Format 273
Enabling Management by REST API 275
Introduction 275
Enabling REST API Support During Cisco CSR 1000v OVA Deployment 275
Enabling REST API Support Using the Cisco IOS XE CLI 277
Introduction to REST API Configuration Options 277
Enabling REST API Support 277
Configuring the Shared Management Interface to Support the REST API 279
Configuring the Dual Management Interface to Support the REST API 281
Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide
xi
Contents
Configuring the REST API Local Port and AutoSave Options 283
Configuring HTTPS Support for the REST API Using the Cisco IOS XE CLI 284
Disabling REST API Support 285
Viewing the REST API Container Status 287
CHAPTER 16
CHAPTER 17
CHAPTER 18
Configuring Support for Remote Management by the Cisco Prime Network Services
Controller 289
Configuring the Management Interface to Support Remote Management by the Cisco Prime
Network Services Controller 289
Enabling Remote Management by the Cisco Prime Network Services Controller Host 292
Disabling Remote Management by the Cisco Prime Network Services Controller Host 295
Troubleshooting Cisco CSR 1000v VM Issues 297
Verifying the Cisco CSR 1000v Hardware and VM Requirements 297
Troubleshooting Network Connectivity Issues 297
Troubleshooting VM Performance Issues 298
Rehosting the Cisco CSR 1000v License 299
Voluntarily Rehosting the License to a New VM 299
Obtaining a Rehost License if the System Fails 301
xii
Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide
Preface
CHAPTER 1
Preface
Preface, page 1
•
Objectives, page 1
•
Related Documentation, page 1
•
Document Conventions, page 2
•
Obtaining Documentation and Submitting a Service Request, page 4
•
This preface describes the objectives and organization of this document and explains how to find additional
information on related products and services. This preface contains the following sections:
Objectives
This document provides an overview of software functionality that is specific to the Cisco CSR 1000v Series
Cloud Services Router. It is not intended as a comprehensive guide to all of the software features that can be
run using the Cisco CSR 1000v Series router, but only the software aspects that are specific to this router.
For information on general software features that are also available on the Cisco CSR 1000v Series router,
see the Cisco IOS XE technology guides for that specific software feature.
Related Documentation
This section refers you to other documentation that also might be useful as you configure your Cisco CSR
1000v router. The documentation listed below is available online. The following documents cover other
important information for the Cisco CSR 1000v:
Cisco CSR 1000V Documentation Roadmap, Cisco IOS XE Denali 16.x
•
Cisco CSR 1000V Series Cloud Services Router Release Notes, Cisco IOS XE 3S
•
Cisco CSR 1000V Series Cloud Services Router Release Notes for Cisco IOS XE Denali 16.x
•
Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide
1
Document Conventions
Cisco CSR 1000V Series Cloud Services Router Deployment Guide for Amazon Web Services
•
Cisco CSR 1000v Deployment Guide for Microsoft Azure
•
Cisco IOS XE REST API Management Reference Guide
•
The Cisco IOS XE release documentation home page contains technology guides and feature documentation:
See http://www.cisco.com/en/US/products/ps11174/tsd_products_support_series_home.html
For information on commands, see one of the following resources:
Cisco IOS XE Software Command References
•
Command Lookup Tool (cisco.com login required)
•
Document Conventions
This documentation uses the following conventions:
Preface
DescriptionConvention
^ or Ctrl
string
Command syntax descriptions use the following conventions:
bold
italics
The ^ and Ctrl symbols represent the Control key.
For example, the key combination ^D or Ctrl-D
means hold down the Control key while you press
the D key. Keys are indicated in capital letters but are
not case sensitive.
A string is a nonquoted set of characters shown in
italics. For example, when setting an SNMP
community string to public, do not use quotation
marks around the string or the string will include the
quotation marks.
DescriptionConvention
Bold text indicates commands and keywords that you
enter exactly as shown.
Italic text indicates arguments for which you supply
values.
[x]
|
Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide
2
Square brackets enclose an optional element (keyword
or argument).
A vertical line indicates a choice within an optional
or required set of keywords or arguments.
Preface
Document Conventions
DescriptionConvention
[x | y]
Square brackets enclosing keywords or arguments
separated by a vertical line indicate an optional
choice.
{x | y}
Braces enclosing keywords or arguments separated
by a vertical line indicate a required choice.
Nested sets of square brackets or braces indicate optional or required choices within optional or required
elements. For example:
DescriptionConvention
[x {y | z}]
Braces and a vertical line within square brackets
indicate a required choice within an optional element.
Examples use the following conventions:
DescriptionConvention
screen
bold screen
Examples of information displayed on the screen are
set in Courier font.
Examples of text that you must enter are set in Courier
bold font.
Note
< >
Angle brackets enclose text that is not printed to the
screen, such as passwords.
!
An exclamation point at the beginning of a line
indicates a comment line. (Exclamation points are
also displayed by the Cisco IOS XE software for
certain processes.)
[ ]
Square brackets enclose default responses to system
prompts.
The following conventions are used to attract the attention of the reader:
Means reader take note . Notes contain helpful suggestions or references to materials that may not be
contained in this manual.
Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide
3
Obtaining Documentation and Submitting a Service Request
Preface
Caution
Means reader be careful . In this situation, you might do something that could result in equipment damage
or loss of data.
Obtaining Documentation and Submitting a Service Request
For information about obtaining documentation, submitting a service request, and gathering additional
information, see What’s New in Cisco Product Documentation, which lists all new and revised Cisco technical
documentation.
Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide
4
CHAPTER 2
Cisco CSR 1000v Series Cloud Services Router Overview
Introduction, page 5
•
Virtual Machine Requirements, page 7
•
Cisco Software Licensing (CSL), page 27
•
Cisco Smart Licensing, page 35
•
Differences Between Cisco CSR 1000v Series and ASR 1000 Series, page 35
•
Supported Cisco IOS XE Technologies, page 37
•
Management Support, page 48
•
Cisco Unified Computing System (UCS) Products, page 50
•
Finding Support Information for Platforms and Cisco Software Images, page 51
•
Introduction
Virtual Router
The Cisco CSR 1000v Cloud Services Router provides a cloud-based virtual router deployed on a virtual
machine (VM) instance on x86 server hardware. It supports a subset of Cisco IOS XE software features and
technologies, providing Cisco IOS XE security and switching features on a virtualization platform.
When the Cisco CSR 1000v is deployed on a VM, the Cisco IOS XE software functions just as if it were
deployed on a traditional Cisco hardware platform.
Features
The Cisco CSR 1000v includes a virtual Route Processor and a virtual Forwarding Processor (FP) as part of
its architecture. It supports a subset of Cisco IOS XE software features and technologies.
The Cisco CSR 1000v can provide secure connectivity from an enterprise location, such as a branch office
or data center, to the public or private cloud.
Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide
5
Cisco CSR 1000v Series Cloud Services Router Overview
Benefits of Virtualization Using the Cisco CSR 1000v Series Cloud Services Router
The Cisco CSR 1000v is deployed as a virtual machine on a hypervisor. Optionally, you can use a virtual
switch (vSwitch), depending on your deployment. You can use selected Cisco equipment for some components.
The supported components will depend on your software release.
Benefits of Virtualization Using the Cisco CSR 1000v Series Cloud Services
Router
The Cisco CSR 1000v Series uses the benefits of virtualization in the cloud to provide the following:
Hardware independence
•
Because the Cisco CSR 1000v runs on a virtual machine, it can be supported on any x86 hardware that
the virtualization platform supports.
Sharing of resources
•
The resources used by the Cisco CSR 1000v are managed by the hypervisor, and resources can be shared
among VMs. The amount of hardware resources that the VM server allocates to a specific VM can be
reallocated to another VM on the server.
Flexibility in deployment
•
You can easily move a VM from one server to another. Thus, you can move the Cisco CSR 1000v from
a server in one physical location to a server in another physical location without moving any hardware
resources.
Software Configuration and Management Using the Cisco IOS XE CLI
You can perform software configuration and management of the Cisco CSR 1000v using the following
methods:
Provision a serial port in the VM and connect to access the Cisco IOS XE CLI commands.
•
Use the virtual VGA console or the console on the virtual serial port to access the Cisco IOS XE CLI
•
commands.
Note
A serial port can be used to manage a Cisco CSR 1000v VM only if the underlying hypervisor supports
associating a serial port with a VM. For example, the Citrix XenServer environment does not support
serial port association. See your hypervisor documentation for details.
Use remote SSH/Telnet to access the Cisco IOS XE CLI commands.
•
The Cisco CSR 1000v also supports management and configuration using the following products:
Cisco IOS XE REST API
•
Cisco Prime Network Services Controller
•
For more information, see "Management Support", from Managing the Router Using Cisco Configuration
Professional, on page 48 onwards.
Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide
6
Cisco CSR 1000v Series Cloud Services Router Overview
Router Interfaces
The Cisco CSR 1000v router interfaces perform the same functionality as those on hardware-based Cisco
routers. The Cisco CSR 1000v interfaces function as follows:
Interfaces are logically named as the Gigabit Ethernet (GE) interfaces.
•
The available interface numbering depends on the Cisco CSR 1000v version.
•
(Cisco IOS XE Release 3.11S and later, and Denali 16.2 and later) The interface numbering is as follows:
Interface port numbering is from 1 and up to the number of interfaces supported.
•
◦
GigabitEthernet interface 0 is no longer supported beginning with this release.
◦
You can designate any interface as the management interface. You can change the management
◦
interface when deploying the OVA template on first-time installation.
(Cisco IOS XE Release 3.10S and earlier) The interface numbering is as follows:
Router Interfaces
Interface port numbering is from 0 and up to the number of interfaces supported.
•
◦
Gigabit Ethernet interface 0 is reserved for the management interface used for obtaining the licenses
◦
and upgrading software.
At first boot, the Cisco CSR 1000v router interfaces are mapped to the vNIC interfaces on the VM based
•
on the vNIC enumeration to the Cisco CSR 1000v; on subsequent boot, the Cisco CSR 1000v router
interfaces are mapped to the vNIC MAC address
Caution
If upgrading to Cisco IOS XE Release 3.11S from an earlier release, we recommend you update your
configuration to remove the GigabitEthernet 0 management interface before upgrading. Because the
GigabitEthernet 0 interface is no longer supported beginning with Cisco IOS XE Release 3.11S, you will
receive system errors if the upgraded configuration includes this interface.
For more information, see the “Mapping Cisco CSR 1000v Network Interfaces to VM Network Interfaces”
section on page 11-1 .
Virtual Machine Requirements
The Cisco CSR 1000v runs only on a virtual machine. This section describes the virtual machine requirements
for the router.
Virtual Machines, on page 8
•
Hypervisor Support, on page 8
•
Server Requirements, on page 26
•
Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide
7
Virtual Machines
Virtual Machines
A virtual machine (VM) is a software implementation of a computing environment in which an operating
system (OS) or program can be installed and run. The VM typically emulates a physical computing environment,
but requests for CPU, memory, hard disk, network and other hardware resources are managed by a virtualization
layer which translates these requests to the underlying physical hardware.
You can deploy an Open Virtualization Archive (OVA) file. The OVA file package simplifies the process of
deploying a VM by providing a complete definition of the parameters and resource allocation requirements
for the new VM.
An OVA file consists of a descriptor (.ovf) file, a storage (.vmdk) file and a manifest (.mf) file.
• ovf file—Descriptor file which is an xml file with extension .ovf which consists of all the metadata about
• vmdk file—File format that encodes a single virtual disk from a VM.
• mf file—Optional file that stores the SHA key generated during packaging.
Cisco CSR 1000v Series Cloud Services Router Overview
the package. It encodes all the product details, virtual hardware requirements and licensing.
You can also install the Cisco CSR 1000v using an .iso file and manually create the VM in the hypervisor.
For more information, see the “Installation Overview” section on page 3-1 .
Hypervisor Support
A hypervisor enables multiple operating systems to share a single hardware host machine. While each operating
system appears to have the dedicated use of the host's processor, memory, and other resources; the hypervisor
controls and allocates only needed resources to each operating system and ensures that the operating systems
(VMs) do not disrupt each other.
Supported Hypervisor Types
Installation of the Cisco CSR 1000v is supported on selected Type 1 (native, bare metal) hypervisors.
Installation is not supported on Type 2 (hosted) hypervisors, such as VMware Fusion, VMware Player, or
Virtual Box.
Amazon Cloud Marketplace
The Cisco CSR 1000v is available in the Amazon Cloud Marketplace. (For use with Cisco IOS XE Release
3.11S through 3.16.2S, and Cisco IOS XE Denali 16.3.1 and later.) For more information, see the Cisco CSR
1000V Series Cloud Services Router Deployment Guide for Amazon Web Services.
Microsoft Azure Marketplace
The Cisco CSR 1000v is available in the Microsoft Azure Marketplace . For more information, see the Cisco
CSR 1000V Series Cloud Services Router Deployment Guide for Microsoft Azure .
Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide
8
Cisco CSR 1000v Series Cloud Services Router Overview
Hypervisor Versions—Cisco IOS XE Denali 16.3.1 and Later
The following hypervisors/versions are supported by Cisco CSR 1000v on Cisco IOS XE Denali 16.3.1 and
later. If you are using other versions of Cisco IOS XE, see Hypervisor Versions—Cisco IOS XE 3.x, on page
9.
VMware ESXi
Server 6.0 update2 (instance running vm11)—recommended. F.ully tested and meets performance benchmarks
Server 5.5 update3 (instance running vm10)
Although 5.5 update 3 is supported for Cisco IOS XE Denali 16.3.1 and later, we recommend using VMware
ESXi Server 6.0 update 2 instead.
Kernel Based Virtual Machine (KVM)
RHEL 7.2—recommended
RHEL 7.1
Citrix XenServer
Hypervisor Support
6.5—recommended
6.2
Microsoft Hyper-V
Windows Server 2012-R2, Hyper-V Mgr 6.3.9600.16384—recommended
Amazon Web Services
C4 and T2 instance types—recommended
C3 instance types—supported (in Cisco IOS XE 3.11 to IOS XE 3.17)
See "Amazon Web Services" in Hypervisor Support, on page 8.
Microsoft Azure
Standard D2 and Standard D3—recommended
Standard D4—supported
See "Microsoft Azure" in Hypervisor Support, on page 8.
Hypervisor Versions—Cisco IOS XE 3.x
The following table lists the supported hypervisor versions for older software releases (Cisco IOS XE 3.x).
Note
For recent hypervisor versions see the Hypervisor Versions—Cisco IOS XE Denali 16.3.1 and Later, on
page 9.
Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide
9
Hypervisor Support
Table 1: Support Matrix for Hypervisor Versions
Cisco CSR 1000v Series Cloud Services Router Overview
XE Release
Citrix XenServerVMwareESXiCisco CSR 1000v IOS
Microsoft Hyper-VKernel Based Virtual
Machine (KVM)
Amazon Web
Services
Not supportedNot supportedNot supportedNot supported5.03.9S
6.0.25.05.13.10S
Linux KVM
•
Not supportedNot supported
based on Red
Hat Enterprise
Linux 6.3
Red Hat
•
1
Enterprise
Virtualization
3.1
6.025.05.13.11S
Linux KVM
•
SupportedNot supported
based on Red
Hat Enterprise
Linux 6.31
Red Hat
•
Enterprise
Virtualization
3.1
3.12S
Ubuntu
•
12.04.03 LTS
Server 64 Bits
3
6.15.05.15.5
Linux KVM
•
based on Red
2
SupportedWindows Server
2012 R2
Hat Enterprise
Linux 6.31
Ubuntu
•
12.04.03 LTS
Server 64 Bits
2
Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide
10
Cisco CSR 1000v Series Cloud Services Router Overview
Hypervisor Support
XE Release
3.13S
3.14S
3.15S
Citrix XenServerVMwareESXiCisco CSR 1000v IOS
Microsoft Hyper-VKernel Based Virtual
Machine (KVM)
4
6.25.05.15.5
Linux KVM
•
based on Red
2012 R2
Amazon Web
Services
SupportedWindows Server
Hat Enterprise
Linux 6.31
Ubuntu
•
12.04.03 LTS
Server 64 Bits
2
5
6.25.05.15.5
Linux KVM
•
based on Red
2012 R2
SupportedWindows Server
Hat Enterprise
Linux 6.5
Ubuntu 14.04
•
LTS Server 64
Bits 2
6
6.25.05.15.5
Linux KVM
•
based on Red
2012 R2
SupportedWindows Server
Hat Enterprise
Linux 6.6
3.16S
Ubuntu 14.04
•
LTS Server 64
Bits 2
8
6.25.05.15.576.0
Linux KVM
•
based on Red
Windows Server
2012 R2
Hat Enterprise
Supported until
Cisco IOS XE
3.16.2
Linux 6.6
Ubuntu 14.04
•
LTS Server 64
Bits 2
6.25.05.15.56.03.17S
Linux KVM
•
based on Red
Hat Enterprise
Linux 7.1
Ubuntu 14.04
•
2012 R2
9
Not supportedWindows Server
LTS Server 64
Bits 2
Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide
11
Hypervisor Support
Cisco CSR 1000v Series Cloud Services Router Overview
Citrix XenServerVMwareESXiCisco CSR 1000v IOS
XE Release
Machine (KVM)
For later versions of
Cisco IOS XE, see:
Hypervisor
Versions—Cisco
IOS XE Denali
16.3.1 and Later, on
page 9
1
Requires Kernel version 2.6.3.2 and QEMU 0.12.
2
Requires QEMU-x86_64 version 1.0 (qemu-kvm-1.0), Copyright (c) 2003-2008 Fabrice Bellard.
3
VMware ESXi 5.5 update 3 is not supported on Cisco IOS XE 3.12S..
4
VMware ESXi 5.5 update 3 is not supported on Cisco IOS XE 3.13S..
5
VMware ESXi 5.5 update 3 is not supported on Cisco IOS XE 3.14S.
6
VMware ESXi 5.5 update 3 is not supported on Cisco IOS XE 3.15S.
7
VMware ESXi 5.5 update 3 is supported on Cisco IOS XE 3.16.1S and later.
8
VMware ESXi 6.0 supported on Cisco IOS XE 3.16.1S and later (and 3.17S and later).
9
Requires Kernel version 3.10.0 and QEMU 1.5.3.
Hypervisor features may differ depending on the hypervisor, and not all features in a given hypervisor version
may be supported. The hypervisor versions listed are those officially tested and supported by the Cisco CSR
1000v. See the following sections for more information:
Microsoft Hyper-VKernel Based Virtual
Amazon Web
Services
For information about deploying the Cisco CSR 1000v in an Amazon Web Services environment, see theNote
Note
For information about deploying the Cisco CSR 1000v in a Microsoft Azure environment, see the Cisco
CSR 1000V Deployment Guide for Microsoft Azure .
Hypervisor vNIC Requirements
Depending on the Cisco CSR 1000v release version, each of the hypervisors supports different virtual network
interface card (vNIC) types. The Cisco CSR 1000v also supports a different maximum number of vNICs
depending on the hypervisor. Some versions and hypervisors also support the ability to add and remove vNICs
without powering down the VM (vNIC Hot Add/Remove).
The VMXNET3, VIF and Virtio NIC types listed in the table are para-virtualized NICs.
See also Supported I/O Modes and Drivers, on page 21.
The following sections list the supported vNICs and the minimum and maximum number of vNICs supported
for each VM instance. Choose a section, depending on the release of Cisco IOS XE which you are using.
Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide
12
Cisco CSR 1000v Series Cloud Services Router Overview
Hypervisor vNIC Requirements for Cisco IOS XE Everest 16.6
Hypervisor Support
ValuevNIC Requirements for VMware ESXi
NIC Types Supported
VMXNET3ixgbe(Intel 10Gb PCI
Express NIC Driver) ixgbef
10Max. number of vNICs per VM instance
YesvNIC Hot Add Support (Intel 10Gb PCI Express NIC Driver)
NovNIC Hot Remove Support (Intel 10Gb PCI Express NIC Driver)
YesSingle Root I/O virtualization (SR-IOV) Support
ValuevNIC Requirements for Citrix XenServer
VIF-netfront(pmap)NIC Types Supported
7Max. number of vNICs per VM instance
YesvNIC Hot Add Support
NovNIC Hot Remove Support
YesSingle Root I/O virtualization (SR-IOV) Support
ValuevNIC Requirements for KVM
Virtio, ixgbevf, ixgbbeNIC Types Supported
26Max. number of vNICs per VM instance
YesvNIC Hot Add Support
NovNIC Hot Remove Support
YesSingle Root I/O virtualization (SR-IOV) Support
ValuevNIC Requirements for Microsoft Hyper-V
NetVSCNIC Types Supported
8Max. number of vNICs per VM instance
NovNIC Hot Add Support
NovNIC Hot Remove Support
NoSingle Root I/O virtualization (SR-IOV) Support
ValuevNIC Requirements for Microsoft Azure
NetVSCNIC Types Supported
8Max. number of vNICs per VM instance
Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide
13
Hypervisor Support
Cisco CSR 1000v Series Cloud Services Router Overview
ValuevNIC Requirements for Microsoft Azure
NovNIC Hot Add Support
NovNIC Hot Remove Support
NoSingle Root I/O virtualization (SR-IOV) Support
ValuevNIC Requirements for Amazon Web Services (AWS)
VIF-netfront(pmap), ixgbevfNIC Types Supported
Max. number of vNICs per VM instance
Hypervisor vNIC Requirements for Cisco IOS XE Everest 16.5
NIC Types Supported
8 (See http://docs.aws.amazon.com/AWSEC2/
latest/UserGuide/
using-eni.html#AvailableIpPerENI)
NovNIC Hot Add Support
NovNIC Hot Remove Support
NoSingle Root I/O virtualization (SR-IOV) Support
ValuevNIC Requirements for VMware ESXi
VMXNET3ixgbe(Intel 10Gb PCI
Express NIC Driver) ixgbef
10Max. number of vNICs per VM instance
YesvNIC Hot Add Support (Intel 10Gb PCI Express NIC Driver)
NovNIC Hot Remove Support (Intel 10Gb PCI Express NIC Driver)
YesSingle Root I/O virtualization (SR-IOV) Support
ValuevNIC Requirements for Citrix XenServer
VIF-netfront(pmap)NIC Types Supported
7Max. number of vNICs per VM instance
YesvNIC Hot Add Support
NovNIC Hot Remove Support
YesSingle Root I/O virtualization (SR-IOV) Support
ValuevNIC Requirements for KVM
Virtio, ixgbevf, ixgbbeNIC Types Supported
26Max. number of vNICs per VM instance
YesvNIC Hot Add Support
Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide
14
Cisco CSR 1000v Series Cloud Services Router Overview
Hypervisor Support
ValuevNIC Requirements for KVM
NovNIC Hot Remove Support
YesSingle Root I/O virtualization (SR-IOV) Support
ValuevNIC Requirements for Microsoft Hyper-V
NetVSCNIC Types Supported
8Max. number of vNICs per VM instance
NovNIC Hot Add Support
NovNIC Hot Remove Support
NoSingle Root I/O virtualization (SR-IOV) Support
ValuevNIC Requirements for Microsoft Azure
Max. number of vNICs per VM instance
Hypervisor vNIC Requirements for Cisco IOS XE Everest 16.4
NetVSCNIC Types Supported
8Max. number of vNICs per VM instance
NovNIC Hot Add Support
NovNIC Hot Remove Support
NoSingle Root I/O virtualization (SR-IOV) Support
ValuevNIC Requirements for Amazon Web Services (AWS)
VIF-netfront(pmap), ixgbevfNIC Types Supported
8 (See http://docs.aws.amazon.com/AWSEC2/
latest/UserGuide/
using-eni.html#AvailableIpPerENI)
NovNIC Hot Add Support
NovNIC Hot Remove Support
NoSingle Root I/O virtualization (SR-IOV) Support
NIC Types Supported
ValuevNIC Requirements for VMware ESXi
VMXNET3ixgbe(Intel 10Gb PCI
Express NIC Driver) ixgbef
10Max. number of vNICs per VM instance
YesvNIC Hot Add Support (Intel 10Gb PCI Express NIC Driver)
NovNIC Hot Remove Support (Intel 10Gb PCI Express NIC Driver)
Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide
15
Hypervisor Support
Cisco CSR 1000v Series Cloud Services Router Overview
ValuevNIC Requirements for VMware ESXi
YesSingle Root I/O virtualization (SR-IOV) Support
ValuevNIC Requirements for Citrix XenServer
VIF-netfront(pmap)NIC Types Supported
7Max. number of vNICs per VM instance
YesvNIC Hot Add Support
NovNIC Hot Remove Support
YesSingle Root I/O virtualization (SR-IOV) Support
ValuevNIC Requirements for KVM
Virtio, ixgbevf, ixgbbeNIC Types Supported
26Max. number of vNICs per VM instance
YesvNIC Hot Add Support
NovNIC Hot Remove Support
YesSingle Root I/O virtualization (SR-IOV) Support
ValuevNIC Requirements for Microsoft Hyper-V
NetVSCNIC Types Supported
8Max. number of vNICs per VM instance
NovNIC Hot Add Support
NovNIC Hot Remove Support
NoSingle Root I/O virtualization (SR-IOV) Support
ValuevNIC Requirements for Microsoft Azure
NetVSCNIC Types Supported
4Max. number of vNICs per VM instance
NovNIC Hot Add Support
NovNIC Hot Remove Support
NoSingle Root I/O virtualization (SR-IOV) Support
ValuevNIC Requirements for Amazon Web Services (AWS)
VIF-netfront(pmap), ixgbevfNIC Types Supported
Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide
16
Cisco CSR 1000v Series Cloud Services Router Overview
Hypervisor Support
ValuevNIC Requirements for Amazon Web Services (AWS)
Max. number of vNICs per VM instance
Hypervisor vNIC Requirements for Cisco IOS XE Denali 16.3
NIC Types Supported
8 (See http://docs.aws.amazon.com/AWSEC2/
latest/UserGuide/
using-eni.html#AvailableIpPerENI)
NovNIC Hot Add Support
NovNIC Hot Remove Support
NoSingle Root I/O virtualization (SR-IOV) Support
ValuevNIC Requirements for VMware ESXi
VMXNET3ixgbe (Intel 10Gb PCI
Express NIC Driver) ixgbef
10Max. number of vNICs per VM instance
YesvNIC Hot Add Support (Intel 10Gb PCI Express NIC Driver)
NovNIC Hot Remove Support (Intel 10Gb PCI Express NIC Driver)
YesSingle Root I/O virtualization (SR-IOV) Support
ValuevNIC Requirements for Citrix XenServer
VIF-netfront(pmap)NIC Types Supported
7Max. number of vNICs per VM instance
YesvNIC Hot Add Support
NovNIC Hot Remove Support
YesSingle Root I/O virtualization (SR-IOV) Support
ValuevNIC Requirements for KVM
Virtio, ixgbevf, ixgbbeNIC Types Supported
26Max. number of vNICs per VM instance
YesvNIC Hot Add Support
NovNIC Hot Remove Support
YesSingle Root I/O virtualization (SR-IOV) Support
ValuevNIC Requirements for Microsoft Hyper-V
NetVSCNIC Types Supported
8Max. number of vNICs per VM instance
Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide
17
Hypervisor Support
Cisco CSR 1000v Series Cloud Services Router Overview
ValuevNIC Requirements for Microsoft Hyper-V
NovNIC Hot Add Support
NovNIC Hot Remove Support
NoSingle Root I/O virtualization (SR-IOV) Support
ValuevNIC Requirements for Microsoft Azure
NetVSCNIC Types Supported
4Max. number of vNICs per VM instance
NovNIC Hot Add Support
NovNIC Hot Remove Support
NoSingle Root I/O virtualization (SR-IOV) Support
Max. number of vNICs per VM instance
Hypervisor vNIC Requirements for Cisco IOS XE 3S Releases
Table 2: Cisco CSR 1000v vNIC Support for Cisco IOS XE 3S Releases
Release:
VMware ESXi
Supported
ValuevNIC Requirements for Amazon Web Services (AWS)
VIF-netfront(pmap), ixgbevfNIC Types Supported
8 (See http://docs.aws.amazon.com/AWSEC2/
latest/UserGuide/
using-eni.html#AvailableIpPerENI)
NovNIC Hot Add Support
NovNIC Hot Remove Support
NoSingle Root I/O virtualization (SR-IOV) Support
3.16S, 3.17S3.13S, 3.14S, 3.15S3.12S3.10S, 3.11S3.9SCisco IOS XE
VMXNET3VMXNET3VMXNET3NIC Types
VMXNET3ixgbe
(Intel 10Gb PCI
Express NIC Driver)
VMXNET3ixgbe
Intel 10Gb PCI
Express NIC
Driverenic
vNICs per VM
instance
Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide
18
1010101010Max. number of
Loading...