Cisco CSR 1000V User Manual

Cisco CSR 1000V Series Cloud Services Router Software Configuration Guide

Cisco IOS XE Release 3.9S, 3.10S, 3.11S, 3.12S

First Published: July 26, 2012 Last Updated: June 27, 2014

Cisco Systems, Inc.

www.cisco.com

Cisco has more than 200 offices worldwide. Addresses, phone numbers, and fax numbers are listed on the Cisco website at www.cisco.com/go/offices.

Text Part Number: OL-27477-07

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.

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: 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)

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 CSR 1000V Series Cloud Services Router Software Configuration Guide

Preface

CHAPTER

Objectives

Document Revision History vi

Organization vii

Objectives

Preface

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, page v

• Document Revision History, page vi

• Organization, page vii

• Related Documentation, page viii

• Document Conventions, page viii

• Obtaining Documentation and Submitting a Service Request, page ix

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.

OL-27477-07

Cisco CSR 1000V Series Cloud Services Router Software Configuration Guide

Document Revision History

The Document Revision History records technical changes to this document. The table shows the Cisco IOS XE software release number, the date of the change, and a brief summary of the change

Release Date Change Summary

Cisco IOS XE Release 3.9S

Cisco IOS XE Release 3.10S

April 1, 2013

July 30, 2013

Preface

• Updates to Cisco IOS technology features

supported

• Support for throughput-based licenses

• Support for the Cisco Build, Deploy, Execute

OVF (BDEO) tool

• Support for the VMXNET3 vNIC interface

type

• Support for updating properties using the

vSphere GUI

• Support for VMware ESXi 5.1

• Support for the Citrix XenServer, version

6.0.2 hypervisor

• Support for the Kernel Virtual Machine

(KVM) hypervisor

Cisco IOS XE Release 3.11S

Cisco IOS XE Release 3.12S

November 21, 2013

March 28, 2014

• Support for technology-based licenses

• Support for 1vCPU and 4vCPU

configurations (VMware ESXi only)

• Initial support of REST API for selected

features

• Removal of the GigabitEthernet 0 interface

• Support added for 2 vCPU configurations

(VMware ESXi only)

• Support added for 1vCPU and 4vCPU

configurations (Citrix XenServer and KVM)

• Support for KVM using OpenStack

• Support for VXLAN termination

• Support for deploying the Cisco CSR 1000V

on Amazon Web Services

• Support for additional REST APIs

• Support for managing the router remotely

using Cisco Prime Network Services Controller (PNSC)

• Support for the Microsoft Hyper-V

hypervisor

• Support for Cisco Call Home and Cisco Smart

Call Home

• Support for additional REST APIs

Cisco CSR 1000V Series Cloud Services Router Software Configuration Guide

OL-27477-07

Preface

Organization

Chapter Title Description

Chapter 1 “Cisco CSR 1000V Series Cloud

Chapter 2 “Using Cisco IOS XE Software” Provides an overview of Cisco IOS XE software.

Chapter 3 “Installation Overview” Provides information on the Cisco CSR 1000V

Chapter 4 “Installing the Cisco CSR 1000V in

Chapter 5 “Installing the Cisco CSR 1000V in

Chapter 6 “Installing the Cisco CSR 1000V in

Chapter 7 “Installing the Cisco CSR 1000V in

Chapter 8 “Booting the Cisco CSR 1000V and

Chapter 9 “Upgrading the Cisco IOS XE

Chapter 10 “Mapping Cisco CSR 1000V

Chapter 11 “Accessing and Using GRUB

Chapter 12 “Configuring Call Home for the

Chapter 13 “Managing Cisco CSR 1000V

Chapter 14 “Configuring Support for Manage-

Chapter 15 “Configuring Support for Remote

Chapter 16 “Troubleshooting Cisco CSR

Appendix A “Rehosting the Cisco CSR 1000V

Services Router Overview”

VMware ESXi Environments”

Citrix XenServer Environments”

KVM Environments”

Microsoft Hyper-V Environments”

Accessing the Console”

Software”

Network Interfaces to VM Network Interfaces”

Mode”

Cisco CSR 1000V”

Licenses”

ment Using the REST API”

Management by the Cisco Prime Network Services Controller”

1000V VM Issues”

License”

Provides an overview of the Cisco CSR 1000V Series Cloud Services Router.

installation options.

Describes how to install the Cisco CSR 1000V on a VMware ESXi VM.

Describes how to install the Cisco CSR 1000V on a Citrix XenServer VM.

Describes how to install the Cisco CSR 1000V on a Kernel Virtual Machine (KVM).

Describes how to install the Cisco CSR 1000V on a Microsoft Hyper-V VM.

Describes how to boot the Cisco CSR 1000V and access the console.

Describes how to upgrade the Cisco IOS XE software on the Cisco CSR 1000V.

Provides information on how to map the Cisco CSR 1000V router interfaces to the VM network interfaces.

Describes how to access the GRUB interface and how to change the configuration register settings.

Describes how to configure Call Home and Smart Call Home.

Provides information on managing software licenses for the Cisco CSR 1000V.

Provides information on how to configure the Cisco CSR 1000V to enable management of the router using the REST API.

Provides information on how to activate support for Cisco Prime Network Services Controller (PNSC), a GUI-based network management tool that can be used to manage and provision the Cisco CSR 1000V.

Provides information on how to troubleshoot issues related to VM and router performance.

Provides information on rehosting the Cisco CSR 1000V license to another VM.

OL-27477-07

Cisco CSR 1000V Series Cloud Services Router Software Configuration Guide

vii

Document Conventions

This documentation uses the following conventions:

Convention Description

^ or Ctrl The ^ and Ctrl symbols represent the Control key. For example, the key combi-

string A string is a nonquoted set of characters shown in italics. For example, when

Command syntax descriptions use the following conventions:

Convention Description

bold Bold text indicates commands and keywords that you enter exactly as shown.

italics Italic text indicates arguments for which you supply values.

[x] Square brackets enclose an optional element (keyword or argument).

| A vertical line indicates a choice within an optional or required set of keywords

[x | y] Square brackets enclosing keywords or arguments separated by a vertical line

{x | y} Braces enclosing keywords or arguments separated by a vertical line indicate a

nation ^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.

setting an SNMP community string to public, do not use quotation marks around the string or the string will include the quotation marks.

or arguments.

indicate an optional choice.

required choice.

viii

Cisco CSR 1000V Series Cloud Services Router Software Configuration Guide

OL-27477-07

Preface

Nested sets of square brackets or braces indicate optional or required choices within optional or required elements. For example:

Convention Description

[x {y | z}] Braces and a vertical line within square brackets indicate a required choice

within an optional element.

Examples use the following conventions:

Convention Description

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.

< > 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. (Ex-

clamation 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:

Note Means reader take note. Notes contain helpful suggestions or references to materials that may not be

contained in this manual.

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 on obtaining documentation, submitting a service request, and gathering additional information, see What’s New in Cisco Product Documentation at:

http://www.cisco.com/c/en/us/td/docs/general/whatsnew/whatsnew.html

Subscribe to What’s New in Cisco Product Documentation, which lists all new and revised Cisco technical documentation, as an RSS feed and deliver content directly to your desktop using a reader application. The RSS feeds are a free service.

OL-27477-07

Cisco CSR 1000V Series Cloud Services Router Software Configuration Guide

Preface

Cisco CSR 1000V Series Cloud Services Router Software Configuration Guide

OL-27477-07

Introduction

CHA P T ER

Cisco CSR 1000V Series Cloud Services Router Overview

• Introduction

• Virtual Machine Requirements

• Cisco CSR 1000V Series Software License Overview

• Cisco CSR 1000V Series Architecture Differences from Hardware Platforms

• Supported Cisco IOS XE Technologies

• Management Support

• Finding Support Information for Platforms and Cisco Software Images

The Cisco CSR 1000V Series Cloud Services Router provides a cloud-based router that is deployed on a virtual machine (VM) instance on x86 server hardware. The Cisco CSR 1000V provides selected Cisco IOS XE features on a virtualization platform.

When the Cisco CSR 1000V virtual IOS XE software is deployed on a VM, the Cisco IOS XE software functions just as if it were deployed on a traditional Cisco hardware platform. The Cisco CSR 1000V includes a virtual Route Processor and a virtual Forwarding Processor (FP) as part of its architecture. The Cisco CSR 1000V supports a subset of Cisco IOS XE software features and technologies. For more information, see the “Supported Cisco IOS XE Technologies” section on page 1-13.

The Cisco CSR 1000V provides secure connectivity from the enterprise premise (such as a branch office or data center) to the public or private cloud.

Figure 1-1 shows the basic virtual form factor for the Cisco CSR 1000V. 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.

OL-27477-07

Cisco CSR 1000V Series Cloud Services Router Software Configuration Guide

1-1

Introduction

Chapter 1 Cisco CSR 1000V Series Cloud Services Router Overview

Figure 1-1 Cisco CSR 1000V Virtual Form Factor

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 VM console or the console on the virtual serial port to access the Cisco IOS XE CLI

commands.

1-2

Cisco CSR 1000V Series Cloud Services Router Software Configuration Guide

OL-27477-07

Chapter 1 Cisco CSR 1000V Series Cloud Services Router Overview

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 CSR 1000V REST API

• Cisco Prime Network Services Controller

For more information, see the “Management Support” section on page 1-20.

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.

Virtual Machine Requirements

(Cisco IOS XE Release 3.11S 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:

–

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, Cisco recommends 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 10-1.

Virtual Machine Requirements

The Cisco CSR 1000V runs only on a virtual machine. This section describes the virtual machine requirements for the router.

Cisco CSR 1000V Series Cloud Services Router Software Configuration Guide

OL-27477-07

1-3

Virtual Machine Requirements

• Virtual Machines

• Hypervisor Support

• Server Requirements

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

• 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.

Chapter 1 Cisco CSR 1000V Series Cloud Services Router Overview

about 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 “Cisco CSR 1000V Series Cloud Services Router Overview” section on

page 1-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.

The Cisco CSR 1000V is supported for installation on selected hypervisors. The following table lists the supported hypervisor versions for your software release.

Note Beginning with Cisco IOS XE Release 3.11S, the Cisco CSR 1000V can also be deployed on Cisco

Amazon Web Services. For more information, see the Cisco CSR 1000V Series Cloud Services Router

Deployment Guide for Amazon Web Services.

1-4

Cisco CSR 1000V Series Cloud Services Router Software Configuration Guide

OL-27477-07

Chapter 1 Cisco CSR 1000V Series Cloud Services Router Overview

Table 1-1 Support Matrix for Hypervisor Versions

Virtual Machine Requirements

Cisco CSR 1000V IOS XE Release

VMware ESXi

Citrix XenServer

Kernel Based Virtual Machine (KVM) Microsoft Hyper-V

3.9S 5.0 Not supported Not supported Not supported

3.10S 5.0

5.1

6.0.2

• Linux KVM based on

Red Hat Enterprise Linux 6.3

• Red Hat Enterprise

Not supported

Virtualization 3.1

3.11S 5.0

5.1

6.02

• Linux KVM based on

Red Hat Enterprise Linux 6.3

• Red Hat Enterprise

Not supported

Virtualization 3.1

3.12S 5.0

5.1

5.5

6.1

• Ubuntu 12.04.03 LTS

Server 64 Bits

• Ubuntu 12.04.03 LTS

Server 64 Bits

• KVM installation on

Windows Server

2012 R2

OpenStack using .qcow2 file

1. Requires Kernel version 2.6.3.2 and QEMU 0.12.

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:

• VMware ESXi Support Information, page 4-1

• Citrix XenServer Support Information, page 5-1

• Kernel Virtual Machine Support Information, page 6-1

• Microsoft Hyper-V Support Information, page 7-1

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. This feature is known as vNIC Hot Add/Remove.

The following table lists the supported vNICs and the minimum and maximum number of vNICs supported for each VM instance.

OL-27477-07

Cisco CSR 1000V Series Cloud Services Router Software Configuration Guide

1-5

Virtual Machine Requirements

Table 1-2 Cisco CSR 1000V vNIC Support

Cisco IOS XE Release: 3.9S 3.10S, 3.11S 3.12S

VMware ESXi:

NIC Types Supported VMXNET3 VMXNET3 VMXNET3

Max. number of vNICs per VM instance

vNIC Hot Add/Remove Support

Single Root I/O virtualization (SR-IOV) Support

Citrix XenServer:

NIC Types Supported — VIF VIF

Max. number of vNICs per VM instance

vNIC Hot Add/Remove Support

Single Root I/O virtualization (SR-IOV) Support

KVM:

NIC Types Supported — Virtio Virtio

Max. number of vNICs per VM instance

vNIC Hot Add/Remove Support

Single Root I/O virtualization (SR-IOV) Support

Microsoft Hyper-V:

NIC Types Supported — — HV NETVSC

Max. number of vNICs per VM instance

vNIC Hot Add/Remove Support

Single Root I/O virtualization (SR-IOV) Support

1. Requires the host hardware to support the Intel VT-d or AMD IOMMU specification. SR-IOV is not supported with Virtual LANs (VLANs).

2. Supported beginning with the Cisco IOS XE 3.12.1 release.

3. Requires the Cisco CSR 1000V to be reloaded.

Chapter 1 Cisco CSR 1000V Series Cloud Services Router Overview

10 10 10

No Yes Yes

—— No

—7 7

—No No

Yes

—— Yes

—10 26

—Yes

—— Yes

—— 3

—— No

1-6

Cisco CSR 1000V Series Cloud Services Router Software Configuration Guide

OL-27477-07

Chapter 1 Cisco CSR 1000V Series Cloud Services Router Overview

The VMXNET3, VIF and Virtio NIC types are para-virtualized NICs.

Note vNIC Hot Remove requires reloading the Cisco CSR 1000V.

Cisco CSR 1000V and Hypervisor Limitations

This section describes performance limitations due to how the Cisco CSR 1000V integrates with the supported hypervisors.

Cisco CSR 1000V and Hypervisor Limitations for Cisco IOS XE Release 3.12S

• When the Cisco CSR 1000V is installed on Microsoft Hyper-V, the interface numbers can change

after Microsoft Hyper-V fails over to a new server, or restarts after a live migration.

–

If the server is set to perform ungraceful failover, there is no workaround.

–

If the server is set to perform graceful failover or restart, enter the clear platform software vnic-if nvtable command before executing the failover or restart.

This issue is not seen if the maximum number of interfaces is configured.

• When the Cisco CSR 1000V is installed on Microsoft Hyper-V, if you want to configure a VLAN,

you must configure the VLAN interfaces on Microsoft Hyper-V using the Hyper-V Power Shell CLI.

Virtual Machine Requirements

• When the Cisco CSR 1000V is installed on Microsoft Hyper-V and an NSF-based virtual hard disk

is used, if there is a network connectivity issue between the Cisco CSR 1000V and the NSF server, the Cisco CSR 1000V is unable to use the virtual hard disk even if the network connection is restored. You must reboot the Cisco CSR 1000V to restore access to the virtual hard disk.

Cisco CSR 1000V and Hypervisor Limitations for Cisco IOS XE Release 3.10S

• Configuring Network Based Application Recognition (NBAR), or Application Visibility and

Control (AVC) support on the Cisco CSR 1000V requires a minimum of 4GB of DRAM on the VM, even when using the one vCPU configuration on the VM.

• On the Cisco CSR 1000V, all the NICs are logically named as the Gigabit Ethernet interface. The

Cisco CSR 1000V does support the 10G IXGBE vNIC in passthrough mode; but that interface also is also logically named as a Gigabit Ethernet interface. Note that with emulated devices like VMXNET3/PV/VIRTIO from the hypervisor, the Cisco CSR 1000V is not aware of the underlying interfaces. The vSwitch may be connected to a 10-GB physical NIC or 1-GB physical NICs or multiple NICs (with NIC teaming on the hypervisor) as well.

• The Cisco CSR 1000V supports an MTU range from 1500 to 9216 bytes. However, the maximum

MTU supported on your hypervisor version may be lower. The MTU value configured on the Cisco CSR 1000V should not exceed the maximum MTU value supported on the hypervisor.

Cisco CSR 1000V and Hypervisor Limitations for Cisco IOS XE Release 3.9S

The following are the Cisco CSR 1000V and VMware ESXi limitations for Cisco IOS XE Release 3.9S:

• The Cisco CSR 1000V interface bandwidth defaults to 1 GB, irrespective of the hypervisor’s

physical NIC bandwidth. The routing protocols (OSPF, EIGRP) use the Cisco CSR 1000V interface bandwidth values for calculating the costs, not the physical NIC bandwidth.

OL-27477-07

Cisco CSR 1000V Series Cloud Services Router Software Configuration Guide

1-7

Cisco CSR 1000V Series Software License Overview

• When a Cisco CSR 1000V interface is directly connected to a physical router, and that physical

router’s connecting interface goes down, the change is not reflected on the Cisco CSR 1000V. This is because the Cisco CSR 1000V is actually connected to the hypervisor’s vSwitch and the vSwitch uplink port is connected to the physical interface of the router. This behavior is expected.

• The Cisco CSR 1000V provides an MTU range from 1500 to 9216 bytes. However, ESXi 5.0

supports only a maximum value of 9000 bytes.

Server Requirements

The server and processor requirements are different depending on the Cisco CSR 1000V release.

Table 1-3 Server Requirements

Cisco CSR 1000V Release Intel AMD

Cisco IOS XE Release

3.9S

Cisco IOS XE Releases

3.10S, 3.11S, 3.12S

Chapter 1 Cisco CSR 1000V Series Cloud Services Router Overview

Intel Nehalem and later-generation processors are supported.

Intel processors prior to the Nehalem generation are supported.

Not supported

Supported

For more information, see the Cisco CSR 1000V Series Cloud Services Router Release Notes.

Note In Cisco IOS XE Release 3.9S and earlier, the Cisco CSR 1000V uses instructions not supported on Intel

pre-Nehalem generation processors. The existence of the required Nehalem or later processor instruction set is determined at boot time. If the required instructions are not present, the following message is displayed:

%IOSXEBOOT-4-BOOT_HALT: (rp/0): Halted boot due to missing CPU feature requirement(s)

For more information, see the “Installation Overview” section on page 3-1.

Cisco CSR 1000V Series Software License Overview

The Cisco CSR 1000V Series software supports the standard Cisco software licensing process in Cisco IOS XE. The software activation process is similar to other Cisco router products, but there are some differences and additional requirements.

The Cisco CSR 1000V supports the following license types depending on the software release:

• Perpetual and subscription term licenses for 1, 3, and 5 years based on the following attributes:

–

Cisco IOS XE technology packages (Standard, Advanced and Premium)

–

Maximum supported throughput level (10, 25, 50, 100, 250, or 500 Mbps, and 1, 2.5 or 5 Gbps )

1-8

Cisco CSR 1000V Series Cloud Services Router Software Configuration Guide

OL-27477-07

Chapter 1 Cisco CSR 1000V Series Cloud Services Router Overview

• Memory upgrade licenses (selected technology packages and throughput levels only)

• 60-day evaluation licenses

The following table lists the available license types for your release. See the Cisco CSR 1000V Series

Cloud Services Router Release Notes for the specific license SKUs and the Cisco CSR 1000V Router Data Sheet.

Table 1-4 Cisco CSR 1000V Software License Types

Cisco CSR 1000V Version License Type License Term

All Evaluation 60 days

Cisco IOS XE Release 3.9S Base subscription technology package

licenses (Standard, Advanced, and Premium) for the following throughput maximums:

• 10 Mbps

• 25 Mbps

• 50 Mbps

Cisco IOS XE Releases

3.10S, 3.11S

Base subscription Standard technology package licenses for the following throughput maximums:

• 10 Mbps

• 50 Mbps

Cisco CSR 1000V Series Software License Overview

1, 3, and 5 years

• 1 and 3 years

• Perpetual

• 100 Mbps

• 250 Mbps

• 500 Mbps

• 1 Gbps

Base subscription Advanced and Premium technology package licenses for the following throughput maximums:

• 10 Mbps

• 50 Mbps

• 100 Mbps

• 250 Mbps

• (Cisco IOS XE Release 3.11S and later)

License to add 8 GB of memory with route reflector support

Note Selected licenses are available

through a Cisco service representative only.

OL-27477-07

Cisco CSR 1000V Series Cloud Services Router Software Configuration Guide

1-9

Cisco CSR 1000V Series Software License Overview

Table 1-4 Cisco CSR 1000V Software License Types (continued)

Cisco CSR 1000V Version License Type License Term

Cisco IOS XE Release

3.12S

Cisco IOS XE Release

3.12.1S

Chapter 1 Cisco CSR 1000V Series Cloud Services Router Overview

All of the licenses supported in Cisco IOS XE Release 3.11S, plus the following licenses:

Base subscription Advanced and Premium technology package licenses for the following throughput maximum:

• 1 Gbps

Base subscription Standard, Advanced and Premium technology package licenses for the following throughput maximum:

• 2.5 Gbps

Base subscription Standard technology package licenses for the following throughput maximum:

• 5 Gbps

New technology package licenses are supported:

• IPBase package license, with the same

feature set as the Standard package

• Security package license, with the same

feature set as the Advanced package

• AX package license, with the same

feature set as the Premium package

• 1 and 3 years

• Perpetual

• 1 and 3 years

• Perpetual

Cisco recommends using these technology packages for compatibility with future releases. All technology packages support the same throughput maximums as feature sets in earlier releases.

1. Available for the Premium package only. The additional memory is allocated to IOSD processes on the router only. The memory upgrade license does not add available memory on the VM.

The supported performance indicates the maximum throughput supported by the Cisco CSR 1000V for the license. If the throughput exceeds the supported performance, the router may experience dropped packets and you will receive notification that the supported performance has been exceeded. The Cisco CSR 1000V uses a performance limiter to regulate the throughput level. For more information, see the “License-Based Restriction on Aggregate Bandwidth” section on page 13-6.

If additional performance is required, an additional license for a separate Cisco CSR 1000V VM must be purchased. The Cisco CSR 1000V supports only one router instance per VM.

The Cisco CSR 1000V software licenses operate as follows:

• Each software license can be used for only one VM.

• You can install more than one license on a VM, but the multiple licenses can only apply to that VM.

1-10

Cisco CSR 1000V Series Cloud Services Router Software Configuration Guide

OL-27477-07

Chapter 1 Cisco CSR 1000V Series Cloud Services Router Overview

• Similar to other Cisco hardware products, the software license is node-locked to the unique device

identifier (UDI) of that product. The Cisco CSR 1000V generates a Virtual UDI (vUDI) when first installed on the VM, and licenses are node-locked to that vUDI. One license per VM instance is required. Instances that are cloned from a repository must generate a new vUDI.

Note When you clone the Cisco CSR 1000V, you will automatically get a new vUDI, and all the

licenses from the original VM should be removed.

• You must purchase and install a new technology level license if you want to upgrade or downgrade

the technology level. For example, if you have a Premium technology package license and you want to downgrade to the Standard technology package, you must purchase a new Standard technology package license.

• In Cisco IOS XE Release 3.10S, the default license will not enable advanced IPsec features and

MPLS.

• The Cisco CSR 1000V does not provide or support Right-to-Use performance licenses.

• You will receive warning notices that the subscription term license will expire beginning eight

weeks before license expiration.

The licenses must be activated in order for the Cisco CSR 1000V network ports to provide the supported throughput.

When the Cisco CSR 1000V is first booted, the router operates in evaluation mode, and provides limited feature support and is limited to a maximum throughput of 2.5 Mbps. To obtain the full feature support and throughput provided by your license, you must do the following:

Cisco CSR 1000V Series Software License Overview

• To access the features supported in your license, you must enter the license boot-level command

and set it to the level supported by your license (Standard, Advanced, or Premium).

• To set the throughput level to match your license, you must enter the platform

hardware-throughput command.

• You must then reboot the Cisco CSR 1000V for these settings to take effect.

If the throughput license expires or becomes invalid, the maximum throughput of the router reverts to

2.5 Mbps. When the 60-day evaluation license expires, the maximum throughput reverts to 2.5 Mbps and to the limited feature set.

The subscription term begins on the day the license is issued.

For more information about license activation, see the “Managing Cisco CSR 1000V Licenses” section

on page 13-1.

If you rehost the Cisco CSR 1000V to a VM on another server, the following rules apply:

• You must purchase a new rehost software license that lasts for the period remaining on the original

license.

• If the original license was renewed, the rehosted software license will last for the period remaining

on the renewed license.

• You have a 60-day grace period to remove the software license from the original server hardware

and activate it on the rehosted server hardware.

The Cisco CSR 1000V also supports Cisco License Manager and Cisco License Call Home. For more information about the standard Cisco IOS XE software activation procedure, and information about Cisco License Manager and Cisco License Call Home, see the Software Activation Configuration Guide,

Cisco IOS XE Release 3S.

OL-27477-07

Cisco CSR 1000V Series Cloud Services Router Software Configuration Guide

1-11

Chapter 1 Cisco CSR 1000V Series Cloud Services Router Overview

Cisco CSR 1000V Series Architecture Differences from Hardware Platforms

Unlike traditional Cisco hardware router platforms, the Cisco CSR 1000V Series is a virtual router that runs independently on an x86 machine. As a result, the Cisco CSR 1000V Series architecture has unique attributes that differentiate it from hardware-based router platforms.

For example, Table 1-5 lists a comparison of some key areas where the Cisco CSR 1000V Series differs from the Cisco ASR 1000 series routers.

Table 1-5 Cisco CSR 1000V Series Architecture Differences with Cisco ASR 1000 Series Routers

Feature Cisco ASR 1000 Series Cisco CSR 1000V Series

Hard Disk Supported. The Cisco CSR 1000V does not include

a hard disk. The software image is stored on bootflash only (8 GB).

Physical resources Managed by architecture of the

hardware platform.

Console types supported Physical serial port.

Managed by the hypervisor. Physical resources are shared among VMs.

• VMware soft console

• Network option (virtual terminal

server)

• Named pipe option

• Physical serial port on the ESXi or

KVM host

ROMMON Supported. The Cisco CSR 1000V does not include

ROMMON, but uses GRUB to provide similar but more limited functionality.

Break Signal Supported. Not supported.

Port numbering See the Cisco ASR1000

documentation.

ISSU Supports In-Service Software

Upgrades (ISSU).

Subpackage upgrades Supports installation of

subpackages for specific SPAs and SIP SPAs.

Diagnostic mode Supported. Not supported.

Dynamic addition/deletion of ports

1. Requires reload of the VM.

Supported. Supported.

Gigabit Ethernet x ports only.

Not supported.

Subpackages not supported. The Cisco CSR 1000V does not support SPAs.

1-12

Cisco CSR 1000V Series Cloud Services Router Software Configuration Guide

OL-27477-07

Chapter 1 Cisco CSR 1000V Series Cloud Services Router Overview

Supported Cisco IOS XE Technologies

The Cisco CSR 1000V Series Cloud Services Router supports selected Cisco IOS XE technologies. The Cisco CSR 1000V supports a more limited set of functionality compared to other router platforms.

Table 1- 6 lists the major Cisco IOS XE technologies the Cisco CSR 1000V supports. Technologies not

listed are not currently supported on the Cisco CSR 1000V. Not all features in a given technology may be supported. To verify support for specific features, use Cisco Feature Navigator. For more information, see the “Using Cisco Feature Navigator” section on page 1-22.

In Cisco IOS XE Release 3.9S, the Cisco CSR 1000V supports a maximum of 150 IPsec tunnels. Beginning with Cisco IOS XE Release 3.10S, the number of IPSec tunnels depends on the installed license. For more information, see the Cisco CSR 1000V Series Cloud Services Router Release Notes.

The information listed in this table applies only if using the Cisco IOS XE CLI. Support for Cisco IOS XE technologies is more limited in the following scenarios:

• When deploying the Cisco CSR 1000V on Amazon Web Services (AWS)

For more information, see the Cisco CSR 1000V Series Cloud Services Router Deployment Guide

for Amazon Web Services.

• When using the REST API to manage the Cisco CSR 1000V

For more information, see the “Configuring Support for Management Using the REST API” section

on page 14-1. For information about Cisco IOS XE technologies supported by the REST API, see

the Cisco CSR 1000V Series Cloud Services Router REST API Management Reference Guide.

• When using Cisco Prime Network Services Controller (PNSC) to remotely manage the

Cisco CSR 1000V

Supported Cisco IOS XE Technologies

For more information on features supported, see the “Configuring Support for Remote Management

by the Cisco Prime Network Services Controller” section on page 15-1.

Note The license technology packages available beginning with Cisco IOS XE release 3.12.1 support the same

sets of features as technology packages supported in previous releases. For example, the IPBase package supports Standard package features, the Security package supports Advanced package features, and the AX package supports the Premium package set of features.

Table 1-6 Cisco IOS XE Technologies Supported on the Cisco CSR 1000V Cloud Services Router

Minimum Cisco IOS

XE Release Technologies Supported

Required for

Cisco CSR 1000V

Technology Package Licenses Supported

See the Following Documentation:

IP:

• IPv4 Routing

• IPv4

Fragmentation and Reassembly

• IPv6 Forwarding

Cisco IOS XE

Release 3.9S

• Standard

• Advanced

• Premium

• IP Addressing

Configuration Guide Library, Cisco IOS XE Release 3S

• Cisco IOS IP Addressing

Services Command Reference

OL-27477-07

Cisco CSR 1000V Series Cloud Services Router Software Configuration Guide

1-13

Supported Cisco IOS XE Technologies

Table 1-6 Cisco IOS XE Technologies Supported on the Cisco CSR 1000V Cloud Services Router

Technologies Supported

• IPv6 Routing Cisco IOS XE

• Generic Routing

Encapsulation (GRE)

• LISP Cisco IOS XE

Basic Routing:

• BGP Cisco IOS XE

• EIGRP Cisco IOS XE

• ISIS Cisco IOS XE

• OSPF Cisco IOS XE

Minimum Cisco IOS XE Release Required for Cisco CSR 1000V

Release 3.9S

Cisco IOS XE Release 3.9S

Release 3.9S

Chapter 1 Cisco CSR 1000V Series Cloud Services Router Overview

Technology Package Licenses Supported

• Standard

• Advanced

• Premium

See the Following Documentation:

• IPv 6 Configuration Guide

Library, Cisco IOS XE Release 3S

• Cisco IOS IPv6 Command

Reference

• Standard

• Advanced

• Premium

• Interface and Hardware

Component Configuration Guide, Cisco IOS XE Release 3S

• Cisco IOS Interface and

Hardware Component Command Reference

• Premium • IP Routing: LISP

Configuration Guide, Cisco IOS XE Release 3S

• Cisco IOS IP Routing:

LISP Command Reference

• Standard

• Advanced

• Premium

• IP Routing: BGP

Configuration Guide, Cisco IOS XE Release 3S

• Cisco IOS IP Routing:

BGP Command Reference

• Standard

• Advanced

• Premium

• IP Routing: EIGRP

Configuration Guide, Cisco IOS XE Release 3S

• Cisco IOS IP Routing:

EIGRP Command Reference

• Standard

• Advanced

• Premium

• IP Routing: ISIS

Configuration Guide, Cisco IOS XE Release 3S

• Cisco IOS IP Routing:

ISIS Command Reference

• Standard

• Advanced

• Premium

• IP Routing: OSPF

Configuration Guide, Cisco IOS XE Release 3S

• Cisco IOS IP Routing:

OSPF Command Reference

1-14

Cisco CSR 1000V Series Cloud Services Router Software Configuration Guide

OL-27477-07

Chapter 1 Cisco CSR 1000V Series Cloud Services Router Overview

Table 1-6 Cisco IOS XE Technologies Supported on the Cisco CSR 1000V Cloud Services Router

Minimum Cisco IOS

XE Release Technologies Supported

• Performance

Routing

Required for

Cisco CSR 1000V

Cisco IOS XE

Release 3.9S

IP Multicast:

• IGMP Cisco IOS XE

Release 3.9S

• PIM Cisco IOS XE

Release 3.9S

IP Switching:

• Cisco Express

Forwarding

Cisco IOS XE

Release 3.9S

Technology Package Licenses Supported

• Standard

• Advanced

• Premium

• Advanced

• Premium

• Advanced

• Premium

• Standard

• Advanced

• Premium

Supported Cisco IOS XE Technologies

See the Following Documentation:

• Performance Routing

Configuration Guide, Cisco IOS XE Release 3S

• Cisco IOS Performance

Routing Command Reference

• IP Multicast: IGMP

Configuration Guide, Cisco IOS XE Release 3S

• Cisco IOS IP Multicast

Command Reference

• IP Multicast: PIM

Configuration Guide, Cisco IOS XE Release 3S

• Cisco IOS IP Multicast

Command Reference

• IP Switching Cisco

Express Forwarding Configuration Guide, Cisco IOS XE Release 3S

OL-27477-07

Wide Area Networking:

• OTV Cisco IOS XE

Release 3.10S

• VxLAN Cisco IOS XE

Release 3.11S

• WCCPv2 Cisco IOS XE

Release 3.9S

Cisco CSR 1000V Series Cloud Services Router Software Configuration Guide

• Cisco IOS IP Switching

Command Reference

• Premium • Wide-Area Networking

Configuration Guide: Overlay Transport Virtualization, Cisco IOS XE Release 3S

• Cisco IOS Wide-Area

Networking Command Reference

• Premium • CSR 1000V VxLAN

Support

• Premium • IP Application Services

Configuration Guide, Cisco IOS XE Release 3S

• Cisco IOS IP Application

Services Command Reference

1-15

Supported Cisco IOS XE Technologies

Table 1-6 Cisco IOS XE Technologies Supported on the Cisco CSR 1000V Cloud Services Router

Technologies Supported

VPN:

• IPsec VPN Cisco IOS XE

• DMVPN Cisco IOS XE

• Easy VPN Cisco IOS XE

• FlexVPN Cisco IOS XE

• GETVPN Cisco IOS XE

• SSL VPN Cisco IOS XE

MPLS:

• MPLS Cisco IOS XE

Minimum Cisco IOS XE Release Required for Cisco CSR 1000V

Release 3.9S

Release 3.11S

3.12.1S

Release 3.9S

Chapter 1 Cisco CSR 1000V Series Cloud Services Router Overview

Technology Package Licenses Supported

• Advanced

• Premium

• Advanced

• Premium

• Advanced

• Premium

• Advanced

• Premium

• Advanced

• Premium

• Advanced

• Premium

See the Following Documentation:

• Secure Connectivity

Configuration Guide Library, Cisco IOS XE Release 3S

• Cisco IOS Security

Command Reference

• SSL VPN Configuration

Guide, Cisco IOS Release 15M&T

• Cisco IOS Security

Command Reference

• Premium • Multiprotocol Label

Switching Configuration Guide Library, Cisco IOS XE Release 3S

1-16

• EoMPLS Cisco IOS XE

• Premium • Multiprotocol Label

Release 3.9S

• VRF Cisco IOS XE

Release 3.9S

Cisco CSR 1000V Series Cloud Services Router Software Configuration Guide

• Standard

• Advanced

• Premium

• Cisco IOS Multiprotocol

Label Switching Command Reference

Switching Configuration Guide Library, Cisco IOS XE Release 3S

• Cisco IOS Multiprotocol

Label Switching Command Reference

• MPLS: Layer 3 VPNs

Configuration Guide, Cisco IOS XE Release 3S

• Cisco IOS Multiprotocol

Label Switching Command Reference

OL-27477-07

+ 190 hidden pages

Cisco CSR 1000V User Manual

Specifications and Main Features

Frequently Asked Questions

User Manual

Cisco CSR 1000V Series Cloud Services Router Software Configuration Guide

CONTENTS

Objectives

Preface

Document Revision History

Organization

Related Documentation

Document Conventions

Obtaining Documentation and Submitting a Service Request

Introduction

Cisco CSR 1000V Series Cloud Services Router Overview

Benefits of Virtualization Using the Cisco CSR 1000V Series Cloud Services Router

Software Configuration and Management Using the Cisco IOS XE CLI

Router Interfaces

Virtual Machine Requirements

Virtual Machines

Hypervisor Support

Hypervisor vNIC Requirements

Cisco CSR 1000V and Hypervisor Limitations

Cisco CSR 1000V Series Software License Overview

Server Requirements

Cisco CSR 1000V Series Architecture Differences from Hardware Platforms

Supported Cisco IOS XE Technologies