Install and upgrade internal modules and field replaceable units (28 pages)
Summary of Contents for Cisco CSR 1000v Series
Page 1
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 http://www.cisco.com Tel: 408 526-4000 800 553-NETS (6387) Fax: 408 527-0883 Text Part Number:...
Page 2
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.
Page 3
Cisco CSR 1000v Series Cloud Services Router Overview C H A P T E R 2 Introduction Benefits of Virtualization Using the Cisco CSR 1000v Series Cloud Services Router Software Configuration and Management Using the Cisco IOS XE CLI Router Interfaces...
Cisco CSR 1000v and Hypervisor Limitations for Cisco IOS XE Release 3.9S Server Requirements Cisco Software Licensing (CSL) Evaluation Licenses—Cisco IOS XE 3.13S and Later, Cisco IOS XE Denali 16.3.1 and Later Evaluation Licenses—Cisco IOS XE 3.12S and Earlier Cisco Smart Licensing...
Page 5
Deploying the Cisco CSR 1000v VM using COT Example Manually Creating the VM and Installing the Cisco CSR 1000v Software Using the .iso File (VMware ESXi) Overview of Tasks for Manually Creating the Cisco CSR 1000v VM Manually Creating the Cisco CSR 1000v VM Using the .iso File (VMware ESXi) Increasing Performance on VMware ESXi Configurations VMware Requirements—Cisco IOS XE Everest 16.5...
Page 6
Citrix XenServer Support Information Installation Requirements for Citrix XenServer: Cisco IOS XE Everest 16.6 Manually Creating the Cisco CSR 1000v VM Using the .iso File (Citrix XenServer) Installation Requirements for Citrix XenServer: Cisco IOS XE Everest 16.5 Installation Requirements for Citrix XenServer: Cisco IOS XE Everest 16.4 Installation Requirements for Citrix XenServer: Cisco IOS XE 16.3...
Page 7
Microsoft Hyper-V Support Information Microsoft Hyper-V Limitations Installation Requirements for Microsoft Hyper-V—Cisco IOS XE Everest 16.6 Manually Creating the Cisco CSR 1000v VM using the .iso File (Microsoft Hyper-V) Prerequisites Prerequisites for Manually Creating the CSR 1000v VM using the .iso File...
Page 8
Contents Opening a Telnet Session to the Cisco CSR 1000v Console on the Virtual Serial Port Changing the Console Port Access After Installation License Installation Installing Cisco CSR 1000v Licenses C H A P T E R 1 0 Activating Cisco CSR 1000v Licenses Cisco Software Licensing (CSL) Installing CSL Evaluation Licenses for Cisco IOS XE 3.13S and Later...
Page 9
Requesting a New Virtual UDI Cisco Software Licensing (IOS XE 3.12 or Earlier) Activating CSL Evaluation Licenses for Cisco IOS XE 3.12S and Earlier Installing CSL Regular Licenses for Cisco IOS XE 3.12S and Earlier Upgrading the Cisco IOS XE Software...
Page 10
Specifying Rate Limit for Sending Call Home Messages Specifying HTTP Proxy Server Enabling AAA Authorization to Run IOS Commands for Call Home Messages Configuring Syslog Throttling Configuring Call Home Data Privacy Sending Call Home Communications Manually Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Page 11
Introduction to REST API Configuration Options Enabling REST API Support Configuring the Shared Management Interface to Support the REST API Configuring the Dual Management Interface to Support the REST API Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Page 12
Contents Configuring the REST API Local Port and AutoSave Options Configuring HTTPS Support for the REST API Using the Cisco IOS XE CLI Disabling REST API Support Viewing the REST API Container Status Configuring Support for Remote Management by the Cisco Prime Network Services...
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,...
Preface 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: http://www.cisco.com/en/US/products/ps11174/tsd_products_support_series_home.html...
Page 15
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. Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
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...
Page 17
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.
Page 18
• 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.
• 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...
Page 20
• 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. You can also install the Cisco CSR 1000v using an .iso file and manually create the VM in the hypervisor. “Installation Overview” section on page 3-1...
Page 21
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.
Page 22
• Ubuntu 12.04.03 LTS Server 64 Bits 3.12S 5.05.15.5 Windows Server Supported • Linux KVM 2012 R2 based on Red Hat Enterprise Linux 6.31 • Ubuntu 12.04.03 LTS Server 64 Bits Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Page 23
LTS Server 64 Bits 2 3.17S 5.05.15.56.0 Windows Server Not supported • Linux KVM 2012 R2 based on Red Hat Enterprise Linux 7.1 • Ubuntu 14.04 LTS Server 64 Bits 2 Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Page 24
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...
Page 25
Hot Add Support vNIC Hot Remove Support Single Root I/O virtualization (SR-IOV) Support vNIC Requirements for Microsoft Azure Value NIC Types Supported NetVSC Max. number of vNICs per VM instance Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Page 26
Hot Remove Support Single Root I/O virtualization (SR-IOV) Support vNIC Requirements for KVM Value NIC Types Supported Virtio, ixgbevf, ixgbbe Max. number of vNICs per VM instance vNIC Hot Add Support Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Page 27
Express NIC Driver) ixgbef Max. number of vNICs per VM instance vNIC Hot Add Support (Intel 10Gb PCI Express NIC Driver) vNIC Hot Remove Support (Intel 10Gb PCI Express NIC Driver) Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Page 28
Max. number of vNICs per VM instance vNIC Hot Add Support vNIC Hot Remove Support Single Root I/O virtualization (SR-IOV) Support vNIC Requirements for Amazon Web Services (AWS) Value NIC Types Supported VIF-netfront(pmap), ixgbevf Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Page 29
Hot Add Support vNIC Hot Remove Support Single Root I/O virtualization (SR-IOV) Support vNIC Requirements for Microsoft Hyper-V Value NIC Types Supported NetVSC Max. number of vNICs per VM instance Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Page 30
Hot Add Support vNIC Hot Remove Support Single Root I/O virtualization (SR-IOV) Support Hypervisor vNIC Requirements for Cisco IOS XE 3S Releases Table 2: Cisco CSR 1000v vNIC Support for Cisco IOS XE 3S Releases Cisco IOS XE 3.9S 3.10S, 3.11S 3.12S...
Page 31
— Virtio Virtio Virtio Virtio Supported ixgbevf ixgbevf ixgbe (Intel 10Gb ixgbe (Intel 10Gb PCI Express NIC PCI Express NIC Driver) Driver)enic Max. number of — vNICs per VM instance Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Page 32
— — virtualization (SR-IOV) Support Amazon Web Services NIC Types — (For Cisco IOS XE aws-vif(pmap) aws-vif(pmap) (Up until Cisco IOS Supported 3.11 and later), XE 3.16.2) aws-vif(pmap) aws-vif(pmap), aws-ixgbevf(SRIOV) Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Page 33
OS in which the CSR is operating, and the physical NIC accessed by the host Modes Beginning with Cisco IOS XE 3.16S and also including Cisco IOS XE Denali 16.3.1 and later, the Cisco CSR 1000v supports several modes of communication between the vNICs and the physical hardware: •...
Page 34
Cisco CSR 1000v Series Cloud Services Router Overview Hypervisor Support The figure below, "Cisco CSR 1000v I/O Routing Between vNIC of Guest OS and Hardware NIC of Host", shows the I/O routing options. Figure 1: Cisco CSR 1000v I/O Routing Between vNIC of Guest OS and Hardware NIC of Host Drivers The following table indicates the drivers required to support various I/O modes.
Page 35
IOS XE Denali 16.3.1 and higher. Note: For releases Cisco IOS XE 3.16 or later, and Cisco IOS XE Denali 16.3 or later, the boot up process may take a long time (5 minutes) when using passthrough drivers. This is due to performing DHCP during a PXE boot.
Page 36
Cisco CSR 1000v and Hypervisor Limitations for Cisco IOS XE Denali 16.3.1 and Later In these releases, the Cisco CSR 1000v does not support the hot removal of interfaces and does not have the ability to modify vNIC MTU.
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.
%IOSXEBOOT-4-BOOT_HALT: (rp/0): Halted boot due to missing CPU feature requirement(s) (For Cisco IOS XE Denali 16.3 and 16.4) the Cisco CSR 1000v uses instructions supported on Intel Core 2 and later generation processors including Streaming SIMD: SSE, SSE2, SSE3 and SSSE3. The existence of the required instruction set is not verified and the deployment of the Cisco CSR 1000v in an environment that does not meet these processor requirements may result in random system reloads.
Cisco CSR 1000v Series Cloud Services Router Overview Cisco Software Licensing (CSL) Cisco Software Licensing (CSL) The Cisco CSR 1000v supports two types of license: Cisco Software Licensing and Cisco Smart Licensing. This section summarizes Cisco Software Licensing. For more details of both licensing methods, see Activating...
Page 40
IOSD processes on the router only. The memory upgrade license does not add available memory on the Selected licenses are Note available through a Cisco service representative only. Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Page 41
IOSD processes on the router only. The memory upgrade license does not add available memory on the Selected licenses are only available through a Cisco service representative. Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Page 42
Premium package We recommend using these technology packages for compatibility with future releases. All technology packages support the same throughput maximums as feature sets in earlier releases. Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Page 43
10 Gbps Maximum Throughput, on page 161. 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: •...
Page 44
• In Cisco IOS XE 3.13S and later, the Cisco CSR 1000v first boots up in the AX technology mode by default, so all features in this package are supported. Installing an AX technology license applies the AX license immediately, and the throughput is increased to the maximum throughput of the installed license.
IOS XE release version. This section describes versions Cisco IOS XE 3.13S or later and Cisco IOS XE Denali 16.3.1 or later. Default Beginning with the Cisco IOS XE 3.13S release, the CSR 1000v boots by default with the following features: • AX technology package features • 100 Kbps maximum throughput Evaluation License Options Evaluation licenses valid for 60 days are available at the Cisco licensing portal.
Page 46
Step 4 Click “Get Other Licenses” and select “Demo and Evaluation” from the dropdown menu. Step 5 In the Product Family section, select “Routers & Switches.” In the Product section, select “Cisco Cloud Services Router 1000v.” Click Next. Step 6 Select the desired license type.
As a result, the Cisco CSR 1000v Series architecture has unique attributes that differentiate it from hardware-based router platforms. For example, the table below lists a comparison of some key areas where the Cisco CSR 1000v Series differs from the Cisco ASR 1000 series routers.
Page 48
Cisco CSR 1000v Series Cloud Services Router Overview Differences Between Cisco CSR 1000v Series and ASR 1000 Series Table 7: Cisco CSR 1000v Series Architecture Differences with Cisco ASR 1000 Series Routers Feature Cisco ASR 1000 Series Cisco CSR 1000v Series Hard Disk Supported.
To verify support for specific features, use Cisco Feature Navigator. For more information, see Using Cisco Feature Navigator, on page 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: •...
Management Support Managing the Router Using Cisco Configuration Professional Beginning with Cisco IOS XE Release 3.12S, the Cisco CSR 1000v supports managing the router using Cisco Configuration Professional. The minimum version required is Cisco Configuration Professional 2.8. For more information, see the Cisco Configuration Professional documentation.
Managing the Router Using the Cisco IOS XE REST API Beginning with Cisco IOS XE Release 3.10S, and including Cisco IOS XE Denali 16.2, a REST API is available as an alternative method for managing the Cisco CSR 1000v router.
Using the Software Advisor To see if a feature is supported by a Cisco IOS XE release, to locate the software document for that feature, or to check the minimum Cisco IOS XE software requirements with your router, Cisco maintains the Software Advisor tool on Cisco.com at:...
See Cisco Feature Navigator for cumulative feature information. For more information, see http://www.cisco.com/c/en/us/support/routers/cloud-services-router-1000v-series/ products-release-notes-list.html. Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Using Cisco IOS XE Software This chapter provides information about the Cisco IOS XE software used to configure the Cisco CSR 1000v Series Cloud Services Router. The Cisco CSR 1000v Series uses standard Cisco IOS XE CLI commands and conventions.
Page 66
Cisco IOS XE. Use the CLI to access Cisco IOS XE software. Because the CLI is divided into many different modes, the commands available to you at any given time depend on the mode that you are currently in. Entering a question mark (?) at the CLI prompt allows you to obtain a list of commands available for each command mode.
Page 67
Lists all commands available for a particular command mode. command ? Lists the keywords or arguments that you must enter next on the command line. (Space between command and question mark.) Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
To display keywords and arguments for a command, enter a question mark (?) at the configuration prompt or after entering part of a command followed by a space. The Cisco IOS XE software displays a list and brief description of available keywords and arguments. For example, if you were in global configuration mode and wanted to see all the keywords or arguments for the arap command, you would type arap ?.
Page 69
Set the interface Maximum Transmission Unit (MTU) netbios Use a defined NETBIOS access list or enable name-caching Negate a command or set its defaults nrzi-encoding Enable use of NRZI encoding Configure NTP Router(config-if)# Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Page 70
Almost every configuration command has a no form. In general, use the no form to disable a function. Use the command without the no keyword to re-enable a disabled function or to enable a function that is disabled Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Page 71
This task saves the configuration to NVRAM. On the Cisco CSR 1000v, the startup configuration file is stored in the NVRAM partition. As a matter of routine maintenance on any Cisco router, users should backup the startup configuration file by copying the startup configuration file from NVRAM onto one of the router’s other file systems and, additionally, onto a...
For example, information in NVRAM is encrypted so that it is not visible to administrative entities with access to the physical hard disk that the Cisco CSR 1000v is stored You can search and filter the output of show and more commands. This functionality is useful if you need to sort through large amounts of output or if you want to exclude output that you need not see.
CSR 1000v Series Cloud Services Router is not hardware-based, you must download the Cisco IOS XE software from Cisco.com and install it directly onto the virtual machine. However, as part of the initial installation process, you must first provision the attributes of the VM so that the Cisco CSR 1000v software can install and boot.
Page 74
The figure below ("Cisco CSR 1000v Installation Task Workflow") shows the high-level tasks required to install the Cisco CSR 1000v on the VM. The different installation options are dependent on the hypervisor being used. See the following sections for more information.
• .qcow2 Used for installing the software image in KVM OpenStack environments. • .run (Cisco IOS XE 3.16 and later, and Cisco IOS XE Denali 16.3.1 and later) Self-installing image used for installation in a KVM environment. • .bin Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Prerequisites for the Software Upgrade Process, on page 199 and subsequent sections. (Cisco IOS XE Everest 16.5 and later) On AWS, you can use the Cisco CSR 1000v .bin file to upgrade Note the version of Cisco CSR 1000v, without having to recreate AWS EC2 instance from a new AMI. This inline upgrade process is not yet available on Microsoft Azure.
Page 77
Prerequisites for Manually Creating the CSR 1000v VM using the .iso File, on page 137 • Create the Cisco CSR 1000v instance in KVM using OpenStack Uses the .qcow2 file. The qcow2 (QEMU Copy on Write) image format is used to create the Cisco CSR 1000v tenant in the KVM OpenStack cloud environment. See...
• The Cisco IOS XE CLI can be accessed either through the virtual VGA console or the console on the virtual serial port. The console can be selected from GRUB mode during the first-time installation, or it can be changed using the Cisco IOS XE platform console command after the router boots.
Page 79
• Kernel Virtual Machine Support Information, on page 113 Note For information about deploying the Cisco CSR 1000v in an Amazon Web Services environment, see the Cisco CSR 1000V Series Cloud Services Router Deployment Guide for Amazon Web Services. For information about deploying the Cisco CSR 1000v in a Microsoft Azure environment, see the...
Page 80
Installation Overview Where to Go Next Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
VMware ESXi Support Information This section includes information about VMware tools/software,and VM requirements required by the Cisco CSR 1000v running the latest Cisco IOS XE Denali 16.3.1 software, as well as a list of the supported VM features. The Cisco CSR 1000v can run on the VMware ESXi hypervisor. VMware ESXi runs on PCs with x86-based CPUs.
To find out more about installing vSphere products, see VMware product documentation VMware Requirements—Cisco IOS XE Everest 16.6 The VMware tools supported by Cisco CSR 1000v using Cisco IOS XE Everest 16.6 are as follows: Note For VMware requirements—Cisco IOS XE 3.x, see VMware Requirements—Cisco IOS XE 3.x, on page...
VMware features and operations, see the VMware Documentation The following VMware features and operations are not supported in all versions of the Cisco CSR 1000v, but can still be used or performed on non-supported versions at the risk of encountering dropped packets, dropped connections, and other error statistics: •...
You can export an OVF package to your local computer. Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Page 85
ARP packets to flood the Cisco CSR 1000v and overload the CPU. To avoid this situation, reduce the number of ARP packets and implement NIC Teaming as Active-Standby rather than Active-Active. Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
You can also configure a vSwitch to handle a physical NIC failover. High Availability Cisco IOS-based High Availability is not supported by the Cisco CSR 1000v. High Availability is supported Note on the VM host only. Table 20: Supported VMware Features and Operations: High Availability...
Cisco CSR 1000v. • Cisco CSR 1000v supports USB disk hot-plug. • You can use only two USB disk hot-plug devices at a time. • USB hub is not supported. Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Deploying the Cisco CSR 1000v OVA to the VM You can use the provided CSR 1000v OVA file package to deploy the Cisco CSR 1000v to the VM. The OVA package includes an OVF file that contains a default VM configuration based on a Cisco IOS XE release and the supported hypervisor.
2. From the vSphere Client Menu Bar, choose File > Deploy OVF Template. 3. In the OVA Wizard, point the source to the Cisco CSR 1000v OVA to be deployed. Click Next. 4. Under Name and Inventory Location, specify the name for the VM and click Next.
Page 90
The options for mapping the vNICs differ depending on the release version: • (Cisco IOS XE Release 3.11S and later, and IOS XE Denali 16.2 and later): Select the network mappings for the 3 default vNICs created during the OVA deployment. You can choose which vNIC will map to the router’s management interface when setting the bootstrap properties (see table "Bootstrap Properties for Cisco IOS XE...
Page 91
Remote Management IPv4 Address (Optional) Configures the IP address used for remote management of the Cisco CSR 1000v by the REST API or by the Cisco Prime Network Services Controller. The address must be in the same subnet as the management interface address.
Page 92
(Cisco IOS XE 3.13S and later, and Denali 16.2 and later) Configures the license technology level that is available when the Cisco CSR 1000v boots. able 23: OVA Bootstrap Properties for Cisco IOS XE Release 3.9S and 3.10S Property Description...
The OVA deploys the .iso file and, if the “Power on after deployment” setting is selected, automatically powers on the VM. Once the VM is powered on, the Cisco CSR 1000v begins the installation and boot process. If a bootstrap configuration file was included in the OVA, the router configuration will automatically be enabled.
Page 94
. If you wish to do so, you will need to add a second virtual CD/DVD drive to the VM for vCenter to pass these properties into the VM. To edit the vApp options to set basic Cisco CSR 1000v properties, do the following: SUMMARY STEPS 1.
You can add custom properties to the Cisco CSR 1000v based on Cisco IOS XE CLI commands using the vSphere GUI. You can add these properties either before or after you boot the Cisco CSR 1000v. If you set these custom properties after the Cisco CSR 1000v has booted, you will need to reload the router or power-cycle the VM for the properties settings to take effect.
Enter the information to create the new custom property based on a Cisco IOS XE CLI command: Note Before adding a custom property, make sure that the Cisco IOS XE command upon which it is based is supported on the Cisco CSR 1000v in your release.
Editing the Basic Properties of Cisco CSR 1000v using COT Before deploying Cisco CSR 1000v using COT, you can edit the basic or custom properties of the Cisco CSR 1000v VM in the OVA package using COT. To edit the basic properties of the OVA, use the cot edit-properties command.
Before doing the procedures shown in section Deploying the Cisco CSR 1000v VM using COT, on page you can edit custom properties, for example to include Cisco IOS XE CLI commands. To edit the custom properties of the OVA, use one of the following two commands: •...
Page 99
Text file that contains IOS XE configuration -c iosxe_config.txt commands. Each line of configuration in this file results in a entry such as com.cisco.csr1000v.ios-config-xxxx in the XML of the OVF. Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Specifies the name of a text file, such as iosxe_config.txt , to be embedded in the OVA. Example In this example, the cot inject-config command adds Cisco IOS XE commands in text file iosxe_config.txt to the OVA. $ cat iosxe_config.txt...
Deploying the Cisco CSR 1000v VM using COT To deploy the Cisco CSR 1000v VM, use the cot deploy ... esxi command as shown in the following step. Note that the following description provides general guidance. The exact steps that you need to perform may vary depending on the characteristics of your VMware environment and setup.
Manually Creating the VM and Installing the Cisco CSR 1000v Software Using the .iso File (VMware ESXi) Example The table below shows an example cot deploy command, and its arguments, that is used to deploy a Cisco CSR 1000v VM in a vCenter environment.
Page 103
Installing the Cisco CSR 1000v in VMware ESXi Environments Overview of Tasks for Manually Creating the Cisco CSR 1000v VM If you manually create the VM and you plan to use the Cisco CSR 1000v REST API, you must configure Note the HTTPS port using the Cisco IOS XE CLI.
• Location: Store with the virtual machine While the following procedure provides general guidance for how to deploy the Cisco CSR 1000v, the exact steps that you need to perform may vary depending on the characteristics of your VMware environment and setup.
Page 105
The number of cores per socket should always be set to 1, regardless of the number of virtual sockets selected. For example, a Cisco CSR 1000v with a 4 vCPU configuration should be configured as 4 sockets and 1 core per socket.
Step 19 Click Finish. The VM is now configured for the Cisco CSR 1000v and is ready to boot. The Cisco CSR 1000v is booted when the VM is powered on. See Booting the Cisco CSR 1000v and Accessing the Console, on page 145.
A default video, SCSI controller set is required, and an installed virtual CD/DVD drive. VMware Requirements—Cisco IOS XE Everest 16.4 The VMware tools supported by Cisco CSR 1000v using Cisco IOS XE Everest 16.4 are as follows: Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
A default video, SCSI controller set is required, and an installed virtual CD/DVD drive. VMware Requirements—Cisco IOS XE 3.x The VMware requirements supported by Cisco CSR 1000v using old versions of Cisco IOS XE from 3.9 to 3.17 are shown in the table below.
Page 110
Installing the Cisco CSR 1000v in VMware ESXi Environments VMware Requirements—Cisco IOS XE 3.x (For VMware requirements of Cisco IOS XE Denali 16.3 or later, see sections such as VMware Requirements—Cisco IOS XE Denali 16.3, on page 96.) Table 24: VMware Requirements for Cisco CSR 1000v (Cisco IOS XE versions 3.x)
VMware VM Requirements—Cisco IOS XE 3.x The VMware tools supported by Cisco CSR 1000v using versions of Cisco IOS XE from 3.9 to 3.17 are shown in the table below. The Cisco CSR 1000v does not support Cisco IOS XE Denali 16.2 Note (For the VMware requirements using Cisco IOS XE Denali 16.3 or later, see sections such as...
Installation Requirements—Cisco IOS XE 3.x Installation Requirements—Cisco IOS XE 3.x The table below lists the installation requirements for VMware ESXi using versions of Cisco IOS XE from 3.9 to 3.17. For Cisco IOS XE Denali 16.3 or later, see sections such as VMware Requirements—Cisco IOS...
Installation Requirements for Citrix XenServer: Cisco IOS XE 3.x, page 111 Citrix XenServer Support Information Supported Releases The Cisco CSR 1000v, using Cisco IOS XE 3.10S and later (Cisco IOS XE Denali 16.2 is not supported), is supported in the Citrix XenServer environment. Other Support Information The Cisco CSR 1000v installation on Citrix XenServer requires the manual creation of a VM and installation using the .iso file.
• Remote storage • Performance monitoring (CPU, network and disk) Note The Cisco CSR 1000v does not support XenTools. The XenMotion operation is not supported on the Cisco CSR 1000v because it requires XenTools. For more information, see Manually Creating the Cisco CSR 1000v VM Using the .iso File (Citrix XenServer), on page 107.
10. Click Finish. DETAILED STEPS Step 1 Download the .iso file from the Cisco CSR 1000v software installation image package and copy it onto a local or network device. Step 2 In the Citrix XenCenter console, to create a new VM, select the server, and click New VM.
Page 120
Click Add and then click Next. Step 9 On the Networking screen, select the networks that will connect to the Cisco CSR 1000v through the vNICs. Installation Requirements for Citrix XenServer: Cisco IOS XE Everest 16.4, on page 109 or other "Installation Requirements"...
The Citrix XenServer requirements for older versions of Cisco IOS XE (before IOS XE Denali 16.3) are shown in the Manually Creating the Cisco CSR 1000v VM Using the .iso File (Citrix XenServer), page 5-3. • Citrix XenServer version supported: 6.5 is recommended—tested and meets performance benchmarks.
Manually Creating the Cisco CSR 1000v VM Using the .iso File (Citrix XenServer), on page 107. The Citrix XenServer requirements for older versions of Cisco IOS XE (before IOS XE Denali 16.3) are shown in Manually Creating the Cisco CSR 1000v VM Using the .iso File (Citrix XenServer), on page 107.
Installation Requirements for Citrix XenServer: Cisco IOS XE 3.x Installation Requirements for Citrix XenServer: Cisco IOS XE Installation Requirements for Citrix XenServer (Cisco IOS XE 3.14, 3.15, 3.16, 3.17) For installation procedures, see Manually Creating the Cisco CSR 1000v VM Using the .iso File (Citrix XenServer), on page 107.
Page 124
• Maximum number of vNICs supported per VM instance: 7 • Virtual CD/DVD drive Installed: Required (Cisco IOS XE 3.10S Release and earlier) The network added to NIC0 maps to the Gigabit Ethernet 0 Note management interface on the Cisco CSR 1000v.
Red Hat Enterprise Linux (RHEL), an enterprise virtualization product produced by Red Hat, based on the Kernel-based Virtual Machine (KVM), is an open source, full virtualization solution for Linux on x86 hardware, containing virtualization extensions. Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
KVM" sections in the following few pages. The Cisco CSR 1000v installation on KVM requires the manual creation of a VM and installation using the .iso file or the qcow2 file. Deploying the OVA template into a KVM environment is not supported.
Creating a Cisco CSR 1000v KVM Instance Creating a Cisco CSR 1000v KVM Instance Creating the Cisco CSR 1000v VM Using the Self-installing .Run Package The Cisco CSR 1000v KVM Installer package (with .run extension) is a self-installing CSR package for KVM. Default or Interactive Installing a CSR instance using the .run package provides two options:...
Prerequisites Download and install the virt-manager RPM package on the KVM server. Download the .qcow2 or .iso image from the Cisco CSR 1000v software installation image package and copy it onto a local or network device. Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
4. Configure the memory and CPU parameters. 5. Configure virtual machine storage. 6. Click Finish. 7. Access the Cisco CSR 1000v console by using one of the following: DETAILED STEPS Step 1 Launch the virt-manager GUI. Click Create a new virtual machine.
Installing the Cisco CSR 1000v in KVM Environments Creating the Cisco CSR 1000v VM Using the virt-manager GUI Tool DETAILED STEPS Step 1 Click Add Hardware. Step 2 Select the Serial option from the menu. Step 3 From the Device type drop-down menu, select TCP net console (tcp).
The following steps are performed on the KVM server. Prerequisites • Download and install the virt-install RPM package on the KVM server. • Download the .qcow2 image from the Cisco CSR 1000v software installation image package and copy it onto a local or network device. SUMMARY STEPS 1.
Prerequisites • Download and install the virt-install RPM package on the KVM server. • Download the .iso image from the Cisco CSR 1000v software installation image package and copy it onto a local or network device. Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Page 133
Red Hat Enterprise Linux—Setting Host Mode Due to an issue specific to Red Hat Enterprise Linux, when launching the Cisco CSR1000v in a Red Hat Enterprise Linux environment using virt-install, set the host mode as follows: • In Red Hat Enterprise Linux 6, use: --cpu host •...
This procedure provides additional steps to execute within one of the following procedures, as noted within the procedures: • Creating the Cisco CSR 1000v VM Using virt-install—Using .qcow2 Image, on page 119 • Creating the Cisco CSR 1000v VM Using virt-install—Using ISO Image, on page 120...
The disk size should be set to 0 for the Cisco CSR 1000v to boot. The following command example creates a KVM instance with 4096 MB RAM, a disk size of 0 and 2 vCPUs configured:...
Prior to Cisco IOS XE 3.16S, you could specify only one of the two configuration files in the nova boot command. Beginning with Cisco IOS XE 3.16S, and including Cisco IOS XE Denali 16.3.1 and later, you can specify both configuration files in the nova boot command line—for example:...
Installing the Cisco CSR 1000v in KVM Environments, on page 113. The disk size should be set to 0 for the Cisco CSR 1000v to boot. as in the tables 6-1 and 6-2. Select the required flavor from the System Panel > Flavors tab.
Installing the Cisco CSR 1000v in KVM Environments Bootstrapping the CSR Configuration Bootstrapping the CSR Configuration Bootstrap Properties The Cisco CSR 1000v bootstrap properties are specified in the ovf-env.xml file. For an example ovf-env.xml file, see Example ovf-env.xml File, on page 128.
Page 139
This setting is used if you plan to remotely manage the Cisco CSR 1000v using the Cisco Prime Network Services Controller. privilege-password Configures the password for privileged (enable) access. Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Increasing Performance on KVM Configurations You can increase the performance for a Cisco CSR 1000v in a KVM environment by changing settings on the KVM host. These settings are independent of the Cisco IOS XE configuration settings on the Cisco CSR 1000v.
Cisco CSR1000v virtual machine that may be un-bootable. The issue is caused by an increase in the size of the cloned image size created by virt-manager, compared with the original Cisco CSR1000v VM image. The extra bytes (in the KB range) cause the boot failure. Workarounds There are three workarounds: •...
Installation Requirements for KVM—Cisco IOS XE Denali 16.4 The KVM requirements for Cisco CSR 1000v using Cisco IOS XE Denali 16.4.x are as follows: The KVM requirements for older versions of Cisco IOS XE (before IOS XE Denali 16.3.1) are shown in Note Installation Requirements for KVM—Cisco IOS XE 3.x, on page...
Installation Requirements for KVM—Cisco IOS XE 3.x This section contains information about VMware requirements for older Cisco IOS XE releases (before IOS XE Denali 16.3.1). To see the installation requirements for Cisco IOS XE Denali 16.3 or later, see sections such as Installation Requirements for KVM—Cisco IOS XE Denali 16.3, on page...
Page 146
Virtio Virtio Virtio Virtio Virtio Maximum number of vNICs supported per VM instance Virtual CD/DVD Required Required Required Required Required drive installed (applicable only when installing using an .iso file) Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Installation Requirements for Microsoft Hyper-V—Cisco IOS XE 3.x, page 143 Microsoft Hyper-V Support Information (Cisco IOS XE Release 3.12S or later and Cisco IOS XE Release Denali 16.3.1 or later)—the Cisco CSR 1000v supports installation on Microsoft Hyper-V using Windows Server 2012 R2.
This section describes the limitations when specifying VLANs on a VM interface, using the Hyper-V Manager. (Cisco IOS XE Denali 16.3.1 or later) You can only add one VLAN for a VM interface using the Virtual Switch Manager of Hyper-V Manager.
Prerequisites for Manually Creating the CSR 1000v VM using the .iso File While the following procedure provides a general guideline for how to manually create the VM for the Cisco CSR 1000v, the exact steps that you need to perform may vary depending on the characteristics of your Microsoft Hyper-V environment and setup.
5. On the Configure Networking screen, select a network connection to the virtual switch that was previously created. 6. On the Connect Virtual Hard Disk Screen, select the following option: 7. Review the VM settings, and if correct, click Finish. Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
On the Configure Networking screen, select a network connection to the virtual switch that was previously created. The network adapter selected in this step will become the first interface for the Cisco CSR 1000v once the VM is launched and the router boots. The other vNICs for the VM are created in the next procedure.
Page 152
Step 5 Under IDE Controller1, select the DVD Drive. The DVD Drive screen displays. For the Media setting, click the Image File checkbox, and browse to the Cisco CSR 1000v .iso file that you downloaded from Cisco.com. Click OK. Step 6 Select Network Adapter to verify that the network connection to the virtual switch is configured.
The hot-add of vNICs is not supported with Microsoft Hyper-V, so the network interfaces need to be added Note before launching the VM. After the Cisco CSR 1000v boots, you can verify the vNICs and how they are mapped to the interfaces using the show platform software vnic-if interface-mapping command. See Mapping Cisco CSR 1000v Network Interfaces to VM Network Interfaces, on page 213.
Installation Requirements for Microsoft Hyper-V—Cisco IOS XE Everest 16.4 The Microsoft Hyper-V requirements for Cisco CSR 1000v using Cisco IOS XE Everest 16.4 are as follows: The Microsoft Hyper-V requirements for older versions of Cisco IOS XE (before IOS XE Denali 16.3)
Installation Requirements for Microsoft Hyper-V—Cisco IOS XE Denali 16.3.1 The Microsoft Hyper-V requirements for Cisco CSR 1000v using Cisco IOS XE Denali 16.3.1 are as follows: Note The Microsoft Hyper-V requirements for older versions of Cisco IOS XE (before IOS XE Denali 16.3.1) are shown in the Installation Requirements for Microsoft Hyper-V—Cisco IOS XE 3.x, on page...
Page 156
10 The required vCPU configuration depends on the throughput license and technology package installed. See the data sheet for your release for more information. 11 The VHD format is supported only. The VHDX format is not supported. Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
1. Power-up the VM. Within 5 seconds of powering on the VM, choose a console described from one of the following three steps (2, 3,or 4) to select a console to view the router bootup and to access the Cisco CSR 1000v CLI.
Page 158
Choose this option to use the virtual VGA console. If you choose to use the virtual console, the rest of the steps in this procedure do not apply. On Cisco IOS XE 3.12S and earlier, this is the default setting and the Cisco CSR 1000v boots using the Virtual Console if another option is not selected within the 5 second timeframe.
Page 159
When the Cisco CSR 1000v is booted for the first time, the mode the router boots in depends on the release version. For Cisco IOS XE 3.13S and later, and IOS XE Denali 16.3.1 and later, the Cisco CSR 1000v boots with the AX package set of features and throughput is limited to 100 Kbps.
Accessing the Cisco CSR 1000v Through the Virtual VGA Console When installing the Cisco CSR 1000v software image, the setting to use is as follows: • (Cisco IOS XE 3.12S and earlier, Cisco_IOS XE 3.17S and later, and IOS XE Denali 16.3.1 and later) Virtual VGA console •...
Page 161
In the Firewall section, click Properties, and then select the VM serial port connected over Network value. You can now access the Cisco IOS XE console using the Telnet port URI. When you configure the virtual serial port, the CSR 1000v is no longer accessible from the VM’s virtual console. See...
To use these settings, either the Auto Console option or the Serial Console option in the GRUB menu must Note have been selected while the Cisco CSR 1000v booted. If you have already installed the Cisco CSR 1000v software using the virtual VGA console, you must configure either the Cisco IOS XE platform console auto command or platform console serial command and reload the VM in order for the console access through the virtual serial port to work.
• Or, from a UNIX terminal use the command telnet host-ipaddress portnumber Step 2 At the Cisco CSR 1000v IOS XE password prompt, enter your login password. The following example shows entry of the password mypass: Example: User Access Verification...
Changing the Console Port Access After Installation After the Cisco CSR 1000v has booted successfully, you can change the console port access to the router using Cisco IOS XE commands. After you change the console port access, you must reload or power-cycle the router.
Page 165
Router(config)# end Step 5 copy system:running-config Copies the running configuration to the NVRAM startup configuration. nvram:startup-config Example: Router# copy system:running-config nvram:startup-config Step 6 Reloads the operating system. reload Example: Router# reload Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Booting the Cisco CSR 1000v and Accessing the Console License Installation License Installation One of the first steps you need to perform after obtaining console access is to install the Cisco CSR 1000v software licenses. For more information, see Installing Cisco CSR 1000v Licenses, on page 155.
• Registering the Router with the Cisco Licensing Cloud (CSSM satellite), page 176 • Re-establishing Connectivity to the Cisco Smart Call Home Server when IPv6 is Configured, page 178 • Requesting Cisco Smart License Throughput Level Licenses, page 180 •...
Installing CSL Evaluation Licenses for Cisco IOS XE 3.13S and Later In Cisco IOS XE 3.13S and later, including IOS XE Denali 16.2 and later, the Cisco CSR 1000v first boots with the AX feature set enabled and the maximum throughput limited to 100 Kbps. The following evaluation licenses are available: •...
Page 169
Installing CSL Evaluation Licenses for Cisco IOS XE 3.13S and Later SUMMARY STEPS 1. enable 2. show license udi 3. Log on to the Cisco Software Licensing portal to obtain the evaluation license: http://www.cisco.com/go/ license 4. license install stored-location-url 5. configure terminal 6.
Page 170
Example: write memory Step 9 reload Restarts the Cisco CSR 1000v to enable the feature set and the maximum throughput supported by the evaluation license. The Cisco CSR 1000v reloads with the evaluation license activated. Example: The evaluation license expires 60 days from the time it is activated.
Installing CSL Regular Licenses for Cisco IOS XE 3.13S and Later In Cisco IOS XE 3.13S and later, including IOS XE Denali 16.3 and later, the Cisco CSR 1000v first boots in limited mode with the AX feature set enabled and the maximum throughput limited to 100 Kbps. You can generate multiple licenses for the Cisco CSR 1000v from one PAK.
Page 172
Installing Cisco CSR 1000v Licenses Installing CSL Regular Licenses for Cisco IOS XE 3.13S and Later Step 4 Convert the PAK to a license by entering the PAK and the UDI into the Cisco Product License registration portal: http:/ www.cisco.com/go/license Example: When entering the UDI, enter only the 11-character serial number;...
Example: Router# reload Restarts the Cisco CSR 1000v to enable the feature set and the maximum throughput supported by the license. Note: If you are installing an AX license, you do not need to restart the Cisco CSR 1000v. Step 11...
Understanding the Cisco CSR 1000v Memory Allocation The feature add-on licenses add memory for the Cisco CSR 1000v, but the memory is allocated to both the IOSd component and the data plane component, with the allocations depending on the licenses installed.
Dataplane = 2.5G Installing Memory Add-on License Beginning with Cisco IOS XE 3.13S, you can add memory in 4 GB increments to enable control plane scaling using the memory add-on license (L-CSR-MEM-4G=). The following prerequisites apply: Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Page 176
SUMMARY STEPS 1. Obtain the PAK. 2. enable 3. show license udi 4. Convert the PAK to a license by entering the PAK and the UDI into the Cisco Product License registration portal: http://www.cisco.com/go/license 5. show platform software vmemory info 6.
Page 177
Installing Cisco CSR 1000v Licenses Installing CSL Feature Add-on Licenses for Cisco IOS XE 3.13S and Later Command or Action Purpose • Copy the license file received from the Cisco Product License Registration portal to the appropriate file system on the device.
License Priority: Medium Information About Installing Broadband Feature License Beginning with Cisco IOS XE 3.13S, the Cisco CSR 1000v supports the Broadband Network Gateway feature set and the Intelligent Services Gateway feature set. The required broadband feature license (L-CSR-BB-1K=) provides up to 4 GB of additional memory and support for up to 1000 broadband sessions.
SUMMARY STEPS 1. Obtain the PAK. 2. enable 3. show license udi 4. Convert the PAK to a license by entering the PAK and the UDI into the Cisco Product License registration portal http://www.cisco.com/go/license 5. show platform software vmemory info 6.
Page 180
Installing Cisco CSR 1000v Licenses Installing CSL Feature Add-on Licenses for Cisco IOS XE 3.13S and Later Command or Action Purpose • You need the UDI of the device as part of the process to obtain a license. Example: Router# show license udi...
Page 181
Installing Cisco CSR 1000v Licenses Installing CSL Feature Add-on Licenses for Cisco IOS XE 3.13S and Later Command or Action Purpose Example: 4096 MB memory has been added to the system Example: Execute ’write memory' to persist this change Step 11 write memory Saves the running configuration to NVRAM.
Determining the License Status You can install multiple licenses on a Cisco CSR 1000v. To determine if a license is active, enter the show license or show license detail command. The display indicates the license status. The following are the possible states for license: •...
Determining the AWS License Type If you migrated either a Standard or Advanced technology package license from a previous version to Cisco IOS XE 3.13S, then the show version and show license commands display the old license names, which is expected behavior.
• To use Cisco Smart Licensing, you must first configure the Call Home feature and obtain Cisco Smart Call Home Services. • For Cisco IOS XE 3.15S and later, and IOS XE Denali 16.3 and later, the following Cisco IOS XE technology packages are supported: IPBase, Security, AX and APPX •...
Page 185
Installing Cisco CSR 1000v Licenses Configuring Call Home for Smart Licensing For more information in general about configuring Call Home for the Cisco CSR 1000v, see Configuring Note Call Home for the Cisco CSR 1000v, on page 229. SUMMARY STEPS 1.
Note or http://, depending on whether the server is a secure server, or not. Enabling Cisco Smart Licensing To enable Cisco Smart Licensing and register your device, perform the following steps: SUMMARY STEPS 1. configure terminal 2. license smart enable 3.
Router# reload What to Do Next After Cisco Smart Licensing is enabled, the Cisco CSR 1000v is no longer in evaluation mode and the technology level and throughput level supported by your license takes effect. For more information about managing the technology package and throughput license attributes, see...
Smart licensing may fail when IPv6 is configured on any interface and the device does not have IPv6 Note connectivity to the Internet or the Cisco Smart Software Agent at tools.cisco.com, resulting in log file error messages such as those shown below.
Page 189
Registering the Router with the Cisco Licensing Cloud (CSSM satellite) After you have enabled Cisco Smart Licensing, you must register the router with Cisco. Using the ID token, the license agent on the router registers the product with Cisco and then receives back an identity certificate.
Re-establishing Connectivity to the Cisco Smart Call Home Server when IPv6 is Configured This section describes what to do if there is a failure to connect to the Cisco Smart Call Home Server when IPv6 is configured, as mentioned previously in Enabling Cisco Smart Licensing, on page 174.
IPv6 address. Re-establishing Connectivity—Method 2 This task applies to the following Cisco IOS XE releases: 3.16.5 (or earlier), Everest 16.4.1, and Denali 16.3.1 to 16.3.3. To establish a connection if IPv6 connectivity fails, choose one of the following two options: •...
Register the CSR device with the Smart License server. Changing Throughput Licenses When working with Cisco Smart Licenses, using the platform hardware throughput level command requests a license for the new throughput level. Typically, the activation process requires several minutes. During this time, the new license remains “pending.”...
For information about memory add-on licenses, see Understanding the Cisco CSR 1000v Memory Allocation, on page 162. For Cisco Smart Licensing, the procedure for requesting the license is as follows: SUMMARY STEPS 1. configure terminal 2. platform memory add memory 3.
By default, the license (also called “entitlement”) is automatically renewed every 30 days. You can manually renew the license using this procedure. This may be useful in either of the following circumstances: • Only a limited window of Internet access is available. Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Smart Call Home backend server. Disabling Cisco Smart Licensing Describes how you can disable Cisco Smart Licensing and switch back to standard Cisco Software Licensing (CSL) mode. Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Smart Licensing server for a license and the number of available licenses recorded on the Smart Licensing account is exceeded. The "out of compliance" message may also occur as a result of the Cisco CSR 1000v having been configured to have a higher performance level compared to the previously purchased feature set.
Page 198
Feature Restricted mode are lost if the Cisco CSR 1000v is rebooted. The Cisco CSR 1000v then returns to Feature Restricted mode. If you use the platform hardware throughput restricted-throughput-rate-mode command, recovery is helped as you are now able to use the configuration commands that are required to restore the router license.
Activating Permanent License Reservation If configuration commands to renew licensing are not required then you can reboot the Cisco CSR 1000v and the router will be able to communicate with the Smart Licensing server and then pre-existing licenses can be renewed.
Locate the entry that matches the Unique Device Identifier (UDI) of the device that you want to remove from the list. Step 5 Select Actions, click Remove Product Instance. Cisco SSM removes the product instance. Step 6 Paste the return code and click Remove. Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Smart Agent for Licensing: 1.4.0_rel/11 Component Versions: SA:(1_4_rel)1.0.10, SI:(rel21)1.2.0, CH:(rel4)1.0.23, PK:(rel17)1.0.5 Additional show Commands Useful for Troubleshooting The following show commands may be helpful during troubleshooting: show call-home profile all show license tech support Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
• (Cisco IOS XE 3.10S and earlier) The license shaper regulates the throughput on non-management interfaces only. The GigabitEthernet 0 dedicated management interface is not counted • (Cisco IOS XE 3.11S and later, and IOS XE Denali 16.2 and later) The license shaper regulates the throughput on all interfaces.
Release 3S Managing Throughput Notifications Beginning with Cisco IOS XE 3.13S, and including IOS XE Denali 16.3.1 and later, you can configure the Cisco CSR 1000v to notify you when a certain percentage of the maximum throughput level is reached. The maximum allowable throughput is based on the installed throughput license.
Requesting a New Virtual UDI The Cisco CSR 1000v license is node-locked to the vUDI. If you clone the Cisco CSR 1000v to a new VM instance, the vUDI is in most cases automatically updated when the router first boots up on the cloned machine.
This material is provided as legacy information. When the Cisco CSR 1000v first boots, the network interfaces are activated but feature support is limited and the throughput is limited to 2.5 Mbps. The evaluation license is bundled with the software, but you must activate the evaluation license to access the features.
Note available. This material is provided as legacy information. In Cisco IOS XE 3.12S and earlier, the Cisco CSR 1000v first boots in limited mode with the Standard feature set enabled and the maximum throughput limited to 2.5 Mbps. You can generate multiple licenses for the Cisco CSR 1000v from one PAK. The purchased PAK determines the number of licenses you can generate.
Page 208
SUMMARY STEPS 1. Obtain the PAK. 2. enable 3. show license udi 4. Convert the PAK to a license by entering the PAK and the UDI into the Cisco Product License registration portal: "http:/www.cisco.com/go/license" 5. license install stored-location-url 6. configure terminal 7.
Page 209
Saves the running configuration to NVRAM. Example: Router# write memory Step 10 reload Restarts the Cisco CSR 1000v to enable the feature set and the maximum throughput supported by the license. Example: Router# reload Step 11 show license detail After the Cisco CSR 1000v restarts, verifies that the license has been installed and is active.
Page 210
Installing Cisco CSR 1000v Licenses Installing CSL Regular Licenses for Cisco IOS XE 3.12S and Earlier Command or Action Purpose Step 13 configure terminal Enters global configuration mode. Example: Router# configure terminal Step 14 platform hardware throughput level MB{10 | 100 (Optional) Changes the maximum throughput level for the Cisco CSR 1000v.
Router Overview, on page This procedure is for upgrading to a new software version of the Cisco CSR 1000v on the same VM only. It does not describe how to install or rehost an existing CSR 1000v running the same or upgraded software version on a different VM.
Upgrading the Cisco IOS XE Software Saving Backup Copies of Your Old System Image and Configuration If upgrading to Cisco IOS XE Release 3.11S from an earlier release, we recommend that you update your Caution configuration to remove the GigabitEthernet0 management interface before upgrading. Because the GigabitEthernet0 interface is no longer supported beginning with Cisco IOS XE Release 3.11S, you will...
Page 213
The following example shows the startup configuration being copied to a TFTP server: Router# copy nvram:startup-config tftp: Remote host[]? 192.0.2.1 Name of configuration file to write [rtr2-confg]? rtr2-config-b4upgrade Write file rtr2-confg-b4upgrade on host 192.0.0.1?[confirm] <cr> ![OK] Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
• Specify the outbound file directory to which you will download and store the system image. • Download the new Cisco IOS software image into the workstation or PC. • Verify that the TFTP or RCP server has IP connectivity to the router. If you cannot successfully ping between the TFTP or RCP server and the router, either configure a default gateway on the router or make sure that the router and server each have an IP address in the same network or subnet.
Page 215
3. When prompted, enter the IP address of the TFTP or RCP server: 4. When prompted, enter the filename of the Cisco IOS software image to be installed: 5. When prompted, enter the filename as you want it to appear on the router. Typically, the same filename is entered as was used in the previous step.
Page 216
• If you are not certain that all files in bootflash memory should be erased, press Ctrl-Z. Step 7 If the error message does not appear, enter no when prompted to erase the bootflash memory before copying: Example: Accessing tftp://10.10.10.2/csr1000v-universalk9.03.10.00.S.153-3.S-ext.SPA.bin... Erase bootflash: before copying? [confirm] no Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Upgrading the Cisco IOS XE Software Loading the New System Image from the Cisco IOS XE Software Loading the New System Image from the Cisco IOS XE Software SUMMARY STEPS 1. dir bootflash: 2. configure terminal 3. no boot system 4.
Page 218
Example: Router# write memory This step is required beginning with Cisco IOS XE Release 3.9S if upgrading to a later version. Entering the Note write or write memory command updates the GRUB menu list of images available on the bootflash disk.
Page 219
Router# copy running-config startup-config Step 14 write memory This step is required beginning with Cisco IOS XE Release 3.9S if upgrading to a later version. Entering the Note write memory command updates the GRUB menu list of images available on the bootflash disk.
Use this command to display a list of all files and directories in bootflash memory: Example: Router# dir bootflash: Directory of bootflash:/ -rw- 6458388 Mar 01 1993 00:00:58 csr1000v.tmp Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Page 221
Example: Router(config)# do write memory This step is required beginning with Cisco IOS XE Release 3.9S if upgrading to a later version. Entering the Note do write or do write memory command updates the GRUB menu list of images available on the bootflash disk.
To aid file recovery and to minimize downtime in the event of file corruption, we recommend that you save backup copies of the startup configuration file and the Cisco IOS software system image file on a server. Do not erase any existing backup copies of your configuration and system image that you saved before upgrading your system image.
Page 223
[4137952 bytes used, 12639264 available, 16777216 total] 16384K bytes of processor board System flash (Read/Write)\ Router# copy bootflash: tftp: IP address of remote host [255.255.255.255]? 192.0.2.1 filename to write on tftp host? csr1000v-advernterprisek9-mz Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
VM. See your VM vendor documentation for more information about rebooting the VM. After rebooting, the Cisco CSR 1000v VM should include the new system image with a newly installed Cisco IOS XE software version.
Mapping the Router Network Interfaces to vNICs The Cisco CSR 1000v maps the GigabitEthernet network interfaces to the logical virtual network interface card (vNIC) name assigned by the VM. The VM in turn maps the logical vNIC name to a physical MAC address.
Page 226
Mapping the Router Network Interfaces to vNICs When the Cisco CSR 1000v is booted for the first time, the router interfaces are mapped to the logical vNIC interfaces that were added when the VM was created. The figure below shows the relationship between the vNICs and the Cisco CSR 1000v router interfaces.
Adding and Deleting Network Interfaces on the Cisco CSR 1000v The vNIC name shown in the display is a logical interface that the Cisco CSR 1000v uses to map to the interface on the hypervisor. It does not always map to the corresponding NIC name added during the VM installation.
The mapping between the router network interfaces and the vNICs only applies to the current VM that the Cisco CSR 1000v is installed on. If the VM is cloned, then the stored UUID will not match the current UUID and the interface mapping will not match the router configuration.
Mapping Cisco CSR 1000v Network Interfaces with vSwitch Interfaces You can configure the network interfaces in ESXi in different ways to accommodate the Cisco CSR 1000v interfaces. The figure below shows an example where each Cisco CSR 1000v router interface is mapped to one host Ethernet interface.
Page 230
Mapping Cisco CSR 1000v Network Interfaces to VM Network Interfaces Mapping Cisco CSR 1000v Network Interfaces with vSwitch Interfaces The figure below shows an example with multiple Cisco CSR 1000v interfaces sharing one host ESXi Ethernet interface. Figure 8: Cisco CSR 1000v Interfaces Sharing One ESXi Host Ethernet Interface...
Page 231
Mapping Cisco CSR 1000v Network Interfaces to VM Network Interfaces Mapping Cisco CSR 1000v Network Interfaces with vSwitch Interfaces The next figure shows one of the Cisco CSR 1000v interfaces mapped directly to a trunk interface on the vSwitch. Figure 9: Cisco CSR 1000v Interfaces Directly Mapped to vSwitch Trunk...
Page 232
Mapping Cisco CSR 1000v Network Interfaces to VM Network Interfaces Mapping Cisco CSR 1000v Network Interfaces with vSwitch Interfaces Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
About GRUB Mode and the Configuration Register The Cisco CSR 1000v has a 16-bit configuration register in NVRAM. Each bit has value 1 (on or set) or value 0 (off or clear), and each bit setting affects the router behavior upon the next reload power cycle. The Cisco CSR 1000v GRUB mode supports a subset of configuration register options compared to ROMMON options on other Cisco routers.
Page 234
Use the 0x000 setting to configure the Cisco CSR 1000v to automatically enter GRUB mode when the Note router boots.
To access the GRUB menu, enter ESC at the GRUB prompt. The following shows the GRUB menu display. GNU GRUB version 0.97 (638K lower / 3143616K upper memory) Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
CSR 1000v does not include a ROMMON mode, the similar functionality is handled in the GRUB command mode. You can also modify the configuration register setting from the Cisco IOS CLI by using the config-register command in global configuration mode.
Page 237
What to Do Next The following shows an example of entering GRUB mode and using the configuration register. You access the GRUB mode by entering the Cisco IOS XE config-register command and specifying the value as “0000”. Router(config)# config-register 0x0000 GNU GRUB version 0.97...
[isord @ 0x7e6d0000, 0x191f000 bytes] Changing the Configuration Register Settings You can change the configuration register settings from either the GRUB or the Cisco IOS XE CLI. This section describes how to modify the configuration register settings from the Cisco IOS XE CLI.
EXEC mode. The configuration register settings are displayed in the last line of the show version command output: Configuration register is 0x142 (will be 0x142 at next reload) Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Page 240
Accessing and Using GRUB Mode Displaying the Configuration Register Settings Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
XML-based automated parsing applications. Common uses of this feature may include direct paging of a network support engineer, email notification to a network operations center, XML delivery to a support website, and use of Cisco Smart Call Home services for direct case generation with the Cisco Systems Technical Assistance Center (TAC).
• Router must have IP connectivity to an email server or the destination HTTP(S) server. • If Cisco Smart Call Home is used, an active service contract covering the device is required to provide full SCH service.
Obtaining Smart Call Home Services Obtaining Smart Call Home Services If you have a service contract directly with Cisco, you can register for the Smart Call Home service. Smart Call Home analyzes Call Home messages and provides background information and recommendations. For critical issues, Automatic Service Requests are generated with the Cisco TAC.
To enable all Call Home basic configurations using a single command, perform the following steps: SUMMARY STEPS 1. configure terminal 2. call-home reporting {anonymous | contact-email-addr email-address} [http-proxy {ipv4-address | ipv6-address | name} port port-number] Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Internet. The implementation on the Cisco CSR 1000v supports the trustpool feature (embedded CA certificates in IOS images). The trustpool feature simplifies configuration to enable Smart Call Home service on configured devices.
Each router must include a contact email address (except if Call Home is enabled in anonymous mode). You can optionally include a phone number, street address, contract ID, customer ID, and site ID. To assign the contact information, perform the following steps: Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Page 247
Enter up to 200 characters. If you include spaces, you must enclose your entry in quotes (“”). Example: Router(cfg-call-home)# street-address “1234 Picaboo Street, Any city, Any state, 12345“ Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
155. Note If you use the Cisco Smart Call Home service, the destination profile must use the XML message format. You can configure the following attributes for a destination profile: • Profile name—String that uniquely identifies each user-defined destination profile. The profile name is limited to 31 characters and is not case-sensitive.
7. destination message-size-limit bytes 8. active 9. reporting {all | smart-call-home-data| smart-licensing-data } 10. end 11. show call-home profile {name | all} 12. show call-home smart-licensing 13. show call-home smart-licensing statistics Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Page 250
Step 9 reporting {all | smart-call-home-data| Configures the type of data to report for a profile. You can smart-licensing-data } select either to report Smart Call Home data or Smart Licensing Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
By default, the profile sends a full report of all types Note Example: of events subscribed in the profile. When anonymous-reporting-only is set, only crash, Router(cfg-call-home-profile)# inventory, and test messages are sent. anonymous-reporting-only Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
A Call Home alert is sent only to destination profiles that have subscribed to the alert group containing Note that Call Home alert. In addition, the alert group must be enabled. To subscribe a destination profile to one or more alert groups, perform the following steps: Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Page 254
{daily hh:mm | monthly date hh:mm | weekly day The Configuration alert group can be configured for periodic notification, as described in Periodic Notification, on page 244. hh:mm}] Example: Router(cfg-call-home-profile)# Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Page 255
Snapshot alert group subscribe-to-alert-group snapshot periodic daily 12:00 will be included in the snapshot message. Step 10 Exits configuration mode. Example: Router(cfg-call-home-profile)# end Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
(level 9, highest level of urgency) to debugging (level 0, lowest level of urgency). Other alert groups do not allow setting a threshold for severity. Call Home severity levels are not the same as system message logging severity levels. Note Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
• The mail-server priority number parameter can be configured from 1 to 100. The server with the highest priority (lowest priority number) is tried first. To configure general email options, perform the following steps: Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Page 259
Router(cfg-call-home)# sender from username@example.com Step 5 sender reply-to email-address (Optional) Assigns the email address that appears in the reply-to field in Call Home email messages. Example: Router(cfg-call-home)# sender reply-to username@example.com Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
To specify an HTTP proxy server for sending Call Home HTTP(S) messages to a destination, perform the following steps: SUMMARY STEPS 1. configure terminal 2. call-home 3. http-proxy {ipv4-address | ipv6-address | name} port port-number Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
• normal—Scrubs all normal-level commands. Router(cfg-call-home)# data-privacy level high • high—Scrubs all normal-level commands plus the IP domain name and IP address commands. Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Note the following guidelines when manually sending a Call Home alert group message: • Only the snapshot, crash, configuration, and inventory alert groups can be sent manually. Syslog alert groups cannot be sent manually. Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Page 266
[profile name] Sends an inventory alert group message to one destination profile if specified or to all subscribed destination profiles. Example: Router# call-home send alert-group inventory profile profile1 Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Submitting Call Home Analysis and Report Requests You can use the call-home request command to submit information about your system to Cisco to receive helpful analysis and report information specific to your system. You can request a variety of reports, including security alerts, known bugs, best practices, and command references.
• {cli command | cli list}—Specifies the IOS command or list of IOS commands xml} | http (separated by ‘;’). It can be any run command, including commands for all {destination-email-address email}] modules. The commands must be contained in quotes (“”). [tac-service-request SR#] Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
(DS) files are formatted files that collate knowledge of diagnostic events and provide methods to troubleshoot them without a need to upgrade the Cisco software. The aim of DS is to deliver flexible intelligence that can detect and collect troubleshooting information that can be used to resolve known problems in customers networks.
DS files contain XML data to specify the event description, and these files include CLI commands or scripts to perform required actions. These files are digitally signed by Cisco or a third party to certify their integrity, reliability, and security.
DS file into a non-removable disk, such as bootflash or hard disk, so that DS files can be read after the device is reloaded. On the Cisco CSR 1000v, the DS file is stored in the bootflash:/call home directory. 4 The device continues sending periodic regular DS download requests to get the latest revision of DS and replace the older one in device.
The predefined CiscoTAC-1 profile is enabled as a DS profile by default and we recommend using it. If used, you only need to change the destination transport-method to the http setting. Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Page 273
Router(cfg-call-home)# mail-server 10.1.1.1 priority 4 any DS. Step 6 profile profile-name Configures a destination profile for Call Home and enters call-home profile configuration mode. Example: Router(cfg-call-home)# profile user1 Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
(DS) files are formatted files that collate knowledge of diagnostic events and provide methods to troubleshoot them without a need to upgrade the Cisco software. The aim of DS is to deliver flexible intelligence that can detect and collect troubleshooting information that can be used to resolve known problems in customers networks.
ID: X123456789 site ID: SantaClara source ip address: Not yet set up source interface: GigabitEthernet1 Mail-server[1]: Address: 192.168.2.1 Priority: 1 Mail-server[2]: Address: 209.165.254.254 Priority: 2 http proxy: 192.168.1.1:80 aaa-authorization: disable Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Page 277
Email address(es): noc@example.com HTTP address(es): Not yet set up Alert-group Severity ------------------------ ------------ configuration normal crash normal inventory normal Syslog-Pattern Severity ------------------------ ------------ .*CALL_LOOP.* debug Profile Name: CiscoTAC-1 Profile status: INACTIVE Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Page 278
Periodic configuration info message is scheduled every 14 day of the month at 11:12 Periodic inventory info message is scheduled every 14 day of the month at 10:57 Alert-group Severity ------------------------ ------------ crash normal Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Page 279
Send-CLI Total Failed Config Crash Inventory Snapshot SysLog Test Request Send-CLI Total Ratelimit -dropped Config Crash Inventory Snapshot SysLog Test Request Send-CLI Last call-home message sent time: 2011-09-26 23:26:50 GMT-08:00 Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Alert Groups, Events, and Actions , on page 269 lists the trigger events included in each alert group, including the severity level of each event and the executed commands for the alert group. Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Page 281
| include MAC, show license all , show platform, show platform hardware qfp active infrastructure chipset 0 capabilities, show platform software vnic-if interface-mapping, show version. Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Message name Name of message. Specific event names For short text message only are listed in Alert Group Trigger Events and Commands, on page 268. Message type Specifically “Call Home”. CallHome/Event/Type Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Page 283
Optional user-configurable field used for CallHome/CustomerData/ContractData/ContractId contract information or other ID by any support service. Site ID Optional user-configurable field used for CallHome/CustomerData/ContractData/SiteId Cisco-supplied site ID or other data meaningful to alternate support service. Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Page 284
C a l l H o m e / D e v i c e / C i s c o _ C h a s s i s / A d d i t i o n a l I n f o r m a t i o n / A D @ n a m e = “ s y s D e s c r ” element. Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
For more information on deploying the OVA template, see Deploying the Cisco CSR 1000v OVA to the VM, on page Table 39: Cisco CSR 1000v OVA Template Bootstrap Properties Required for REST API Support (Cisco IOS XE Release 3.12S and Later) Property Description Management Interface Designates the management interface for the Cisco CSR 1000v.
Page 288
“192.168.2.0 255.255.255.0”) that the management gateway should route to. If a default route (0.0.0.0/0) is desired, this may be left blank. Table 40: Cisco CSR 1000v OVA Template Bootstrap Properties Required for REST API Support (Cisco IOS XE Release 3.11S and Later) Property Description Management Interface Designates the management interface for the Cisco CSR 1000v.
Enabling REST API Support Using the Cisco IOS XE CLI Introduction to REST API Configuration Options You need to configure the management interface to support REST API using the Cisco IOS XE CLI if you installed the Cisco CSR 1000v in either of the following ways: •...
Page 290
Enters remote-management configuration mode. Example: router(config)# remote-management Step 4 restful-api Enables support for the REST API. Example: router(cfg-remote-mgmt)# restful-api Step 5 Exits remote-management configuration mode and enters configuration mode. Example: router(cfg-remote-mgmt)# end Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Configures the IP address for the management interface. Example: Router(config-if)# ip address 172.25.29.235 255.255.255.128 Step 5 no shutdown Enables the management interface. Example: Router(config-if)# no shutdown Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Page 292
1 Step 10 activate Activates the csr_mgmt virtual services container. Example: router(config-virt-serv)# activate Step 11 Exits virtual services configuration mode and enters global configuration mode. Example: router(config-virt-serv)# end Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Router# configure terminal Step 3 interface GigabitEthernetx Enters interface configuration mode for the interface designated by x. Example: The range of GigabitEthernet ports depends on the platform. Router(config)# interface gigabitethernet1 Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Page 294
Step 12 Creates a vNIC gateway interface for the virtual services vnic gateway virtualportgroup virtualportgroup_number container and maps it to the virtual port group. Example: router(config-virt-serv)# vnic gateway virtualportgroup 0 Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
172.25.29.236 255.255.255.255 VirtualPortGroup0 Configuring the REST API Local Port and AutoSave Options Beginning with Cisco IOS XE 3.13S, you can configure the REST API local port and autosave options. SUMMARY STEPS 1. remote-management 2. restful-api local-port local-port-number 3.
The REST API requires HTTPS server support. Beginning with Cisco IOS XE Release 3.11S, HTTPS server support is enabled by default and no additional configuration is required. However, if using Cisco IOS XE Release 3.10S, you must manually configure HTTPS support for the REST API in the following situations: •...
Disabling REST API Support Beginning with Cisco IOS XE Release 3.11S, and including IOS XE Denali 16.3.1 and later, you can disable REST API support on the remote management interface. To enable REST API support, see Enabling REST API Support, on page 277.
Page 298
What to Do Next Note When REST API support is disabled using the no restful-api command, the REST API PUT, POST and DELETE operations are disabled. However, the GET operation is still available. Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Type Name Alias --------------------------------------------- Serial/Trace serial3 Serial/Syslog serial2 Serial/aux serial1 Serial/shell serial0 Disk /opt/var Disk _rootfs dp_2_0 net2 ieobc_2 ieobc Network interfaces MAC address Attached to interface ------------------------------------------------------ 00:1E:BD:DE:F8:BA VirtualPortGroup0 Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
Page 300
Guest routes Address/Mask Next Hop Intf. ------------------------------------------------------------------------------- 0.0.0.0/0 172.25.223.137 eth1 Resource admission (without profile) : passed Disk space : 540MB Memory : 512MB : 30% system CPU VCPUs : Not specified Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide...
The Cisco Prime Network Services Controller is unsupported using Cisco IOS XE Denali 16.3.1 or later, on the Cisco CSR 1000v. (Cisco IOS XE Denali 16.3 or earlier) You can use the Cisco Prime Network Services Controller to provision, manage and monitor the Cisco CSR 1000v. This procedure configures the Cisco CSR 1000v management interface to support remote management using the Cisco Prime Network Services Controller.
Configuring Support for Remote Management by the Cisco Prime Network Services Controller Configuring the Management Interface to Support Remote Management by the Cisco Prime Network Services Controller SUMMARY STEPS 1. enable 2. configure terminal 3. interface mgmt-interface 4. ip address mgmt-ipv4-addr subnet-mask 5.
Page 303
Configuring Support for Remote Management by the Cisco Prime Network Services Controller Configuring the Management Interface to Support Remote Management by the Cisco Prime Network Services Controller Command or Action Purpose Step 5 no shutdown Enables the management interface. Example:...
Network Services Controller CPA must be activated on the Cisco CSR 1000v before Cisco Prime Network Services Controller can be used to remotely manage the router. You must use the Cisco IOS XE CLI to manually activate the Cisco Prime Network Services Controller CPA in the following situations:...
Page 305
Configuring Support for Remote Management by the Cisco Prime Network Services Controller Enabling Remote Management by the Cisco Prime Network Services Controller Host • If you did not enable Cisco Prime Network Services Controller support through bootstrap when you deployed the OVA.
Page 306
******* What to Do Next Once remote management by Cisco Prime Network Services Controller is enabled, the following warning is displayed when entering the Cisco IOS XE CLI mode directly on the router: WARNING: This device is managed by Prime Network Services Controller. RESTful API is read only.
Configuring Support for Remote Management by the Cisco Prime Network Services Controller Disabling Remote Management by the Cisco Prime Network Services Controller Host Disabling Remote Management by the Cisco Prime Network Services Controller Host SUMMARY STEPS 1. enable 2. configure terminal 3.
Page 308
Configuring Support for Remote Management by the Cisco Prime Network Services Controller Disabling Remote Management by the Cisco Prime Network Services Controller Host Command or Action Purpose Step 6 show remote-management status Displays the Cisco CSR 1000v remote management settings.
Troubleshooting VM Performance Issues, page 298 Verifying the Cisco CSR 1000v Hardware and VM Requirements To help troubleshoot issues with the Cisco CSR 1000v, make sure that the router is installed on supported hardware and that the VM requirements are being met: •...
• If a given VM does not have enough memory to support the Cisco CSR 1000v, increase the size of the VM’s memory. Insufficient memory on the VM or the host can cause the Cisco CSR 1000v console to hang and be non-responsive.
Because the license is not mapped to a Cisco hardware device, additional steps may be necessary for rehosting the license. If you plan to voluntarily rehost the Cisco CSR 1000v to a new VM and the router is operating properly, you can use the self-service rehosting process on the Cisco Software Licensing Tool.
Page 312
Specify the Source License. Select the license with the original node-locked UDI for your system. See the "Source Rehost License" figure below . If you changed the virtual UDI on the Cisco CSR 1000v using the request license new-udi command, the Note original node-locked UDI is invalidated on the router.
Obtaining a Rehost License if the System Fails There may be cases when the Cisco CSR 1000v is not accessible due to a system failure and you need to rehost the existing licenses to a replacement device. Examples of a system failure may include: •...
Page 314
4 If you changed the virtual UDI on the Cisco CSR 1000v using the request license new-udi command and the VM is lost due to a system failure, the installed licenses will be destroyed. You must contact Cisco for assistance.