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.
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.
CONTENTS Preface Objectives v Document Revision History Organization vi vii Related Documentation viii Document Conventions viii Obtaining Documentation and Submitting a Service Request CHAPTER 1 Cisco CSR 1000V Series Cloud Services Router Overview ix 1-1 Introduction 1-1 Benefits of Virtualization Using the Cisco CSR 1000V Series Cloud Services Router Software Configuration and Management Using the Cisco IOS XE CLI 1-2 Router Interfaces 1-3 Virtual Machine Requirements 1-4 Virtual Machines
Contents Using the Software Release Notes CHAPTER 2 Using Cisco IOS XE Software Using Keyboard Shortcuts 1-22 2-1 2-1 Using the History Buffer to Recall Commands Understanding the Command Modes Getting Help 2-3 Finding Command Options 2-1 2-2 2-3 Using the no and default Forms of Commands Saving Configuration Changes 2-6 2-6 Managing Configuration Files 2-7 NVRAM File Security 2-8 Filtering the Output of show and more Commands Powering Off the Cisco CSR 1000V CHAPTER 3 Installation Overview
Contents CHAPTER 5 Installing the Cisco CSR 1000V in Citrix XenServer Environments 5-1 Citrix XenServer Support Information 5-1 Installation Requirements for Citrix XenServer 5-2 Manually Creating the Cisco CSR 1000V VM Using the .
Contents CHAPTER 9 Upgrading the Cisco IOS XE Software 9-1 Prerequisites for the Software Upgrade Process 9-1 Saving Backup Copies of Your Old System Image and Configuration 9-2 Using TFTP or Remote Copy Protocol to Copy the System Image into Boot Flash Memory Loading the New System Image 9-5 Loading the New System Image from the Cisco IOS XE Software Loading the New System Image from GRUB Mode 9-8 9-5 Saving Backup Copies of Your New System Image and Configuration 9-9 Rebooting the Cisco CSR 100
Contents Creating a New Destination Profile 12-9 Copying a Destination Profile 12-11 Setting Profiles to Anonymous Mode 12-12 Subscribing to Alert Groups 12-13 Periodic Notification 12-15 Message Severity Threshold 12-16 Configuring Snapshot Command List 12-17 Configuring General email Options 12-18 Example 12-20 Specifying Rate Limit for Sending Call Home Messages 12-20 Specifying HTTP Proxy Server 12-21 Enabling AAA Authorization to Run IOS Commands for Call Home Messages 12-22 Configuring Syslog Throttl
Contents CHAPTER 13 Managing Cisco CSR 1000V Licenses 13-1 Activating Cisco CSR 1000V Licenses 13-1 Managing Technology Package and Throughput Licenses 13-1 License Upgrade and Downgrade Scenarios 13-2 Changing the Technology Package License Boot Level (Cisco IOS XE Release 3.10S and Later) Managing the Throughput Level Licenses 13-3 Changing the Maximum Throughput Level 13-4 License-Based Restriction on Aggregate Bandwidth 13-6 Managing Memory Upgrade Licenses (Cisco IOS XE Release 3.
Preface This preface describes the objectives and organization of this document and explains how to find additional information on related products and services.
Preface 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 Cisco IOS XE Release 3.9S April 1, 2013 Cisco IOS XE Release 3.10S Cisco IOS XE Release 3.11S Cisco IOS XE Release 3.
Preface Organization Chapter Title Description Chapter 1 “Cisco CSR 1000V Series Cloud Services Router Overview” Provides an overview of the Cisco CSR 1000V Series Cloud Services Router. 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 installation options.
Preface Related Documentation This section refers you to other documentation that also might be useful as you configure your Cisco CSR 1000V router. The documentation listed below is available online.
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 Examples of information displayed on the screen are set in Courier font. bold screen Examples of text that you must enter are set in Courier bold font.
Preface Cisco CSR 1000V Series Cloud Services Router Software Configuration Guide x OL-27477-07
CH A P T E R 1 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 Introduction The Cisco CSR 1000V Series Cloud Services Router provides a cloud-based router that is deployed on a virtual machi
Chapter 1 Cisco CSR 1000V Series Cloud Services Router Overview Introduction 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.
Chapter 1 Cisco CSR 1000V Series Cloud Services Router Overview Virtual Machine Requirements 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. Note • Use remote SSH/Telnet to access the Cisco IOS XE CLI commands.
Chapter 1 Cisco CSR 1000V Series Cloud Services Router Overview 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.
Chapter 1 Cisco CSR 1000V Series Cloud Services Router Overview Virtual Machine Requirements Table 1-1 Support Matrix for Hypervisor Versions 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 3.11S 3.12S 5.0 5.1 5.0 5.1 5.5 6.02 6.1 • Linux KVM based on Not supported Red Hat Enterprise Linux 6.31 • Red Hat Enterprise Virtualization 3.
Chapter 1 Cisco CSR 1000V Series Cloud Services Router Overview Virtual Machine Requirements Table 1-2 Cisco CSR 1000V vNIC Support Cisco IOS XE Release: 3.9S 3.10S, 3.11S 3.12S NIC Types Supported VMXNET3 VMXNET3 VMXNET3 Max. number of vNICs per VM instance 10 10 10 vNIC Hot Add/Remove Support No Yes Yes Single Root I/O virtualization (SR-IOV) Support — — No NIC Types Supported — VIF VIF Max.
Chapter 1 Cisco CSR 1000V Series Cloud Services Router Overview Virtual Machine Requirements 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.
Chapter 1 Cisco CSR 1000V Series Cloud Services Router Overview 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.
Chapter 1 Cisco CSR 1000V Series Cloud Services Router Overview Cisco CSR 1000V Series Software License 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.
Chapter 1 Cisco CSR 1000V Series Cloud Services Router Overview Cisco CSR 1000V Series Software License Overview Table 1-4 Cisco CSR 1000V Software License Types (continued) Cisco CSR 1000V Version License Type Cisco IOS XE Release 3.12S All of the licenses supported in Cisco IOS XE Release 3.
Chapter 1 Cisco CSR 1000V Series Cloud Services Router Overview Cisco CSR 1000V Series Software License 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.
Chapter 1 Cisco CSR 1000V Series Cloud Services Router Overview Cisco CSR 1000V Series Architecture Differences from Hardware Platforms 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.
Chapter 1 Cisco CSR 1000V Series Cloud Services Router Overview Supported Cisco IOS XE Technologies 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.
Chapter 1 Cisco CSR 1000V Series Cloud Services Router Overview 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 Minimum Cisco IOS XE Release Required for Technology Package Cisco CSR 1000V Licenses Supported Cisco IOS XE Release 3.9S Generic Routing Cisco IOS XE Encapsulation Release 3.9S (GRE) LISP Cisco IOS XE Release 3.
Chapter 1 Cisco CSR 1000V Series Cloud Services Router Overview Supported Cisco IOS XE Technologies Table 1-6 Cisco IOS XE Technologies Supported on the Cisco CSR 1000V Cloud Services Router Technologies Supported • Performance Routing Minimum Cisco IOS XE Release Required for Technology Package Cisco CSR 1000V Licenses Supported Cisco IOS XE Release 3.
Chapter 1 Cisco CSR 1000V Series Cloud Services Router Overview Supported Cisco IOS XE Technologies Table 1-6 Technologies Supported Cisco IOS XE Technologies Supported on the Cisco CSR 1000V Cloud Services Router Minimum Cisco IOS XE Release Required for Technology Package Cisco CSR 1000V Licenses Supported See the Following Documentation: VPN: • • • • • • IPsec VPN DMVPN Easy VPN FlexVPN GETVPN SSL VPN Cisco IOS XE Release 3.9S • Advanced • Premium Cisco IOS XE Release 3.
Chapter 1 Cisco CSR 1000V Series Cloud Services Router Overview Supported Cisco IOS XE Technologies Table 1-6 Cisco IOS XE Technologies Supported on the Cisco CSR 1000V Cloud Services Router Technologies Supported • VPLS Minimum Cisco IOS XE Release Required for Technology Package Cisco CSR 1000V Licenses Supported Cisco IOS XE Release 3.
Chapter 1 Cisco CSR 1000V Series Cloud Services Router Overview Supported Cisco IOS XE Technologies Table 1-6 Cisco IOS XE Technologies Supported on the Cisco CSR 1000V Cloud Services Router Technologies Supported Minimum Cisco IOS XE Release Required for Technology Package Cisco CSR 1000V Licenses Supported See the Following Documentation: Access Control: • • • • • • • AAA Access Control Lists IP SLA RADIUS TACACS+ Layer3 Firewall Zone-Based Firewall Cisco IOS XE Release 3.
Chapter 1 Cisco CSR 1000V Series Cloud Services Router Overview Supported Cisco IOS XE Technologies Table 1-6 Cisco IOS XE Technologies Supported on the Cisco CSR 1000V Cloud Services Router Technologies Supported Minimum Cisco IOS XE Release Required for Technology Package Cisco CSR 1000V Licenses Supported See the Following Documentation: Application Services: • • Application Visibility and Control (AVC) NBAR Cisco IOS XE Release 3.9S Cisco IOS XE Release 3.
Chapter 1 Cisco CSR 1000V Series Cloud Services Router Overview Management Support Management Support The Cisco CSR 1000V supports the following management options: • Managing the Router Using Cisco Configuration Professional • Managing the Router Using the Cisco CSR 1000V REST API • Managing the Router Using Cisco Prime Network Services Controller Managing the Router Using Cisco Configuration Professional Beginning with Cisco IOS XE Release 3.
Chapter 1 Cisco CSR 1000V Series Cloud Services Router Overview Management Support For more information about configuring the Cisco CSR 1000V to enable remote management using Cisco Prime Network Services Controller, see the “Configuring Support for Remote Management by the Cisco Prime Network Services Controller” section on page 15-1.
Chapter 1 Cisco CSR 1000V Series Cloud Services Router Overview Finding Support Information for Platforms and Cisco Software Images Table 1-8 Cisco CSR 1000V Compatibility with Cisco UCS Servers Cisco IOS XE Release 3.9S/3.10S/3.11S/3.
Chapter 1 Cisco CSR 1000V Series Cloud Services Router Overview Finding Support Information for Platforms and Cisco Software Images Using the Software Release Notes Cisco IOS XE software release notes provide the following information: • Platform support • Memory recommendations • New features • Open and resolved severity 1 and 2 caveats Release notes are intended to be release-specific for the most current release, and the information provided in these documents may not be cumulative in providing
Chapter 1 Cisco CSR 1000V Series Cloud Services Router Overview Finding Support Information for Platforms and Cisco Software Images Cisco CSR 1000V Series Cloud Services Router Software Configuration Guide 1-24 OL-27477-07
CH A P T E R 2 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. Using Keyboard Shortcuts Commands are not case sensitive. You can abbreviate commands and parameters if the abbreviations contain enough letters to be different from any other currently available commands or parameters.
Chapter 2 Using Cisco IOS XE Software Understanding the Command Modes Table 2-2 History Substitution Commands Command Purpose Ctrl-P or the Up Arrow key Recall commands in the history buffer, beginning with the most recent command. Repeat the key sequence to recall successively older commands. Ctrl-N or the Down Arrow key Return to more recent commands in the history buffer after recalling commands with Ctrl-P or the Up Arrow key.
Chapter 2 Using Cisco IOS XE Software Getting Help Table 2-3 Accessing and Exiting Command Modes (continued) Command Mode Access Method Prompt Exit Method Global configuration From privileged EXEC mode, use the configure terminal privileged EXEC command. Router(config)# To return to privileged EXEC mode from global configuration mode, use the exit or end command. Interface configuration From global configuration mode, specify an interface using an interface command.
Chapter 2 Using Cisco IOS XE Software Getting Help complete the command and that the arguments and keywords in the list preceding the symbol are optional. The symbol by itself indicates that no more arguments or keywords are available and that you must press Enter to complete the command. Table 2-5 shows examples of how you can use the question mark (?) to assist you in entering commands.
Chapter 2 Using Cisco IOS XE Software Getting Help Table 2-5 Finding Command Options (continued) Command Comment Router(config-if)# ? Interface configuration commands: . . .
Chapter 2 Using Cisco IOS XE Software Using the no and default Forms of Commands Table 2-5 Finding Command Options (continued) Command Comment Router(config-if)# ip address 172.16.0.1 ? A.B.C.D IP subnet mask Router(config-if)# ip address 172.16.0.1 Enter the keyword or argument that you want to use. This example uses the 172.16.0.1 IP address. Enter ? to display what you must enter next on the command line. In this example, you must enter an IP subnet mask.
Chapter 2 Using Cisco IOS XE Software Managing Configuration Files It might take a minute or two to save the configuration. After the configuration has been saved, the following output appears: [OK] Router# This task saves the configuration to NVRAM. Managing Configuration Files On the Cisco CSR 1000V, the startup configuration file is stored in the NVRAM partition.
Chapter 2 Using Cisco IOS XE Software Filtering the Output of show and more Commands NVRAM File Security The Cisco CSR 1000V encrypts some of the disk partitions internal to the VM to provide extra security around sensitive data that may be stored on the router. 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 on.
CH A P T E R 3 Installation Overview • Introduction • Obtaining the Cisco CSR 1000V Software • Where to Go Next Introduction Cisco hardware routers are normally shipped with the Cisco IOS XE software pre-installed. Because the Cisco 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.
Chapter 3 Installation Overview Introduction Figure 3-1 Cisco CSR 1000V Installation Task Workflow Download Cisco CSR 1000V Software from Cisco.com Install Cisco CSR 1000V on VM using .ova File Deploy OVA Template to Create VM Use BDEO Tool to Deploy OVA Install Cisco CSR 1000V on VM using .
Chapter 3 Installation Overview Obtaining the Cisco CSR 1000V Software Obtaining the Cisco CSR 1000V Software Step 1 Go to the product page for Cisco Routers at http://www.cisco.com/en/US/partner/products/hw/routers/index.html Step 2 Navigate to the Cisco CSR 1000V Cloud Services Router product page. Step 3 Click the “Download Software” link. Step 4 Select the Cisco IOS XE release package and click Download Now or Add to Cart. Follow the instructions for downloading the software.
Chapter 3 Installation Overview Obtaining the Cisco CSR 1000V Software • Manually configure the VM using the .iso file. Uses the .iso file. You can install the .iso file on your host and manually create the VM using your hypervisor software. For example, if you are installing the Cisco CSR 1000V on VMware, you would install the .iso file on the VMware ESXi host, and manually create the VM using the vSphere GUI. See the following sections: – Manually Creating the Cisco CSR 1000V VM Using the .
Chapter 3 Installation Overview Where to Go Next • Note The Cisco IOS XE CLI can be accessed either through the virtual console or on a serial port console. 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. For more information, see the “Booting the Cisco CSR 1000V and Accessing the Console” section on page 8-1. Some hypervisors may not support serial console access.
Chapter 3 Installation Overview Where to Go Next Cisco CSR 1000V Series Cloud Services Router Software Configuration Guide 3-6 OL-27477-07
CH A P T E R 4 Installing the Cisco CSR 1000V in VMware ESXi Environments • VMware ESXi Support Information • Installation Requirements for VMware ESXi • Deploying the Cisco CSR 1000V OVA Template to the VM • Manually Creating the VM and Installing the Cisco CSR 1000V Software Using the .iso File (VMware ESXi) VMware ESXi Support Information The Cisco CSR 1000V runs on the VMware ESXi hypervisor. You can use the same VMware vSphere hypervisor to run several VMs.
Chapter 4 Installing the Cisco CSR 1000V in VMware ESXi Environments VMware ESXi Support Information Table 4-1 VMware Virtual Machine Requirements Cisco CSR 1000V Version Supported Tools and Requirements Cisco IOS XE Release 3.9S PC running the following: • Supported vSwitch VMware standard switch VMware vSphere Client 5.0 VMware distributed switch Server running the following:1 • VMware ESXi 5.0 Installation Tool: • Cisco IOS XE Release 3.10S and 3.
Chapter 4 Installing the Cisco CSR 1000V in VMware ESXi Environments VMware ESXi Support Information Table 4-2 VMware Requirements for Cisco CSR 1000V Cisco CSR 1000V Release Cisco IOS XE Release 3.9S VM Configuration Requirements • VMware ESXi 5.0 • Single hard disk Note Cisco IOS XE Release 3.10S Multiple hard disk drives on a VM are not supported. • 8 GB virtual disk • 4 virtual CPUs • 4 GB of RAM • 3 or more virtual network interface cards • VMware ESXi 5.0 or 5.
Chapter 4 Installing the Cisco CSR 1000V in VMware ESXi Environments VMware ESXi Support Information Table 4-2 VMware Requirements for Cisco CSR 1000V Cisco CSR 1000V Release Cisco IOS XE Release 3.11S VM Configuration Requirements • VMware ESXi 5.0 or 5.1 • Single hard disk Note Multiple hard disk drives on a VM are not supported. • 8 GB virtual disk • The following virtual CPU configurations are supported: – 1 virtual CPU, requiring 2.5 GB minimum of RAM – 2 virtual CPUs, requiring 2.
Chapter 4 Installing the Cisco CSR 1000V in VMware ESXi Environments VMware ESXi Support Information • Suspend See the following table for more information. Table 4-3 Supported VMware Features and Operations: General Features (for vCenter Server Only) Supported Entities First Supported Cisco CSR 1000V Release Description Cloning Cisco IOS XE Release Enables cloning a virtual machine or template, or cloning a 3.9S1 virtual machine to a template.
Chapter 4 Installing the Cisco CSR 1000V in VMware ESXi Environments VMware ESXi Support Information Table 4-4 Supported VMware Features and Operations: Operations (for Both vCenter Server and vSphere Client) Supported Entities First Supported Cisco CSR 1000V Release Description OVF Creation Cisco IOS XE Release An OVF package captures the state of a virtual machine into 3.9S a self-contained package. The disk files are stored in a compressed, sparse format.
Chapter 4 Installing the Cisco CSR 1000V in VMware ESXi Environments VMware ESXi Support Information Table 4-5 Supported VMware Features and Operations: Networking Features (continued) Supported Entities NIC Teaming First Supported Cisco CSR 1000V Release Description Cisco IOS XE Release From both vCenter Server and vSphere Client. Allows you 3.9S to set up an environment where each virtual switch connects to two uplink adapters that form a NIC team.
Chapter 4 Installing the Cisco CSR 1000V in VMware ESXi Environments VMware ESXi Support Information Table 4-6 Supported VMware Features and Operations: High Availability (continued) First Supported Cisco CSR 1000V Release Supported Entities Description Host-Level High Availability Cisco IOS XE Release To monitor physical servers, an agent on each server 3.
Chapter 4 Installing the Cisco CSR 1000V in VMware ESXi Environments Installation Requirements for VMware ESXi Installation Requirements for VMware ESXi Before starting your installation of the Cisco CSR 1000V, you must first set up your VMware environment, including the necessary host and client software. For example, if you are installing the Cisco CSR 1000V in a VMware ESXi environment, you must first install the vSphere Client. Table 4-8 lists the installation requirements for VMware ESXi.
Chapter 4 Installing the Cisco CSR 1000V in VMware ESXi Environments Deploying the Cisco CSR 1000V OVA Template to the VM 1. The required vCPU configuration depends on the throughput license and technology package installed. For more information, see the data sheet for your release. 2. Not automatically supported when deploying the OVA. If configuring Cisco Network Based Application Recognition (NBAR), or Cisco Application Visibility and Control (AVC), a 4-GB RAM allocation is required. 3.
Chapter 4 Installing the Cisco CSR 1000V in VMware ESXi Environments Deploying the Cisco CSR 1000V OVA Template to the VM Perform the following steps in VMware vSphere Client: Step 1 Log in to the VMware vSphere Client. Step 2 From the vSphere Client Menu Bar, choose File > Deploy OVF Template. Step 3 In the OVA Wizard, point the source to the Cisco CSR 1000V OVA to be deployed. Click Next. The OVF Template Details displays, showing information about the OVA file. Click Next.
Chapter 4 Installing the Cisco CSR 1000V in VMware ESXi Environments Deploying the Cisco CSR 1000V OVA Template to the VM Table 4-9 OVA Bootstrap Properties for Cisco IOS XE Release 3.9S and 3.10S Property Description Bootstrap Properties Login Username Sets the login username for the router. Login Password Sets the login password for the router. Management IPv4 Address/Mask Sets the management gateway address/mask in IPv4 format for the GigabitEthernet0 management interface.
Chapter 4 Installing the Cisco CSR 1000V in VMware ESXi Environments Deploying the Cisco CSR 1000V OVA Template to the VM Table 4-10 OVA Bootstrap Properties for Cisco IOS XE Release 3.11S and Later (continued) Property Description Management vLAN Configures the dot1Q VLAN interface. Requires the management interface to be configured using the GigabitEthernetx.xxx format. Management Interface IPv4 Address/Mask Configures the IPv4 address and subnet mask for the management interface.
Chapter 4 Installing the Cisco CSR 1000V in VMware ESXi Environments Deploying the Cisco CSR 1000V OVA Template to the VM Table 4-10 OVA Bootstrap Properties for Cisco IOS XE Release 3.11S and Later (continued) Property Description Enable SSH Login (Cisco IOS XE Release 3.11S) Enables remote login using SSH and disables remote login via Telnet. Requires that the login username and password are set. Enable SSH Login and Disable Telnet Login (Cisco IOS XE Release 3.
Chapter 4 Installing the Cisco CSR 1000V in VMware ESXi Environments Deploying the Cisco CSR 1000V OVA Template to the VM The following restrictions apply to the BDEO tool: • You can deploy the .ova file directly onto an ESXi host. The BDEO tool is not supported for Citrix XenServer, KVM, or Microsoft Hyper-V environments. • Beginning with Cisco IOS XE Release 3.12S, the CSR 1000V OVA provides the option to select multiple user-selectable hardware configuration profiles.
Chapter 4 Installing the Cisco CSR 1000V in VMware ESXi Environments Deploying the Cisco CSR 1000V OVA Template to the VM Table 4-11 BDEO Command-Line Bootstrap Properties (continued) Command Name Parameters Description -m | -memory MB Enters the amount of memory to provision on the VM. The Cisco CSR 1000V requires 4096 MB. -ds | -disksize Not supported. -ns | -nics nics Enters the number of Ethernet NICs to provision. The Cisco CSR 1000V requires a minimum of three vNICs.
Chapter 4 Installing the Cisco CSR 1000V in VMware ESXi Environments Deploying the Cisco CSR 1000V OVA Template to the VM Table 4-11 BDEO Command-Line Bootstrap Properties (continued) Command Name Parameters -po | -poweron Description Enters the instruction to automatically power-on the VM. Note Cisco recommends you do not set the VM to automatically power-on because you need to manually edit the new VM settings for the serial console before powering up the VM on the vSphere Client.
Chapter 4 Installing the Cisco CSR 1000V in VMware ESXi Environments Deploying the Cisco CSR 1000V OVA Template to the VM If the VM was manually created from the .iso file, then the vSphere GUI will not provide options to set basic router properties. However, you can still set custom properties as described in the “Adding Custom Properties for the Cisco CSR 1000V” section on page 4-19.
Chapter 4 Installing the Cisco CSR 1000V in VMware ESXi Environments Deploying the Cisco CSR 1000V OVA Template to the VM Figure 4-2 Cisco CSR 1000V Advanced Property Configuration Screen See Table 4-9 and Table 4-10 for the basic Cisco CSR 1000V properties that can be edited in the vSphere vApps GUI. Step 4 Select the property to be edited and click Edit. Step 5 Once you have edited the property, click OK to close.
Chapter 4 Installing the Cisco CSR 1000V in VMware ESXi Environments Deploying the Cisco CSR 1000V OVA Template to the VM Figure 4-3 Step 5 Enter the information to create the new custom property based on a Cisco IOS XE CLI command: Note Step 6 Edit Property Settings Window Before adding a custom property, make sure that the Cisco IOS XE command that it is based on is supported on the Cisco CSR 1000V in your release. a. (Optional) Enter the label. This is a descriptive string for the property.
Chapter 4 Installing the Cisco CSR 1000V in VMware ESXi Environments Manually Creating the VM and Installing the Cisco CSR 1000V Software Using the .iso File (VMware ESXi) Figure 4-4 Example of Custom Property Added Step 7 Click OK. Step 8 Reboot the Cisco CSR 1000V. The router must reboot in order for the new or edited properties to take effect. Manually Creating the VM and Installing the Cisco CSR 1000V Software Using the .
Chapter 4 Installing the Cisco CSR 1000V in VMware ESXi Environments Manually Creating the VM and Installing the Cisco CSR 1000V Software Using the .iso File (VMware ESXi) Figure 4-5 Task Overview for Manually Creating the Cisco CSR 1000V VM Install the Cisco CSR 1000V .iso file on a local or remote server Manually create the VM Configure VM name Select .
Chapter 4 Installing the Cisco CSR 1000V in VMware ESXi Environments Manually Creating the VM and Installing the Cisco CSR 1000V Software Using the .iso File (VMware ESXi) Manually Creating the Cisco CSR 1000V VM Using the .iso File (VMware ESXi) The following steps are performed using VMware VSphere.
Chapter 4 Installing the Cisco CSR 1000V in VMware ESXi Environments Manually Creating the VM and Installing the Cisco CSR 1000V Software Using the .iso File (VMware ESXi) d. Click Next. Note (Cisco IOS XE Release 3.10S and earlier) The first vNIC added is mapped to the GigabitiEthernet0 management interface on the Cisco CSR 1000V. All remaining vNICs are mapped to the Cisco CSR 1000V network interfaces when the VM is powered on and the router boots for the first time.
Chapter 4 Installing the Cisco CSR 1000V in VMware ESXi Environments Increasing Performance on VMWare ESXi Configurations 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 the “Booting the Cisco CSR 1000V and Accessing the Console” section on page 8-1.
Chapter 4 Installing the Cisco CSR 1000V in VMware ESXi Environments Increasing Performance on VMWare ESXi Configurations Cisco CSR 1000V Series Cloud Services Router Software Configuration Guide 4-26 OL-27477-07
CH A P T E R 5 Installing the Cisco CSR 1000V in Citrix XenServer Environments • Citrix XenServer Support Information • Installation Requirements for Citrix XenServer • Manually Creating the Cisco CSR 1000V VM Using the .iso File (Citrix XenServer) Citrix XenServer Support Information The Cisco CSR 1000V installation on Citrix XenServer requires the manual creation of a VM and installation using the .iso file.
Chapter 5 Installing the Cisco CSR 1000V in Citrix XenServer Environments Installation Requirements for Citrix XenServer For more information, see the “Installation Requirements for Citrix XenServer” section on page 5-2. For more information, see also the Citrix XenServer documentation. Installation Requirements for Citrix XenServer Table 5-1 lists the installation requirements for Citrix XenServer. For installation procedures, see the “Manually Creating the Cisco CSR 1000V VM Using the .
Chapter 5 Installing the Cisco CSR 1000V in Citrix XenServer Environments Manually Creating the Cisco CSR 1000V VM Using the .iso File (Citrix XenServer) Manually Creating the Cisco CSR 1000V VM Using the .iso File (Citrix XenServer) 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 Citrix XenServer environment and setup.
Chapter 5 Installing the Cisco CSR 1000V in Citrix XenServer Environments See Table 5-1 on page 5-2 for the supported number of vNICs for your release. Note Step 10 a. Select a network and click Add Network. b. Select External and click Next. c. Type in the network name. Click Next. d. Select the NIC to use, the VLAN, and set the MTU value. (Cisco IOS XE 3.10S Release and earlier) The network added to NIC0 maps to the Gigabit Ethernet 0 management interface on the Cisco CSR 1000V. Click Finish.
CH A P T E R 6 Installing the Cisco CSR 1000V in KVM Environments • Kernel Virtual Machine Support Information • Installation Requirements for KVM • Manually Creating the Cisco CSR 1000V VM Using the .iso File (KVM) • Creating the Cisco CSR 1000V KVM Instance on OpenStack Using the .
Chapter 6 Installing the Cisco CSR 1000V in KVM Environments Installation Requirements for KVM Installation Requirements for KVM Table 6-1 lists the installation requirements for KVM environments. For installation procedures, see the “Manually Creating the Cisco CSR 1000V VM Using the .iso File (KVM)” section on page 6-3. Table 6-1 KVM Requirements KVM versions supported Installation Requirements for KVM Environments Cisco IOS XE Release 3.10S Cisco IOS XE Release Cisco IOS XE Release 3.11S 3.
Chapter 6 Installing the Cisco CSR 1000V in KVM Environments Manually Creating the Cisco CSR 1000V VM Using the .iso File (KVM) 2. Requires QEMU-x86_64 version 1.0 (qemu-kvm-1.0), Copyright (c) 2003-2008 Fabrice Bellard 3. The required vCPU configuration depends on the throughput license and technology package installed. See the data sheet for your release for more information. 4. Applies only to creating the VM using the .iso file. If using the .
Chapter 6 Installing the Cisco CSR 1000V in KVM Environments Manually Creating the Cisco CSR 1000V VM Using the .iso File (KVM) Step 9 Enter the memory and CPU settings. See Table 6-1 on page 6-2 for the memory requirements and supported number of CPUs for your release. Click Forward. Step 10 On the next screen, select the checkbox to enable storage for the VM. Step 11 Choose the method for storing the VM: • Create a disk image on the computer’s hard drive. Select the memory allocation.
Chapter 6 Installing the Cisco CSR 1000V in KVM Environments Creating the Cisco CSR 1000V KVM Instance on OpenStack Using the .qcow2 File Step 19 Step 20 To create additional vNICs before installing the VM, click the Add Hardware button. All vNICs must be the Virtio Disk device type. Note You can add more vNICs after the VM is installed and the Cisco CSR 1000V has booted. You do not need to power down the VM or the router to add vNICs.
Chapter 6 Installing the Cisco CSR 1000V in KVM Environments Creating the Cisco CSR 1000V KVM Instance on OpenStack Using the .qcow2 File /usr/bin/kvm -S -M pc-1.0 -enable -kvm -m 2560 -smp 1,sockets=4,cores=1,threads=1 -nographic -nodefconfig -nodefaults -no-shutdown -boot order=c,menu=on -device lsi,id=scsi0,bus=pci.0,addr=0x6 -drive file=csr.qcow2,if=none,id=drive-ide0-0-0,format=qcow2 -serial telnet: 127.0.0.1:3548,server,nowait See Table 6-1 on page 6-2 for the installation requirements.
Chapter 6 Installing the Cisco CSR 1000V in KVM Environments Creating the Cisco CSR 1000V KVM Instance on OpenStack Using the .qcow2 File The --config-drive option can be used to specify that the configuration is loaded on the Cisco CSR 1000V when it comes up. Set the --config-drive option to “true” and specify the configuration file name. The configuration file can either use the “ovf-env.xml” file using the OVF format, or the “iosxe_config.
Chapter 6 Installing the Cisco CSR 1000V in KVM Environments Increasing Performance on KVM Configurations Specify the image, the flavor, and the appropriate network interfaces to be attached to the instance. Select the System Panel > Instances tab. The instance should show up on the list of instances shown on the screen, and you should be able to access the console by clicking on the instance name. Step 7 To launch the instance, select the instance and select Launch Instance. Click the Details tab.
Chapter 6 Installing the Cisco CSR 1000V in KVM Environments Increasing Performance on KVM Configurations Note • When configuring CPU pinning, carefully consider the CPU topology of the host server. If using a Cisco CSR 1000V configured with multiple cores, do not configure CPU pinning across multiple sockets. Enabling the vhost-net Driver To improve performance in KVM environments, Cisco recommends that you enable the LINUX vhost-net driver.
Chapter 6 Installing the Cisco CSR 1000V in KVM Environments Increasing Performance on KVM Configurations Cisco CSR 1000V Series Cloud Services Router Software Configuration Guide 6-10 OL-27477-07
CH A P T E R 7 Installing the Cisco CSR 1000V in Microsoft Hyper-V Environments • Microsoft Hyper-V Support Information • Installation Requirements for Microsoft Hyper-V • Manually Creating the Cisco CSR 1000V VM Using the .iso File (Microsoft Hyper-V) Microsoft Hyper-V Support Information Beginning with Cisco IOS XE Release 3.12S, the Cisco CSR 1000V supports installation on the Microsoft Hyper-V hypervisor using Windows Server 2012 R2.
Chapter 7 Installing the Cisco CSR 1000V in Microsoft Hyper-V Environments Installation Requirements for Microsoft Hyper-V Installation Requirements for Microsoft Hyper-V Table 7-1 lists the installation requirements for Microsoft HyperV. Table 7-1 Installation Requirements for Microsoft Hyper-V Microsoft Hyper-V Requirements Cisco IOS XE 3.
Chapter 7 Installing the Cisco CSR 1000V in Microsoft Hyper-V Environments Manually Creating the Cisco CSR 1000V VM Using the .iso File (Microsoft Hyper-V) Prerequisites 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. For more information, see Microsoft Windows Server 2012 R2 documentation.
Chapter 7 Manually Creating the Cisco CSR 1000V VM Using the .iso File (Microsoft Hyper-V) Step 3 Installing the Cisco CSR 1000V in Microsoft Hyper-V Environments Click Specify Name and Location. • Enter the name of the VM. • (Optional) Click the checkbox to store the VM in a different location. Click Next. Step 4 On the Assign Memory screen, enter the Startup Memory value. The Cisco CSR 1000V requires 4096 MB for the startup memory. Click Next.
Chapter 7 Installing the Cisco CSR 1000V in Microsoft Hyper-V Environments Manually Creating the Cisco CSR 1000V VM Using the .iso File (Microsoft Hyper-V) The Cisco CSR 1000V does not support the other disk type options. c. Specify the Name and Location for the virtual hard disk. Click Next. d. On the Configure Disk screen, click the option to create a new blank virtual hard disk. For the size, specify 8 GB. e. Click Next to view the Summary of the virtual hard disk settings. f.
Chapter 7 Manually Creating the Cisco CSR 1000V VM Using the .iso File (Microsoft Hyper-V) Installing the Cisco CSR 1000V in Microsoft Hyper-V Environments Launching the VM to Boot the Cisco CSR 1000V To launch the VM, perform the following steps: Step 1 Select the virtual switch. Step 2 Select the VM and click Start. The Hyper-V Manager connects to the VM, and starts the launch process. Once the VM is launched, the Cisco CSR 1000V starts the boot process.
CH A P T E R 8 Booting the Cisco CSR 1000V and Accessing the Console • Booting the Cisco CSR 1000V as the VM • Accessing the Cisco CSR 1000V Console Booting the Cisco CSR 1000V as the VM The Cisco CSR 1000V boots when the VM is powered on. Depending on your configuration, you can monitor the installation process on the VM console or the console on the virtual serial port.
Chapter 8 Booting the Cisco CSR 1000V and Accessing the Console Booting the Cisco CSR 1000V as the VM Note The option to select the console port during the boot process is available only the first time the Cisco CSR 1000V boots. To change the console port access after the Cisco CSR 1000V has first booted, see the “Changing the Console Port Access After Installation” section on page 8-6. The Cisco CSR 1000V starts the boot process.
Chapter 8 Booting the Cisco CSR 1000V and Accessing the Console Accessing the Cisco CSR 1000V Console – To enable the throughput level supported by your license, you must configure the platform hardware throughput level command. Once these settings are configured, you must reboot the router. For more information about managing technology and throughput licenses, see the “Managing Cisco CSR 1000V Licenses” section on page 13-1. • (VMware ESXi only) If you manually created the VM using the .
Chapter 8 Booting the Cisco CSR 1000V and Accessing the Console Accessing the Cisco CSR 1000V Console Creating Serial Console Access in VMware ESXi Perform the following steps using VMware VSphere. For more information, refer to the VMware VSphere documentation. Step 1 Power-down the VM. Step 2 Select the VM and configure the virtual serial port settings. a. Choose Edit Settings > Add. b. Choose Device Type > Serial port. Click Next. c. Choose Select Port Type.
Chapter 8 Booting the Cisco CSR 1000V and Accessing the Console Accessing the Cisco CSR 1000V Console Creating the Serial Console Access in KVM Perform the following steps using the KVM console on your server. For more information, refer to the KVM documentation. Step 1 Power off the VM. Step 2 Click on Add Hardware. Step 3 Select Serial to add a serial device. Step 4 Under Character Device, choose the TCP Net Console (tcp) device type from the drop-down menu.
Chapter 8 Booting the Cisco CSR 1000V and Accessing the Console Accessing the Cisco CSR 1000V Console Password: mypass Note Step 3 If no password has been configured, press Return. From user EXEC mode, enter the enable command as shown in the following example: Router> enable Step 4 At the password prompt, enter your system password.
Chapter 8 Booting the Cisco CSR 1000V and Accessing the Console Accessing the Cisco CSR 1000V Console Step 4 Command or Action Purpose end Exits configuration mode. Example: Router(config)# end Step 5 copy system:running-config nvram:startup-config Copies the running configuration to the NVRAM startup configuration. Example: Router# copy system:running-config nvram:startup-config Step 6 reload Reloads the operating system.
Chapter 8 Booting the Cisco CSR 1000V and Accessing the Console Accessing the Cisco CSR 1000V Console Cisco CSR 1000V Series Cloud Services Router Software Configuration Guide 8-8 OL-27477-07
CH A P T E R 9 Upgrading the Cisco IOS XE Software This chapter describes how to upgrade the Cisco IOS XE software image on the Cisco CSR 1000V Cloud Services Router.
Chapter 9 Upgrading the Cisco IOS XE Software Prerequisites for the Software Upgrade Process Be sure to complete the following prerequisites for upgrading the Cisco IOS XE version of the Cisco CSR 1000V software image: • Read the Cisco CSR 1000V Series Cloud Services Router Release Notes to verify the following: – Compatibility with the hypervisor vendor and version that you are using If you want to upgrade to a new hypervisor version not supported on your current Cisco CSR 1000V version, you need to u
Chapter 9 Upgrading the Cisco IOS XE Software Prerequisites for the Software Upgrade Process Step 3 Command or Action Purpose dir bootflash: Displays the layout and contents of a bootflash memory file system. bootflash: is aliased onto flash:. • Example: Learn the name of the system image file. Router# dir bootflash: Step 4 copy bootflash: {ftp: | rcp: | tftp:} Copies a file from bootflash memory to a server. • Copy the system image file to a server. This file can serve as a backup copy.
Chapter 9 Upgrading the Cisco IOS XE Software Using TFTP or Remote Copy Protocol to Copy the System Image into Boot Flash Memory Using TFTP or Remote Copy Protocol to Copy the System Image into Boot Flash Memory The following details the logistics of upgrading the system image: • Install a TFTP server or an RCP server application on a TCP/IP-ready workstation or PC. Many third-party vendors provide free TFTP server software, which you can find by searching for “TFTP server” in a web search engine.
Chapter 9 Upgrading the Cisco IOS XE Software Loading the New System Image Step 6 If an error message appears that says, “Not enough space on device,” do the following: • If you are certain that all the files in bootflash memory should be erased, enter y when prompted twice to confirm that bootflash memory will be erased before copying: Accessing tftp://10.10.10.2/csr1000v-universalk9.03.10.00.S.153-3.S-ext.SPA.bin...
Chapter 9 Upgrading the Cisco IOS XE Software Loading the New System Image Step 4 Note boot system bootflash:system-image-filename.bin If the new system image is the first file or the only file displayed in the dir bootflash: command output in Step 1, you do not need to perform this step. Use this command to load the new system image after the next system reload or power cycle. For example: Router(config)# boot system bootflash:csr1000v-universalk9.03.10.00.S.153-3.S-ext.SPA.
Chapter 9 Upgrading the Cisco IOS XE Software Loading the New System Image Note Step 12 The 0x2102 value is the default configuration register setting. If you didn’t change this setting from the default, this step is not required.
Chapter 9 Upgrading the Cisco IOS XE Software Loading the New System Image Loading the New System Image from GRUB Mode To load the new system image from the GNU GRand Unified Bootloader (GRUB) mode, follow these steps beginning in EXEC mode. Step 1 dir bootflash: Use this command to display a list of all files and directories in bootflash memory: Router# dir bootflash: Directory of bootflash:/ 3 1580 -rw-rw- 6458388 6462268 Mar 01 1993 00:00:58 csr1000v.
Chapter 9 Upgrading the Cisco IOS XE Software Saving Backup Copies of Your New System Image and Configuration grub> help [ Minimal BASH-like line editing is supported. For the first word, TAB lists possible command completions. Anywhere else TAB lists the possible completions of a device/filename. ESC at any time exits to menu. ] confreg [VALUE] help [--all] [PATTERN ...] grub> Step 6 At the grub> prompt, enter ESC to access the GRUB menu.
Chapter 9 Upgrading the Cisco IOS XE Software Saving Backup Copies of Your New System Image and Configuration Step 1 Command or Action Purpose enable Enables privileged EXEC mode. • Enter your password if prompted. Example: Router> enable Step 2 copy nvram:startup-config {ftp: | rcp: | tftp:} Example: Copies the startup configuration file to a server. • The configuration file copy serves as a backup copy. • Enter the destination URL when prompted.
Chapter 9 Upgrading the Cisco IOS XE Software Rebooting the Cisco CSR 1000V Rebooting the Cisco CSR 1000V Once you have copied the new system image into bootflash memory, loaded the new system image and saved a backup copy of the new system image and configuration, you need to reboot the VM. The Cisco CSR 1000V reboots with the new system image and Cisco IOS XE software version installed. See your VM vendor documentation for more information.
Chapter 9 Upgrading the Cisco IOS XE Software Rebooting the Cisco CSR 1000V Cisco CSR 1000V Series Cloud Services Router Software Configuration Guide 9-12 OL-27477-07
CH A P T E R 10 Mapping Cisco CSR 1000V Network Interfaces to VM Network Interfaces • Mapping the Router Network Interfaces to Virtual Network Interface Cards • Mapping Cisco CSR 1000V Network Interfaces with vSwitch Interfaces Mapping the Router Network Interfaces to Virtual Network Interface Cards The Cisco CSR 1000V maps the GigabitEthernet network interfaces to the logical virtual network interface card (vNIC) name assigned by the VM.
Chapter 10 Mapping the Router Network Interfaces to Virtual Network Interface Cards Figure 10-1 Mapping Cisco CSR 1000V Network Interfaces to VM Network Interfaces vNICs Mapped to Cisco CSR 1000V Router Interfaces After the Cisco CSR 1000V boots, you need to display the mapping between the logical interface on the router with the vNIC and the vNIC MAC address using the show platform software vnic-if interface-mapping command.
Chapter 10 Mapping Cisco CSR 1000V Network Interfaces to VM Network Interfaces Mapping the Router Network Interfaces to Virtual Network Interface Cards Note 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. For example, the logical “eth1” vNIC name in the display may not necessarily map to “NIC1” as added in the VM installation process.
Chapter 10 Mapping the Router Network Interfaces to Virtual Network Interface Cards Mapping Cisco CSR 1000V Network Interfaces to VM Network Interfaces csr1000v# show platform software vnic-if interface-mapping -------------------------------------------------------------------------Interface Name Driver Name Mac Addr -------------------------------------------------------------------------GigabitEthernet3 vmxnet3 000c.2946.3f4d GigabitEthernet2 vmxnet3 0050.5689.0034 GigabitEthernet1 vmxnet3 0050.5689.
Chapter 10 Mapping Cisco CSR 1000V Network Interfaces to VM Network Interfaces Mapping Cisco CSR 1000V Network Interfaces with vSwitch Interfaces 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. Figure 10-2 shows an example where each Cisco CSR 1000V router interface is mapped to one host Ethernet interface.
Chapter 10 Mapping Cisco CSR 1000V Network Interfaces with vSwitch Interfaces Mapping Cisco CSR 1000V Network Interfaces to VM Network Interfaces Figure 10-3 shows an example with multiple Cisco CSR 1000V interfaces sharing one host ESXi Ethernet interface.
Chapter 10 Mapping Cisco CSR 1000V Network Interfaces to VM Network Interfaces Mapping Cisco CSR 1000V Network Interfaces with vSwitch Interfaces Figure 10-4 shows one Cisco CSR 1000V interfaces mapped directly to a trunk interface on the vSwitch.
Chapter 10 Mapping Cisco CSR 1000V Network Interfaces with vSwitch Interfaces Mapping Cisco CSR 1000V Network Interfaces to VM Network Interfaces Cisco CSR 1000V Series Cloud Services Router Software Configuration Guide 10-8 OL-27477-07
CH A P T E R 11 Accessing and Using GRUB Mode • About GRUB Mode and the Configuration Register • Accessing GRUB Mode • Using the GRUB Menu • Modifying the Configuration Register (confreg) • Changing the Configuration Register Settings • Displaying the Configuration Register Settings About GRUB Mode and the Configuration Register The Cisco CSR 1000V has a 16-bit configuration register in NVRAM.
Chapter 11 Accessing and Using GRUB Mode Accessing GRUB Mode Table 11-2 describes the boot field, which is the lowest four bits of the configuration register (bits 3, 2, 1, and 0). The boot field setting determines whether the router loads an operating system. Table 11-2 Boot Field Configuration Register Bit Descriptions Boot Field (Bits 3, 2, 1, and 0) 0000 (0x0) Meaning At the next power cycle or reload, the router boots to the GRUB (bootstrap program).
Chapter 11 Accessing and Using GRUB Mode Using the GRUB Menu The following shows an example of entering GRUB mode. Router(config)# config-register 0x0000 GNU GRUB version 0.97 (638K lower / 3143616K upper memory) [ Minimal BASH-like line editing is supported. For the first word, TAB lists possible command completions. Anywhere else TAB lists the possible completions of a device/filename. ESC at any time exits to menu. ] grub> help [ Minimal BASH-like line editing is supported.
Chapter 11 Accessing and Using GRUB Mode Modifying the Configuration Register (confreg) Note The modified configuration register value is automatically written into NVRAM, but the new value does not take effect until you reset or power-cycle the router. SUMMARY STEPS 1. confreg [value] DETAILED STEPS Step 1 Command or Action Purpose confreg [value] Changes the configuration register settings while in GRUB command mode.
Chapter 11 Accessing and Using GRUB Mode Modifying the Configuration Register (confreg) do you wish to change the configuration? y/n [n]: ignore system config info? y/n [n]: automatically boot default system image? y/n [n]: Configuration Register: 0x42 grub> confreg 0x2102 Configuration Register: 0x2102 grub> confreg Configuration Summary (Virtual Configuration Register: 0x2102) enabled are: boot: default image do you wish to change the configuration? y/n [n]: grub> grub> GNU GRUB version 0.
Chapter 11 Accessing and Using GRUB Mode Changing the Configuration Register Settings 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. To change the configuration register settings from the Cisco IOS XE CLI, complete the following steps: Step 1 Power on the router.
CH A P T E R 12 Configuring Call Home for the Cisco CSR 1000V • Prerequisites for Call Home • Information About Call Home • How to Configure Call Home • Displaying Call Home Configuration Information • Default Settings • Alert Group Trigger Events and Commands • Message Contents Prerequisites for Call Home The Call Home feature provides email-based and web-based notification of critical system events.
Chapter 12 Configuring Call Home for the Cisco CSR 1000V Information About Call Home • If Cisco Smart Call Home is used, an active service contract covering the device is required to provide full SCH service. Information About Call Home The Call Home feature can deliver alert messages containing information on configuration, inventory, syslog, snapshot, and crash events. It provides these alert messages as either email-based or web-based messages.
Chapter 12 Configuring Call Home for the Cisco CSR 1000V Information About Call Home 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.
Chapter 12 Configuring Call Home for the Cisco CSR 1000V How to Configure Call Home How to Configure Call Home The following section shows how you can configure Call Home using a single command: • Configuring Smart Call Home (Single Command) • Configuring and Enabling Smart Call Home The following sections show detailed or optional configurations: • Enabling and Disabling Call Home • Configuring Contact Information • Configuring Destination Profiles • Subscribing to Alert Groups • Configurin
Chapter 12 Configuring Call Home for the Cisco CSR 1000V How to Configure Call Home DETAILED STEPS Step 1 Command or Action Purpose configure terminal Enters global configuration mode. Example: Router# configure terminal Step 2 call-home reporting {anonymous | contact-email-addr email-address} [http-proxy {ipv4-address | ipv6-address | name} port port-number] Enables all Call Home basic configurations using a single command.
Chapter 12 Configuring Call Home for the Cisco CSR 1000V How to Configure Call Home Configuring and Enabling Smart Call Home For application and configuration information about the Cisco Smart Call Home service, see the Smart Call Home User Guide. See also the Cisco Support Community page for Smart Call Home. The user guide includes configuration examples for sending Smart Call Home messages directly from your device or through a transport gateway (TG) aggregation point.
Chapter 12 Configuring Call Home for the Cisco CSR 1000V How to Configure Call Home Configuring Contact Information 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: SUMMARY STEPS 1. configure terminal 2. call-home 3. contact-email-addr email-address 4. phone-number +phone-number 5.
Chapter 12 Configuring Call Home for the Cisco CSR 1000V How to Configure Call Home Step 6 Command or Action Purpose customer-id text (Optional) Identifies customer ID. Enter up to 64 characters. If you include spaces, you must enclose your entry in quotes (“”). Example: Router(cfg-call-home)# customer-id Customer1234 Step 7 site-id text (Optional) Identifies customer site ID. Enter up to 200 characters. If you include spaces, you must enclose your entry in quotes (“”).
Chapter 12 Configuring Call Home for the Cisco CSR 1000V How to Configure Call Home – For the predefined CiscoTAC-1 profile, you can enable either transport mechanism, but not both. • Destination address—The actual address related to the transport method by which the alert should be sent. In this version of the Call Home feature, you can change the destination of the CiscoTAC-1 profile. • Message formatting—The message format used for sending the alert.
Chapter 12 Configuring Call Home for the Cisco CSR 1000V How to Configure Call Home DETAILED STEPS Step 1 Command or Action Purpose configure terminal Enters global configuration mode. Example: Router# configure terminal Step 2 call-home Enters the Call Home configuration submode. Example: Router(config)# call-home Step 3 profile name Example: Enters the Call Home destination profile configuration submode for the specified destination profile.
Chapter 12 Configuring Call Home for the Cisco CSR 1000V How to Configure Call Home Step 9 Command or Action Purpose end Returns to privileged EXEC mode. Example: Router(cfg-call-home-profile)# end Step 10 show call-home profile {name | all} Displays the destination profile configuration for the specified profile or all configured profiles.
Chapter 12 Configuring Call Home for the Cisco CSR 1000V How to Configure Call Home Setting Profiles to Anonymous Mode To set an anonymous profile, perform the following steps: SUMMARY STEPS 1. configure terminal 2. call-home 3. profile name 4. anonymous-reporting-only DETAILED STEPS Step 1 Command or Action Purpose configure terminal Enters global configuration mode. Example: Router# configure terminal Step 2 call-home Enters Call Home configuration submode.
Chapter 12 Configuring Call Home for the Cisco CSR 1000V How to Configure Call Home Subscribing to Alert Groups An alert group is a predefined subset of Call Home alerts supported in all routers. Different types of Call Home alerts are grouped into different alert groups depending on their type.
Chapter 12 Configuring Call Home for the Cisco CSR 1000V How to Configure Call Home DETAILED STEPS Step 1 Command or Action Purpose configure terminal Enters global configuration mode. Example: Router# configure terminal Step 2 call-home Enters Call Home configuration submode. Example: Router(config)# call-home Step 3 alert-group {all | configuration | environment | inventory | syslog | crash | snapshot} Enables the specified alert group. Use the keyword all to enable all alert groups.
Chapter 12 Configuring Call Home for the Cisco CSR 1000V How to Configure Call Home Step 8 Command or Action Purpose subscribe-to-alert-group crash Subscribes to the Crash alert group in user profile. By default, the CiscoTAC-1 profile subscribes to the Crash alert group and cannot be unsubscribed.
Chapter 12 Configuring Call Home for the Cisco CSR 1000V How to Configure Call Home Message Severity Threshold When you subscribe a destination profile to the Syslog alert group, you can set a threshold for the sending of alert group messages based on the level of severity of the message. Any message with a value lower than the destination profile specified threshold is not sent to the destination.
Chapter 12 Configuring Call Home for the Cisco CSR 1000V How to Configure Call Home Configuring Snapshot Command List To configure the snapshot command list, perform the following steps: SUMMARY STEPS 1. configure terminal 2. call-home 3. [no | default] alert-group-config snapshot 4. [no | default] add-command command string 5. end DETAILED STEPS Step 1 Command or Action Purpose configure terminal Enters global configuration mode.
Chapter 12 Configuring Call Home for the Cisco CSR 1000V How to Configure Call Home Configuring General email Options To use the email message transport, you must configure at least one Simple Mail Transfer Protocol (SMTP) email server address. You can configure the from and reply-to email addresses, and you can specify up to four backup email servers.
Chapter 12 Configuring Call Home for the Cisco CSR 1000V How to Configure Call Home Step 4 Command or Action Purpose sender from email-address (Optional) Assigns the email address that appears in the from field in Call Home email messages. If no address is specified, the contact email address is used. Example: Router(cfg-call-home)# sender from username@example.
Chapter 12 Configuring Call Home for the Cisco CSR 1000V How to Configure Call Home Example The following example shows the configuration of general email parameters, including a primary and secondary email server: Router# configure terminal Enter configuration commands, one per line. End with CNTL/Z. Router(config)# call-home Router(cfg-call-home)# mail-server smtp.example.com priority 1 Router(cfg-call-home)# mail-server 192.168.0.1 priority 2 Router(cfg-call-home)# sender from username@example.
Chapter 12 Configuring Call Home for the Cisco CSR 1000V How to Configure Call Home Specifying HTTP Proxy Server 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 DETAILED STEPS Step 1 Command or Action Purpose configure terminal Enters global configuration mode.
Chapter 12 Configuring Call Home for the Cisco CSR 1000V How to Configure Call Home Enabling AAA Authorization to Run IOS Commands for Call Home Messages To enable AAA authorization to run IOS commands that enable the collection of output for a Call Home message, perform the following steps: SUMMARY STEPS 1. configure terminal 2. call-home 3. aaa-authorization 4.
Chapter 12 Configuring Call Home for the Cisco CSR 1000V How to Configure Call Home Configuring Syslog Throttling To enable or disable Call Home syslog message throttling and avoid sending repetitive Call Home syslog messages, perform the following steps: SUMMARY STEPS 1. configure terminal 2. call-home 3. [no] syslog-throttling DETAILED STEPS Step 1 Command or Action Purpose configure terminal Enters configuration mode.
Chapter 12 Configuring Call Home for the Cisco CSR 1000V How to Configure Call Home Configuring Call Home Data Privacy The data-privacy command scrubs data, such as IP addresses, from running configuration files to protect the privacy of customers. Enabling the data-privacy command can affect CPU utilization when scrubbing a large amount of data. Currently, show command output is not being scrubbed except for configuration messages in the show running-config all and show startup-config data.
Chapter 12 Configuring Call Home for the Cisco CSR 1000V How to Configure Call Home Sending Call Home Communications Manually You can manually send several types of Call Home communications. To send Call Home communications, perform the tasks in this section.
Chapter 12 Configuring Call Home for the Cisco CSR 1000V How to Configure Call Home Sending Call Home Alert Group Messages Manually You can use the call-home send command to manually send a specific alert group message. 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.
Chapter 12 Configuring Call Home for the Cisco CSR 1000V How to Configure Call Home 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.
Chapter 12 Configuring Call Home for the Cisco CSR 1000V How to Configure Call Home Example The following example shows a request for analysis of a user-specified show command: Router# call-home request output-analysis “show diag” profile TG Manually Sending Command Output Message for One Command or a Command List You can use the call-home send command to execute an IOS command or a list of IOS commands and send the command output through HTTP or email protocol.
Chapter 12 Configuring Call Home for the Cisco CSR 1000V How to Configure Call Home DETAILED STEPS Step 1 Command or Action Purpose call-home send {cli command | cli list} [email email msg-format {long-text | xml} | http {destination-email-address email}] [tac-service-request SR#] Executes the CLI or CLI list and sends output via email or HTTP. • {cli command | cli list}—Specifies the IOS command or list of IOS commands (separated by ‘;’).
Chapter 12 Configuring Call Home for the Cisco CSR 1000V Configuring Diagnostic Signatures The following example shows the command output sent in XML message format to the Cisco TAC backend server, with the SR number specified: Router# call-home send “show version; show run” http tac-service-request 123456 The following example shows the command output sent to the Cisco TAC backend server through the HTTP protocol and forwarded to a user-specified email address: Router# call-home send “show version; sho
Chapter 12 Configuring Call Home for the Cisco CSR 1000V Configuring Diagnostic Signatures Diagnostic Signatures Overview Diagnostic signatures (DS) for the Call Home system provides a flexible framework that allows the defining of new events and corresponding CLIs that can analyze these events without upgrading the Cisco software. DSs provide the ability to define more types of events and trigger types than the standard Call Home feature supports.
Chapter 12 Configuring Call Home for the Cisco CSR 1000V Configuring Diagnostic Signatures include a field to notify device to start its periodic DS download/update. In a DS update request message, the status and revision number of the DS is included such that only a DS with the latest revision number is downloaded. Forced-download downloads a specific DS or a set of DSes. You can trigger the forced-download update request only by initiating an on-demand CLI.
Chapter 12 Configuring Call Home for the Cisco CSR 1000V Configuring Diagnostic Signatures Other than using EEM to detect events, a DS is triggered when a Tool Command Language (Tcl) script is used to specify event detection types. Multiple Event Detection Multiple event detection involves defining two or more event detectors, two ore more corresponding tracked object states, and a time period for the events to occur.
Chapter 12 Configuring Call Home for the Cisco CSR 1000V Configuring Diagnostic Signatures • Syslog event variable: values assigned during a syslog event detection in the DS file. This variable is valid only for syslog event detection.
Chapter 12 Configuring Call Home for the Cisco CSR 1000V Configuring Diagnostic Signatures DETAILED STEPS Step 1 Command or Action Purpose configure terminal Enters global configuration mode. Example: Router# configure terminal Step 2 service call-home Enables Call Home service on a device. Example: Router(config)# service call-home Step 3 call-home Enters call-home configuration mode for the configuration of Call Home settings.
Chapter 12 Configuring Call Home for the Cisco CSR 1000V Configuring Diagnostic Signatures Command or Action Step 9 Purpose subscribe-to-alert-group inventory [periodic {daily Configures a destination profile to send messages for the hh:mm | monthly day hh:mm | weekly day hh:mm}] Inventory alert group for Call Home. • Example: This command is used only for the periodic downloading of DS files.
Chapter 12 Configuring Call Home for the Cisco CSR 1000V Configuring Diagnostic Signatures Step 3 Command or Action Purpose profile ds-profile-name Specifies the destination profile on a device that DS uses. Example: Router(cfg-call-home-diag-sign)# profile user1 Step 4 environment ds_env-var-name ds-env-var-value Sets the environment variable value for DS on a device.
Chapter 12 Configuring Call Home for the Cisco CSR 1000V Displaying Call Home Configuration Information The following is sample output from the show call-home diagnostic-signature command for the configuration displayed above: Router# show call-home diagnostic-signature Current diagnostic-signature settings: Diagnostic-signature: enabled Profile: user1 (status: ACTIVE) Environment variable: ds_env1: abc Downloaded DSes: DS ID DS Name -------- ------------------------------6015 CronInterval 6030 ActCH 603
Chapter 12 Configuring Call Home for the Cisco CSR 1000V Displaying Call Home Configuration Information Step 4 Command or Action Purpose show call-home mail-server status Checks and displays the availability of the configured email server(s). Example: Router# show call-home mail-server status Step 5 show call-home profile {all | name} Displays the configuration of the specified destination profile. Use the all keyword to display the configuration of all destination profiles.
Chapter 12 Configuring Call Home for the Cisco CSR 1000V Displaying Call Home Configuration Information Keyword -----------------------configuration crash inventory snapshot syslog State ------Enable Enable Enable Enable Enable Description ------------------------------configuration info crash and traceback info inventory info snapshot info syslog info Profiles: Profile Name: campus-noc Profile Name: CiscoTAC-1 Example 2 Call Home Information in Detail Router# show call-home detail Current call hom
Chapter 12 Configuring Call Home for the Cisco CSR 1000V Displaying Call Home Configuration Information Alert-group -----------------------configuration crash inventory Severity -----------normal normal normal Syslog-Pattern -----------------------.*CALL_LOOP.* Severity -----------debug Profile Name: CiscoTAC-1 Profile status: INACTIVE Profile mode: Full Reporting Preferred Message Format: xml Message Size Limit: 3145728 Bytes Transport Method: email Email address(es): callhome@cisco.
Chapter 12 Configuring Call Home for the Cisco CSR 1000V Displaying Call Home Configuration Information Alert-group -----------------------configuration crash inventory Severity -----------normal normal normal Syslog-Pattern -----------------------.*CALL_LOOP.* Severity -----------debug Profile Name: CiscoTAC-1 Profile status: INACTIVE Profile mode: Full Reporting Preferred Message Format: xml Message Size Limit: 3145728 Bytes Transport Method: email Email address(es): callhome@cisco.
Chapter 12 Configuring Call Home for the Cisco CSR 1000V Displaying Call Home Configuration Information Example 7 Call Home Statistics Router# show call-home statistics Message Types Total -------------------------------Total Success 3 Config 3 Crash 0 Inventory 0 Snapshot 0 SysLog 0 Test 0 Request 0 Send-CLI 0 Email -------------------3 3 0 0 0 0 0 0 0 HTTP -----------------0 0 0 0 0 0 0 0 0 Total In-Queue Config Crash Inventory Snapshot SysLog Test Request Send-CLI 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
Chapter 12 Configuring Call Home for the Cisco CSR 1000V Default Settings Default Settings Table 12-2 lists the default Call Home settings.
Chapter 12 Configuring Call Home for the Cisco CSR 1000V Message Contents Table 12-3 Call Home Alert Groups, Events, and Actions (continued) Alert Group Call Home Trigger Event Syslog Event Severity Description and Commands Executed Configuration — — — User-generated request for configuration or configuration change event. Commands executed: show platform show running-config all show startup-config show version Inventory — — — User-generated request for inventory event.
Chapter 12 Configuring Call Home for the Cisco CSR 1000V Message Contents Table 12-5 Common Fields for All Long Text and XML Messages Data Item Description (Plain Text and XML) (Plain Text and XML) Call-Home Message Tag (XML Only) Time stamp CallHome/EventTime Date and time stamp of event in ISO time notation: YYYY-MM-DD HH:MM:SS GMT+HH:MM. Message name Name of message. Specific event names are listed in the “Alert Group Trigger Events and Commands” section on page 12-44.
Chapter 12 Configuring Call Home for the Cisco CSR 1000V Message Contents Table 12-5 Common Fields for All Long Text and XML Messages (continued) Data Item Description (Plain Text and XML) (Plain Text and XML) Call-Home Message Tag (XML Only) Message description Short text describing the error. CallHome/MessageDescription Device name Node that experienced the event. This is the host name of the CallHome/CustomerData/ device.
Chapter 12 Configuring Call Home for the Cisco CSR 1000V Message Contents Table 12-6 Inserted Fields Specific to a Particular Alert Group Message Data Item Description (Plain Text and XML) (Plain Text and XML) Call-Home Message Tag (XML Only) The following fields may be repeated if multiple commands are executed for this alert group. Command output name Exact name of the issued command. /aml/Attachments/Attachment/Name Attachment type Attachment type. Usually “inline”.
Chapter 12 Configuring Call Home for the Cisco CSR 1000V Message Contents CSR1000V@C@9S1NMSF22DW qiang-vm weijuhua@cisco.
Chapter 12 Configuring Call Home for the Cisco CSR 1000V Message Contents Cisco CSR 1000V Series Cloud Services Router Software Configuration Guide 12-50 OL-27477-07
CH A P T E R 13 Managing Cisco CSR 1000V Licenses • Activating Cisco CSR 1000V Licenses • Managing Technology Package and Throughput Licenses Activating Cisco CSR 1000V Licenses When the Cisco CSR 1000V first boots, the router boots in evaluation mode. The network interfaces are activated but throughput is limited to 2.5 Mbps and the feature support is limited. You need to activate the software licenses to obtain the throughput and feature support provided by the license.
Chapter 13 Managing Cisco CSR 1000V Licenses Managing Technology Package and Throughput Licenses License Upgrade and Downgrade Scenarios The Cisco CSR 1000V licenses are based on both technology packages and maximum supported throughput levels. Depending on the licenses installed, different upgrades and downgrades are possible. • If you want to change the technology package, you must install a new license.
Chapter 13 Managing Cisco CSR 1000V Licenses Managing Technology Package and Throughput Licenses SUMMARY STEPS 1. enable 2. configure terminal 3. license boot level {standard | advanced | premium} DETAILED STEPS Step 1 Command or Action Purpose enable Enables privileged EXEC mode. • Enter your password if prompted. Example: Router> enable Step 2 configure terminal Enters global configuration mode.
Chapter 13 Managing Cisco CSR 1000V Licenses Managing Technology Package and Throughput Licenses • If you are using an evaluation license, the maximum throughput is initially limited to 2.5 Mbps. You must enter the platform hardware throughput level command to increase the maximum throughput to the supported level. When the 60-day evaluation license expires, the maximum throughput level reverts to 2.5 Mbps. Once activated, the evaluation license provides a default maximum throughput of 50 Mbps.
Chapter 13 Managing Cisco CSR 1000V Licenses Managing Technology Package and Throughput Licenses DETAILED STEPS Step 1 Command or Action Purpose enable Enables privileged EXEC mode. • Enter your password if prompted. Example: Router> enable Step 2 show platform hardware throughput level Displays the current maximum hardware throughput level. Example: Verify the current settings.
Chapter 13 Managing Cisco CSR 1000V Licenses Managing Technology Package and Throughput Licenses License-Based Restriction on Aggregate Bandwidth The Cisco CSR 1000V includes a license-based performance limiter that may restrict the aggregate bandwidth of the router’s interfaces. For example, if a 50 Mbps license is installed, then a maximum of 25 Mbps of bidirectional traffic is possible.
Chapter 13 Managing Cisco CSR 1000V Licenses Managing Technology Package and Throughput Licenses Total (pps) (bps) Output: Total (pps) (bps) Processing: Load (pct) Input: 59232 58757104 48839 50011264 33 59234 58757824 48835 50012072 34 59237 58760840 48833 50009312 34 59234 58757880 48833 498768736 34 In the example, the input rate shown in bold is close to 60 Mbps. The output rate shown in bold is close to 50 Mbps. In this case, the input rate exceeds 50 Mbps, the maximum license rate allowed.
Chapter 13 Managing Cisco CSR 1000V Licenses Managing Technology Package and Throughput Licenses 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. However, if the vUDI is not automatically updated, you must manually request a new vUDI on the cloned VM instance.
CH A P T E R 14 Configuring Support for Management Using the REST API • Introduction • Enabling REST API Support During Cisco CSR 1000V OVA Deployment • Enabling REST API Support Using the Cisco IOS XE CLI Introduction You can use the REST API to manage the Cisco CSR 1000V as an alternative to configuring and managing selected features on the router using the Cisco IOS XE CLI. This chapter describes how to configure the Cisco CSR 1000V to enable management using the REST API.
Chapter 14 Configuring Support for Management Using the REST API Enabling REST API Support During Cisco CSR 1000V OVA Deployment Table 14-1 Cisco CSR 1000V OVA Template Bootstrap Properties Required for REST API Support (Cisco IOS XE Release 3.10S) Property Description Management IPv4 Address/Mask Sets the management gateway address and mask in IPv4 format for the GigabitEthernet0 management interface.
Chapter 14 Configuring Support for Management Using the REST API Enabling REST API Support Using the Cisco IOS XE CLI Table 14-3 Cisco CSR 1000V OVA Template Bootstrap Properties Required for REST API Support (Cisco IOS XE Release 3.12S and Later) (continued) Property Description Management IPv4 Gateway (Cisco IOS XE Release 3.12S) Configures the IPv4 management default gateway address. If using DHCP, enter “dhcp” in the field. Management IPv4 Network (Cisco IOS XE Release 3.
Chapter 14 Configuring Support for Management Using the REST API Enabling REST API Support Using the Cisco IOS XE CLI 9. no shutdown 10. exit 11. virtual-service csr_mgmt 12. vnic gateway virtualportgroup virtual-port-group-number 13. guest ip address remote-mgmt-ipv4-addr 14. activate 15. ip route ip-address subnet-mask virtualportgroup virtual-port-group-number DETAILED STEPS Step 1 Command or Action Purpose enable Enables privileged EXEC mode. • Enter your password if prompted.
Chapter 14 Configuring Support for Management Using the REST API Enabling REST API Support Using the Cisco IOS XE CLI Step 8 Command or Action Purpose ip unnumbered management-interface Enables IP processing on an interface without assigning it an explicit IP address. Example: router(config-if)# ip unnumbered gigabitethernet1 Step 9 no shutdown Enables the virtual port group interface. Example: router(config-if)# no shutdown Step 10 exit Exits virtual port group interface mode.
Chapter 14 Configuring Support for Management Using the REST API Enabling REST API Support Using the Cisco IOS XE CLI Configuring HTTPS Support for the REST API Using the Cisco IOS XE CLI The Cisco CSR 1000V 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.
Chapter 14 Configuring Support for Management Using the REST API Enabling REST API Support Using the Cisco IOS XE CLI Step 5 Command or Action Purpose secure-server Enables the secure HTTPS server. Example: router(config)# secure-server Step 6 transport type persistent webui input transport-map-name Enables the transport map to support HTTPS. Example: router(config)# transport type persistent webui input https-webui Disabling REST API Support Beginning with Cisco IOS XE Release 3.
Chapter 14 Configuring Support for Management Using the REST API Enabling REST API Support Using the Cisco IOS XE CLI Step 4 Command or Action Purpose no restful-api Disables support for the REST API. Example: router(cfg-remote-mgmt)# no restful-api Step 5 end Exits remote-management configuration mode and enters configuration mode.
Chapter 14 Configuring Support for Management Using the REST API Enabling REST API Support Using the Cisco IOS XE CLI PNSC Enabled, UP Network stats: eth0: RX packets:38, TX eth1: RX packets:87, TX host: 172.25.223.233 port: 8443 socket: unix:/usr/local/cpa-fcgi.
Chapter 14 Configuring Support for Management Using the REST API Enabling REST API Support Using the Cisco IOS XE CLI Cisco CSR 1000V Series Cloud Services Router Software Configuration Guide 14-10 OL-27477-07
CH A P T E R 15 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 • Configuring Remote Management by Cisco Prime Network Services Controller Configuring the Management Interface to Support Remote Management by the Cisco Prime Network Services Controller You can use the Cisco Prime Network Services Controller to provision, manage and monitor the Cisco
Chapter 15 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 15. activate 16. end 17. ip route ip-address subnet-mask virtualportgroup virtual-port-group-number DETAILED STEPS Step 1 Command or Action Purpose enable Enables privileged EXEC mode. • Enter your password if prompted.
Chapter 15 Step 9 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 Command or Action Purpose no shutdown Enables the management interface. Example: Router(config-if)# no shutdown Step 10 exit Exits virtual port group interface mode.
Chapter 15 Configuring Support for Remote Management by the Cisco Prime Network Services Controller Configuring Remote Management by Cisco Prime Network Services Controller Configuring Remote Management by Cisco Prime Network Services Controller • Enabling Remote Management by the Cisco Prime Network Services Controller Host • Disabling Remote Management by the Cisco Prime Network Services Controller Host Enabling Remote Management by the Cisco Prime Network Services Controller Host The Cisco Prime Net
Chapter 15 Configuring Support for Remote Management by the Cisco Prime Network Services Controller Configuring Remote Management by Cisco Prime Network Services Controller DETAILED STEPS Step 1 Command or Action Purpose enable Enables privileged EXEC mode. • Enter your password if prompted. Example: Router> enable Step 2 configure terminal Enters global configuration mode. Example: Router# configure terminal Step 3 remote-management Enters remote-management configuration mode.
Chapter 15 Configuring Support for Remote Management by the Cisco Prime Network Services Controller Configuring Remote Management by Cisco Prime Network Services Controller Step 5 Command or Action Purpose end Exits configuration mode and enters privileged EXEC mode. Example: Router(config-remote-mgmt)# end Step 6 show remote-management status Displays the Cisco CSR 1000V remote management settings.
Chapter 15 Configuring Support for Remote Management by the Cisco Prime Network Services Controller Configuring Remote Management by Cisco Prime Network Services Controller DETAILED STEPS Step 1 Command or Action Purpose enable Enables privileged EXEC mode. • Enter your password if prompted. Example: Router> enable Step 2 configure terminal Enters global configuration mode. Example: Router# configure terminal Step 3 remote-management Enters remote-management configuration mode.
Chapter 15 Configuring Support for Remote Management by the Cisco Prime Network Services Controller Configuring Remote Management by Cisco Prime Network Services Controller Cisco CSR 1000V Series Cloud Services Router Software Configuration Guide 15-8 OL-27477-07
CH A P T E R 16 Troubleshooting Cisco CSR 1000V VM Issues • Verifying the Cisco CSR 1000V Hardware and VM Requirements • Troubleshooting Network Connectivity Issues • Troubleshooting VM Performance Issues 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: • Verify that the server hardware is supported by the hypervisor vendor.
Chapter 16 Troubleshooting Cisco CSR 1000V VM Issues Troubleshooting Network Connectivity Issues Troubleshooting Network Connectivity Issues To troubleshoot network connectivity issues for the Cisco CSR 1000V, do the following: • Verify that there is an active and unexpired license installed on the VM. Enter the show license command. The License State should be shown as “Active, In Use”. • Verify that the vNIC for the VMs are connected to the correct physical NIC, or to the proper vSwitch.
A P P E N D I X A Rehosting the Cisco CSR 1000V License The process for rehosting a license on the Cisco CSR 1000V is different than for other Cisco platforms. Because the license is not mapped to a Cisco hardware device, additional steps may be necessary for rehosting the license.
Appendix A Rehosting the Cisco CSR 1000V License Voluntarily Rehosting the License to a New VM Figure A-1 Step 4 License to Initiate-Transfer Screen Specify the Source License. Select the license with the original node-locked UDI for your system. See Figure A-2. Note If you changed the virtual UDI on the Cisco CSR 1000V using the request license new-udi command, the original node-locked UDI is invalidated on the router.
Appendix A Rehosting the Cisco CSR 1000V License Voluntarily Rehosting the License to a New VM Step 5 Specify the Target and Options for the rehost license. See Figure A-3. Click Next. Note When specifying the Target rehost license, use the new vUDI. Figure A-3 Step 6 License Rehost Target and Options Review the license rehost information for accuracy. If the license information is valid, click Submit. See Figure A-4.
Appendix A Rehosting the Cisco CSR 1000V License Obtaining a Rehost License if the System Fails The license portal processes the license request. You will receive an email confirming the new rehost licenses. 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.
INDEX hypervisor limitations Symbols hypervisor support ? command 2-3 1-7 1-4 installing a KVM on OpenStack using qcow2 file 2-3 installing on Citrix XenServer using .iso installing on KVM using .iso 5-3 6-3, 6-5 installing on Microsoft Hyper-V using .iso A 7-3 installing on Red Hat Linux KVM using .iso aaa-authorization (call-home) command active (call-home) command add-command command installing on VMware using .
Index call-home service call-home 12-7, 12-9, 12-11 call-home diagnostic-signature call-home reporting call-home send show call-home profile 12-29 contact-email-addr (call-home) show remote-management status 12-7 context-sensitive help for abbreviating source-ip-address customer-id (call-home) 12-7 data-privacy (call-home) 12-24 syslog-throttling (call-home) virtual-service csr_mgmt 12-9, 12-35 vnic gateway 12-9 destination preferred-msg-format (call-home) destination transport-method (c
Index contact-email-addr (call-home) command contact-email-addr command hypervisor support 12-7 1-4 12-35 contract-id (call-home) command 12-7 copy profile (call-home) command 12-11 customer-id (call-home) command 12-7 I IDs serial IDs 12-46 installation D data-privacy (call-home) command installing a KVM on OpenStack using .qcow2 file 6-5 12-24 destination address (call-home) command on Citrix XenServer using .
Index requesting new virtual UDI throughput level prompts, system 13-8 2-2 13-3 Q M question mark (?) command mail-server (call-home) command 12-18, 12-35 management remote using Cisco Prime Network Services Controller 1-20 using REST API 2-3 1-20 R rate-limit (call-home) command release notes mapping router interfaces to vNICs 10-1 maximum throughput level, changing See platforms, supported 13-3 remote-management command Microsoft Hyper-V requesting a new virtual UDI installation requ
Index show license udi history command 13-8 U show platform hardware throughput level command 13-4, 13-5 upgrading the software show platform software vnic-if interface-mapping command 10-2 user EXEC mode, summary of show remote-management status command site-id (call-home) command using the GRUB menu 15-6 2-2 11-3 12-7 software activation V requesting a new vUDI 13-8 virtual-service csr_mgmt command software installation KVM on OpenStack using .qcow2 file on Citrix XenServer using .
Index Cisco CSR 1000V Series Cloud Services Router Software Configuration Guide IN-6 OL-27477-07
