How to Configure Call Home, 12-4 | Cisco Systems CSR 1000V instruction

Chapter 12 Configuring Call Home for the Cisco CSR 1000V

How to Configure Call Home

How to Configure Call Home

The following section shows how you can configure Call Home using a single command:

•Configuring Smart Call Home (Single Command)

•Configuring and Enabling Smart Call Home

The following sections show detailed or optional configurations:

•Enabling and Disabling Call Home

•Configuring Contact Information

•Configuring Destination Profiles

•Subscribing to Alert Groups

•Configuring General email Options

•Specifying Rate Limit for Sending Call Home Messages

•Specifying HTTP Proxy Server

•Enabling AAA Authorization to Run IOS Commands for Call Home Messages

•Configuring Syslog Throttling

•Configuring Call Home Data Privacy

•Sending Call Home Communications Manually

Configuring Smart Call Home (Single Command)

To enable all Call Home basic configurations using a single command, perform the following steps:

SUMMARY STEPS

1.configure terminal

2.call-home reporting {anonymous contact-email-addr email-address}[http-proxy {ipv4-addressipv6-addressname} port port-number]

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

Image 136

Cisco Systems CSR 1000V manual How to Configure Call Home, Configuring Smart Call Home Single Command, 12-4

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 Related Documentation Document ConventionsConvention Description Or Ctrl Square brackets enclose default responses to system prompts Within an optional elementExamples use the following conventions 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 VMware Citrix Kernel Based Virtual Hypervisor vNIC RequirementsESXi XenServer Machine KVM Microsoft Hyper-V Cisco IOS XE Release 10S, 3.11S 12S VMware ESXiNIC Types Supported Citrix XenServer Cisco CSR 1000V and Hypervisor Limitations VMXNET3, VIF and Virtio NIC types are para-virtualized NICs Server Requirements Cisco CSR 1000V Series Software License OverviewIntel 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 See the Following XE Release Technologies Required forSupported Cisco CSR Licenses Supported Documentation Network Management ServicesQoS AAA Waas Managing the Router Using Cisco Configuration Professional Managing the Router Using the Cisco CSR 1000V Rest APIManagement Support 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 the History Buffer to Recall Commands Using Keyboard ShortcutsKeystrokes Purpose Command Purpose Understanding the Command ModesCommand Mode Access Method Prompt Exit Method Finding Command Options Getting Help Enter the configure terminal Command CommentUsing the interface GigabitEthernet Interface configuration commands Configuration commandsEnter the command that you want to Configure for the interface. This Using the no and default Forms of Commands Saving Configuration Changes This task saves the configuration to Nvram Managing Configuration FilesExample 1 Copying a Startup Configuration File to Bootflash Powering Off the Cisco CSR Filtering the Output of show and more CommandsNvram File Security Installation Overview Cisco CSR 1000V software can install and boot Cisco CSR 1000V Installation Task Workflow Cisco CSR 1000V Installation Options Cisco CSR 1000V Installation FilesObtaining the Cisco CSR 1000V Software Installation Option VMware ESXi Citrix XenServer Guidelines and LimitationsMicrosoft 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 Cisco CSR 1000V Version Supported vSwitch2lists the virtual machine requirements for the Cisco CSR GB virtual disk Virtual CPUsGB of RAM 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 GB RAM Allocation VCPUs Requires Minimum Installation Requirements for VMware ESXiAllocation 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 Cisco CSR 1000V Cloud Services Router Enters the ESXi login usernamePw -password Enters the ESXi login password Login Ipw -iospasswordEnters the Cisco IOS XE IOS password required for 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 Virsh nodeinfo Increasing Performance on KVM ConfigurationsVirsh vcpupin csr1000v 1 Modprobe vhost-net For more information, see the KVM documentation OL-27477-07 Microsoft Hyper-V Support Information 1lists the installation requirements for Microsoft HyperV Installation Requirements for Microsoft Hyper-VMicrosoft Hyper-V Requirements Cisco IOS XE 3.12S Prerequisites Configuring the Server Manager SettingsCreating 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 Microsoft Hyper-V Creating the Serial Console Access in KVMClick on Add Hardware Command or Action Purpose Changing the Console Port Access After InstallationExample End Exits configuration mode Example Routerconfig# endRouter# copy systemrunning-config Nvramstartup-config Reload Reloads the operating system OL-27477-07 Prerequisites for the Software Upgrade Process Upgrading the Cisco IOS XE Software Copy nvramstartup-config ftp rcp tftp Copies the startup configuration file to a serverConfiguration file copy can serve as a backup copy Enter the destination URL when prompted Dir bootflash Copy bootflash ftp rcp tftp Copy tftp bootflash or Copy rcp bootflash Router# copy tftp bootflash Use this command to enter global configuration mode No boot systemLoading the New System Image Loading the New System Image from the Cisco IOS XE Software Exit Copy running-config startup-config ExitWrite Write memory Config-register Loading the New System Image from Grub ModeDo write Do write memory Enter the letter c Upgrading the Cisco IOS XE Software Configuration file copy serves as a backup copy Backup copySystem 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 10-4 Cisco CSR 1000V Network Interfaces and VM CloningCsr1000v# 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 Bit Number Hexadecimal Meaning About Grub Mode and the Configuration Register11-1 Accessing Grub Mode Boot FieldEnable Config-register 11-2 Modifying the Configuration Register confreg Using the Grub Menu11-3 Confreg value 11-4 11-5 Displaying the Configuration Register Settings Changing the Configuration Register Settings11-6 Prerequisites for Call Home 12-1 Information About Call Home Benefits of Using Call Home12-2 Anonymous Reporting Obtaining Smart Call Home Services12-3 How to Configure Call Home Configuring Smart Call Home Single CommandFollowing sections show detailed or optional configurations 12-4 Call-home reporting anonymous contact-email-addr Mode using the call-home reporting12-5 Configuring and Enabling Smart Call Home Configure terminal Service call-home No service call-homeEnabling and Disabling Call Home 12-6 Phone-number + phone-number Configuring Contact Information12-7 Example Configuring Destination Profiles12-8 Creating a New Destination Profile 12-9 No destination transport-method email http Destination address email email-address http urlDestination preferred-msg-format long-text Short-text xml Copying a Destination Profile Configure terminal Call-home12-11 Setting Profiles to Anonymous Mode Call -homeAnonymous-reporting-only is set, only crash 12-12 Subscribing to Alert Groups 12-13 12-14 Periodic Notification Subscribe-to-alert-group snapshot periodic dailyHhmm hourly mm interval mm monthly date 12-15 Level Keyword Syslog Level Description Message Severity Threshold12-16 Configuring Snapshot Command List 12-17 Priority number Configuring General email Options12-18 Command or Action Purpose 12-19 Specifying Rate Limit for Sending Call Home Messages Configure terminal Call-home Rate-limit number12-20 Specifies the proxy server for the Http request Specifying Http Proxy Server12-21 12-22 Configure terminal Call-home No syslog-throttling Configuring Syslog Throttling12-23 Hostname command Configuring Call Home Data Privacy12-24 Sending Call Home Communications Manually Sending a Call Home Test Message ManuallyCall-home test test-messageprofile name Call-home test test-message profile name Call-home send alert-group configuration profile Sending Call Home Alert Group Messages ManuallyCall-home send alert-group snapshot profile name 12-26 Submitting Call Home Analysis and Report Requests 12-27 Example 12-28 12-29 Configuring Diagnostic Signatures Prerequisites for Diagnostic SignaturesInformation About Diagnostic Signatures 12-30 Diagnostic Signature Downloading Diagnostic Signatures Overview12-31 Diagnostic Signature Workflow Diagnostic Signature Events and ActionsDiagnostic Signature Event Detection 12-32 Diagnostic Signature Variables Diagnostic Signature Actions12-33 Configuring the Call Home Service for Diagnostic Signatures How to Configure Diagnostic Signatures12-34 Destination transport-method email http Mail-server ipv4-addr name priority number12-35 Configuring Diagnostic Signatures Call-home Diagnostic-signatureWhat to Do Next Before You Begin Router# configure terminal Routerconfig# service call-home Configuration Examples for Diagnostic Signatures12-37 Show call-home Displaying Call Home Configuration Information12-38 All destination profiles Examples12-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 Default Settings Alert Group Trigger Events and CommandsParameters Default 12-44 Message Contents Data Item Description Call-Home Message Tag Plain Text and XML XML OnlyType is the product model number from backplane 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 MB 10 100 1000 250 2500 50 500Platform hardware throughput level 10000 25000 50000 eval-only License-Based Restriction on Aggregate Bandwidth 13-6 13-7 Input58757880 Output Requesting a New Virtual UDI Request license new-udi13-8 Router# show license udi history Rest API 14-1 14-2 Enable Configure terminal Enabling Rest API Support Using the Cisco IOS XE CLI14-3 Activate No shutdownInterface virtualportgroup virtualportgroup-number 14-4 14-5 14-6 Enables the secure Https server Enables the transport map to support HttpsEnters remote-management configuration mode Disabling Rest API Support Disables support for the Rest API Exits remote-management configuration modeRouter# show virtual-service detail Viewing the Rest API Container Status 14-9 Pnsc 14-10 No shutdown Exit No shutdown Exit Virtual-service csrmgmt15-1 Enables IP processing on an interface without Activate EndInterface virtualportgroup Assigning it an explicit IP address Ip route ip-addresssubnet-maskvirtualportgroup 15-3 15-4 Http port command To the Cisco Prime Network Services Controller Host15-5 Exits configuration mode and enters privileged Exec modeSettings 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 VM Performance Issues Troubleshooting Network Connectivity 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 Command modes, understanding Call-home reporting command Commands Call-home request commandAaa-authorization call-home Call-home send alert-group command Active call-home IN-2 IN-3 IN-4 IN-5 IN-6