Cisco CSR 1000v Series Software Configuration Manual Download Page 289 | Manualshive

Page: 289 / 314

background image

Enabling REST API Support Using the Cisco IOS XE CLI

Introduction to REST API Configuration Options

You need to configure the management interface to support REST API using the Cisco IOS XE CLI if you
installed the Cisco CSR 1000v in either of the following ways:

•

If you installed the Cisco CSR 1000v using the .iso file.

•

If you deployed the Cisco CSR 1000v using an Amazon Machine Image (AMI).

If upgrading a REST API configuration from Cisco IOS XE Release 3.10S to a later release, you must
add your REST API configuration to the IOS configuration.

Note

Before configuring the shared management interface, perform the steps in

Enabling REST API Support, on

page 277

.

The REST API management is located in a management virtual services container that is separate from the
router components, including the router management interface. You have two choices for configuring the
REST API management support, and the steps for each of these are in the following two sections:

•

Configuring the Shared Management Interface to Support the REST API , on page 279

(Cisco IOS XE 3.13S and later, and IOS XE Denali 16.3 and later) The router management interface
and the virtual services management container can share the same IP address. This can be used to save
an IP address to be allocated for other purposes.

•

Configuring the Dual Management Interface to Support the REST API , on page 281

(Required in Cisco IOS XE 3.11S and 3.12S, optional in later releases.) The router management interface
and the virtual services management container use different IP addresses.

The remainder of this section contains information about:

•

Configuring the REST API Local Port and AutoSave Options, on page 283

•

Configuring HTTPS Support for the REST API Using the Cisco IOS XE CLI, on page 284

•

Disabling REST API Support, on page 285

•

Viewing the REST API Container Status, on page 287

Enabling REST API Support

Beginning with Cisco IOS XE Release 3.11S, and including IOS XE Denali 16.3.1 and later, you can enable
REST API support on the remote management interface. To disable REST API support, see

API Support, on page 285

. To enable the REST API, perform the following steps.

Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide

277

Enabling Management by REST API

Enabling REST API Support Using the Cisco IOS XE CLI

«
...
287
288
289
290
291
...
»

Summary of Contents for CSR 1000v Series

Page 1: ...outerSoftwareConfiguration Guide Last Modified 2017 08 18 Americas Headquarters Cisco Systems Inc 170 West Tasman Drive San Jose CA 95134 1706 USA http www cisco com Tel 408 526 4000 800 553 NETS 6387 Fax 408 527 0883 Text Part Number ...

Page 2: ... IMPLIED INCLUDING WITHOUT LIMITATION THOSE OF MERCHANTABILITY FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF DEALING USAGE OR TRADE PRACTICE IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT SPECIAL CONSEQUENTIAL OR INCIDENTAL DAMAGES INCLUDING WITHOUT LIMITATION LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE T...

Page 3: ...S XE Denali 16 3 1 and Later 9 Hypervisor Versions Cisco IOS XE 3 x 9 Hypervisor vNIC Requirements 12 Hypervisor vNIC Requirements for Cisco IOS XE Everest 16 6 13 Hypervisor vNIC Requirements for Cisco IOS XE Everest 16 5 14 Hypervisor vNIC Requirements for Cisco IOS XE Everest 16 4 15 Hypervisor vNIC Requirements for Cisco IOS XE Denali 16 3 17 Hypervisor vNIC Requirements for Cisco IOS XE 3S Re...

Page 4: ...uration Professional 48 Managing the Router Using the Cisco IOS XE REST API 49 Managing the Router Using Cisco Prime Network Services Controller 49 Cisco Unified Computing System UCS Products 50 Finding Support Information for Platforms and Cisco Software Images 51 Using Cisco Feature Navigator 51 Using the Software Advisor 51 Using the Software Release Notes 52 C H A P T E R 3 Using Cisco IOS XE ...

Page 5: ...iting the Custom Properties of Cisco CSR 1000v using vSphere 83 Deploying the Cisco CSR 1000v to the VM using COT 84 Deploying the Cisco CSR 1000v OVA to the VM using COT 84 Downloading COT 85 Editing the Basic Properties of Cisco CSR 1000v using COT 85 Editing the Custom Properties of Cisco CSR 1000v using COT 86 cot edit properties 86 cot inject config 88 Deploying the Cisco CSR 1000v VM using C...

Page 6: ... 6 114 Creating a Cisco CSR 1000v KVM Instance 115 Creating the Cisco CSR 1000v VM Using the Self installing Run Package 115 Installation Procedure 115 Creating the Cisco CSR 1000v VM Using the virt manager GUI Tool 116 Creating the Cisco CSR 1000v VM Using virt manager Using qcow2 or iso Image 116 Creating the Cisco CSR 1000v VM Using virt manager Add Serial Port 117 Creating the Cisco CSR 1000v ...

Page 7: ...Manager Settings 137 Creating the VM 138 Configuring the VM Settings 139 Launching the VM to Boot the Cisco CSR 1000v 141 Installation Requirements for Microsoft Hyper V Cisco IOS XE Everest 16 5 141 Installation Requirements for Microsoft Hyper V Cisco IOS XE Everest 16 4 142 Installation Requirements for Microsoft Hyper V Cisco IOS XE Denali 16 3 1 143 Installation Requirements for Microsoft Hyp...

Page 8: ...re License 167 Troubleshooting CSL License Issues 170 Determining the License Status 170 Migrating Technology Package Licenses to Cisco IOS XE 3 13S 170 Determining the AWS License Type 171 Cisco Smart Licensing 172 Prerequisites for Cisco Smart Licensing 172 Configuring Call Home for Smart Licensing 172 Enabling Cisco Smart Licensing 174 Registering the Router with the Cisco Licensing Cloud 175 R...

Page 9: ... Cisco IOS XE 3 12S and Earlier 195 C H A P T E R 1 1 Upgrading the Cisco IOS XE Software 199 Prerequisites for the Software Upgrade Process 199 Saving Backup Copies of Your Old System Image and Configuration 200 Using TFTP or Remote Copy Protocol to Copy the System Image into Boot Flash Memory 202 Loading the New System Image from the Cisco IOS XE Software 205 Loading the New System Image from GR...

Page 10: ...Enabling Smart Call Home 233 Enabling and Disabling Call Home 234 Configuring Contact Information 234 Information About Destination Profiles 236 Creating a New Destination Profile 237 Copying a Destination Profile 239 Setting Profiles to Anonymous Mode 240 Subscribing to Alert Groups 241 Periodic Notification 244 Message Severity Threshold 244 Configuring Snapshot Command List 245 Configuring Gene...

Page 11: ...ow to Configure Diagnostic Signatures 260 Configuring the Call Home Service for Diagnostic Signatures 260 Configuring Diagnostic Signatures 262 Configuration Examples for Diagnostic Signatures 262 Displaying Call Home Configuration Information 263 Examples 264 Default Settings 268 Alert Group Trigger Events and Commands 268 Message Contents 270 Sample Syslog Alert Notification in XML Format 273 C ...

Page 12: ...89 Enabling Remote Management by the Cisco Prime Network Services Controller Host 292 Disabling Remote Management by the Cisco Prime Network Services Controller Host 295 C H A P T E R 1 7 Troubleshooting Cisco CSR 1000v VM Issues 297 Verifying the Cisco CSR 1000v Hardware and VM Requirements 297 Troubleshooting Network Connectivity Issues 297 Troubleshooting VM Performance Issues 298 C H A P T E R...

Page 13: ... 1000v Series router but only the software aspects that are specific to this router For information on general software features that are also available on the Cisco CSR 1000v Series router see the Cisco IOS XE technology guides for that specific software feature Related Documentation This section refers you to other documentation that also might be useful as you configure your Cisco CSR 1000v rou...

Page 14: ...e the key combination D or Ctrl D means hold down the Control key while you press the D key Keys are indicated in capital letters but are not case sensitive or Ctrl A string is a nonquoted set of characters shown in italics For example when setting an SNMP community string to public do not use quotation marks around the string or the string will include the quotation marks string Command syntax de...

Page 15: ...es of information displayed on the screen are set in Courier font screen Examples of text that you must enter are set in Courier bold font bold screen Angle brackets enclose text that is not printed to the screen such as passwords An exclamation point at the beginning of a line indicates a comment line Exclamation points are also displayed by the Cisco IOS XE software for certain processes Square ...

Page 16: ...vice Request For information about obtaining documentation submitting a service request and gathering additional information see What s New in Cisco Product Documentation which lists all new and revised Cisco technical documentation Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide 4 Preface Obtaining Documentation and Submitting a Service Request ...

Page 17: ... virtual machine VM instance on x86 server hardware It supports a subset of Cisco IOS XE software features and technologies providing Cisco IOS XE security and switching features on a virtualization platform When the Cisco CSR 1000v is deployed on a VM the Cisco IOS XE software functions just as if it were deployed on a traditional Cisco hardware platform Features The Cisco CSR 1000v includes a vi...

Page 18: ...sical location without moving any hardware resources Software Configuration and Management Using the Cisco IOS XE CLI You can perform software configuration and management of the Cisco CSR 1000v using the following methods Provision a serial port in the VM and connect to access the Cisco IOS XE CLI commands Use the virtual VGA console or the console on the virtual serial port to access the Cisco I...

Page 19: ... for obtaining the licenses and upgrading software At first boot the Cisco CSR 1000v router interfaces are mapped to the vNIC interfaces on the VM based on the vNIC enumeration to the Cisco CSR 1000v on subsequent boot the Cisco CSR 1000v router interfaces are mapped to the vNIC MAC address If upgrading to Cisco IOS XE Release 3 11S from an earlier release we recommend you update your configuratio...

Page 20: ...ypervisor For more information see the Installation Overview section on page 3 1 Hypervisor Support A hypervisor enables multiple operating systems to share a single hardware host machine While each operating system appears to have the dedicated use of the host s processor memory and other resources the hypervisor controls and allocates only needed resources to each operating system and ensures th...

Page 21: ...ix XenServer 6 5 recommended 6 2 Microsoft Hyper V Windows Server 2012 R2 Hyper V Mgr 6 3 9600 16384 recommended Amazon Web Services C4 and T2 instance types recommended C3 instance types supported in Cisco IOS XE 3 11 to IOS XE 3 17 See Amazon Web Services in Hypervisor Support on page 8 Microsoft Azure Standard D2 and Standard D3 recommended Standard D4 supported See Microsoft Azure in Hyperviso...

Page 22: ... 31 Red Hat Enterprise Virtualization 3 1 6 0 2 5 05 1 3 10S Supported Not supported Linux KVM based on Red Hat Enterprise Linux 6 31 Red Hat Enterprise Virtualization 3 1 Ubuntu 12 04 03 LTS Server 64 Bits2 6 02 5 05 1 3 11S Supported Windows Server 2012 R2 Linux KVM based on Red Hat Enterprise Linux 6 31 Ubuntu 12 04 03 LTS Server 64 Bits 2 6 1 5 05 15 53 3 12S Cisco CSR 1000v Series Cloud Servi...

Page 23: ... 14S Supported Windows Server 2012 R2 Linux KVM based on Red Hat Enterprise Linux 6 6 Ubuntu 14 04 LTS Server 64 Bits 2 6 2 5 05 15 56 3 15S Supported until Cisco IOS XE 3 16 2 Windows Server 2012 R2 Linux KVM based on Red Hat Enterprise Linux 6 6 Ubuntu 14 04 LTS Server 64 Bits 2 6 2 5 05 15 57 6 08 3 16S Not supported Windows Server 2012 R2 Linux KVM based on Red Hat Enterprise Linux 7 19 Ubuntu...

Page 24: ...sted and supported by the Cisco CSR 1000v See the following sections for more information For information about deploying the Cisco CSR 1000v in an Amazon Web Services environment see the Note For information about deploying the Cisco CSR 1000v in a Microsoft Azure environment see the Cisco CSR 1000V Deployment Guide for Microsoft Azure Note Hypervisor vNIC Requirements Depending on the Cisco CSR ...

Page 25: ...ve Support Yes Single Root I O virtualization SR IOV Support Value vNIC Requirements for KVM Virtio ixgbevf ixgbbe NIC Types Supported 26 Max number of vNICs per VM instance Yes vNIC Hot Add Support No vNIC Hot Remove Support Yes Single Root I O virtualization SR IOV Support Value vNIC Requirements for Microsoft Hyper V NetVSC NIC Types Supported 8 Max number of vNICs per VM instance No vNIC Hot A...

Page 26: ...Intel 10Gb PCI Express NIC Driver ixgbef NIC Types Supported 10 Max number of vNICs per VM instance Yes vNIC Hot Add Support Intel 10Gb PCI Express NIC Driver No vNIC Hot Remove Support Intel 10Gb PCI Express NIC Driver Yes Single Root I O virtualization SR IOV Support Value vNIC Requirements for Citrix XenServer VIF netfront pmap NIC Types Supported 7 Max number of vNICs per VM instance Yes vNIC ...

Page 27: ...eb Services AWS VIF netfront pmap ixgbevf NIC Types Supported 8 See http docs aws amazon com AWSEC2 latest UserGuide using eni html AvailableIpPerENI Max number of vNICs per VM instance No vNIC Hot Add Support No vNIC Hot Remove Support No Single Root I O virtualization SR IOV Support Hypervisor vNIC Requirements for Cisco IOS XE Everest 16 4 Value vNIC Requirements for VMware ESXi VMXNET3ixgbe In...

Page 28: ... virtualization SR IOV Support Value vNIC Requirements for Microsoft Hyper V NetVSC NIC Types Supported 8 Max number of vNICs per VM instance No vNIC Hot Add Support No vNIC Hot Remove Support No Single Root I O virtualization SR IOV Support Value vNIC Requirements for Microsoft Azure NetVSC NIC Types Supported 4 Max number of vNICs per VM instance No vNIC Hot Add Support No vNIC Hot Remove Suppor...

Page 29: ...l 10Gb PCI Express NIC Driver Yes Single Root I O virtualization SR IOV Support Value vNIC Requirements for Citrix XenServer VIF netfront pmap NIC Types Supported 7 Max number of vNICs per VM instance Yes vNIC Hot Add Support No vNIC Hot Remove Support Yes Single Root I O virtualization SR IOV Support Value vNIC Requirements for KVM Virtio ixgbevf ixgbbe NIC Types Supported 26 Max number of vNICs ...

Page 30: ...eni html AvailableIpPerENI Max number of vNICs per VM instance No vNIC Hot Add Support No vNIC Hot Remove Support No Single Root I O virtualization SR IOV Support Hypervisor vNIC Requirements for Cisco IOS XE 3S Releases Table 2 Cisco CSR 1000v vNIC Support for Cisco IOS XE 3S Releases 3 16S 3 17S 3 13S 3 14S 3 15S 3 12S 3 10S 3 11S 3 9S Cisco IOS XE Release VMware ESXi VMXNET3ixgbe Intel 10Gb PCI...

Page 31: ...evf ixgbe Intel 10Gb PCI Express NIC Driver VIF VIF NIC Types Supported 7 7 7 7 Max number of vNICs per VM instance No No No No vNIC Hot Add Remove Support Yes Yes Yes from release 3 12 1S Single Root I O virtualization SR IOV Support KVM Virtio ixgbevf ixgbe Intel 10Gb PCI Express NIC Driver enic Virtio ixgbevf ixgbe Intel 10Gb PCI Express NIC Driver Virtio Virtio NIC Types Supported 26 26 26 10 ...

Page 32: ...pecification SR IOV is not supported with Virtual LANs VLANs Yes from release 3 12 1S Single Root I O virtualization SR IOV Support Microsoft Hyper V HV NetVSC HV NetVSC HV NetVSC NIC Types Supported 3 3 3 Max number of vNICs per VM instance No No No vNIC Hot Add Remove Support No No No Single Root I O virtualization SR IOV Support Amazon Web Services Up until Cisco IOS XE 3 16 2 aws vif pmap aws ...

Page 33: ...rs The Cisco CSR 1000v operates within a virtualization environment Data I O involves communication between one or more vNICs of the guest OS in which the CSR is operating and the physical NIC accessed by the host OS Modes Beginning with Cisco IOS XE 3 16S and also including Cisco IOS XE Denali 16 3 1 and later the Cisco CSR 1000v supports several modes of communication between the vNICs and the p...

Page 34: ...wing table indicates the drivers required to support various I O modes Table 3 Driver Support for I O Modes Cisco CSR1000v Drivers Mode VMXNET3 ESXi Virtio KVM VIF netfront Xen NetVSC Hyper V Para Virtual ixgbe for Intel 10 gig NIC enic for Cisco VIC PCI Passthrough ixgbevf SR IOV Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide 22 Cisco CSR 1000v Series Cloud Services Rou...

Page 35: ... function 0x0 source rom bar off Add this line to xml file address type pci domain 0x0000 bus 0x00 slot 0x07 function 0x0 hostdev Limitations The following table describes the limitations that apply to I O modes Table 4 I O Mode Limitations Limitations Mode Driver Interoperability with another NIC If enic is connected to other NIC for example Intel NIC and then that NIC is used for other CSR VM Pa...

Page 36: ...VM FEX ESXi DirectPath IO VMXNET3 Cisco CSR 1000v and Hypervisor Limitations This section describes performance limitations due to how the Cisco CSR 1000v integrates with supported hypervisors Cisco CSR 1000v and Hypervisor Limitations for Cisco IOS XE Denali 16 3 1 and Later In these releases the Cisco CSR 1000v does not support the hot removal of interfaces and does not have the ability to modif...

Page 37: ...co CSR1000v is reloaded When a large AllowedVlanIdList is configured only lower numbered VLANS may successfully pass traffic For example when the following Power Shell CLI command is used Set VMNetworkAdapterVlan VMName dr vm 6 1 Trunk AllowedVlanIdList 1 2000 NativeVlanId 0 Only VLANS lower than 300 may successfully pass traffic Cisco CSR 1000v and Hypervisor Limitations for Cisco IOS XE Release ...

Page 38: ...SSSE3 Cisco IOS XE Denali 16 3 1 and later For more information see the release notes http www cisco com c en us support routers cloud services router 1000v series products release notes list html For Cisco IOS XE Release 3 9S the Cisco CSR 1000v uses instructions not supported on Intel pre Nehalem generation processors The existence of the required Nehalem or later processor instruction set is de...

Page 39: ...0 or 500 Mbps 1 2 5 or 5 Gbps Maximum supported throughput level for the IPBase package 10 25 50 100 250 or 500 Mbps 1 2 5 5 or 10 Gbps Memory upgrade licenses selected technology packages and throughput levels only Evaluation licenses see Evaluation Licenses Cisco IOS XE 3 13S and Later Cisco IOS XE Denali 16 3 1 and Later on page 33 Three legacy technology packages Standard Advanced and Premium ...

Page 40: ...ps 100 Mbps 250 Mbps Feature Add on License License to add 8 GB of memory with route reflector support This is available for the Premium or AX packages only The additional memory is allocated to IOSD processes on the router only The memory upgrade license does not add available memory on the VM Selected licenses are available through a Cisco service representative only Note Cisco IOS XE Releases 3...

Page 41: ...Mbps 50 Mbps 100 Mbps 250 Mbps 1 Gbps Feature Add on License License to add 8 GB of memory with route reflector support This is available for the Premium or AX packages only The additional memory is allocated to IOSD processes on the router only The memory upgrade license does not add available memory on the VM Selected licenses are only available through a Cisco service representative Cisco IOS X...

Page 42: ... set as the Advanced package AX package license with the same feature set as the Premium package We recommend using these technology packages for compatibility with future releases All technology packages support the same throughput maximums as feature sets in earlier releases Cisco IOS XE Release 3 12 1S Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide 30 Cisco CSR 1000v ...

Page 43: ... Cisco CSR 1000v for the license If the throughput exceeds the supported performance the router may experience dropped packets and you will receive notification that the supported performance has been exceeded The Cisco CSR 1000v uses a performance limiter to regulate the throughput level For example this applies when using 10 Gbps throughput as part of the IPBase technology package licenses For m...

Page 44: ...be rebooted for the new license level to take effect and to have the new license applied In Cisco IOS XE 3 13S and later the Cisco CSR 1000v first boots up in the AX technology mode by default so all features in this package are supported Installing an AX technology license applies the AX license immediately and the throughput is increased to the maximum throughput of the installed license Rebooti...

Page 45: ...co IOS XE Denali 16 3 1 or later Default Beginning with the Cisco IOS XE 3 13S release the CSR 1000v boots by default with the following features AX technology package features 100 Kbps maximum throughput Evaluation License Options Evaluation licenses valid for 60 days are available at the Cisco licensing portal http www cisco com go license The evaluation license options enable test driving addit...

Page 46: ...ther Licenses and select Demo and Evaluation from the dropdown menu 5 In the Product Family section select Routers Switches In the Product section select Cisco Cloud Services Router 1000v Click Next 6 Select the desired license type Enter the UDI Serial number then click Next to generate the license You can display the UDI Serial number on your router by entering the show license udi command DETAI...

Page 47: ...ng This section summarizes Cisco Smart Licensing For details see Cisco Smart Licensing on page 172 Beginning with Cisco IOS XE Release 3 15S the Cisco CSR 1000v supports activation using Cisco Smart Licensing CSL To use Cisco Smart Licensing first configure the Call Home feature and obtain Cisco Smart Call Home Services For details see Cisco Smart Licensing on page 172 The Cisco CSR 1000v supports...

Page 48: ...orted The Cisco CSR 1000v does not include ROMMON but uses GRUB to provide similar but more limited functionality Supported ROMMON Not supported Supported Break Signal Gigabit Ethernet x ports only See the Cisco ASR1000 documentation Port numbering Not supported Supports In Service Software Upgrades ISSU ISSU Subpackages not supported The Cisco CSR 1000v does not support SPAs Supports installation...

Page 49: ... Implementation Guide When deploying the Cisco CSR 1000v on Microsoft Azure For more information see Cisco CSR 1000v Deployment Guide for Microsoft Azure When using the Cisco IOS XE REST API to manage the Cisco CSR 1000v For more information see Enabling Management by REST API on page 275 For information about Cisco IOS XE technologies supported by the REST API see the Cisco IOS XE REST API Manage...

Page 50: ...warding IPv6 Configuration Guide Library Cisco IOS XE Release 3S Cisco IOS IPv6 Command Reference IPBase Security AX APPX Standard Advanced Premium IPv6 Routing Interface and Hardware Component Configuration Guide Cisco IOS XE Release 3S Cisco IOS Interface and Hardware Component Command Reference IPBase Security AX APPX Standard Advanced Premium Generic Routing Encapsulation GRE IP Routing LISP C...

Page 51: ...uide Cisco IOS XE Release 3S Cisco IOS IP Routing BGP Command Reference IPBase Security AX APPX Standard Advanced Premium BGP IP Routing EIGRP Configuration Guide Cisco IOS XE Release 3S Cisco IOS IP Routing EIGRP Command Reference IPBase Security AX APPX Standard Advanced Premium EIGRP IP Routing ISIS Configuration Guide Cisco IOS XE Release 3S Cisco IOS IP Routing ISIS Command Reference IPBase S...

Page 52: ...g Configuration Guide Cisco IOS XE Release 3S Cisco IOS Performance Routing Command Reference IPBase Security AX APPX Standard Advanced Premium Performance Routing IP Multicast IP Multicast IGMP Configuration Guide Cisco IOS XE Release 3S Cisco IOS IP Multicast Command Reference Security AX Advanced Premium IGMP IP Multicast PIM Configuration Guide Cisco IOS XE Release 3S Cisco IOS IP Multicast Co...

Page 53: ...warding Wide Area Networking Wide Area Networking Configuration Guide Overlay Transport Virtualization Cisco IOS XE Release 3S Cisco IOS Wide Area Networking Command Reference AX APPX Premium OTV Supported beginning in Cisco IOS XE 3 10S Cisco CSR 1000V VxLAN Support AX APPX Premium VxLAN Supported beginning in Cisco IOS XE 3 11S IP Application Services Configuration Guide Cisco IOS XE Release 3S ...

Page 54: ...Configuration Guide Cisco IOS XE Release 3S Security AX Advanced Premium Easy VPN FlexVPN and Internet Key Exchange Version 2 Configuration Guide Cisco IOS XE Release 3S Security AX Advanced Premium FlexVPN Cisco Group Encrypted Transport VPN Configuration Guide Cisco IOS XE Release 3S Security AX Advanced Premium GETVPN Supported beginning in Cisco IOS XE Everest 16 6 1 SSL VPN Configuration Guid...

Page 55: ...hing MPLS guides in the CSR 1000v Configuration Guides APPX AX Premium EoMPLS MPLS Layer 3 VPNs Configuration Guide Cisco IOS XE Release 3S Cisco IOS Multiprotocol Label Switching Command Reference IPBase Advanced Premium VRF MPLS Layer 2 VPNs Configuration Guide Cisco IOS XE Release 3S Cisco IOS Multiprotocol Label Switching Command Reference APPX AX Premium VPLS Supported beginning in Cisco IOS ...

Page 56: ... 3S Cisco IOS Flexible NetFlow Command Reference IPBase Security AX APPX Standard Advanced Premium Flexible NetFlow Secure Shell Configuration Guide Cisco IOS XE Release 3S IPBase Security AX APPX Standard Advanced Premium Secure Shell SSH QoS Quality of Service Solutions Configuration Guide Library Cisco IOS XE Release 3S Cisco IOS Quality of Service Solutions Command Reference IPBase Security AX...

Page 57: ...rization and Accounting Configuration Guide Cisco IOS XE Release 3S IPBase Security AX APPX Standard Advanced Premium AAA Securing the Data Plane Configuration Guide Library Cisco IOS XE Release 3S IPBase Security AX APPX Standard Advanced Premium Access Control Lists IP SLAs Configuration Guide Cisco IOS XE Release 3S Cisco IOS IP SLAs Command Reference AX APPX Premium IP SLA RADIUS Configuration...

Page 58: ...lease 3S Cisco IOS Multiprotocol Label Switching Command Reference Security AX Advanced Premium Layer3 Firewall Security Configuration Guide Zone Based Policy Firewall Cisco IOS XE Release 3S Security AX Advanced Premium Zone Based Firewall Cloud Integrated Security Solution Guide Advanced Premium NA Zone Based Firewall Multi tenancy for Cloud Integrated Security Solution Supported starting with C...

Page 59: ... IOS XE Release 3S Download the NBAR2 protocol pack for your release on the Cisco CSR 1000V software download page For more information see the NBAR2 Protocol Library AX APPX Premium NBAR2 Broadband Broadband Access Aggregation and DSL Configuration Guide Cisco IOS XE Release 3S Cisco IOS Broadband Access Aggregation and DSL Command Reference APPX Requires broadband add on feature license L CSR BB...

Page 60: ...ndancy Protocols Configuration Guide Cisco IOS XE Release 3S IPBase Security AX APPX Standard Advanced Premium HSRP WAAS Configuration Guide for AppNav XE for Cisco Cloud Services Router 1000V Series AX APPX Premium Integrated AppNav XE Management Support Managing the Router Using Cisco Configuration Professional Beginning with Cisco IOS XE Release 3 12S the Cisco CSR 1000v supports managing the r...

Page 61: ... monitor the Cisco CSR 1000v Cisco Prime Network Services Controller can be used to streamline configuration when you are provisioning and managing many Cisco CSR 1000v VMs If deploying the Cisco CSR 1000v on ESXi support for remote management using PNSC can be configured while deploying the OVA template If deploying the Cisco CSR 1000v on other hypervisors or if launching the Cisco CSR 1000v on a...

Page 62: ...1Version 3 2 2 Cisco IOS XE Release 3 11S Features added in this release Sub interface IPSec VPN DHCP Server Relay Routing EIGRP SNMP NAT Overload PAT VPN Tunnel interface Site to Site VPN VMware ESXi KVM Version 3 2 1 Version 3 2 2 Cisco IOS XE Release 3 12S and later Cisco Unified Computing System UCS Products Table 10 Cisco CSR 1000v Compatibility with Cisco UCS Servers on page 51 lists Cisco C...

Page 63: ...XE software image you can use Cisco Feature Navigator the Software Advisor or the Cisco CSR 1000v Release Notes Cisco IOS XE Denali 16 3 Using Cisco Feature Navigator Use Cisco Feature Navigator to find information about platform support and software image support Cisco Feature Navigator enables you to determine which Cisco IOS XE software images support a specific software release feature set or ...

Page 64: ...on provided in these documents may not be cumulative in providing information about features that first appeared in previous releases See Cisco Feature Navigator for cumulative feature information For more information see http www cisco com c en us support routers cloud services router 1000v series products release notes list html Cisco CSR 1000v Series Cloud Services Router Software Configuration...

Page 65: ...arameters if the abbreviations contain enough letters to be different from any other currently available commands or parameters The table below lists the keyboard shortcuts for entering and editing commands Table 11 Keyboard Shortcuts Purpose Keystrokes Move the cursor back one character Ctrl B or the Left Arrow key Move the cursor forward one character Ctrl F orthe Right Arrow key Move the cursor...

Page 66: ...e When you log in to the CLI you are in user EXEC mode User EXEC mode contains only a limited subset of commands To have access to all commands enter privileged EXEC mode normally by using a password From privileged EXEC mode you can issue any EXEC command user or privileged mode or you can enter global configuration mode Most EXEC commands are one time commands For example show commands show impo...

Page 67: ...lays a list of commands available for each command mode You can also get a list of keywords and arguments associated with any command by using the context sensitive help feature To get help specific to a command mode a command a keyword or an argument use one of the commands listed in the table below Table 14 Help Commands and Purpose Purpose Command Provides a brief description of the help system...

Page 68: ... you can use the question mark to assist you in entering commands Table 15 Finding Command Options Comment Command Enter the enable command and password to access privileged EXEC commands You are in privileged EXEC mode when the prompt changes to a from the for example Router to Router Router enable Password password Router Enter the configure terminal privileged EXEC command to enter global confi...

Page 69: ... for an interface locaddr priority Assign a priority group logging Configure logging for interface loopback Configure internal loopback on an interface mac address Manually set interface MAC address mls mls router sub interface commands mpoa MPOA interface configuration commands mtu Set the interface Maximum Transmission Unit MTU netbios Use a defined NETBIOS access list or enable name caching no ...

Page 70: ...ord 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 A cr is not displayed therefore you must enter additional keywords or arguments to complete the command 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 Com...

Page 71: ...lly onto a network server Backing up the startup configuration file provides an easy method of recovering the startup configuration file in the event the startup configuration file in NVRAM becomes unusable for any reason The copy command can be used to backup startup configuration files The following examples show the startup configuration file in NVRAM being backed up Example 1 Copying a Startup...

Page 72: ...e output of show and more commands This functionality is useful if you need to sort through large amounts of output or if you want to exclude output that you need not see To use this functionality enter a show or more command followed by the pipe character one of the keywords begin include or exclude and a regular expression on which you want to search or filter the expression is case sensitive sh...

Page 73: ...t 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 For information about deploying the Cisco CSR 1000v in an Amazon Web Services environment seehttp www cisco com c en us td docs routers csr...

Page 74: ...isco CSR 1000v on the VM The different installation options are dependent on the hypervisor being used See the following sections for more information Figure 2 Cisco CSR 1000v Installation Task Workflow Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide 62 Installation Overview Introduction ...

Page 75: ...age Step 3 On the Download Software page select the router model Cloud Services Router 1000v Step 4 Click IOS XE Software The recommended Cisco IOS XE release is selected by default Step 5 In the list of available images click Download Now or Add to Cart Follow the instructions for downloading the software Cisco CSR 1000v Installation Files The following software images are available for installin...

Page 76: ... ova file on the VM using the Common OVF Tool COT The COT application is included in the file package However to ensure that you are using the latest version of COT download COT directly from the GitHub site https github com glennmatthews cot blob master README md Using the COT application you can customize the VM values and easily deploy the custom VM as part of the Cisco CSR 1000v installation p...

Page 77: ...llowing table lists the installation options for the supported hypervisors and the minimum Cisco IOS XE software release required Table 16 Cisco CSR 1000v Supported Installation Options Microsoft Hyper V KVM Citrix XenServer VMware ESXi Installation Option Not supported Not supported Not supported Cisco IOS XE 3 9S and later Deploy OVA Template Using OVA Wizard Not supported Not supported Not supp...

Page 78: ... image This differs from 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 inc...

Page 79: ...0v in an Amazon Web Services environment see the Cisco CSR 1000V Series Cloud Services Router Deployment Guide for Amazon Web Services Note For information about deploying the Cisco CSR 1000v in a Microsoft Azure environment see the Cisco CSR 1000v Deployment Guide for Microsoft Azure Note Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide 67 Installation Overview Where to G...

Page 80: ...Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide 68 Installation Overview Where to Go Next ...

Page 81: ...sco IOS XE 3 x page 99 Installation Requirements Cisco IOS XE 3 x page 101 VMware ESXi Support Information This section includes information about VMware tools software and VM requirements required by the Cisco CSR 1000v running the latest Cisco IOS XE Denali 16 3 1 software as well as a list of the supported VM features The Cisco CSR 1000v can run on the VMware ESXi hypervisor VMware ESXi runs on...

Page 82: ...tributed vSwitches are supported Hard Drive only a single hard disk drive is supported Multiple hard disk drives on a VM are not supported Virtual Disk a 8 GB virtual disk is supported vCPUs the following vCPU configurations are supported The required vCPU configuration depends on the throughput license and technology package installed For more information see the data sheet for your release Note ...

Page 83: ... still be used or performed on non supported versions at the risk of encountering dropped packets dropped connections and other error statistics Distributed Resource Scheduling DRS Fault Tolerance Resume Snapshot Suspend See the following sections for more information General Features vCenter Server on page 71 Operations for vCenter Server and vSphere Web Client on page 72 High Availability on pag...

Page 84: ...logous to pulling the power cable on a physical machine and always works Cisco IOS XE Release 3 9S Power Off Shut Down or soft power off leverages VMware Tools to perform a graceful shutdown of a guest operating system In certain situations such as when VMware Tools is not installed or the guest operating system is hung shut down might not succeed and using the Power off option is necessary Not su...

Page 85: ...esources Scheduler From both vCenter Server and vSphere Client Load balancing and failover policies allow you to determine how network traffic is distributed between adapters and how to reroute traffic if an adapter fails Cisco IOS XE Release 3 9S NIC Load Balancing From both vCenter Server and vSphere Client Allows you to set up an environment where each virtual switch connects to two uplink adap...

Page 86: ...or operating system failures VM Level High Availability monitors heartbeat information in the VMware High Availability cluster Failures are detected when no heartbeat is received from a given virtual machine within a user specified time interval VM Level High Availability is enabled by creating a resource pool of VMs using VMware vCenter Server Cisco IOS XE Release 3 9S VM Level High Availability ...

Page 87: ...e is in the internal hard disks located inside your ESXi host Local storage devices do not support sharing across multiple hosts A datastore on a local storage device can be accessed by only one host Cisco IOS XE Release 3 9S Local Storage You can deploy the Cisco CSR 1000v on external storage that is a Storage Area Network SAN Cisco IOS XE Release 3 9S External Storage Target You can connect USB ...

Page 88: ...The OVA package includes an OVF file that contains a default VM configuration based on a Cisco IOS XE release and the supported hypervisor See the Guidelines and Limitations section of the installation configuration that is included in the OVA file The Citrix XenServer KVM and Microsoft Hyper V implementations do not support deploying the VM using the ova file You must manually install the VM usin...

Page 89: ...tination network using the drop down list The options for mapping the vNICs differ depending on the release version 9 Configure the properties for the VM 10 Select Power on after deployment to automatically power on the VM 11 Click Finish to deploy the OVA DETAILED STEPS 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...

Page 90: ...se that you are using See the tables below for the OVA bootstrap properties for the relevant release of Cisco IOS XE The bootstrap properties are optional when creating the VM You can set these properties to easily provision the VM before starting it up Note able 22 OVA Bootstrap Properties for Cisco IOS XE Release 3 11S and Later Description Property Bootstrap Properties Cisco IOS XE 3 17S and la...

Page 91: ...ace to support REST API See Introduction to REST API Configuration Options on page 277 Note Remote Management IPv4 Address Configures the IP address of the Cisco Prime Network Services Controller This setting is used if you plan to remotely manage the Cisco CSR 1000v using the Cisco Prime Network Services Controller PNSC IPv4 Address Optional Configures the Cisco Prime Network Services Controller ...

Page 92: ...omain Name Cisco IOS XE 3 13S and later and Denali 16 2 and later Configures the license technology level that is available when the Cisco CSR 1000v boots License Boot Level able 23 OVA Bootstrap Properties for Cisco IOS XE Release 3 9S and 3 10S Description Property Bootstrap Properties Sets the login username for the router Login Username Sets the login password for the router Login Password Set...

Page 93: ... 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 Booting the Cisco CSR 1000v and Accessing the Console on page 145 Editing the Basic Properties of Cisco CSR 1000v using vSphere When ...

Page 94: ...to be edited and click Edit 5 Once you have edited the property click OK to close DETAILED STEPS Step 1 In the vSphere GUI select the Options tab Step 2 Choose vApp Options Properties Figure 3 vApp Advanced Options for Cisco CSR 1000v Step 3 Click on the Properties button A new window opens that provides access to the properties that can be edited See the example Advanced Property Configuration Sc...

Page 95: ...ose Editing the Custom Properties of Cisco CSR 1000v using vSphere You can add custom properties to the Cisco CSR 1000v based on Cisco IOS XE CLI commands using the vSphere GUI You can add these properties either before or after you boot the Cisco CSR 1000v If you set these custom properties after the Cisco CSR 1000v has booted you will need to reload the router or power cycle the VM for the prope...

Page 96: ... for the property b Enter the class ID as com cisco csr1000v c Assign the property an ID of ios config xxxx where xxxx is a sequence number from 0001 to 9999 that determines the order in which the custom properties are applied d Optional Enter a description for the property e Enter the property type as string This is the only type supported f Enter the default value as the Cisco IOS XE CLI command...

Page 97: ...000v VM using COT on page 89 COT Restrictions COT supports deployment of the OVA package directly onto an ESXi host The tool does not support Citrix XenServer KVM or Microsoft Hyper V environments Downloading COT Download and install the COT libraries and script according to the instructions on the GitHub site http cot readthedocs io en latest installation html Editing the Basic Properties of Cisc...

Page 98: ...ommands from the text file o csr1000v universalk9 customized ova Editing the Custom Properties of Cisco CSR 1000v using COT Before doing the procedures shown in section Deploying the Cisco CSR 1000v VM using COT on page 89 you can edit custom properties for example to include Cisco IOS XE CLI commands To edit the custom properties of the OVA use one of the following two commands cot edit propertie...

Page 99: ...1 0 Router Name Intercloud Tunnel Interface Gateway IPv4 Address ios config 0001 interface GigabitEthernet1 ios config 0002 no shutdown ios config 0003 ip address 192 168 100 10 255 255 255 0 ios config 0004 ip route 0 0 0 0 0 0 0 0 GigabitEthernet1 192 168 100 1 The table below shows the cot edit properties command and arguments used in the example Description Script Step Edits the custom environ...

Page 100: ...OVA Example In this example the cot inject config command adds Cisco IOS XE commands in text file iosxe_config txt to the OVA cat iosxe_config txt interface GigabitEthernet1 no shutdown ip address 192 168 100 10 255 255 255 0 ip route 0 0 0 0 0 0 0 0 GigabitEthernet1 192 168 100 1 cot inject config csr1000v universalk9 ova o csr1000v universalk9 customized ova c iosxe_config txt cot info csr1000v ...

Page 101: ...description provides general guidance The exact steps that you need to perform may vary depending on the characteristics of your VMware environment and setup SUMMARY STEPS 1 Run the cot deploy esxi command to deploy the Cisco CSR 1000v The script options are described at http cot readthedocs io en latest usage_deploy_esxi html DETAILED STEPS Run the cot deploy esxi command to deploy the Cisco CSR ...

Page 102: ...Network N GigabitEthernet3 VM Network Target hypervisor currently always ESXi esxi OVA to deploy Downloads csr1000v universalk9 ova Any ESXi specific parameters here the datastore to use for disk storage ds datastore38a Manually Creating the VM and Installing the Cisco CSR 1000v Software Using the iso File VMware ESXi Overview of Tasks for Manually Creating the Cisco CSR 1000v VM The figure below ...

Page 103: ...PS port using the Cisco IOS XE CLI Note Figure 5 Task Overview for Manually Creating the Cisco CSR 1000v VM Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide 91 Installing the Cisco CSR 1000v in VMware ESXi Environments Overview of Tasks for Manually Creating the Cisco CSR 1000v VM ...

Page 104: ...ck Next 6 Under Virtual Machine Version select Virtual Machine Version 8 Click Next 7 Under Guest Operating System select Linux and the Other 2 6x Linux 64 bit setting from the drop down menu Click Next 8 Under CPUs select the following settings 9 Under Memory configure the supported memory size for your Cisco CSR 1000v release 10 Under Network allocate at least three virtual network interface car...

Page 105: ... three virtual network interface cards vNICs a Select the number of vNICs that you want to connect from the drop down menu 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 Note b Add the vNICs Select a different network for each vNIC Select the adapter type from th...

Page 106: ...ources 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 Booting the Cisco CSR 1000v and Accessing the Console on page 145 To access and configure the Cisco CSR 1000v from the serial port on the ESXi host in...

Page 107: ...ted vCPUs the following vCPU configurations are supported The required vCPU configuration depends on the throughput license and technology package installed For more information see the data sheet for your release Note 1 vCPU requires minimum 4 GB RAM allocation 2 vCPUs requires minimum 4 GB RAM allocation 4 vCPUs requires minimum 4 GB RAM allocation 8 vCPUs requires minimum 4 GB RAM allocation Vi...

Page 108: ... 8 GB virtual disk is supported vCPUs the following vCPU configurations are supported The required vCPU configuration depends on the throughput license and technology package installed For more information see the data sheet for your release Note 1 vCPU requires minimum 4 GB RAM allocation 2 vCPUs requires minimum 4 GB RAM allocation 4 vCPUs requires minimum 4 GB RAM allocation 8 vCPUs requires mi...

Page 109: ...k is supported vCPUs the following vCPU configurations are supported The required vCPU configuration depends on the throughput license and technology package installed For more information see the data sheet for your release Note 1 vCPU requires minimum 4 GB RAM allocation 2 vCPUs requires minimum 4 GB RAM allocation 4 vCPUs requires minimum 4 GB RAM allocation 8 vCPUs requires minimum 4 GB RAM al...

Page 110: ...al CPU requiring 2 5 GB minimum of RAM 4 virtual CPUs requiring 4 GB minimum of RAM 3 or more virtual network interface cards Single hard disk Multiple hard disk drives on a VM are not supported Note Cisco IOS XE Release 3 10S VMware ESXi 5 0 or 5 1 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 5 GB...

Page 111: ...virtual CPU configurations are supported 1 virtual CPU requiring 4 GB minimum of RAM 2 virtual CPUs requiring 4 GB minimum of RAM 4 virtual CPUs requiring 4 GB minimum of RAM 8 virtual CPUs requiring 4 GB minimum of RAM 3 or more virtual network interface cards Single hard disk Multiple hard disk drives on a VM are not supported Note Cisco IOS XE Release 3 14 3 15 3 16 3 17 VMware VM Requirements ...

Page 112: ...lient 5 0 Server running the following VMware ESXi 5 0 or 5 1 Installation Tool VMware vCenter Cisco IOS XE Release 3 10S and 3 11S VMware standard switch VMware distributed switch PC running the following VMware vSphere Client 5 0 5 1 or 5 5 Server running the following 1 VMware ESXi 5 0 5 1 or 5 5 VMware ESXi 5 5 update 3 is supported on Cisco IOS XE 3 16 1S and later and on 3 17s and later 6 0 ...

Page 113: ...o IOS XE Release3 14S 3 15S 3 16S 3 17S Cisco IOS XE Release 3 12S 3 13S Cisco IOS XE Release 3 11S Cisco IOS XE Release 3 10S Cisco IOS XE Release 3 9S VMware ESXi Requirement 5 0 5 1 5 5 VMware ESXi 5 5 update 3 is supported on Cisco IOS XE 3 16 1S and later and on 3 17s and later 6 0 VMware ESXi 6 0 supported on Cisco IOS XE 3 16 1S and later and on 3 17S and later 5 0 5 1 5 5 5 0 5 1 5 0 5 1 5...

Page 114: ...1 vCPU requires minimum 2 5 GB RAM allocation Not automatically supported when deploying the OVA 4 vCPUs requires minimum 4 GB RAM allocation If configuring Cisco Network Based Application Recognition NBAR or Cisco Application Visibility and Control AVC a 4 GB RAM allocation is required 1 vCPU requires minimum 4 GB RAM allocation Supported vCPU configurations The required vCPU configuration depend...

Page 115: ...10 10 10 10 10 Maximum number of vNICs supported Required Required Required Required Required Default video SCSI controller set Required Required Required Required Required Virtual CD DVD drive installed Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide 103 Installing the Cisco CSR 1000v in VMware ESXi Environments Installation Requirements Cisco IOS XE 3 x ...

Page 116: ...Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide 104 Installing the Cisco CSR 1000v in VMware ESXi Environments Installation Requirements Cisco IOS XE 3 x ...

Page 117: ...rix XenServer Cisco IOS XE 3 x page 111 Citrix XenServer Support Information Supported Releases The Cisco CSR 1000v using Cisco IOS XE 3 10S and later Cisco IOS XE Denali 16 2 is not supported is supported in the Citrix XenServer environment Other Support Information The Cisco CSR 1000v installation on Citrix XenServer requires the manual creation of a VM and installation using the iso file Deploy...

Page 118: ...rver Cisco IOS XE Everest 16 6 For installation procedures see Manually Creating the Cisco CSR 1000v VM Using the iso File Citrix XenServer on page 107 The Citrix XenServer requirements for early versions of Cisco IOS XE before IOS XE Denali 16 3 are shown in Installation Requirements for Citrix XenServer Cisco IOS XE 3 x on page 111 Citrix XenServer version supported Citrix XenServer 6 5 is recom...

Page 119: ...ckage and copy it onto a local or network device 2 In the Citrix XenCenter console to create a new VM select the server and click New VM 3 Click Template Scroll through the templates and select Other Install Media 4 In the Name field enter the name of the VM 5 When prompted for the installation media choose from one of the following 6 Select the server where the VM will be placed 7 Enter the numbe...

Page 120: ... 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 Installation Requirements for Citrix XenServer Cisco IOS XE Everest 16 4 on page 109 or other Installation Requirements sections for the supported number of vCPUs and memory requirements for your release a S...

Page 121: ...netfront pmap Maximum number of vNICs supported per VM instance 7 Virtual CD DVD drive Installed Required Virtual Disk a 8 GB virtual disk is supported Virtual CPU cores 1 vCPU is required Supported vNICs Maximum number of vNICs supported per VM instance 7 Virtual CD DVD drive installed required Installation Requirements for Citrix XenServer Cisco IOS XE Everest 16 4 Installation Requirements for ...

Page 122: ...versions of Cisco IOS XE before IOS XE Denali 16 3 are shown in Manually Creating the Cisco CSR 1000v VM Using the iso File Citrix XenServer on page 107 Citrix XenServer version supported Citrix XenServer 6 5 is recommended tested and meets performance benchmarks Citrix XenServer 6 2 is supported Supported vCPU configurations Also depends on the throughput license and technology package installed ...

Page 123: ...IOS XE 3 13 For installation procedures see Manually Creating the Cisco CSR 1000v VM Using the iso File Citrix XenServer on page 107 Citrix XenServer version supported 6 2 Supported vCPU configurations also depends on the throughput license and technology package installed see Datasheet 1 vCPU requires minimum 2 5 GB RAM allocation 2 vCPUs requires minimum 2 5 GB RAM allocation 4 vCPUs requires mi...

Page 124: ... Cisco CSR 1000v VM Using the iso File Citrix XenServer on page 107 Citrix XenServer version supported 6 0 2 Supported vCPU configurations Also depends on the throughput license and technology package installed see Datasheet 4 vCPUs requires 4 GB minimum RAM allocation Virtual CPU cores required 1 Virtual hard disk size 8 GB minimum Supported vNICs VIF Maximum number of vNICs supported per VM inst...

Page 125: ...on Requirements for KVM Cisco IOS XE Denali 16 4 page 131 Installation Requirements for KVM Cisco IOS XE Denali 16 3 page 131 Installation Requirements for KVM Cisco IOS XE 3 x page 132 Kernel Virtual Machine Support Information The CSR1000v supports the following Linux KVM environments Red Hat Enterprise Linux RHEL Red Hat Enterprise Virtualization RHEV Ubuntu beginning with Cisco IOS XE Release ...

Page 126: ... Installation Requirements for KVM Cisco IOS XE Everest 16 6 The KVM requirements for Cisco CSR 1000v using Cisco IOS XE Everest 16 6 are as follows The KVM requirements for older versions of Cisco IOS XE before IOS XE Denali 16 3 are shown in Installation Requirements for KVM Cisco IOS XE 3 x on page 132 Note KVM versions The following KVM versions are supported Linux KVM based on Red Hat Enterpr...

Page 127: ... or a separate qcow2 image Installation Procedure The following steps are performed on the KVM server Prerequisites Download the run executable from the Cisco CSR 1000v software installation image package and copy it onto a local device SUMMARY STEPS 1 Run the run executable to launch the CSR VM DETAILED STEPS Run the run executable to launch the CSR VM Example csr1000v universalk9 03 16 01a S 155...

Page 128: ...Enter number of vnics 3 2 Options for virtual bridge virbr0 vnet1 Enter bridge for vnic 1 virbr0 Options for virtual bridge virbr0 vnet1 Enter bridge for vnic 2 virbr0 Options for virtual bridge virbr0 vnet1 Creating VM my_csr_vm Do you want to start the CSR y Starting CSR my_csr_vm VM my_csr_vm started Creating the Cisco CSR 1000v VM Using the virt manager GUI Tool Creating the Cisco CSR 1000v VM...

Page 129: ...selected then the next screen displays an Add Hardware button that can be used one or more times to add various hardware options such as additional disks or a serial port interface see the following sections Note Step 7 Access the Cisco CSR 1000v console by using one of the following a If using the virtual console Double click the VM instance to access the VM console b If using the serial console ...

Page 130: ...orage option from the menu 3 Select Select managed or other existing storage checkbox 4 Applicable only when adding a Bootstrap Day0 configuration Click the Browse button and navigate to the csr_config iso location From the Device type drop down menu select the IDE CDROM option 5 Click Finish 6 After adding all necessary hardware click Begin Installation DETAILED STEPS Step 1 Click Add Hardware St...

Page 131: ...iso configuration_filename Step 3 This step must be performed within Creating the Cisco CSR 1000v VM Using virt manager Using qcow2 or iso Image on page 116 Mount the csr_config iso as an additional disk during creation of the CSR virtual machine Creating the Cisco CSR 1000v VM Using virt install Using qcow2 Image The following steps are performed on the KVM server Prerequisites Download and insta...

Page 132: ... Due to an issue specific to Red Hat Enterprise Linux when launching the Cisco CSR1000v in a Red Hat Enterprise Linux environment using virt install set the host mode as follows In Red Hat Enterprise Linux 6 use cpu host In Red Hat Enterprise Linux 7 use cpu host model Creating the Cisco CSR 1000v VM Using virt install Using ISO Image The following steps are performed on the KVM server Prerequisit...

Page 133: ...00v_iso disk path csr_disk qcow2 bus virtio size 8 sparse false cache none format qcow2 network bridge virbr0 model virtio noreboot Optional To configure a Bootstrap Day0 configuration perform the steps described in Creating a Bootstrap Day0 Configuration for virt install on page 122 The virt install command creates a new VM instance and the CSR installs the image onto the specified disk file Afte...

Page 134: ...dure see the options indicated above DETAILED STEPS Step 1 Create an iosxe_config txt or ovf env xml file For details see Bootstrap Properties on page 126 Step 2 Create a disk image from the file using following command Example mkisofs l o my path csr_config iso configuration_filename Step 3 This step must be performed within the VM creation procedure see the options indicated above Add an additio...

Page 135: ...nstallation 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...

Page 136: ...taining the router configuration nova boot csr_instance image csr_image flavor 6 nic net id 546af738 bc0f 43cf 89f2 1e2c747d1764 config drive true file ovf env xml opt stack csr files ovf env xml Example The following example boots the Cisco CSR 1000v image on OpenStack with the iosxe_config txt file containing the router configuration nova boot csr_instance image csr_image flavor 6 nic net id 546...

Page 137: ...nce using the Instance Create tab on the screen 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 Lau...

Page 138: ...e Enables execution of a Cisco IOS command To execute multiple commands use multiple instances of ios config with a number appended to each instance for example ios config 1 ios config 2 The commands are executed in numerical order according to the appended number Example ios config 1 username cisco priv 15 pass ciscoxyz ios config 2 ip scp server enable ios config 3 ip domain lookup ios config 4 ...

Page 139: ... Network Services Controller service agent SSL port on the local Cisco CSR 1000v to receive policies from the service manager This setting is used if you plan to remotely manage the Cisco CSR 1000v using the Cisco Prime Network Services Controller pnsc agent local port Configures the IP address of the Cisco Prime Network Services Controller This setting is used if you plan to remotely manage the C...

Page 140: ...in username 1 oe value lab Property oe key com cisco csr1000v mgmt interface 1 oe value GigabitEthernet1 Property oe key com cisco csr1000v mgmt ipv4 addr 1 oe value 172 25 223 251 25 Property oe key com cisco csr1000v mgmt ipv4 gateway 1 oe value 172 25 223 129 Property oe key com cisco csr1000v mgmt ipv4 network 1 oe value Property oe key com cisco csr1000v mgmt vlan 1 oe value Property oe key c...

Page 141: ...00v does not support jumbo packets larger than 1518 bytes for KVM on a Virtio interface Packets larger than 1518 bytes are dropped Note You can improve performance on KVM configurations by Enabling CPU Pinning as follows Increase the performance for KVM environments by using the KVM CPU Affinity option to assign a virtual machine to a specific processor To use this option configure CPU pinning on ...

Page 142: ...during the bootup select the GOLDEN image to boot instead of packages conf In the Create a new virtual machine window deselect Allocate entire disk now before the new Cisco CSR1000v VM is created This ensures that the cloned Cisco CSR1000v VM image is able to boot up However this workaround does not support nested cloning Use this method only on the first cloned Cisco CSR1000v VM image Installatio...

Page 143: ...x 7 1 is supported but RHEL 7 2 is recommended vCPUs The following vCPU configurations are supported 1 vCPU requires minimum 4 GB RAM allocation 2 vCPUs requires minimum 4 GB RAM allocation 4 vCPUs requires minimum 4 GB RAM allocation Virtual CPU cores 1 vCPU is required Virtual hard disk size 8 GB minimum Supported vNICs Virtio ixgbe or ixgbevf Maximum number of vNICs supported per VM instance 26...

Page 144: ...ly when installing using an iso file required Installation Requirements for KVM Cisco IOS XE 3 x This section contains information about VMware requirements for older Cisco IOS XE releases before IOS XE Denali 16 3 1 To see the installation requirements for Cisco IOS XE Denali 16 3 or later see sections such as Installation Requirements for KVM Cisco IOS XE Denali 16 3 on page 131 The table below ...

Page 145: ... 3 1 Ubuntu 12 04 03 LTS Server 64 Bits Requires QEMU x86_64 version 1 0 qemu kvm 1 0 Linux KVM based on Red Hat Enterprise Linux 6 3 Requires Kernel version 2 6 32 and QEMU 0 12 1 2 Red Hat Enterprise Virtualization 3 1 KVM versions supported 1 vCPU requires minimum 4 GB RAM allocation 2 vCPUs requires minimum 4 GB RAM allocation 4 vCPUs requires minimum 4 GB RAM allocation 1 vCPU requires minimu...

Page 146: ...ack environment the hard disk size must be set to 0 8 GB minimum Applies only to creating the VM using the iso file If using the qcow2 file to install in an OpenStack environment the hard disk size must be set to 0 8 GB minimum 8 GB minimum Virtual hard disk size Virtio Virtio Virtio Virtio Virtio Supported vNICs 26 26 26 26 26 Maximum number of vNICs supported per VM instance Required Required Re...

Page 147: ...age 143 Installation Requirements for Microsoft Hyper V Cisco IOS XE 3 x page 143 Microsoft Hyper V Support Information Cisco IOS XE Release 3 12S or later and Cisco IOS XE Release Denali 16 3 1 or later the Cisco CSR 1000v supports installation on Microsoft Hyper V using Windows Server 2012 R2 Cisco IOS XE Denali 16 2 Installing Cisco CSR 1000v in a Microsoft Hyper V environment is not supported ...

Page 148: ...g the AllowedVlanIdList parameter Note For more information on the Set VMNetworkAdapterVlan powershell command see https technet microsoft com itpro powershell windows hyper v set vmnetworkadaptervlan See also Configure virtual local area networks for Hyper V Installation Requirements for Microsoft Hyper V Cisco IOS XE Everest 16 6 The Microsoft Hyper V requirements for Cisco CSR 1000v using Cisco...

Page 149: ... information see Microsoft Windows Server 2012 R2 documentation The Cisco CSR 1000v does not support deploying the OVA file in Microsoft Hyper V environments Note Before installing the Cisco CSR 1000v on a Microsoft Hyper V VM the following must be installed on the host Hyper V Manager Failover Cluster Manager Virtual Switch Although not required it is recommended that you create the Virtual Switc...

Page 150: ...rage Services Hyper V Step 5 Select Features In the Features list select the following option by clicking on the checkbox Failover Clustering Failover clustering is required It is not automatically installed so you must make sure this option is checked This feature requires that Failover Cluster Manager is installed Step 6 Click Next Creating the VM To create the VM perform the following steps SUM...

Page 151: ... procedure Changing the MAC address of the first interface and rebooting a licensed Cisco CSR 1000v will de activate the license Note Click Next Step 6 On the Connect Virtual Hard Disk Screen select the following option Attach a virtual hard disk later The New Virtual Machine Wizard only supports creating a virtual hard disk using the vhdx format The Cisco CSR 1000v requires that the hard disk use...

Page 152: ... the virtual hard disk using the vhd format Click Next The Cisco CSR 1000v does not support the VHDX format Note b On the Choose Disk Type screen click on the Fixed Size option Click Next 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 ...

Page 153: ... to VM Network Interfaces on page 213 Step 9 Click BIOS to verify the boot sequence for the VM The VM should be set to boot from the CD Launching the VM to Boot the Cisco CSR 1000v To launch the VM perform the following steps SUMMARY STEPS 1 Select the virtual switch 2 Select the VM and click Start DETAILED STEPS Step 1 Select the virtual switch Step 2 Select the VM and click Start The Hyper V Man...

Page 154: ...he Microsoft Hyper V requirements for Cisco CSR 1000v using Cisco IOS XE Everest 16 4 are as follows The Microsoft Hyper V requirements for older versions of Cisco IOS XE before IOS XE Denali 16 3 are shown in Installation Requirements for Microsoft Hyper V Cisco IOS XE 3 x on page 143 Note The following Microsoft Hyper V versions are supported Windows Server 2012 R2 Hyper V Mgr 6 3 9600 16384 is ...

Page 155: ...tion Virtual CPU cores 1 vCPU is required Virtual hard disk size 8 GB minimum Supported vNICs NetVSC pmap Maximum number of vNICs supported per VM instance 8 Virtual CD DVD drive installed required Installation Requirements for Microsoft Hyper V Cisco IOS XE 3 x This section contains information about Microsoft Hyper V requirements for older Cisco IOS XE releases the releases supported by Cisco CS...

Page 156: ...es required 8 GB 8 GB Virtual hard disk size11 HV driver HV driver Supported vNICs 8 8 Maximum number of vNICs supported per VM instance Required Required Virtual CD DVD drive Installed 10 The required vCPU configuration depends on the throughput license and technology package installed See the data sheet for your release for more information 11 The VHD format is supported only The VHDX format is ...

Page 157: ... SUMMARY STEPS 1 Power up the VM Within 5 seconds of powering on the VM choose a console described from one of the following three steps 2 3 or 4 to select a console to view the router bootup and to access the Cisco CSR 1000v CLI 2 Optional Select Auto Console Cisco IOS XE 3 13S and later and IOS XE Denali 16 3 1 and later 3 Optional Select Virtual Console 4 Optional Select Serial Console 5 Telnet...

Page 158: ...re installing on VMware ESXi see Creating Serial Console Access in VMware ESXi on page 148 If you are installing in KVM environments see Creating the Serial Console Access in KVM on page 150 If you are installing in Microsoft Hyper V environments see Creating the Serial Console Access in Microsoft Hyper V on page 151 The Cisco CSR 1000v starts the boot process Step 3 Optional Select Virtual Consol...

Page 159: ...y is equivalent to booting a different image from ROMMON For more information on changing the configuration register settings to access GRUB mode see Accessing and Using GRUB Mode on page 221 Note 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 1...

Page 160: ...ction to Accessing the Cisco CSR 1000v through the Virtual Serial Port By default the Cisco CSR 1000v is accessed using the virtual VGA console If using automatic console detection and two virtual serial ports are detected the Cisco CSR 1000v CLI will be available on the first virtual serial port You can also configure the VM to use the Serial Console which always attempts to use the first virtual...

Page 161: ... for the virtual serial port b Click the Configuration tab and click Security Profile c In the Firewall section click Properties and then select the VM serial port connected over Network value You can now access the Cisco IOS XE console using the Telnet port URI When you configure the virtual serial port the CSR 1000v is no longer accessible from the VM s virtual console See Opening a Telnet Sessi...

Page 162: ...a serial device Step 5 Under Character Device choose the TCP Net Console tcp device type from the drop down menu Step 6 Under Device Parameters choose the mode from the drop down menu Step 7 Under Host enter 0 0 0 0 The server will accept a telnet connection on any interface Step 8 Choose the port from the drop down menu Step 9 Choose the Use Telnet option Step 10 Click Finish You can now access t...

Page 163: ... shows entry of the password enablepass 5 When the enable password is accepted the privileged EXEC mode prompt appears 6 You now have access to the CLI in privileged EXEC mode and you can enter the necessary commands to complete your desired tasks 7 To exit the Telnet session use the exit or logout command as shown in the following example DETAILED STEPS Step 1 Telnet to the VM Use the following c...

Page 164: ...ing example Example Router logout Changing the Console Port Access After Installation After the Cisco CSR 1000v has booted successfully you can change the console port access to the router using Cisco IOS XE commands After you change the console port access you must reload or power cycle the router SUMMARY STEPS 1 enable 2 configure terminal 3 Do one of the following platform console auto platform...

Page 165: ...cessed through the hypervisor virtual VGA console This is the default setting during the initial installation boot process on Cisco IOS XE 3 12S and earlier Example Router config platform console virtual serial Specifies that the Cisco CSR 1000v is accessed through the serial port on the VM Example Router config platform console serial Note Use this option only if your hypervisor supports serial p...

Page 166: ...le access is to install the Cisco CSR 1000v software licenses For more information see Installing Cisco CSR 1000v Licenses on page 155 Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide 154 Booting the Cisco CSR 1000v and Accessing the Console License Installation ...

Page 167: ...sting Cisco Smart License Throughput Level Licenses page 180 Requesting Memory Add on License page 182 Requesting Smart License Broadband license page 182 Manually Renewing the ID Certificate page 183 Manually Renewing the License page 183 Unregistering a Device from Cisco Smart Licensing page 184 Disabling Cisco Smart Licensing page 184 License Out of Compliance Behavior page 185 License Behavior...

Page 168: ...Licensing Cisco IOS XE Release 3 15S and later See Cisco Smart Licensing on page 172 Cisco Smart Licensing Cisco Software Licensing CSL Installing CSL Evaluation Licenses for Cisco IOS XE 3 13S and Later In Cisco IOS XE 3 13S and later including IOS XE Denali 16 2 and later the Cisco CSR 1000v first boots with the AX feature set enabled and the maximum throughput limited to 100 Kbps The following ...

Page 169: ...ain the evaluation license http www cisco com go license Step 3 1 Click on Continue to Product Registration 2 Click on Get Other Licenses and select Demo and Evaluation 3 Under Product Family select Router Switches 4 Under Product select Cisco Cloud Services Router 1000v 5 Click Next 6 Select the evaluation license 7 Select whether the evaluation license will be used on an Amazon AWS instance a st...

Page 170: ...nd Step 7 Saves the running configuration to NVRAM write memory Example write memory Step 8 Restarts the Cisco CSR 1000v to enable the feature set and the maximum throughput supported by the evaluation license The reload Example reload Step 9 Cisco CSR 1000v reloads with the evaluation license activated The evaluation license expires 60 days from the time it is activated Displays the license infor...

Page 171: ...cense by entering the PAK and the UDI into the Cisco Product License registration portal http www cisco com go license 5 license install stored location url 6 configure terminal 7 license boot level ipbase security ax appx 8 end 9 write memory 10 reload 11 show license detail 12 platform hardware throughput level MB 10 100 1000 10000 250 2500 50 500 5000 DETAILED STEPS Step 1 Obtain the PAK The PA...

Page 172: ...e Step 5 license install stored location url Example Router license install bootflash 90NVHJ3C26E_20140724194119019 lic Installs the license Accept the end user license agreement if prompted Step 6 configure terminal Example Router configure terminal Enters global configuration mode Step 7 license boot level ipbase security ax appx Example Router config license boot level ax Activates the license ...

Page 173: ... 100 1000 10000 250 2500 50 500 5000 Example Router config platform hardware throughput level 500 Optional Changes the maximum throughput level for the Cisco CSR 1000v Note After this command you do not need to restart the Cisco CSR 1000v What to Do Next Repeat these steps for each license available for your PAK Configuring an Interface for 10 Gbps Maximum Throughput If you installed a license wit...

Page 174: ...S and Later Understanding the Cisco CSR 1000v Memory Allocation The feature add on licenses add memory for the Cisco CSR 1000v but the memory is allocated to both the IOSd component and the data plane component with the allocations depending on the licenses installed Multiple 4 GB add on licenses can be installed The broadband feature license adds 4 GB of additional memory and additional 4 GB add ...

Page 175: ...GBDataplane 1 5 GB 4 GB Additional memory or broadband license installation is not available for this level of VM memory NA NA IOSd 4 5G Dataplane 1 5G IOSd 2 5 GBDataplane 1 5 GB 6 GB NA NA IOSd 5 5G Dataplane 2 5G IOSd 2 5 GBDataplane 1 5 GB 8 GB NA IOSd 9 5G Dataplane 2 5G IOSd 5 5G Dataplane 2 5G IOSd 2 5 GBDataplane 1 5 GB 12 GB IOSd 13 5G Dataplane 2 5G IOSd 9 5G Dataplane 2 5G IOSd 5 5G Dat...

Page 176: ...u order or purchase the right to use a feature set Obtain the PAK Step 1 The PAK serves as a receipt and is used as part of the process to obtain a license Enables privileged EXEC mode enable Step 2 Example Router enable Enter your password if prompted Displays all the UDI values that can be licensed in a system show license udi Step 3 Example Router show license udi You need the UDI of the device...

Page 177: ...or each memory license you are planning to install For example if you plan to add three memory licenses you would add 12288 MB of memory Exits configuration mode end Example Router config end Step 8 Installs the memory add on license license install stored location url Example Router license install bootflash 90NVHJ3C26E_20140724194119019 lic Step 9 Example 4096 MB memory has been added to the sys...

Page 178: ...dium Information About Installing Broadband Feature License Beginning with Cisco IOS XE 3 13S the Cisco CSR 1000v supports the Broadband Network Gateway feature set and the Intelligent Services Gateway feature set The required broadband feature license L CSR BB 1K provides up to 4 GB of additional memory and support for up to 1000 broadband sessions The following restrictions apply The APPX featur...

Page 179: ...configure terminal 7 platform broadband 1K 2K 3K 4K 5K 6K 7K 8K 8 platform memory add memory 9 end 10 license install stored location url 11 write memory 12 reload 13 show license detail 14 show platform software vmemory info 15 Optional Install memory add on licenses as needed See Installing Memory Add on License on page 163 DETAILED STEPS Purpose Command or Action The PAK is provided to you when...

Page 180: ... Example Router config platform broadband 1K You can add 1000 sessions for each broadband feature license you are planning to install For example if you plan to add two broadband feature licenses enter the value as 2K Optional Adds the memory allocation to the Cisco CSR 1000v to accommodate added memory license s platform memory add memory Example Router config platform memory add 4096 Step 8 Add ...

Page 181: ... 13 Verifies the updated memory allocation on the Cisco CSR 1000v show platform software vmemory info Step 14 Optional Install memory add on licenses as needed See Installing Memory Add on License on page 163 Step 15 The following is an example of the show license command showing details of a broadband feature license show license begin bb Index 76 Feature bb_1K Period left Life time License Type ...

Page 182: ...e Type Permanent License State Active Not in Use License Count Non Counted License Priority Medium Store Index 1 Store Name Primary License Storage The AX technology license is shown as Active and in use while the Security technology license is Active but not in use To use the Security technology license the license boot level command needs to be configured to security and the Cisco CSR 1000v must...

Page 183: ...the correct feature set name for the migrated license use the show running configuration command Determining the AWS License Type When you deploy Cisco CSR 1000v instances from Cisco CSR 1000v Amazon Machine Images AMIs from Amazon Web Services the license displays differ depending on whether you deployed a Bring Your Own License BYOL or an hourly usage license If the show license command shows th...

Page 184: ...co IOS XE technology packages are supported IPBase Security AX and APPX Cisco Smart Licensing uses the Cisco Smart Software Manager for managing licenses To access the Cisco Smart Software Manager use the following URL https software cisco com module SmartLicensing For more information about Cisco Smart Software Manager see the Cisco Smart Software Manager User Guide which is accessible from the C...

Page 185: ...ature service call home Example Router config call home Step 2 Enters the Call Home configuration submode call home Example Router config call home Step 3 Enters the Call Home destination profile configuration subm for the specified destination profile If the specified destina profile does not exist it is created profile name Example Router config call home profile profile1 Step 4 Enables the HTTP...

Page 186: ...t When entering a destination URL include either https or http depending on whether the server is a secure server or not Note Enabling Cisco Smart Licensing To enable Cisco Smart Licensing and register your device perform the following steps SUMMARY STEPS 1 configure terminal 2 license smart enable 3 exit 4 reload DETAILED STEPS Purpose Command or Action Enters global configuration mode configure ...

Page 187: ...stination address command points to the URL of the Cisco Smart Software Agent as shown above If the URL is not configured then you must manually configure the destination address http command to point to the URL After connectivity is established register the router with the Cisco Licensing Cloud for example see section Registering the Router with the Cisco Licensing Cloud on page 175 Registering t...

Page 188: ...to the Internet or the Cisco Smart Software Agent at tools cisco com resulting in log file error messages such as those shown below Note that these messages may also appear as a result of other conditions being true SMART_LIC 3 AGENT_REG_FAILED Smart Agent for Licensing Registration with Cisco licensing cloud failed Fail to send out Call Home HTTP message SMART_LIC 3 COMM_FAILED Communications fai...

Page 189: ... CiscoTAC 1 Removes the previously configured destination address Software Agent no destination address http default url Example Router cfg call home profile no destination address https tools cisco com its service oddce services DDCEService Step 2 satellite url To determine the URL of the transport ga Satellite documentation The satellite url will be simila http ip address Transportgateway servic...

Page 190: ...nectivity with the Cisco Smart Call Home Server use one of the following two methods depending on the version of Cisco IOS XE that you are using If you are using one of the following recent versions of Cisco IOS XE 3 16 6 Denali 16 3 4 and later Everest 16 4 2 and later Everest 16 5 1 and later see Re establishing Connectivity Method 1 on page 178 If you are using one of the following versions of ...

Page 191: ...fy static IPv4 addresses in the smart licensing call home profile by performing the steps shown below DETAILED STEPS Purpose Command or Action Enters configuration mode configure terminal Example Router configure terminal Step 1 Activates the call home feature service call home Example Router config call home Step 2 Enters the Call Home configuration submode call home Example Router config call ho...

Page 192: ... cfg call home profile no destination address email https 173 37 145 8 its service oddce services DDCEService Cisco may change this IP address for licensing in future Note Requesting Cisco Smart License Throughput Level Licenses Request a license corresponding to the configured technology package level and throughput level Prerequisites Register the CSR device with the Smart License server Changin...

Page 193: ...AUTHORIZED on Nov 09 13 37 00 2015 UTC Last Communication Attempt SUCCEEDED on Nov 09 13 37 00 2015 UTC Next Communication Attempt Nov 09 13 39 20 2015 UTC Communication Deadline Feb 07 13 33 58 2016 UTC License Usage regid 2014 05 com cisco ax_100M 1 0_2fff5ed6 e23c 455d ade3 83ba3c8ed890 ax_100M Description Count 1 Version 1 0 Status AUTHORIZED ax_250M Description Count 1 Version 1 0 Status PEND...

Page 194: ...information about memory allocation with memory add on licenses see the table in Understanding the Cisco CSR 1000v Memory Allocation on page 162 platform memory add memory Step 2 Verifies the updated memory allocation on the Cisco CSR 1000v show platform software vmemory info Step 3 Requesting Smart License Broadband license For information about broadband licenses see Information About Installing...

Page 195: ...ng this procedure This may be useful in either of the following circumstances If you have a limited window of Internet access After making licensing changes in the Smart Software Manager SUMMARY STEPS 1 license smart renew id DETAILED STEPS Purpose Command or Action Renews the ID certificate license smart renew id Example Router license smart renew id Step 1 Manually Renewing the License By defaul...

Page 196: ...se smart deregister DETAILED STEPS Purpose Command or Action Removes the Cisco Smart Licensing registration for the device instance All Cisco Smart Licensing certificates are removed on the CSR1000v and the entitlements are released from the Smart Call Home backend server license smart deregister Step 1 Disabling Cisco Smart Licensing Describes how you can disable Cisco Smart Licensing and switch ...

Page 197: ...ng been configured to have a higher performance level compared to the previously purchased feature set After the out of compliance message appears the system continues to operate at the previously licensed throughput rate License Behavior with no Connectivity to the Smart Licensing Server When a successfully licensed Cisco CSR 1000v is unable to contact the Smart Licensing server during reload rea...

Page 198: ... been blocked nvram startup config is write protected read only Valid license and reboot is required to recover from this state Use configuration CLI platform hardware throughput restricted throughput rate mode if startup config changes are needed In Feature Restricted mode the platform hardware throughput restricted throughput rate mode command is enabled It is only visible when in feature restri...

Page 199: ... on the device onto which you want to install a license using PLR configure terminal Step 1 Enable smart licensing license smart enable Step 2 Enables reservation mode license smart reservation Step 3 end Step 4 Request a reservation request code which you will later enter in Cisco SSM For example license smart reservation request universal Enter this request code in the Cisco Smart Software licen...

Page 200: ...2 license smart reservation return auth code license smart reservation return license smart reservation return auth code In rare cases you can use this second form of the command when you input a value for the auth code This is useful when the current reservation status of the license was previously cleared for example after the license smart reservation cancel command was used to cancel a request...

Page 201: ...ation Status AUTHORIZED on Jul 08 20 46 05 2015 UTC Last Communication Attempt SUCCEEDED on Jul 08 20 46 05 2015 UTC Next Communication Attempt Aug 07 20 46 05 2015 UTC Communication Deadline Oct 06 05 59 43 2015 UTC License Usage CSR 1KV AX 500M ax_500M Description CSR 1KV AX 500M Count 1 Version 1 0 Status AUTHORIZED Product Information UDI PID CSR1000v SN 9Q0BWG3BHL0 Agent Version Smart Agent f...

Page 202: ...the Cisco CSR 1000v are passing an aggregated traffic level of 60 Mbps Because this exceeds the 50 Mbps license enforced maximum throughput 10 Mbps of traffic is discarded To check the license based performance limiter value use the following command for your interface Router show platform hardware qfp active feature qos queue out int GigabitEthernet1 hier det inc max orig_max 0 max 33333 child po...

Page 203: ... sample period 300 seconds in last 24 hours You can configure the QoS policies at the interface level to guarantee that high priority traffic is not dropped For more information see the Quality of Service Solutions Configuration Guide Library Cisco IOS XE Release 3S Managing Throughput Notifications Beginning with Cisco IOS XE 3 13S and including IOS XE Denali 16 3 1 and later you can configure th...

Page 204: ... To disable the platform hardware throughput monitor perform the following command set platform hardware throughput monitor disable 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 au...

Page 205: ...wing example displays the UDI history of the feature license Router show license udi history SlotID PID SN UDI CSR1000V 9MF19951DMU CSR1000V 9MF19951DMU Invalidated UDIs 1 CSR1000V 9YA3086B993 Cisco Software Licensing IOS XE 3 12 or Earlier Activating CSL Evaluation Licenses for Cisco IOS XE 3 12S and Earlier Licenses provided in Cisco IOS XE 3 12S and earlier Standard Advanced and Premium are no ...

Page 206: ...the next reload license boot level standard advanced premium Step 3 Example You must accept the End User License Agreement EULA to use the evaluation license In Cisco IOS XE 3 12 1S and later 3 12 xS releases use the standard option for the IPBase feature set the advanced option for the Security feature set and the premium option for the AX feature set Note Example Example Example Router config li...

Page 207: ...aluation license expires 60 days from the time it is activated Installing CSL Regular Licenses for Cisco IOS XE 3 12S and Earlier Licenses provided in Cisco IOS XE 3 12S and earlier Standard Advanced and Premium are no longer available This material is provided as legacy information Note In Cisco IOS XE 3 12S and earlier the Cisco CSR 1000v first boots in limited mode with the Standard feature set...

Page 208: ...icense Enables privileged EXEC mode enable Step 2 Example Router enable Enter your password if prompted Displays all the UDI values that can be licensed in a system show license udi Step 3 Example Router show license udi You need the UDI of the device as part of the process to obtain a license After entering the appropriate information you will receive an e mail containing the license information ...

Page 209: ...he standard option for the IPBase feature set the advanced option for the Security feature set and the premium option for the AX feature set Note Exits global configuration mode end Example Router config end Step 8 Saves the running configuration to NVRAM write memory Example Router write memory Step 9 Restarts the Cisco CSR 1000v to enable the feature set and the maximum throughput supported by t...

Page 210: ...hput level matches that of the installed license show platform hardware throughput level Example Router show platform hardware throughput level Step 16 Example The current throughput level is 50000 kb s What to Do Next Repeat these steps for each license available for your PAK The following is an example of the show license detail command showing an installed active license Router show license det...

Page 211: ...o CSR 1000v Series Cloud Services Router Overview on page 5 This procedure is for upgrading to a new software version of the Cisco CSR 1000v on the same VM only It does not describe how to install or rehost an existing CSR 1000v running the same or upgraded software version on a different VM The Cisco CSR 1000v does not support In Service Software Upgrade ISSU Note Cisco IOS XE Everest 16 5 and la...

Page 212: ...0v Memory requirements of the VM for the Cisco CSR 1000v software image If the new Cisco CSR 1000v version requires more memory than your previous version you must increase the memory allocation on the VM before beginning the upgrade process Note Software features supported on the upgraded Cisco IOS XE version Any upgrade restrictions Obtain the Cisco CSR 1000v software image from Cisco com See Ob...

Page 213: ...ash Step 3 Learn the name of the system image file Copies a file from bootflash memory to a server copy bootflash ftp rcp tftp Step 4 Example Router copy bootflash ftp Copy the system image file to a server This file can serve as a backup copy Enter the bootflash memory partition number if prompted Enter the filename and destination URL when prompted What to Do Next The following example shows the...

Page 214: ...ils 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 If you use TFTP Configure the TFTP application to operate as a TFTP server not a TFTP client Specify the outbound file directory to whi...

Page 215: ...ETAILED STEPS Step 1 enable Use this command to enter privileged EXEC mode Enter your password if prompted Example Router enable Password password Router Step 2 Use one of the following commands to copy a file from a server to bootflash memory copy tftp bootflash copy rcp bootflash Example Router copy tftp bootflash Step 3 When prompted enter the IP address of the TFTP or RCP server Example Addres...

Page 216: ...0 10 10 2 csr1000v universalk9 03 10 00 S 153 3 S ext SPA bin Erase bootflash before copying confirm y Erasing the flash filesystem will remove all files Continue confirm y Erasing device If you are not certain that all files in bootflash memory should be erased press Ctrl Z Step 7 If the error message does not appear enter no when prompted to erase the bootflash memory before copying Example Acce...

Page 217: ...nfig register 0x2102 12 exit 13 copy running config startup config 14 write memory 15 reload 16 When prompted to save the system configuration enter no 17 When prompted to confirm the reload enter y 18 show version DETAILED STEPS Step 1 dir bootflash Use this command to display a list of all files and directories in bootflash memory Example Router dir bootflash Directory of bootflash 3 rw 6458388 ...

Page 218: ... 00 S 153 3 S ext SPA bin Step 5 Optional Repeat the previous step to specify the order in which the router should attempt to load any backup system images Step 6 exit Use this command to exit global configuration mode Example Router config exit Router Step 7 write or write memory Example Router write memory This step is required beginning with Cisco IOS XE Release 3 9S if upgrading to a later ver...

Page 219: ...tep is not required Note Step 12 exit Use this command to exit global configuration mode Example Router config exit Router Step 13 copy running config startup config Use this command to copy the running configuration to the startup configuration Example Router copy running config startup config Step 14 write memory This step is required beginning with Cisco IOS XE Release 3 9S if upgrading to a la...

Page 220: ... EXEC mode SUMMARY STEPS 1 dir bootflash 2 configure terminal 3 boot system bootflash system image filename bin 4 do write 5 config register 0x0000 6 At the grub prompt enter ESC to access the GRUB menu 7 Select the bin file to upgrade the software image on the router to the new version 8 Press Enter to boot the selected image to begin the upgrade process DETAILED STEPS Step 1 dir bootflash Use th...

Page 221: ...lash disk Note Step 5 config register 0x0000 Use this command to enter GRUB mode The following shows an example of entering GRUB mode Example 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 fil...

Page 222: ...iguration file and the Cisco IOS software system image file on a server Do not erase any existing backup copies of your configuration and system image that you saved before upgrading your system image If you encounter serious problems using your new system image or startup configuration you can quickly revert to the previous working configuration and system image Tip To save backup copies of the s...

Page 223: ...figuration being copied to a TFTP server Router copy nvram startup config tftp Remote host 172 16 101 101 Name of configuration file to write rtr2 confg cr Write file rtr2 confg on host 172 16 101 101 confirm cr OK The following example uses the dir bootflash privileged EXEC command to obtain the name of the system image file and the copy bootflash tftp privileged EXEC command to copy the system i...

Page 224: ...opy of the new system image and configuration you need to reboot the VM See your VM vendor documentation for more information about rebooting the VM After rebooting the Cisco CSR 1000v VM should include the new system image with a newly installed Cisco IOS XE software version Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide 212 Upgrading the Cisco IOS XE Software Rebooting...

Page 225: ...Interfaces page 217 Mapping Cisco CSR 1000v Network Interfaces to VM Network Interfaces Mapping the Router Network Interfaces to vNICs The Cisco CSR 1000v maps the GigabitEthernet network interfaces to the logical virtual network interface card vNIC name assigned by the VM The VM in turn maps the logical vNIC name to a physical MAC address Cisco CSR 1000v Series Cloud Services Router Software Conf...

Page 226: ... platform software vnic if interface mapping command The display for this command is different depending on your Cisco IOS XE release version Note For Cisco IOS XE Release 3 11 or later the GigabitEthernet0 interface is no longer supported Router show platform software vnic if interface mapping Interface Name Short Name vNIC Name Mac Addr GigabitEthernet0 Gi0 eth0 vmxnet3 000c 2946 3f4d GigabitEth...

Page 227: ...is mapped to a MAC address on the VM host You can add or delete vNICs on the VM to add or delete GigabitEthernet interfaces on the Cisco CSR 1000v You can add vNICs while the router is active To delete a vNIC from the VM you must first power down the VM If you delete any vNICs the router must be rebooted For more information about adding and deleting vNICs see the VMware Documentation If you remov...

Page 228: ...the following steps on the original VM before cloning SUMMARY STEPS 1 Make sure the original VM includes the number of configured vNICs required on the cloned VM before beginning the cloning process 2 Enter the clear platform software vnic if nvtable command on the original VM 3 Reboot the Cisco CSR 1000v 4 On the cloned VM verify the interface mapping using the show platform software vnic if inte...

Page 229: ...hows an example where each Cisco CSR 1000v router interface is mapped to one host Ethernet interface Figure 7 Cisco CSR 1000v Interfaces Mapped to Individual ESXi Host Ethernet Interfaces Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide 217 Mapping Cisco CSR 1000v Network Interfaces to VM Network Interfaces Mapping Cisco CSR 1000v Network Interfaces with vSwitch Interfaces...

Page 230: ...net interface Figure 8 Cisco CSR 1000v Interfaces Sharing One ESXi Host Ethernet Interface Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide 218 Mapping Cisco CSR 1000v Network Interfaces to VM Network Interfaces Mapping Cisco CSR 1000v Network Interfaces with vSwitch Interfaces ...

Page 231: ... on the vSwitch Figure 9 Cisco CSR 1000v Interfaces Directly Mapped to vSwitch Trunk Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide 219 Mapping Cisco CSR 1000v Network Interfaces to VM Network Interfaces Mapping Cisco CSR 1000v Network Interfaces with vSwitch Interfaces ...

Page 232: ... CSR 1000v Series Cloud Services Router Software Configuration Guide 220 Mapping Cisco CSR 1000v Network Interfaces to VM Network Interfaces Mapping Cisco CSR 1000v Network Interfaces with vSwitch Interfaces ...

Page 233: ...configuration register in NVRAM Each bit has value 1 on or set or value 0 off or clear and each bit setting affects the router behavior upon the next reload power cycle The Cisco CSR 1000v GRUB mode supports a subset of configuration register options compared to ROMMON options on other Cisco routers You can use the configuration register to Force the router to boot into the GRUB bootstrap program ...

Page 234: ... Field Bits 3 2 1 and 0 At the next power cycle or reload the router boots to the GRUB bootstrap program In GRUB mode you must manually boot the system image or any other image by using the boot command 0000 0x0 At the next power cycle or reload the router sequentially processes each boot system command in global configuration mode that is stored in the configuration file until the system boots su...

Page 235: ...tions of a device filename ESC at any time exits to menu 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 If you enter a question mark at the grub prompt the system shows you the two options available ...

Page 236: ...RUB command mode You can also modify the configuration register setting from the Cisco IOS CLI by using the config register command in global configuration mode 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 Note SUMMARY STEPS 1 confreg value DETAILED STEPS Purpose Command or Action Chan...

Page 237: ...ster 0x0 enabled are boot the boot loader 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 g...

Page 238: ...egister settings enter the config register value command where value is a hexadecimal number preceded by 0x 6 Exit global configuration mode 7 Save the configuration changes to NVRAM DETAILED STEPS Step 1 Power on the router Step 2 If you are asked whether you would like to enter the initial dialog answer no Example Would you like to enter the initial dialog yes no After a few seconds the user EXE...

Page 239: ...ng the Configuration Register Settings To display the configuration register settings that are currently in effect and the settings that will be used at the next router reload enter the show version command in privileged EXEC mode The configuration register settings are displayed in the last line of the show version command output Configuration register is 0x142 will be 0x142 at next reload Cisco ...

Page 240: ...Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide 228 Accessing and Using GRUB Mode Displaying the Configuration Register Settings ...

Page 241: ... Home The Call Home feature provides email based and web based notification of critical system events A versatile range of message formats are available for optimal compatibility with pager services standard email or XML based automated parsing applications Common uses of this feature may include direct paging of a network support engineer email notification to a network operations center XML deli...

Page 242: ...age formats are available allowing for compatibility with pager services standard email or XML based automated parsing applications This feature can deliver alerts to multiple recipients which are Call Home destination profiles Each destination profile has configurable message formats and content categories A predefined destination profile is provided for sending alerts to the Cisco Smart Call Hom...

Page 243: ...ail address Your Cisco com username For detailed information on Smart Call Home see www cisco com go smartcallhome index html Anonymous Reporting Smart Call Home is a service capability included with many Cisco service contracts and helps you to resolve problems In addition information is gained from for example crash messages to help Cisco understand issues occurring in the field If you decide no...

Page 244: ... for Sending Call Home Messages on page 249 Specifying HTTP Proxy Server on page 249 Enabling AAA Authorization to Run IOS Commands for Call Home Messages on page 250 Configuring Syslog Throttling on page 251 Configuring Call Home Data Privacy on page 252 Sending Call Home Communications Manually on page 253 Configuring Smart Call Home Single Command To enable all Call Home basic configurations us...

Page 245: ...nt out If Call Home is enabled in full registration mode a Full Inventory message for full registration mode is sent For more information about what is sent in these messages see the Alert Group Trigger Events and Commands on page 268 Note Configuring and Enabling Smart Call Home For application and configuration information about the Cisco Smart Call Home service see the Smart Call Home User Guid...

Page 246: ...all home Step 2 Disables the Call Home feature no service call home Example Router config no service call home Step 3 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 ste...

Page 247: ...ntact email addr username example com Step 3 Optional Assigns your phone number phone number phone number Step 4 Example Router cfg call home phone number 1 800 555 4567 The number must begin with a plus prefix and may contain only dashes and numbers Enter up to 17 characters If you include spaces you must enclose your entry in quotes Note Optional Assigns your street address where RMA equipment c...

Page 248: ...ch profile to be used for Smart Licensing by enabling or disabling smart licensing data of that profile Only one active profile can have smart license data enabled For more information about Smart Licensing see Installing Cisco CSR 1000v Licenses on page 155 If you use the Cisco Smart Call Home service the destination profile must use the XML message format Note You can configure the following att...

Page 249: ...y to remain anonymous and no identifying information is sent Subscribing to interesting alert groups You can choose to subscribe to alert groups highlighting your interests This section contains the following subsections Creating a New Destination Profile To create and configure a new destination profile perform the following steps SUMMARY STEPS 1 configure terminal 2 call home 3 profile name 4 no...

Page 250: ...ess email myaddress example com Step 5 When entering a destination URL include either http or https depending on whether the server is a secure server Note Optional Configures a preferred message format The default is XML destination preferred msg format long text short text xml Example Router cfg call home profile destination preferred msg format xml Step 6 Optional Configures a maximum destinati...

Page 251: ...ep 12 Displays the Call Home Smart Licensing statistics show call home smart licensing statistics Step 13 Copying a Destination Profile To create a new destination profile by copying an existing profile perform the following steps SUMMARY STEPS 1 configure terminal 2 call home 3 copy profile source profile target profile DETAILED STEPS Purpose Command or Action Enters configuration mode configure ...

Page 252: ...erminal Example Router configure terminal Step 1 Enters Call Home configuration submode call home Example Router config call home Step 2 Enables profile configuration mode profile name Example Router cfg call home profile CiscoTAC 1 Step 3 Sets the profile to anonymous mode anonymous reporting only Step 4 Example Router cfg call home profile anonymous reporting only By default the profile sends a ...

Page 253: ... events for each alert group are listed in Alert Group Trigger Events and Commands on page 268 and the contents of the alert group messages are listed in Message Contents on page 270 You can select one or more alert groups to be received by a destination profile A Call Home alert is sent only to destination profiles that have subscribed to the alert group containing that Call Home alert In additio...

Page 254: ...all Home configuration submode call home Example Router config call home Step 2 Enables the specified alert group Use the keyword all to enable all alert groups By default all alert groups are enabled alert group all configuration environment inventory syslog crash snapshot Example Router cfg call home alert group all Step 3 Enters Call Home destination profile configuration submode for the specif...

Page 255: ... must enclose subscribe to alert group syslog severity major it in quotes You can specify up to five patterns for each destination profile 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 subscribe to alert group crash Example Router cfg call home profile subscribe to alert group crash Step 8 Subscr...

Page 256: ...ay in the format date hh mm Interval Specifies the interval at which the periodic message is sent from 1 to 60 minutes Hourly Specifies the minute of the hour at which the periodic message is sent from 0 to 59 minutes Hourly and by interval periodic notifications are available for the Snapshot alert group only Note Message Severity Threshold When you subscribe a destination profile to the Syslog a...

Page 257: ...ning 3 Basic notification and informational messages Possibly independently insignificant Notice 5 notification 2 Normal event signifying return to normal state Information 6 normal 1 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 co...

Page 258: ... and saves the configuration end Example Router cfg call home snapshot end Step 5 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 Note the following guidelines when configuring genera...

Page 259: ...e mail server stmp example com priority 1 Provide either of these The email server s IP address or The email server s fully qualified domain name FQDN of 64 characters or less Assign a priority number between 1 highest priority and 100 lowest priority 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 i...

Page 260: ...outer cfg call home vrf vpn1 Step 8 For HTTP messages if the source interface is associated with a VRF use the ip http client source interface interface name command in global configuration mode to specify the VRF instance that will be used for all HTTP clients on the device Note Example The following example shows the configuration of general email parameters including a primary and secondary ema...

Page 261: ...ll home Step 2 Specifies a limit on the number of messages sent per minute rate limit number Example Router cfg call home rate limit 40 Step 3 number Range is 1 to 60 The default is 20 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 addres...

Page 262: ...ion 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 aaa authorization username username DETAILED STEPS Purpose Command or Action Enters global configuration mode configure terminal Example Router con...

Page 263: ...rname is callhome Maximum length is 64 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 Purpose Command or Action Enters configuration mode configure terminal Example Router configure terminal S...

Page 264: ...ig all and show startup config data SUMMARY STEPS 1 configure terminal 2 call home 3 data privacy level normal high hostname DETAILED STEPS Purpose Command or Action Enters configuration mode configure terminal Example Router configure terminal Step 1 Enters the Call Home configuration submode call home Example Router config call home Step 2 Scrubs data from running configuration file to protect t...

Page 265: ...orm the following step SUMMARY STEPS 1 call home test test message profile name DETAILED STEPS Purpose Command or Action Sends a test message to the specified destination profile The user defined test message text is optional but must be enclosed in quotes if it call home test test message profile name Example Router call home test profile profile1 Step 1 contains spaces If no user defined message...

Page 266: ...nation profile if specifed or to all subscribed destination profiles call home send alert group snapshot profile name Example Router call home send alert group snapshot profile profile1 Step 1 Sends a crash alert group message to one destination profile if specified or to all subscribed destination profiles call home send alert group crash profile name Example Router call home send alert group cra...

Page 267: ...actices as related to the current running configuration bugs list Known bugs in the running version and in the currently applied features command reference Reference links to all commands in the running configuration product advisory Product Security Incident Response Team PSIRT notices End of Life EOL or End of Sales EOS notices or field notices FN that may affect devices in your network To submi...

Page 268: ... required for both long text and XML message formats and is provided in the subject line of the email If the HTTP option is specified the CiscoTAC 1 profile destination HTTP or HTTPS URL is used as the destination The destination email address can be specified so that Smart Call Home can forward the message to the email address The user must specify either the destination email address or an SR nu...

Page 269: ...il address is not specified Configuring Diagnostic Signatures Configuring Diagnostic Signatures The Diagnostic Signatures feature downloads digitally signed signatures to devices Diagnostic Signatures DS files are formatted files that collate knowledge of diagnostic events and provide methods to troubleshoot them without a need to upgrade the Cisco software The aim of DS is to deliver flexible int...

Page 270: ...nature that specifies new events in the event register line and additional action in the Tcl script Combination of both the formats above The following basic information is contained in a DS file ID unique number unique key that represents a DS file that can be used to search a DS Name ShortDescription unique description of the DS file that can be used in lists for selection Description long descr...

Page 271: ...eriodic download or by on demand forced download 3 The device verifies the digital signature of every single DS If verification passes the device stores the DS file into a non removable disk such as bootflash or hard disk so that DS files can be read after the device is reloaded On the Cisco CSR 1000v the DS file is stored in the bootflash call home directory 4 The device continues sending periodi...

Page 272: ...riable gets resolved Prompt variable values assigned manually by using the call home diagnostic signature install ds id command in privileged EXEC mode If you do not set this value the status of the DS indicates pending Regular expression variable values assigned from a regular expression pattern match with predefined CLI command outputs The value is assigned during the DS run Syslog event variabl...

Page 273: ...Home settings call home Example Router config call home Step 3 Optional Assigns an email address to be used for Call Home customer contact contact email addr email address Example Router cfg call home contact email addr userid example com Step 4 Optional Configures a Simple Mail Transfer Protocol SMTP email server address for Call mail server ipv4 addr name priority number Example Router cfg call ...

Page 274: ...iguration mode exit Example Router cfg call home profile exit Step 10 What to Do Next What to Do Next Set the profile configured in the previous procedure as the DS profile and configure other DS parameters Configuring Diagnostic Signatures The Diagnostic Signatures feature downloads digitally signed signatures to devices Diagnostic Signatures DS files are formatted files that collate knowledge of...

Page 275: ...ature settings Diagnostic signature enabled Profile user1 status ACTIVE Environment variable ds_env1 abc Downloaded DSes DS ID DS Name Revision Status Last Update GMT 00 00 6015 CronInterval 1 0 registered 2013 01 16 04 49 52 6030 ActCH 1 0 registered 2013 01 16 06 10 22 6032 MultiEvents 1 0 registered 2013 01 16 06 10 37 6033 PureTCL 1 0 registered 2013 01 16 06 11 48 Displaying Call Home Configu...

Page 276: ... show call home statistics Step 6 Examples Examples 1 to 7 show sample output when using different options of the show call home command Call Home Information in Summary Router show call home Current call home settings call home feature enable call home message s from address router example com call home message s reply to address support example com vrf for call home messages Not yet set up conta...

Page 277: ...site ID SantaClara source ip address Not yet set up source interface GigabitEthernet1 Mail server 1 Address 192 168 2 1 Priority 1 Mail server 2 Address 209 165 254 254 Priority 2 http proxy 192 168 1 1 80 aaa authorization disable aaa authorization username callhome default data privacy normal syslog throttling enable Rate limit 20 message s per minute Snapshot command 0 show version Snapshot com...

Page 278: ...s 192 168 2 1 Priority 1 Not Available Mail server 2 Address 209 165 254 254 Priority 2 Available Information for All Destination Profiles Router show call home profile all Profile Name campus noc Profile status ACTIVE Preferred Message Format xml Message Size Limit 3145728 Bytes Transport Method email Email address es noc example com HTTP address es Not yet set up Alert group Severity configurati...

Page 279: ...P Total Success 3 3 0 Config 3 3 0 Crash 0 0 0 Inventory 0 0 0 Snapshot 0 0 0 SysLog 0 0 0 Test 0 0 0 Request 0 0 0 Send CLI 0 0 0 Total In Queue 0 0 0 Config 0 0 0 Crash 0 0 0 Inventory 0 0 0 Snapshot 0 0 0 SysLog 0 0 0 Test 0 0 0 Request 0 0 0 Send CLI 0 0 0 Total Failed 0 0 0 Config 0 0 0 Crash 0 0 0 Inventory 0 0 0 Snapshot 0 0 0 SysLog 0 0 0 Test 0 0 0 Request 0 0 0 Send CLI 0 0 0 Total Ratel...

Page 280: ...horization Enabled Call Home syslog message throttling Normal Data privacy level Alert Group Trigger Events and Commands Call Home trigger events are grouped into alert groups with each alert group assigned commands to execute when an event occurs The command output is included in the transmitted message Table 35 Call Home Alert Groups Events and Actions on page 269 lists the trigger events includ...

Page 281: ...st for configuration or configuration change event Commands executed show platform show running config all show startup config show version Configuration User generated request for inventory event Commands executed show diag all eeprom detail include MAC show license all show platform show platform hardware qfp active infrastructure chipset 0 capabilities show platform software vnic if interface m...

Page 282: ...tion in XML Format on page 273 Table 36 Format for a Short Text Message Description Data Item Configured device name Device identification Time stamp of the triggering event Date time stamp Plain English description of triggering event Error isolation message Error level such as that applied to a system message Alarm urgency level Table 37 Common Fields for All Long Text and XML Messages Call Home...

Page 283: ...onspecific to a fabric switch The format is type Sid seria l type is the product model number from backplane IDPROM is a separator character Sid is C identifying the serial ID as a chassis serial number serial is the number identified by the Sid field Example CISCO3845 C 12345678 Device ID CallHome CustomerData ContractData CustomerId Optional user configurable field used for contract information ...

Page 284: ...on identified as contact for this unit Contact email CallHome CustomerData SystemInfo ContactPhoneNumber Phone number of the person identified as the contact for this unit Contact phone number CallHome CustomerData SystemInfo StreetAddress Optional field containing street address for RMA part shipments associated with this unit Street address CallHome Device Cisco_Chassis Model Model name of the r...

Page 285: ...ce uri aml session From aml session MessageId M8 9S1NMSF22DW 51AEAC68 aml session MessageId aml session Session soap env Header soap env Body aml block Block xmlns aml block http www cisco com 2004 01 aml block aml block Header aml block Type http www cisco com 2005 05 callhome syslog aml block Type aml block CreationDate 2013 06 05 03 11 36 GMT 00 00 aml block CreationDate aml block Builder aml b...

Page 286: ...wardAddress value rme AdditionalInformation rme Chassis ch Device ch CallHome aml block Content aml block Attachments aml block Attachment type inline aml block Name show logging aml block Name aml block Data encoding plain CDATA show logging Syslog logging enabled 0 messages dropped 1 messages rate limited 0 flushes 0 overruns xml disabled filtering disabled No Active Message Discriminator No Ina...

Page 287: ...the Cisco CSR 1000v OVA template support for REST API is configured in the Bootstrap Properties screen of the OVA Wizard The required fields are different depending on the Cisco IOS XE release The tables below list the fields required to enable REST API support when deploying the OVA template For more information on deploying the OVA template see Deploying the Cisco CSR 1000v OVA to the VM on page...

Page 288: ...ress 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 Remote Management IPv4 Address not used if configuring the shared management interface to support REST API Table 41 Cisco CSR 1000v OVA Template Bootstrap Properties Required for REST API Support Cisco IOS XE Release 3 10S Description Pr...

Page 289: ...S XE 3 13S and later and IOS XE Denali 16 3 and later The router management interface and the virtual services management container can share the same IP address This can be used to save an IP address to be allocated for other purposes Configuring the Dual Management Interface to Support the REST API on page 281 Required in Cisco IOS XE 3 11S and 3 12S optional in later releases The router managem...

Page 290: ...er configure terminal Step 2 Enters remote management configuration mode remote management Example router config remote management Step 3 Enables support for the REST API restful api Example router cfg remote mgmt restful api Step 4 Exits remote management configuration mode and enters configuration mode end Example router cfg remote mgmt end Step 5 Cisco CSR 1000v Series Cloud Services Router Sof...

Page 291: ...onfiguration mode configure terminal Example Router configure terminal Step 2 Enters interface configuration mode for the management interface interface mgmt interface Example Router config interface gigabitethernet1 Step 3 Configures the IP address for the management interface ip address mgmt ipv4 addr subnet mask Example Router config if ip address 172 25 29 235 255 255 255 128 Step 4 Enables th...

Page 292: ...Maps the virtual service container to the management interface ip shared host interface mgmt interface Example router config virt serv ip shared host interface gigabitethernet 1 Step 9 Activates the csr_mgmt virtual services container activate Example router config virt serv activate Step 10 Exits virtual services configuration mode and enters global configuration mode end Example router config vi...

Page 293: ...subnetmask virtualportgroup virtualportgroupnumber DETAILED STEPS Purpose Command or Action Enables privileged EXEC mode enable Step 1 Example Router enable Enter your password if prompted Enters global configuration mode configure terminal Example Router configure terminal Step 2 Enters interface configuration mode for the interface designated by x interface GigabitEthernetx Example Router config...

Page 294: ... GigabitEthernetx Example router config if ip unnumbered gigabitethernet1 Step 8 Enables the virtual port group interface no shutdown Example router config if no shutdown Step 9 Exits virtual port group interface mode exit Example router config if exit Step 10 Configures the csr_mgmt virtual services container and enters virtual services configuration mode virtual service csr_mgmt Example router c...

Page 295: ...IP address that was configured using the guest ip address command ip route ipaddress subnetmask virtualportgroup virtualportgroupnumber Example router config ip route 172 25 29 236 255 255 255 255 VirtualPortGroup0 Step 16 Configuring the REST API Local Port and AutoSave Options Beginning with Cisco IOS XE 3 13S you can configure the REST API local port and autosave options SUMMARY STEPS 1 remote ...

Page 296: ...ST API requires HTTPS server support Beginning with Cisco IOS XE Release 3 11S HTTPS server support is enabled by default and no additional configuration is required However if using Cisco IOS XE Release 3 10S you must manually configure HTTPS support for the REST API in the following situations If you did not specify the Enable HTTPS Server option when deploying the OVA If you installed the Cisco...

Page 297: ...ansport map type persistent webui https webui Step 4 Enables the secure HTTPS server secure server Example router config secure server Step 5 Enables the transport map to support HTTPS transport type persistent webui input transport map name Example router config transport type persistent webui input https webui Step 6 Disabling REST API Support Beginning with Cisco IOS XE Release 3 11S and includ...

Page 298: ...e router config remote management Step 3 Disables support for the REST API no restful api Example router cfg remote mgmt no restful api Step 4 Exits remote management configuration mode and enters configuration mode end Example router cfg remote mgmt end Step 5 What to Do Next When REST API support is disabled using the no restful api command the REST API PUT POST and DELETE operations are disable...

Page 299: ... 0 1 1 0 climgr UP 0Y 0W 0D 0 1 1 0 restful_api UP 0Y 0W 0D 0 1 1 0 fcgicpa UP 0Y 0W 0D 0 0 13 0 pnscag UP 0Y 0W 0D 0 0 13 0 pnscdme UP 0Y 0W 0D 0 0 12 0 Feature Status Configuration Restful API Enabled UP port 443 GET only auto save timer 8 seconds socket unix usr local nginx csrapi fcgi sock PNSC Enabled UP host 172 25 223 233 port 8443 socket unix usr local cpa fcgi sock Network stats eth0 RX p...

Page 300: ... Mask Next Hop Intf 0 0 0 0 0 172 25 223 137 eth1 Resource admission without profile passed Disk space 540MB Memory 512MB CPU 30 system CPU VCPUs Not specified Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide 288 Enabling Management by REST API Viewing the REST API Container Status ...

Page 301: ...onfiguring the Management Interface to Support Remote Management by the Cisco Prime Network Services Controller The Cisco Prime Network Services Controller is unsupported using Cisco IOS XE Denali 16 3 1 or later on the Cisco CSR 1000v Note Cisco IOS XE Denali 16 3 or earlier You can use the Cisco Prime Network Services Controller to provision manage and monitor the Cisco CSR 1000v This procedure ...

Page 302: ...XEC mode enable Step 1 Example Router enable Enter your password if prompted Enters global configuration mode configure terminal Example Router configure terminal Step 2 Enters interface configuration mode for the management interface interface mgmt interface Example Router config interface gig1 Step 3 Configures the IP address for the management interface ip address mgmt ipv4 addr subnet mask Exa...

Page 303: ...outer config if no shutdown Step 9 Exits virtual port group interface mode exit Example Router config if exit Step 10 Configures the csr_mgmt virtual services container and enters virtual services configuration mode virtual service csr_mgmt Example Router config virtual service csr_mgmt Step 11 Creates a vNIC gateway interface for the virtual services container and maps the vNIC gateway interface ...

Page 304: ...oup number Example Router config ip route 172 25 29 236 255 255 255 255 VirtualPortGroup0 Step 17 Enabling Remote Management by the Cisco Prime Network Services Controller Host The Cisco Prime Network Services Controller is unsupported using Cisco IOS XE Denali 16 3 1 or later on the Cisco CSR 1000v Note The Cisco Prime Network Services Controller control point agent CPA is used to manage the inte...

Page 305: ...emote management configuration mode remote management Example Router config remote management Step 3 Enables remote management by Cisco Prime Network Services Controller and sets up the access to the Cisco Prime Network Services Controller host pnsc host ipv4 addr local port number shared secret string Example Router cfg remote mgmt pnsc host Step 4 The ipvr address represents the IP address of th...

Page 306: ...management status Example Router show remote management status RESTful API enabled https port 443 PNSC CPA enabled Host 172 27 208125 port 8443 shared secret Step 6 What to Do Next Once remote management by Cisco Prime Network Services Controller is enabled the following warning is displayed when entering the Cisco IOS XE CLI mode directly on the router WARNING This device is managed by Prime Netw...

Page 307: ...g remote management Step 3 Disables remote management by Cisco Prime Network Services Controller no pnsc host ipv4 addr local port number shared secret string Step 4 Example Router cfg remote mgmt no pnsc host When remote management by Cisco Prime Network Services Controller is disabled using this command the REST API PUT POST and DELETE operations are enabled Note 172 25 29 234 local port 8443 sh...

Page 308: ...tus RESTful API enabled https port 443 PNSC CPA disabled Host 172 27 208 125 port 8443 shared secret Step 6 Cisco CSR 1000v Series Cloud Services Router Software Configuration Guide 296 Configuring Support for Remote Management by the Cisco Prime Network Services Controller Disabling Remote Management by the Cisco Prime Network Services Controller Host ...

Page 309: ... Verify that the I O devices for example FC iSCSI SAS being used are supported by the VM vendor Verify that sufficient RAM is allocated on the server for the VMs and the hypervisor host If using VMware make sure the server has enough RAM to support both the VMs and VMware ESXi Verify the hypervisor version is supported by the Cisco CSR 1000v Verify that the correct VM settings for the amount of me...

Page 310: ...h settings For more information see the VMware vSwitch documentation ESXi 5 0 supports a maximum MTU size of 9000 even if jumbo frames are enabled on the router Note The Cisco CSR 1000v does not support memory sharing between VMs On the ESXi host check the memory counters to find out how much used memory and shared memory is on the VM Verify that the balloon and swap used counters are zero If a gi...

Page 311: ... 1000v If you have subscription term licenses installed you must contact licensing cisco com for assistance Note SUMMARY STEPS 1 Access the Cisco Software Licensing portal at the following URL https tools cisco com SWIFT LicensingUI Home 2 Click Continue to Product License Registration 3 On the Product License Registration page choose Transfer License for Transfer Initiate 4 Specify the Source Lic...

Page 312: ...he original node locked UDI is invalidated on the router Use the show license udi history command to obtain the node locked UDI for your license that is stored in the Cisco Software Licensing Tool records You can also verify the original node locked UDI with the Cisco email confirmation you received when the license was purchased Note Click Next Figure 11 Source Rehost License Cisco CSR 1000v Seri...

Page 313: ...lure may include The VM instance that the Cisco CSR 1000v was installed on was removed The system server or host that the Cisco CSR 1000v VM instance was installed on experienced a hardware failure In this case you need to obtain a rehost license and install it on a new VM If you have a perpetual license you can use the self service rehosting process in the Cisco Software Licensing portal to obtai...

Page 314: ...ou will need to provide the PAK number from the original license purchase 4 If you changed the virtual UDI on the Cisco CSR 1000v using the request license new udi command and the VM is lost due to a system failure the installed licenses will be destroyed You must contact Cisco for assistance You will need to the provide the PAK number from the original license purchase For information about licen...

Reviews:

No comments

Related manuals for CSR 1000v Series

Brand: ABB Pages: 66

Network Card-MS

Brand: Eaton Pages: 89

Parallel & Serial Port Checker PPC

Brand: B&B Electronics Pages: 4

LinkSmart KW6515

Brand: Kasda Pages: 31

Brand: IDT Pages: 292

PacketMate 1000

Brand: General DataComm Pages: 20

Brand: Edimax Pages: 15

Brand: ActionTec MI424WR Pages: 3

Brand: Erbauer Pages: 36

Brand: TRENDnet Pages: 68

Brand: Axis Pages: 30

Brand: Zapp Pages: 24

Brand: Billion Pages: 2

Brand: Cambium Networks Pages: 292

Brand: Johnson Controls Pages: 10

Brand: Honeywell Pages: 20

Brand: Honeywell Pages: 8

Brand: Honeywell Pages: 2

Brands by name

0 1 2 3 4 5 6 7 8 9 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Popular brands

Load more brands