Cisco CSR 1000V Series Cloud Services Router Software Configuration Guide
Installing and Booting the Cisco CSR 1000V Software on the VM
Downloads: This chapterpdf (PDF - 489.0KB) The complete bookPDF (PDF - 3.29MB) | Feedback

Table Of Contents

Installing and Booting the Cisco CSR 1000V Software on the VM

Introduction

Installation Task Overview

Obtaining the Cisco CSR 1000V Software

Cisco CSR 1000V Installation Files

Cisco CSR 1000V Installation Options

ROMMON and the Cisco CSR 1000V

Installing the Cisco CSR 1000V

Prerequisites

Installation Requirements

Guidelines and Limitations

Deploying the Cisco CSR 1000V OVA Template to the VM

Deploying the OVA Template to the VM (VMware ESXi)

Installing the Cisco CSR 1000V Software Using the Cisco Build, Deploy, Execute OVF Tool

Provisioning the VM Using the BDEO Tool

Manually Creating the VM and Installing the Cisco CSR 1000V Software Using the .iso File

Overview of Tasks for Manually Creating the Cisco CSR 1000V VM

Manually Creating the Cisco CSR 1000V VM Using the .iso File (VMware ESXi)

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

Manually Creating the Cisco CSR 1000V VM Using the .iso File (KVM)

Booting the Cisco CSR 1000V as the VM


Installing and Booting the Cisco CSR 1000V Software on the VM


Introduction

Installing the Cisco CSR 1000V

Booting the Cisco CSR 1000V as the VM

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. However, as part of the initial installation process, you must first provision the attributes of the VM so that the Cisco CSR 1000V software can install and boot.


Note This document does not provide procedures for deploying the Cisco CSR 1000V in an Amazon Web Services environment. See the Cisco CSR 1000V Series Cloud Services Router Deployment Guide for Amazon Web Services for more information.


Installation Task Overview

Obtaining the Cisco CSR 1000V Software

Cisco CSR 1000V Installation Files

Cisco CSR 1000V Installation Options

ROMMON and the Cisco CSR 1000V

Installation Task Overview

Figure 3-1 shows the high-level tasks required to install the Cisco CSR 1000V on the VM. The different installation options are dependent on the hypervisor being used. See the following sections for more information.

Figure 3-1 Cisco CSR 1000V Installation Task Overview

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.


Cisco CSR 1000V Installation Files

The following file types are included in the Cisco CSR 1000V software image package.

.ova

Used for deploying the OVA template on the VM (zipped package)

.iso

Used for installing the software image on the VM (requires manually creating the VM)

.bin

Used for upgrading and downgrading the software only. For more information, see the "Upgrading the Cisco IOS XE Software" section.

Cisco CSR 1000V Installation Options

The Cisco CSR 1000V supports the following installation options:

Deploy the OVA template on the VM.

Uses the .ova file. This template creates a VM using recommended preset values. See the "Deploying the Cisco CSR 1000V OVA Template to the VM" section.

The .ova file can only be used for first-time installation. It cannot be used for upgrading the Cisco IOS XE software version.

Deploy the .ova file on the VM using the Cisco Build, Deploy, Execute OVF (BDEO) configurator.

Uses the BDEO application included in your file package. Using the BDEO tool, you can customize the VM values and easily deploy the custom VM as part of the Cisco CSR 1000V installation process. See the "Installing the Cisco CSR 1000V Software Using the Cisco Build, Deploy, Execute OVF Tool" section.

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 "Manually Creating the VM and Installing the Cisco CSR 1000V Software Using the .iso File" section.

For information about upgrading the Cisco IOS XE software, see the "Upgrading the Cisco IOS XE Software" section.

The following table lists the installation options for the supported hypervisors and the minimum Cisco IOS XE software release required.

Table 3-1 Cisco CSR 1000V Supported Installation Options

Installation Option
VMware ESXi
Citrix XenServer
KVM

Deploy OVA Template Using OVA Wizard

3.9S

Not supported

Not supported

Deploy OVA Using BDEO

3.9S

Not supported

Not supported

Manually Configure VM Using .iso File

3.9S

3.10S

3.10S


ROMMON and the Cisco CSR 1000V

The Cisco CSR 1000V does not include a ROMMON image similar to what is included in many Cisco hardware-based routers. During the initial bootloader process, the installation script creates a clean version of the Cisco CSR 1000V software image known as the Golden Image and places it in a non-accessible partition. This clean version can be used if the software image is not working properly or is not bootable.

Note that although the Cisco CSR 1000V does not include ROMMON, the platform does include a GNU GRand Unified Bootloader (GRUB)-based bootloader. The GRUB function on the Cisco CSR 1000V provides more limited functionality compared to the ROMMON available on other Cisco platforms.

Note that although ROMMON is not present on the Cisco CSR 1000V, some Cisco IOS XE commands such as show version may show references to ROMMON in the command displays.


Note After the Cisco CSR 1000V completes the first-time installation, you can configure the router to automatically enter GRUB mode when the router is booted. For more information, see the "Accessing and Using GRUB Mode" section.


Installing the Cisco CSR 1000V

Prerequisites

Installation Requirements

Guidelines and Limitations

Deploying the Cisco CSR 1000V OVA Template to the VM

Installing the Cisco CSR 1000V Software Using the Cisco Build, Deploy, Execute OVF Tool

Manually Creating the VM and Installing the Cisco CSR 1000V Software Using the .iso File

Prerequisites

Before starting your installation of the Cisco CSR 1000V, you must first set up your virtual environment 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.

For more information, see the vendor documentation for the hypervisor on which the Cisco CSR 1000V will be installed.

Installation Requirements

The Cisco CSR 1000V installation requirements depend on the Cisco IOS XE release version and the hypervisor. The following tables list the Cisco CSR 1000V installation requirements for each of the supported hypervisors.

Table 3-2 Installation Requirements for VMware ESXi 

VMware ESXi Requirement
Cisco IOS XE 3.9S
Cisco IOS XE 3.10S
Cisco IOS XE 3.11S

VMware ESXi version(s) supported

5.0

5.0, 5.1

5.0, 5.1

Supported vCPU configurations1

1 vCPU: requires 4 GB minimum RAM allocation

1 vCPU: requires minimum 2.5 GB RAM allocation2

4 vCPUs: requires minimum 4 GB RAM allocation

1 vCPU: requires minimum 2.5 GB RAM allocation2

2 vCPUs: requires minimum 2.5 GB RAM allocation

4 vCPUs: requires minimum 4 GB RAM allocation

Virtual CPU cores required3

1

1

1

Virtual hard disk size

8 GB minimum

8 GB minimum

8 GB minimum

Supported vNICs

VMXNET3

VMXNET3

VMXNET3

Minimum number of vNICs required4

3

3

3

Maximum number of vNICs supported

10

10

10

Default video, SCSI controller set

Required

Required

Required

Virtual CD/DVD drive installed

Required

Required

Required

1 The required vCPU configuration depends on the throughput license and technology package installed. See the data sheet for your release for more information.

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 Requires a 64-bit processor with Virtualization Technology (VT) enabled in the BIOS setup of the host machine.

4 When deploying the OVA, three vNICs are automatically created. You can manually add vNICs to the VM after the Cisco CSR 1000V has booted.


Table 3-3 Installation Requirements for Citrix XenServer 

Citrix XenServer Requirements
Cisco IOS XE 3.10S
Cisco IOS XE 3.11S

Citrix XenServer version supported

6.0.2

6.0.2

Supported vCPU configurations1

4 vCPUs: requires 4 GB minimum RAM allocation

1 vCPU: requires minimum 2.5 GB RAM allocation

2 vCPUs: requires minimum 2.5  GB RAM allocation

4 vCPUs: requires minimum 4 GB RAM allocation

Virtual CPU cores required

1

1

Virtual hard disk size

8 GB minimum

8 GB minimum

Supported vNICs

VIF

VIF

Minimum number of vNICs required

3

3

Maximum number of vNICs supported per VM instance

7

7

Virtual CD/DVD drive Installed

Required

Required

1 The required vCPU configuration depends on the throughput license and technology package installed. See the data sheet for your release for more information.


Table 3-4 Installation Requirements for KVM Environments 

KVM Requirements
Cisco IOS XE 3.10S
Cisco IOS XE 3.11S

KVM versions supported

Linux KVM based on Red Hat Enterprise Linux 6.31

Red Hat Enterprise Virtualization 3.1

Linux KVM based on Red Hat Enterprise Linux 6.31

Red Hat Enterprise Virtualization 3.1

Ubuntu 12.04.03 LTS Server 64 Bits2

Supported vCPU configurations3

4 vCPUs: requires 4 GB RAM minimum allocation

1 vCPU:
requires minimum 2.5 GB RAM allocation

2 vCPUs: requires minimum 2.5 GB RAM allocation

4 vCPUs: requires minimum 4 GB RAM allocation

Virtual CPU cores required

1

1

Virtual hard disk size

8 GB minimum

8 GB minimum

Supported vNICs

Virtio

Virtio

Minimum number of vNICs required

3

3

Maximum number of vNICs supported per VM instance

26

26

Virtual CD/DVD drive installed

Required

Required

1 Requires Kernel version 2.6.3.2 and QEMU 0.12.1.2.

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.


Guidelines and Limitations

Be aware of the following general guidelines and restrictions before installing the Cisco CSR 1000V in your network:

If the hypervisor does not support vNIC Hot Add/Remove, do not make any changes to the VM hardware (memory, CPUs, hard drive size, etc.) while the VM is powered on.

(Cisco IOS XE 3.11S and later) The GigabitEthernet0 interface is no longer available. You can designate any interface as the management interface.

Cisco IOS XE 3.10S and earlier) The GigabitEthernet0 interface is the default management port and cannot be changed.

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 the 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 "Accessing the Cisco CSR 1000V Console" section.


Note Some hypervisors may not support serial console access. Verify support with your hypervisor documentation.


Deploying the Cisco CSR 1000V OVA Template to the VM

You can use the provided CSR 1000V OVA file package to easily deploy the Cisco CSR 1000V to the VM. The OVA package includes an .ovf file that contains a default VM configuration based on the Cisco IOS XE release and the supported hypervisor. See the Installation Requirements section for the installation configuration that is included in the OVA file.

Deploying the OVA Template to the VM (VMware ESXi)

Installing the Cisco CSR 1000V Software Using the Cisco Build, Deploy, Execute OVF Tool


Note The Citrix XenServer and KVM implementations do not support deploying the VM using the .ova file. You must manually install the VM using the .iso file.


Deploying the OVA Template to the VM (VMware ESXi)

The following restrictions apply to deploying the OVA template to the VM:

(Cisco IOS XE 3.10S and later) The OVA package only creates a VM with 4 virtual CPUs. To change to the 1 or 2 virtual CPU configuration, you must first deploy the OVA template, and then use vSphere to change the virtual CPU configuration and the required RAM allocation.

If the virtual CPU configuration is changed, the Cisco CSR 1000V must be rebooted. Changing the RAM allocation does not require rebooting the Cisco CSR 1000V.


Note When deploying the OVA package, the VM requires two virtual CD/DVD drives, one for the OVF environment file and one for the .iso file.


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.

Step 4 Under Name and Inventory Location, specify the name for the VM and click Next.

Step 5 Under Storage, select the Datastore to use for the VM. Click Next.

Step 6 Under Disk Format, select the disk format option:

Thick Provision Lazy Zeroed

Thick Provision Eager Zeroed


Note The Thin Provision option is not supported. The Thick Provision Eager Zeroed option takes longer to install but provides better performance.


Click Next.

Step 7 Under Network Mapping, allocate a virtual network interface card (vNIC) on the destination network using the drop-down list. Select the vNIC to connect at Power On. Click Next.


Note (Cisco IOS XE Release 3.10S and earlier) The vNIC allocated in this step will map to the GigabitEthernet0 management interface on the router.


When the Cisco CSR 1000V installation using the OVA template is complete, two additional vNICS are allocated. The Cisco CSR 1000V supports up to ten vNICs; additional vNICs must be manually created on the VM.

The Properties displays.

Step 8 Configure the properties for the VM.

The available properties differ depending on the Cisco IOS XE release that you are using. See Table 3-5 for Cisco IOS XE Release 3.9S and 3.10S and Table 3-6 for Cisco IOS XE Release 3.11S and later.


Note The bootstrap properties are optional when creating the VM. You can set these properties to easily provision the VM before starting it up.


Table 3-5 OVA Bootstrap Properties for Cisco IOS XE 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.

Management IPv4 Default Gateway

Sets the default management gateway IP address in IPv4 format for the GigabitEthernet0 management interface.

Router name

Configures the hostname of the router.

Features

Enable HTTP Server

(Cisco IOS XE 3.9S only) Enables an HTTP server for system configuration and administration via a web browser.

Enable HTTPS Server

(Cisco IOS XE 3.10S only) Enables an HTTPS server for system configuration and administration via a web browser. Required if using the REST API to perform system configuration.

Note The HTTPS server is enabled by default beginning in Cisco IOS XE Release 3.11S. This field was removed.

Enable SSH Login

Enables remote login using SSH and disables remote login via Telnet. Requires that the login username and password are set.

Additional Configuration Properties

Enable Password

Configures the password for privileged (enable) access.

Domain Name

Configures the network domain name.


Table 3-6 OVA Bootstrap Properties for Cisco IOS XE 3.11S and Later 

Property
Description
Bootstrap Properties

Login Username

Sets the login username for the router.

Login Password

Sets the login password for the router.

Management Interface

Designates the management interface for the Cisco CSR 1000V. The format must be GigabitEthernetx or GigabitEthernetx.xxx.

Note The GigabitEthernet0 interface is no longer supported beginning in Cisco IOS XE Release 3.11S.

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.

Management IPv4 Default Gateway

Configures the IPv4 management default gateway address. If using DHCP, enter "dhcp" in the field.

Remote Management IPv4 Address

(Optional) Configures the IP address used for remote management of the Cisco CSR 1000V by the REST API or by Cisco PNSC. The address must be in the same subnet as the management interface address.

PNSC IPv4 Address

Configures the IP address of the Cisco Prime Network Services Controller.

PNSC Agent Local Port

(Optional) Configures the Cisco Prime Network Services Controller service agent SSL port on the local Cisco CSR 1000V to receive policies from the service manager.

PNSC Shared Secret Key

Configures the Cisco Prime Network Services Controller shared secret key for the Cisco Prime Network Services Controller agent to set the SSL certificate from the controller.

Router name

Configures the hostname of the router.

Features

Enable SCP Server

Enables the IOS SCP feature.

Enable SSH Login

Enables remote login using SSH and disables remote login via Telnet. Requires that the login username and password are set.

Additional Configuration Properties

Enable Password

Configures the password for privileged (enable) access.

Domain Name

Configures the network domain name.


When finished configuring the router properties, click Next. The Ready to Complete screen displays, showing the settings to be used when the template is deployed.

You can also configure advanced properties after the router boots. See the "Configuring Cisco CSR 1000V Properties Using the vSphere GUI" section.

Step 9 Select Power on after deployment to automatically power on the VM.

Step 10 Click Finish to deploy the OVA.

The OVA deploys the .iso file and, if the "Power on after deployment" setting is selected, automatically powers on the VM. Once the VM is powered on, the Cisco CSR 1000V begins the installation and boot process. If a bootstrap configuration file was included in the OVA, the router configuration will automatically be enabled.

See the "Booting the Cisco CSR 1000V as the VM" section.


Installing the Cisco CSR 1000V Software Using the Cisco Build, Deploy, Execute OVF Tool

The Cisco Build, Deploy, Execute OVF (BDEO) tool included in the Cisco CSR 1000V software package is a Linux-based application that enables you to create attributes for one or more VMs and quickly deploy the VMs with the cloud services router software pre-installed. This tool can speed the process of deploying the Cisco CSR 1000V on multiple VMs.

The BDEO tool provides a simple command-line interface to enter the VM attributes into the .ova file. The BDEO tool can be run either in a LINUX shell or on Solaris, and VMware ovftools must be installed.

You can deploy the .ova file directly onto an ESXi host. The BDEO tool is not supported for Citrix XenServer or KVM environments.

Provisioning the VM Using the BDEO Tool

While the following procedure provides general guidance for how to deploy the Cisco CSR 1000V, the exact steps that you need to perform may vary depending on the characteristics of your VMware environment and setup.


Step 1 Download the .ova file from the Cisco CSR 1000V software installation image package:

Step 2 Extract the BDEO shell script tool from the OVA package.

For example, you could use the following Linux command:

tar xvf [file.ova] bdeo.sh README-BDEO.txt

Step 3 Run the BDEO shell script with the command-line parameters that you wish to use. You can run it with "-h" in order to get a listing of supported parameters, or refer to the following table.

All of the commands below are optional except for the -i | -image command.


Note The default values may vary depending on the Cisco CSR 1000V version.


Table 3-7 BDEO Command-Line Bootstrap Properties 

Command Name
Parameters
Description
Input/Output Options

-i | -image

path

Enters one of the following:

The ISO image filename used to create the OVA from.

The .ova file to deploy to the ESXi server

-o | -output

path

Enters the destination output directory of the OVF package, and/or the OVA file.

-n | -name

[name]

Creates a unique OVF or OVA name with a different name than the image. If you don't specify a name, then the default .ova filename is used.

-format

[ovf | ova | zip]

Generates the package in the given format(s). Use a comma-separated list for more than one format. The default format is ova.

Virtual Machine Hardware Options

-c | -cpus

cpus

Enters the number of CPUs to provision.

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

-ea | -eth_adapter

string

Enters the vNIC Ethernet adapter type. Valid values are the following:

VMXNET3

-nw | -network

string

Enters the VM network name for all vNICs or a comma-separated list of one name per vNIC.

Virtual Machine Description Options

-p | -product

string

Enters the description of the product:
Cisco CSR 1000V Cloud Services Router

-v | -vendor

string

Enters the name of the vendor:
Cisco Systems, Inc.

-vs | -version_short

string

Enters the short version string.

-vl | -version_long

string

Enters the long version string.

-pu | -product_url

url

Enters the URL of the product: http://www.cisco.com/en/US/products/ps12559/index.html.

-vu | -vendor_url <URL>

url

Enters the URL of the vendor: http://www.cisco.com.

ESXi/vSphere Deploy Options

-d | -deploy

url

Deploys the OVA to the specified ESXi host.

-u | -username

string

Enters the ESXi login username.

-pw | -password

string

Enters the ESXi login password.

-s | -store

string

Enters the name of the datastore where the OVA will be deployed.

-dm | -diskmode

option

Enters the disk mode type for the VM. Supported options are:

thick

eagerZeroedThick

-pm | -port_map

list

Enters a comma-separated list of port-map names to use for each VM network from the -network option.

If not specified, the tool will assume this value is the same as the -network value.

-nv | -nooverwrite

 

If this value is set, then it instructs the tool to not overwrite an existing VM with the same name.

-po | -poweron

 

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.


Cisco IOS XE Configuration Options

-iu | -ios_username

string

Enters the Cisco IOS XE username (required for remote login).

-ipw | -ios_password

string

Enters the Cisco IOS XE IOS password (required for remote login).

-epw | -enable_password

string

Enters the Cisco IOS XE IOS enable password.

-ipd | -ip_domain

string

Enters the IP domain name

-hn | -hostname

string

Enters the hostname.

-ip | -ip_address

address/mask

Enters the address/mask for management interface, such as "10.1.1.1/24" or "10.1.1.1 255.255.255.0". You can also specify the string "dhcp" to use DHCP.

-mg | -mgmt_gateway

address

Enters the default gateway for management VRF. You can also specify the string "dhcp" to use DHCP.

-ssh

 

If set, enables Secure Shell (SSH) login (and disables Telnet).

-http

 

If set, enables the HTTP server.

-https

 

If set, enables the HTTPS server. Required in Cisco IOS Release XE 3.10S if implementing the Cisco CSR 1000V REST API.

-b | -bootstrap

path

Enters the Cisco IOS bootstrap configuration file (such as NVRAM output) to add to bootstrap, for any configurations not covered by the above options.


Manually Creating the VM and Installing the Cisco CSR 1000V Software Using the .iso File

Overview of Tasks for Manually Creating the Cisco CSR 1000V VM

Manually Creating the Cisco CSR 1000V VM Using the .iso File (VMware ESXi)

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

Manually Creating the Cisco CSR 1000V VM Using the .iso File (KVM)

Overview of Tasks for Manually Creating the Cisco CSR 1000V VM

Figure 3-2 shows the typical high-level tasks required to manually create the Cisco CSR 1000V VM. The specific procedures, terminology and the order the steps are performed may differ depending on the hypervisor being used. See the sections following for detailed steps for creating the VM.


Note If you manually create the VM and you plan to use the Cisco CSR 1000V REST API, you must configure the HTTPS port using the Cisco IOS XE CLI. For more information, see the Cisco CSR 1000V Series Cloud Services Router REST API Management Reference Guide.


Figure 3-2 Task Overview for Manually Creating the Cisco CSR 1000V VM

Manually Creating the Cisco CSR 1000V VM Using the .iso File (VMware ESXi)

The following steps are performed using VMware VSphere.

While the following procedure provides general guidance for how to deploy the Cisco CSR 1000V, the exact steps that you need to perform may vary depending on the characteristics of your VMware environment and setup. The steps and screen displays in this procedure are based on VMware ESXi 5.0.


Step 1 Download the CSR1000_esxi.iso file from the Cisco CSR 1000V software installation image package and copy it onto the VM Datastore.

Step 2 In the VSphere client, select Create a New Virtual Machine option.

Step 3 Under Configuration, select the option to create a Custom configuration, and click Next.

Step 4 Under Name and Location, specify the name for the VM and click Next.

Step 5 Under Storage, select the datastore to use for the VM. Click Next.

Step 6 Under Virtual Machine Version, select Virtual Machine Version 8. Click Next.


Note The Cisco CSR 1000V is not compatible with ESXi Server versions prior to 5.0.


Step 7 Under Guest Operating System, select Linux and the "Other 2.6x Linux (64-bit) setting" from the drop-down menu. Click Next.

Step 8 Under CPUs, select the following settings:

Number of virtual sockets (virtual CPUs)

Number of cores per virtual socket

See the "Installation Requirements" section for the supported number of virtual CPUs and the corresponding required RAM allocation for your release.

Click Next.

Step 9 Under Memory, configure the supported memory size for your Cisco CSR 1000V release. See the "Installation Requirements" section for the supported number of virtual CPUs and the corresponding required RAM allocation for your release.

Click Next.

Step 10 Under Network, allocate at least three virtual network interface cards (vNICs).

a. Select the number of vNICs that you want to connect from the drop-down menu.


Note The VMware ESXi 5.0 interface only allows the creation of 4 vNICS during the initial VM creation. You can add more vNICs after the VM is created and the Cisco CSR 1000V is first booted.


b. Add the vNICs.

Select a different network for each vNIC.

Select the adapter type from the drop-down menu. See the requirements table in the "Installation Requirements" section for the supported adapter type in your release.

c. Select all vNICs to connect at power on.

d. Click Next.


Note (Cisco IOS XE 3.10S Release 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. For more information about how the vNICs on the VM map to the network interfaces on the router, see the "Mapping Cisco CSR 1000V Network Interfaces to VM Network Interfaces" section.



Note You can add vNICs into the VM using vSphere while the Cisco CSR 1000V is running. For more information about adding vNICS to an existing VM, see the vSphere documentation.


Step 11 Under SCSI Controller, select LSI Logic Parallel. Click Next.

Step 12 Under Select a Disk, click Create a new virtual disk.

Step 13 Under Create a Disk, select the following:

Capacity: Disk Size

See the "Installation Requirements" section for the virtual hard disk size required in your release.

Disk Provisioning: select one of the following:

Thick Provision Lazy Zeroed

Thick Provision Eager Zeroed


Note The Thin Provision option is not supported. The Thick Provision Eager Zeroed option takes longer to install but provides better performance.


Location: Store with the virtual machine

Click Next.

Step 14 Under Advanced Options, select SCSI (0:0) for the virtual device node.

Step 15 On the Ready to Complete screen, click the Edit the virtual machine settings before completion. Click Continue checkbox.

Step 16 In the Hardware tab, click New CD/DVD Drive.

a. Select the Device Type that the VM will boot from:

Select the Datastore ISO file option to boot from the Cisco CSR 1000V .iso file. Browse to the location of the .iso file on the datastore set in Step 1.

b. In the Device Status field, select the Connect at power on checkbox.

c. Select the Virtual Device Node CD/DVD drive on the host that the VM will boot from.

Step 17 In the Resources tab, click the CPU setting:

Set the Resource Allocation setting to Unlimited.

Step 18 Click OK.

Step 19 Click Finish.

The VM is now configured for the Cisco CSR 1000V and is ready to boot. The Cisco CSR 1000V is booted when the VM is powered on. See the "Booting the Cisco CSR 1000V as the VM" section.


Note To access and configure the Cisco CSR 1000V from the serial port on the ESXi host instead of the VM console, provision the VM to use this setting before powering on the VM and booting the router. For more information, see the "Accessing the Cisco CSR 1000V Through the Virtual Serial Port" section.



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. For more information, see the Citrix XenServer documentation.

See Table 3-3 for the requirements to install the Cisco CSR 1000V on a Ctirx XenServer VM.

The following steps are performed using the Citrix XenCenter console.


Step 1 Download the .iso file from the Cisco CSR 1000V software installation image package and copy it onto a local or network device.

Step 2 In the Citrix XenCenter console, to create a new VM, select the server, and click New VM.

The Select a VM template screen displays.

Step 3 Click Template. Scroll through the templates and select Other Install Media.

Click Next.

Step 4 In the Name field, enter the name of the VM.

Step 5 When prompted for the installation media, choose from one of the following:

Install from the ISO library or DVD drive

Boot from network

Click Next.

Step 6 Select the server where the VM will be placed.

Select the checkbox for Place the VM on the server. Click Next.

Step 7 Enter the number of vCPUs and memory settings.

See Table 3-3 for the supported number of vCPUs and memory requirements for your release.

Click Next.

Step 8 Add the virtual disks by inputting the following fields:

Enter the description (optional).

Select the virtual disk size from the pull-down menu. See Table 3-3 for the required disk size for your release.

Enter the location of the virtual disk.

Click Add and then click Next.

Step 9 On the Networking screen, select the networks that will connect to the Cisco CSR 1000V through the vNICs.

See Table 3-3 for the supported number of vNICs for your release.

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.


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


Step 10 Click Finish.

The new network is added. Repeat the procedure in the previous step for each vNIC.

For more information about booting the VM, see the Citrix XenServer documentation. When the VM is booted, the Cisco CSR 1000V begins the first-time boot process. See the "Booting the Cisco CSR 1000V as the VM" section to continue the boot process.


Manually Creating the Cisco CSR 1000V VM Using the .iso File (KVM)

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 KVM environment and setup. For more information, see the Red Hat Linux documentation.

See Table 3-4 for the requirements to install the Cisco CSR 1000V on a VM in a KVM environment.


Note The Cisco CSR 1000V does not support deploying the OVA file on KVM environments in Cisco IOS XE Release 3.10S.


The following steps are performed using the KVM console on your server.


Step 1 Download the .iso file from the Cisco CSR 1000V software installation image package and copy it onto a local or network device.

Step 2 Access the KVM console.

Step 3 Choose Application > System Tools.

Step 4 Open the VM Manager. Select the New VM screen to create a new VM.

Step 5 Enter the name of the VM.

Step 6 Select the method of installation based on where you copied the Cisco CSR 1000V .iso file:

Local install media (ISO image or CDROM)


Note If you plan to install from the CDROM, you must also map the .iso file image to the virtual CDROM.


Network install

Network boot (PXE)

Click Forward.

Step 7 On the next screen, locate the install media by selecting from the following:

Use CDROM or DVD.

Enter the CDROM name that the .iso file was mapped to.

Use ISO image

Browse to the .iso file image location. Select the image and click Open.

Step 8 Use the OS Type and Version for the .iso file that is displayed.

Click Forward.

Step 9 Enter the memory and CPU settings.

See Table 3-4 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. For the required memory allocation in your software version, see Table 3-4.

Select the managed or other existing storage by browsing to the storage location.

Click Forward. The Ready to Begin Installation screen for the selected VM displays.

Step 12 Click Advanced options.

Step 13 On the Overview screen, add a description to the VM.


Note While this step is optional, adding a description is recommended if you will create multiple VMs on your host.


Click Apply.

Step 14 Verify that the processor, memory and boot options settings are correct.

Step 15 Under Processor, do the following:

Verify the CPU configuration and enter the values for the current allocation and maximum allocation. The following is the required CPU configuration:

Sockets = 4

Cores = 1

Threads = 1

Select the Configuration option, and then select the Model from the pull-down menu. The Nehalem model is required for the Cisco CSR 1000V.

Click Apply.

Step 16 Under Boot Options, you can select the boot device order, to determine which device to boot from first, and which devices to boot from following that.

Step 17 Under NIC, configure the first vNIC for the VM.

Step 18 For the Device Model, select Virtio.

This is the only vNIC type supported on the Cisco CSR 1000V for the KVM-based hypervisor.


Note (Cisco IOS XE 3.10S Release and earlier) This first vNIC created is mapped to the Gigabit Ethernet 0 management interface on the Cisco CSR 1000V.


Step 19 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. See Table 3-4 for the number of vNICs supported on the hypervisor for your release.



Note You can also create a serial port interface before creating the VM if you want to access the Cisco CSR 1000V using a serial console. See the "Creating the Serial Console Access in KVM" section. You must select the option to use the serial console when booting the Cisco CSR 1000V.


Step 20 Click the Begin Installation button to create the VM.

Step 21 The VM is created. Once the VM is created, the Cisco CSR 1000V begins the first-time boot process. See the "Booting the Cisco CSR 1000V as the VM" section to continue the boot-up process.


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.


Note If you want to access and configure the Cisco CSR 1000V from the serial port on the hypervisor instead of the VM console, you should provision the VM to use this setting before powering on the VM and booting the router. For more information, see the "Accessing the Cisco CSR 1000V Through the Virtual Serial Port" section.



Step 1 Power on the VM.

Step 2 Within 5 seconds of powering on the VM, choose which console to use to view the router bootup and access the Cisco CSR 1000V CLI:

Virtual Console: Choose this option to use the VMware VM console. This is the default setting and the Cisco CSR 1000V will boot using the virtual console if the serial console is not selected within the 5-second timeframe.

If you choose to use the VMware VM console, the rest of the steps in this procedure do not apply. See the VMware documentation.

Serial Console: Choose this option to use the virtual serial port console on the VM (not supported on Citrix XenServer VMs).

The virtual serial port must already be present on the VM for this option to work.

If you are installing on VMware ESXi, see the "Creating Serial Console Access in VMware ESXi" section.

If you are installing in KVM environments, see the "Creating the Serial Console Access in KVM" section.


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.


The Cisco CSR 1000V starts the boot process.

Step 3 Telnet to the VM using the following command:

telnet://esxi_host_ipaddress:portnumber

or, from a UNIX xTerm terminal:

telnet esxi_host_ipaddress portnumber

The following example shows the Cisco CSR 1000V initial boot output on the VM:

%IOSXEBOOT-4-BOOT_SRC: (rp/0): CD-ROM Boot 
%IOSXEBOOT-4-BOOT_CDROM: (rp/0): Installing GRUB 
%IOSXEBOOT-4-BOOT_CDROM: (rp/0): Copying super package 
vxeultra-adventerprisek9.2011-10-20_13.09.SSA.bin 
%IOSXEBOOT-4-BOOT_CDROM: (rp/0): Creating /boot/grub/menu.lst 
%IOSXEBOOT-4-BOOT_CDROM: (rp/0): CD-ROM Installation finished 
%IOSXEBOOT-4-BOOT_CDROM: (rp/0): Ejecting CD-ROM tray
 
 

The system first calculates the SHA-1, which may take a few minutes.

Once the SHA-1 is calculated, the kernel is brought up. Once the initial installation process is complete, the .iso package file is removed from the virtual CD-ROM, and the VM is rebooted. This enables the Cisco CSR 1000V to boot normally off the virtual Hard Drive.


Note The system reboots during first-time installation only.


The time required for the Cisco CSR 1000V to boot may vary depending on the release and the hypervisor used.

Step 4 When the system is finished booting, the system presents a screen showing the main software image and the Golden Image, with an instruction that the highlighted entry is booted automatically in three seconds. Do not select the option for Golden Image and allow the main software image to boot.


Note The Cisco CSR 1000V does not include a ROMMON image similar to what is included in many Cisco hardware-based routers. During installation, a "backup" copy of the installed version is stored in a backup partition. This copy can be selected to boot from in case you upgraded your boot image, deleted the original boot image, or somehow corrupted your disk. Booting from the backup copy is equivalent to booting a different image from ROMMON.

For more information on changing the configuration register settings to access GRUB mode, see the "Accessing and Using GRUB Mode" section.


You can now enter the router configuration environment by entering the standard commands enable and then configure terminal. The following should be noted for the initial installation:

When the Cisco CSR 1000V is booted for the first time, the router boots in a limited mode that provides only limited throughput and feature support. You must install the software license or enable an evaluation license to obtain the supported throughput and features. In some cases you must enable the boot level or change the maximum throughput level. Once these settings are configured, you must reload the router. For more information, see the next section "Installing the Cisco CSR 1000V Licenses and Setting Up Console Access".

(VMware ESXi only) If you manually created the VM using the .iso file, then you need to configure the basic router properties. You can use either the Cisco IOS XE CLI commands or you can manually configure the properties in the vSphere GUI. For more information, see the "Configuring Cisco CSR 1000V Properties Using the vSphere GUI".