12-42 | Cisco Systems CSR 1000V guide

Chapter 12 Configuring Call Home for the Cisco CSR 1000V

Displaying Call Home Configuration Information

Alert-group	Severity
------------------------	------------
configuration	normal
crash	normal
inventory	normal
Syslog-Pattern	Severity
------------------------	------------
.CALL_LOOP.	debug

Profile Name: CiscoTAC-1 Profile status: INACTIVE Profile mode: Full Reporting Preferred Message Format: xml Message Size Limit: 3145728 Bytes Transport Method: email

Email address(es): callhome@cisco.com

HTTP address(es): https://tools.cisco.com/its/service/oddce/services/DDCEService

Periodic configuration info message is scheduled every 14 day of the month at 11:12

Periodic inventory info message is scheduled every 14 day of the month at 10:57

Alert-groupSeverity

------------------------ ------------

crashnormal

Syslog-PatternSeverity

------------------------ ------------

.*CALL_LOOP.*debug

Example 6 Information for a User-Defined Destination Profile

Router# show call-home profile campus-noc

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
------------------------	------------
configuration	normal
crash	normal
inventory	normal
Syslog-Pattern	Severity
------------------------	------------
.CALL_LOOP.	debug

	Cisco CSR 1000V Series Cloud Services Router Software Configuration Guide
12-42	OL-27477-07

Image 174

Contents

Cisco Systems, Inc Copyright 2012-2014 Cisco Systems, Inc. All rights reserved N T E N T S Iii ESXi Prerequisites Upgrading the Cisco IOS XE Software Periodic Notification Vii Viii 13-2 Preface Objectives Document Revision History Release Date Change Summary Organization Chapter Title Description Convention Description Related DocumentationDocument Conventions Or Ctrl Examples use the following conventions Square brackets enclose default responses to system promptsWithin an optional element Processes OL-27477-07 Cisco CSR 1000V Series Cloud Services Router Overview Introduction Cisco CSR 1000V Virtual Form Factor Virtual Machine Requirements Router Interfaces Virtual Machines Hypervisor Support Hypervisor vNIC Requirements VMware Citrix Kernel Based VirtualESXi XenServer Machine KVM Microsoft Hyper-V NIC Types Supported Cisco IOS XE Release 10S, 3.11S 12SVMware ESXi Citrix XenServer Cisco CSR 1000V and Hypervisor Limitations VMXNET3, VIF and Virtio NIC types are para-virtualized NICs Cisco CSR 1000V Series Software License Overview Server RequirementsIntel Cisco CSR 1000V Version License Type License Term OL-27477-07 OL-27477-07 Feature Cisco ASR 1000 Series Cisco CSR 1000V Series Gigabit Ethernet x ports only When using the Rest API to manage the Cisco CSR Supported Cisco IOS XE Technologies GRE XE Release Technologies Required for XE Release Technologies Required for See the FollowingSupported Cisco CSR Licenses Supported Documentation Services Network ManagementQoS AAA Waas Management Support Managing the Router Using Cisco Configuration ProfessionalManaging the Router Using the Cisco CSR 1000V Rest API Cisco CSR 1000V supports the following management options Related Cisco Product Compatibility Cisco Unified Computing System UCS Products Using Cisco Feature Navigator Using the Software Advisor Cisco IOS XE Release 3.9S/3.10S/3.11S/3.12S Using the Software Release Notes OL-27477-07 Using Keyboard Shortcuts Using the History Buffer to Recall CommandsKeystrokes Purpose Understanding the Command Modes Command PurposeCommand Mode Access Method Prompt Exit Method Finding Command Options Getting Help Command Comment Enter the configure terminalUsing the interface GigabitEthernet Enter the command that you want to Interface configuration commandsConfiguration commands Configure for the interface. This Using the no and default Forms of Commands Saving Configuration Changes Managing Configuration Files This task saves the configuration to NvramExample 1 Copying a Startup Configuration File to Bootflash Filtering the Output of show and more Commands Powering Off the Cisco CSRNvram File Security Installation Overview Cisco CSR 1000V software can install and boot Cisco CSR 1000V Installation Task Workflow Cisco CSR 1000V Installation Files Cisco CSR 1000V Installation OptionsObtaining the Cisco CSR 1000V Software Microsoft Installation Option VMware ESXi Citrix XenServerGuidelines and Limitations Hyper-V Where to Go Next Rommon and the Cisco CSR OL-27477-07 Installing the Cisco CSR 1000V in VMware ESXi Environments VMware ESXi Support Information Supported vSwitch Cisco CSR 1000V Version2lists the virtual machine requirements for the Cisco CSR GB of RAM GB virtual diskVirtual CPUs Or more virtual network interface cards Supported VMware Features and Operations Virtual CPUs, requiring 2.5 GB minimum of RAM Suspend See the following table for more information Supported VMware Features and Operations Networking Features Supported VMware Features and Operations High Availability Client Installation Requirements for VMware ESXi GB RAM Allocation VCPUs Requires MinimumAllocation VCPUs Requires Minimum Deploying the Cisco CSR 1000V OVA Template to the VM Deploying the OVA Template to the VM OL-27477-07 Property Description Enable SCP Server Enables the IOS SCP feature Property Description Command Name Parameters Description Tar xvf file.ova bdeo.sh README-BDEO.txt Pw -password Cisco CSR 1000V Cloud Services RouterEnters the ESXi login username Enters the ESXi login password Enters the Cisco IOS XE IOS password required for LoginIpw -iospassword Remote login Choose vApp Options Properties See Figure Adding Custom Properties for the Cisco CSR Choose vApp Options Advanced Edit Property Settings Window Example of Custom Property Added Power on the VM to boot the Cisco CSR Optional Installing the Cisco CSR 1000V in VMware ESXi Environments Click OK Click Finish Increasing Performance on VMWare ESXi Configurations OL-27477-07 Citrix XenServer Support Information Installation Requirements for Citrix XenServer Requirements Cisco IOS XE 3.10S 12SPage Click Finish Kernel Virtual Machine Support Information KVM Support on OpenStack Installation Requirements for KVM Requirements Release 3.10S 11S 12S Installing the Cisco CSR 1000V in KVM Environments Choose Application System Tools Click Advanced options Creating the Instance Using the KVM Command Creating the Instance Using the OpenStack Command Line Tool Nova flavor-create csrflavor 6 4096 0 Creating the Instance Using the OpenStack Dashboard Increasing Performance on KVM Configurations Virsh nodeinfoVirsh vcpupin csr1000v 1 Modprobe vhost-net For more information, see the KVM documentation OL-27477-07 Microsoft Hyper-V Support Information Installation Requirements for Microsoft Hyper-V 1lists the installation requirements for Microsoft HyperVMicrosoft Hyper-V Requirements Cisco IOS XE 3.12S Configuring the Server Manager Settings PrerequisitesCreating the VM Configuring the VM Settings Click Specify Name and Location Select Network Adapter and click Add Launching the VM to Boot the Cisco CSR Booting the Cisco CSR 1000V and Accessing the Console Booting the Cisco CSR 1000V as the VM OL-27477-07 Accessing the Cisco CSR 1000V Console Accessing the Cisco CSR 1000V Through the VM Console Creating Serial Console Access in VMware ESXi Click the Configuration tab and click Security Profile Creating the Serial Console Access in KVM Creating the Serial Console Access in Microsoft Hyper-VClick on Add Hardware Changing the Console Port Access After Installation Command or Action PurposeExample Router# copy systemrunning-config Nvramstartup-config End Exits configuration mode ExampleRouterconfig# end Reload Reloads the operating system OL-27477-07 Prerequisites for the Software Upgrade Process Upgrading the Cisco IOS XE Software Configuration file copy can serve as a backup copy Copy nvramstartup-config ftp rcp tftpCopies the startup configuration file to a server Enter the destination URL when prompted Dir bootflash Copy bootflash ftp rcp tftp Copy tftp bootflash or Copy rcp bootflash Router# copy tftp bootflash Loading the New System Image Use this command to enter global configuration modeNo boot system Loading the New System Image from the Cisco IOS XE Software Exit Write Copy running-config startup-configExit Write memory Loading the New System Image from Grub Mode Config-registerDo write Do write memory Enter the letter c Upgrading the Cisco IOS XE Software System Configuration file copy serves as a backup copyBackup copy Write down the name of the system image file Rebooting the Cisco CSR OL-27477-07 10-1 10-2 Router# show platform software vnic-if interface-mapping Adding and Deleting Network Interfaces on the Cisco CSR 10-3 Cisco CSR 1000V Network Interfaces and VM Cloning 10-4Csr1000v# show platform software vnic-if interface-mapping 10-5 VMware ESXi 10-6 Vlan Cisco CSR 1000V Interfaces Directly Mapped to vSwitch Trunk 10-7 10-8 About Grub Mode and the Configuration Register Bit Number Hexadecimal Meaning11-1 Enable Config-register Accessing Grub ModeBoot Field 11-2 Using the Grub Menu Modifying the Configuration Register confreg11-3 Confreg value 11-4 11-5 Changing the Configuration Register Settings Displaying the Configuration Register Settings11-6 Prerequisites for Call Home 12-1 Benefits of Using Call Home Information About Call Home12-2 Obtaining Smart Call Home Services Anonymous Reporting12-3 Following sections show detailed or optional configurations How to Configure Call HomeConfiguring Smart Call Home Single Command 12-4 Mode using the call-home reporting Call-home reporting anonymous contact-email-addr12-5 Enabling and Disabling Call Home Configuring and Enabling Smart Call HomeConfigure terminal Service call-home No service call-home 12-6 Configuring Contact Information Phone-number + phone-number12-7 Configuring Destination Profiles Example12-8 Creating a New Destination Profile 12-9 Destination preferred-msg-format long-text No destination transport-method email httpDestination address email email-address http url Short-text xml Configure terminal Call-home Copying a Destination Profile12-11 Anonymous-reporting-only is set, only crash Setting Profiles to Anonymous ModeCall -home 12-12 Subscribing to Alert Groups 12-13 12-14 Hhmm hourly mm interval mm monthly date Periodic NotificationSubscribe-to-alert-group snapshot periodic daily 12-15 Message Severity Threshold Level Keyword Syslog Level Description12-16 Configuring Snapshot Command List 12-17 Configuring General email Options Priority number12-18 Command or Action Purpose 12-19 Configure terminal Call-home Rate-limit number Specifying Rate Limit for Sending Call Home Messages12-20 Specifying Http Proxy Server Specifies the proxy server for the Http request12-21 12-22 Configuring Syslog Throttling Configure terminal Call-home No syslog-throttling12-23 Configuring Call Home Data Privacy Hostname command12-24 Call-home test test-messageprofile name Sending Call Home Communications ManuallySending a Call Home Test Message Manually Call-home test test-message profile name Call-home send alert-group snapshot profile name Call-home send alert-group configuration profileSending Call Home Alert Group Messages Manually 12-26 Submitting Call Home Analysis and Report Requests 12-27 Example 12-28 12-29 Information About Diagnostic Signatures Configuring Diagnostic SignaturesPrerequisites for Diagnostic Signatures 12-30 Diagnostic Signatures Overview Diagnostic Signature Downloading12-31 Diagnostic Signature Event Detection Diagnostic Signature WorkflowDiagnostic Signature Events and Actions 12-32 Diagnostic Signature Actions Diagnostic Signature Variables12-33 How to Configure Diagnostic Signatures Configuring the Call Home Service for Diagnostic Signatures12-34 Mail-server ipv4-addr name priority number Destination transport-method email http12-35 What to Do Next Configuring Diagnostic SignaturesCall-home Diagnostic-signature Before You Begin Configuration Examples for Diagnostic Signatures Router# configure terminal Routerconfig# service call-home12-37 Displaying Call Home Configuration Information Show call-home12-38 Examples All destination profiles12-39 12-40 Example 2 Call Home Information in Detail 12-41 Callloop 12-42 Router# show call-home profile campus-noc 12-43 Example Call Home Statistics Parameters Default Default SettingsAlert Group Trigger Events and Commands 12-44 Message Contents Type is the product model number from backplane Data Item Description Call-Home Message TagPlain Text and XML XML Only 12-46 12-47 Sample Syslog Alert Notification in XML Format 12-48 12-49 12-50 Activating Cisco CSR 1000V Licenses 13-1 License Upgrade and Downgrade Scenarios 13-2 Managing the Throughput Level Licenses 13-3 Changing the Maximum Throughput Level 13-4 Platform hardware throughput level Platform hardware throughput level MB10 100 1000 250 2500 50 500 10000 25000 50000 eval-only License-Based Restriction on Aggregate Bandwidth 13-6 58757880 13-7Input Output 13-8 Requesting a New Virtual UDIRequest license new-udi Router# show license udi history Rest API 14-1 14-2 Enabling Rest API Support Using the Cisco IOS XE CLI Enable Configure terminal14-3 Interface virtualportgroup virtualportgroup-number ActivateNo shutdown 14-4 14-5 14-6 Enters remote-management configuration mode Enables the secure Https serverEnables the transport map to support Https Disabling Rest API Support Router# show virtual-service detail Disables support for the Rest APIExits remote-management configuration mode Viewing the Rest API Container Status 14-9 Pnsc 14-10 No shutdown Exit Virtual-service csrmgmt No shutdown Exit15-1 Interface virtualportgroup Enables IP processing on an interface withoutActivate End Assigning it an explicit IP address Ip route ip-addresssubnet-maskvirtualportgroup 15-3 15-4 To the Cisco Prime Network Services Controller Host Http port command15-5 Settings Exits configuration mode and enters privilegedExec mode Displays the Cisco CSR 1000V remote management No pnsc host ipv4-addrlocal-port number shared-secret 15-7 15-8 Troubleshooting Cisco CSR 1000V VM Issues 16-1 Troubleshooting Network Connectivity Issues Troubleshooting VM Performance Issues16-2 Voluntarily Rehosting the License to a New VM Click Continue to Product License Registration Figure A-1 License to Initiate-Transfer Screen Figure A-3 License Rehost Target and Options Obtaining a Rehost License if the System Fails Aaa-authorization call-home Command modes, understanding Call-home reporting commandCommands Call-home request command Call-home send alert-group command Active call-home IN-2 IN-3 IN-4 IN-5 IN-6