Cisco CSR 1000v Series User Manual

•
csr1000v-universalk9.16.03.01a.qcow2
—choose an image such as this (for Cisco IOS XE Denali 16.3.1) to use a virtual console. This is
recommended for later use with the OpenStack dashboard.
•
csr1000v-universalk9.16.03.01a-serial.qcow2
—choose an image such as this (for Cisco IOS XE Denali 16.3.1) to use a serial console to access the
VM. This is useful in the lab or if you are using the Cisco Modeling Tool.
Creating the Instance Using the OpenStack Command Line Tool
Although the following procedure provides a general guideline for how to create the Cisco CSR 1000v tenant
instance, the exact steps that you need to perform may vary depending on the characteristics of your KVM
environment and setup. For more information, see the OpenStack documentation. See "Installation
Requirements" sections such as Installation Requirements for KVM—Cisco IOS XE Denali 16.3, on page
131 or Installation Requirements for KVM—Cisco IOS XE 3.x, on page 132 for the requirements to install
the Cisco CSR 1000v on a VM in a KVM environment.
The following steps are performed using the Nova (OpenStack Compute) console on your server.
Step 1
Download the .qcow2 file from the Cisco CSR 1000v software installation image package and copy it onto a local or
network device
Step 2
Create the Nova flavor using the nova flavor-createcommand
nova flavor-create <flavor_name> <flavor_id> <ram size MB> <disk size GB> <num_ vCPUs>
See Installation Requirements for KVM—Cisco IOS XE Denali 16.3, on page 131 for the installation requirements. 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:
nova flavor-create csr_flavor 6 4096 0 2
Step 3
Enter the nova flavor-list command to verify that the nova flavor created the previous step is available
Step 4
Use the glance command, to create the OpenStack image
glance image-create --name <image_name> --disk-format qcow2 --container-format bare --file <Location-of-img-file>
The following example creates an OpenStack image using the Cisco CSR 1000v installation file:
Example:
glance image-create --namecsr_image --disk-format qcow2 --container-format bare
--file /opt/stack/csr/files/images/csr1000v-universalk9.03.12.00.S.154-2.S-std.qcow2
Step 5
Use the nova boot command, to create the instance and boot
nova boot <instance_name> --image <image_id> --flavor <flavor_id> --nic net-id=<uuid> --config-drive=<true/false>
--file<configuration_file_name>
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 name of the configuration file in which you enter the router
configuration to be booted. There are two possible formats for the configuration file:
• “ovf-env.xml” (OVF format)
• “iosxe_config.txt”
Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide
123
Installing the Cisco CSR 1000v in KVM Environments
Creating the Instance Using the OpenStack Command Line Tool

Cisco CSR 1000v Series Specifications

General

Model	CSR 1000v Series
Category	Network Router
Virtualization	Yes
Form Factor	Virtual Appliance
Routing Protocols	BGP, OSPF, EIGRP, RIP, IS-IS
Minimum Memory	4 GB
Minimum vCPUs	1
Cloud Platforms	Microsoft Azure
Interfaces	Virtual Interfaces
Supported Protocols	IPv4, IPv6
VPN Protocols	IPSec, DMVPN
Security	IPS
High Availability	VRRP, HSRP, GLBP
Management	NETCONF, RESTCONF, SNMP
Management Interface	CLI

Summary

Cisco CSR 1000v Series Cloud Services Router Overview

Hypervisor Support

Cisco Software Licensing (CSL)

Summarizes Cisco Software Licensing (CSL) for CSR 1000v.

Installation Overview

Obtaining the Cisco CSR 1000v VM Image

Details the process for downloading the CSR 1000v VM image from Cisco.com.

Cisco CSR 1000v Installation Options

Installing the Cisco CSR 1000v in VMware ESXi Environments

VMware ESXi Support Information

Provides information about VMware tools and VM requirements for CSR 1000v.

VMware Requirements—Cisco IOS XE Everest 16.6

Deploying the Cisco CSR 1000v OVA to the VM using vSphere

Explains the steps to deploy the CSR 1000v OVA template using vSphere.

Manually Creating the VM and Installing the Cisco CSR 1000v Software Using the .iso File (VMware ESXi)

Guides for manually creating a VM and installing CSR 1000v software using an ISO file.

Installing the Cisco CSR 1000v in Citrix XenServer Environments

Citrix XenServer Support Information

Provides support information for Cisco CSR 1000v on Citrix XenServer.

Manually Creating the Cisco CSR 1000v VM Using the .iso File (Citrix XenServer)

Guides for manually creating a VM using an ISO file on Citrix XenServer.

Installing the Cisco CSR 1000v in KVM Environments

Kernel Virtual Machine Support Information

Details supported Linux/KVM environments including RHEL and Ubuntu.

Creating the Cisco CSR 1000v VM Using the Self-installing .Run Package

Guides VM creation using the self-installing .run package for KVM.

Creating the Cisco CSR 1000v VM Using virt-install—Using ISO Image

Details VM creation via ISO using virt-install command.

Installing the Cisco CSR 1000v in Microsoft Hyper-V Environments

Microsoft Hyper-V Support Information

Provides support information for Cisco CSR 1000v on Microsoft Hyper-V.

Manually Creating the Cisco CSR 1000v VM using the .iso File (Microsoft Hyper-V)

Installing Cisco CSR 1000v Licenses

Activating Cisco CSR 1000v Licenses

Guides the activation of software licenses for the CSR 1000v.

Installing CSL Regular Licenses for Cisco IOS XE 3.13S and Later

Activating Permanent License Reservation

Upgrading the Cisco IOS XE Software

Prerequisites for the Software Upgrade Process

Loading the New System Image from the Cisco IOS XE Software

Configuring Call Home for the Cisco CSR 1000v

Prerequisites for Call Home

How to Configure Call Home

Enabling Management by REST API

Introduction

Introduces managing the CSR 1000v using the REST API.

Enabling REST API Support During Cisco CSR 1000v OVA Deployment

Enabling REST API Support Using the Cisco IOS XE CLI

Troubleshooting Cisco CSR 1000v VM Issues

Verifying the Cisco CSR 1000v Hardware and VM Requirements

Checks hardware and VM requirements for troubleshooting CSR 1000v issues.

Troubleshooting Network Connectivity Issues

Troubleshooting VM Performance Issues

Rehosting the Cisco CSR 1000v License

Voluntarily Rehosting the License to a New VM

Explains the self-service process for rehosting a license to a new VM.

Obtaining a Rehost License if the System Fails

Guides on obtaining a rehost license after a system failure.