Configuring Call Home

The Call Home feature provides e-mail-based and web-based notification of critical system events. A versatile range of message formats are available for optimal compatibility with pager services, standard e-mail, or XML-based automated parsing applications. Common uses of this feature may include direct paging of a network support engineer, e-mail notification to a Network Operations Center, XML delivery to a support website, and utilization of Cisco Smart Call Home services for direct case generation with the Cisco Systems Technical Assistance Center (TAC).

Finding Feature Information in This Module

Your Cisco IOS software release may not support all of the features documented in this module. To reach links to specific feature documentation in this module and to see a list of the releases in which each feature is supported, see Feature Information for Call Home.

Finding Support Information for Platforms and Cisco IOS and Catalyst OS Software Images

Use Cisco Feature Navigator to find information about platform support and Cisco IOS and Catalyst OS software image support. To access Cisco Feature Navigator, go to http://www.cisco.com/go/cfn. An account on Cisco.com is not required.

Finding Feature Information

Your software release may not support all the features documented in this module. For the latest caveats and feature information, see Bug Search Tool and the release notes for your platform and software release. To find information about the features documented in this module, and to see a list of the releases in which each feature is supported, see the feature information table.

Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to https://cfnng.cisco.com/. An account on Cisco.com is not required.

Prerequisites for Call Home

How you configure Call Home depends on how you intend to use the feature. Consider the following requirements before you configure Call Home:

  • Obtain e-mail, phone, and street address information for the Call Home contact to be configured so that the receiver can determine the origin of messages received.
  • Identify the name or IPv4 address of a primary Simple Mail Transfer Protocol (SMTP) server and any backup servers, if using e-mail message delivery.
  • Configure a trustpoint certificate authority (CA) if using secure HTTP (HTTPS) message delivery. For example, this procedure is required if you are using the HTTPS server for Cisco Smart Call Home Service in the CiscoTAC-1 profile for Call Home.
  • Verify IP connectivity from the router to the e-mail server(s) or the destination HTTP server.
  • If Cisco Smart Call Home is used, verify an active service contract exists for the device being configured.

Restrictions for Call Home

The Call Home feature does not work when the router is connected to an On-Prem server with the following default configuration: 

crypto pki trustpoint SLA-TrustPoint
 enrollment terminal
 revocation-check crl
!

Use the following configuration as a workaround for the above instance:

crypto pki trustpoint SLA-TrustPoint
 enrollment terminal
 revocation-check none
!

Information About Call Home

Call Home provides e-mail-based and web-based notification of critical system events. A versatile range of message formats are available for optimal compatibility with pager services, standard e-mail, or XML-based automated parsing applications. Common uses of this feature may include direct paging of a network support engineer, e-mail notification to a Network Operations Center, XML delivery to a support website, and utilization of Cisco Smart Call Home services for direct case generation with the Cisco Systems Technical Assistance Center (TAC).

The Call Home feature can deliver alert messages containing information on configuration, environmental conditions, inventory, syslog, and crash events.

The Call Home feature can deliver alerts to multiple recipients, referred to as Call Home destination profiles , each with configurable message formats and content categories. A predefined destination profile (CiscoTAC-1) is provided, and you also can define your own destination profiles. The CiscoTAC-1 profile is used to send alerts to the backend server of the Smart Call Home service, which can be used to create service requests to Cisco TAC, the service will depend on the Smart Call Home service support in place for your device and the severity of the alert.

Flexible message delivery and format options make it easy to integrate specific support requirements.

Benefits of Using Call Home

The Call Home feature offers the following benefits:

  • Multiple message-format options:
    • Short Text—Suitable for pagers or printed reports.
    • Plain Text—Full formatted message information suitable for human reading.
    • XML—Matching readable format using Extensible Markup Language (XML) and Adaptive Markup Language (AML) document type definitions (DTDs). The XML format enables communication with the Cisco Smart Call Home server.
  • Multiple concurrent message destinations.

  • Multiple message categories, including configuration, environmental conditions, inventory, syslog, and crash events

  • Filtering of messages by severity and pattern matching.
  • Scheduling of periodic message sending.

Obtaining Smart Call Home Services

If you have a service contract directly with Cisco, you can register for the Smart Call Home service. Smart Call Home analyzes Smart Call Home messages and provides background information and recommendations. For critical issues, Automatic Service Requests are generated with the Cisco TAC.

Smart Call Home offers the following features:

  • Continuous device health monitoring and real-time alerts.

  • Analysis of Smart Call Home messages and, if needed, Automatic Service Request generation routed to the correct TAC team, including detailed diagnostic information to speed problem resolution.

  • Secure message transport directly from your device or through an HTTP proxy server or a downloadable Transport Gateway (TG). You can use a TG aggregation point to support multiple devices or in cases where security dictates that your devices may not be connected directly to the Internet.

  • Web-based access to Smart Call Home messages and recommendations, inventory, and configuration information for all Smart Call Home devices provides access to associated field notices, security advisories, and end-of-life information.

You need the following items to register for Smart Call Home:

  • SMARTnet contract number for your router.
  • Your e-mail address
  • Your Cisco.com username

For information on how to configure and register a Cisco ASR 1000 Series Router for Smart Call Home, see the Smart Call Home Quick Start Configuration Guide

How to Configure Call Home

Configuring the Management Interface VRF

The Call Home feature requires use of the Gigabit Ethernet Management interface virtual routing and forwarding (VRF) instance. The Gigabit Ethernet Management interface is automatically part of its own VRF named “Mgmt-intf.”

To configure the Management interface VRF, complete the following steps:

or

ipv6 address {X:X:X:X::X link-local | X:X:X:X::X/ prefix [anycast | eui-64 ] | autoconfig [default ]}

Procedure

  Command or Action Purpose

Step 1

configure terminal

Example:


Router# configure terminal

Enters global configuration mode.

Step 2

interface GigabitEthernet 0

Example:


Router(config)# interface GigabitEthernet0

(Required) Specifies the Gigabit Ethernet Management interface on the router.

Step 3

vrf forwarding Mgmt-intf

Example:


Router(config-if)# vrf forwarding Mgmt-intf

(Required) Associates the Mgmt-intf VRF with the Gigabit Ethernet Management interface. This command is configured by default.

Step 4

Do one of the following:

  • ip address ip-address mask [secondary [vrf vrf-name ]]
  • ipv6 address {X:X:X:X::X link-local | X:X:X:X::X/ prefix [anycast | eui-64 ] | autoconfig [default ]}

Example:


Router(config-if)# ip address 10.10.10.10 0.0.0.0

(Required) Specifies the IPv4 or IPv6 addressing for the interface.

What To Do Next

To find out more about the Gigabit Ethernet Management interface or perform additional related configuration tasks on the management interface, see the Using the Management Ethernet Interface .

Configuring a Destination Profile

A destination profile contains the required delivery information for an alert notification. You can configure multiple destination profiles of one or more type.

You can create and define a new destination profile or copy and use another destination profile. If you define a new destination profile, you must assign a profile name.


Note
The Call Home feature provides a predefined profile named CiscoTAC-1 that is inactive by default. The CiscoTAC-1 profile is intended for use with the Smart Call Home service, which requires certain additional configuration steps to enable the service with the Call Home feature. For more information about this profile, see the Using the Predefined CiscoTAC-1 Destination Profile.

You can configure the following attributes for a destination profile:

  • Profile name—A string that uniquely identifies each user-defined destination profile. The profile name is limited to 31 characters and is not case-sensitive. You cannot use all as a profile name.
  • Transport method—The transport mechanism, either e-mail or HTTP (including HTTPS), for delivery of alerts.
    • For user-defined destination profiles, e-mail is the default, and you can enable one or both transport mechanisms. If you disable both methods, e-mail is enabled.
    • For the predefined Cisco TAC profile, you can enable either transport mechanism, but not both.
  • Destination address—The actual address related to the transport method to which the alert should be sent.
  • Message formatting—The message format used for sending the alert. The format options for a user-defined destination profile are long-text, short-text, or XML. The default is XML. For the predefined Cisco TAC profile, only XML is allowed. If you use the Cisco Smart Call Home service, the destination profile must use the XML message format.
  • Message size—The maximum destination message size. The valid range is 50 to 3,145,728 bytes and the default is 3,145,728 bytes.

This section includes the following tasks:

Configuring a Destination Profile to Send Email Messages

To configure Call Home to send email messages, complete the following tasks:

Configuring the Mail Server

To use the e-mail message transport, you must configure at least one Simple Mail Transfer Protocol (SMTP) e-mail server address. You can specify up to four backup e-mail servers, for a maximum of five total mail-server definitions.

Consider the following guidelines when configuring the mail server:

  • Backup e-mail servers can be defined by repeating the mail-server command using different priority numbers.
  • The mail-server priority number parameter can be configured from 1 to 100. The server with the highest priority (lowest priority number) is tried first.
Procedure
  Command or Action Purpose

Step 1

configure terminal

Example:

Router# configure terminal

Enters global configuration mode.

Step 2

call-home

Example:

Router(config)# call-home

Enters call home configuration mode.

Step 3

mail-server {ipv4-address | name } priority number

Example:

Router(cfg-call-home)# mail-server stmp.example.com priority 1

Specifies an e-mail server and its relative priority among configured e-mail servers, where:

  • ipv4-address —Specifies the IPv4 address of the mail server.
  • name —Specifies the mail server’s fully qualified domain name (FQDN) of 64 characters or less.
  • number —Assigns a number between 1 (highest priority) and 100 (lowest priority).
What to do next

Example:

The following example shows the configuration of a primary mail server (named “smtp.example.com”) and secondary mail server at IP address 192.168.0.1: 


Router# configure terminal
 
Enter configuration commands, one per line.  End with CNTL/Z.

Router(config)# call-home 

Router(cfg-call-home)# mail-server smtp.example.com priority 1 

Router(cfg-call-home)# mail-server 192.168.0.1 priority 2 

Router(cfg-call-home)# exit

Router(config)#

Associating the Management Interface VRF With Call Home

The Call Home feature requires the management interface VRF (Mgmt-intf) to provide e-mail messaging support. If you have not configured the management interface VRF, see the Configuring the Management Interface VRF.

To associate the management interface VRF with Call Home, complete the following steps:

Procedure
  Command or Action Purpose

Step 1

configure terminal

Example:

Router# configure terminal

Enters global configuration mode.

Step 2

call-home

Example:

Router(config)# call-home

Enters call home configuration mode.

Step 3

vrf Mgmt-intf

Example:

Router(cfg-call-home)# vrf Mgmt-intf

(Required) Associates the Mgmt-intf VRF for the email transport method using Call Home.

Configuring a Destination Profile for E-mail

To configure a destination profile for e-mail transport, complete the following steps:

Procedure
  Command or Action Purpose

Step 1

configure terminal

Example:

Router# configure terminal

Enters global configuration mode.

Step 2

call -home

Example:

Router(config)# call-home

Enters call home configuration mode.

Step 3

profile name

Example:

Router(config-call-home)# profile profile1

Enters call home destination profile configuration mode for the specified destination profile name. If the specified destination profile does not exist, it is created.

Step 4

destination transport-method email

Example:

Router(cfg-call-home-profile)# destination transport-method email

(Optional) Configures the message transport method for email. This is the default.

Step 5

destination address email email-address

Example:

Router(cfg-call-home-profile)# destination address email myaddress@example.com

(Required) Configures the destination e-mail address to which Call Home messages are sent.

Step 6

destination preferred-msg-format {long-text | short-text | xml }

Example:

Router(cfg-call-home-profile)# destination preferred-msg-format xml

(Optional) Configures a preferred message format. The default is XML.

Step 7

destination message-size bytes

Example:

Router(cfg-call-home-profile)# destination message-size 3145728

(Optional) Configures a maximum destination message size (from 50 to 3145728 bytes) for the destination profile. The default is 3145728 bytes.

Step 8

active

Example:

Router(cfg-call-home-profile)# active

(Optional) Enables the destination profile. By default, a user-defined profile is enabled when it is created.

Step 9

exit

Example:

Router(cfg-call-home-profile)# exit

Exits call home destination profile configuration mode and returns to call home configuration mode.

Step 10

end

Example:

Router(cfg-call-home)# end

Returns to privileged EXEC mode.

Configuring Other Email Options

For the e-mail transport method, you can also configure the from and reply-to e-mail addresses by completing the following steps:

Procedure
  Command or Action Purpose

Step 1

configure terminal

Example:

Router# configure terminal

Enters global configuration mode.

Step 2

call-home

Example:

Router(config)# call-home

Enters call home configuration mode.

Step 3

sender from email-address

Example:

Router(cfg-call-home)# sender from username@example.com

(Optional) Assigns the e-mail address that will appear in the from field in Call Home e-mail messages. If no address is specified, the contact e-mail address is used.

Step 4

sender reply-to email-address

Example:

Router(cfg-call-home)# sender reply-to username@example.com

(Optional) Assigns the e-mail address that will appear in the reply-to field in Call Home e-mail messages.

Configuring a Destination Profile to Send HTTP Messages

To configure Call Home to send HTTP (or HTTPS) messages, complete the following tasks:

Configuring the HTTP Source Interface

If you are using HTTP or HTTPS to send Call Home messages, then you must configure the VRF management interface as the HTTP client source interface.

Procedure
  Command or Action Purpose

Step 1

configure terminal

Example:

Router# configure terminal

Enters global configuration mode.

Step 2

ip http client source-interface type number

Example:

Router(config)# ip http client source-interface gigabitethernet 0

Configures the source interface for the HTTP client.

Note

 
This interface should be the VRF management interface.

Step 3

end

Example:

Router(cfg-call-home)# end

Returns to privileged EXEC mode.

Configuring a Destination Profile for HTTP

To configure a destination profile for http transport, complete the following steps:

Procedure
  Command or Action Purpose

Step 1

configure terminal

Example:

Router# configure terminal

Enters global configuration mode.

Step 2

call -home

Example:

Router(config)# call-home

Enters call home configuration mode.

Step 3

profile name

Example:

Router(config-call-home)# profile test

Enters call home destination profile configuration mode for the specified destination profile. If the specified destination profile does not exist, it is created.

Step 4

destination transport-method http

Example:

Router(cfg-call-home-profile)# destination transport-method http

Enables the HTTP message transport method.

Step 5

destination address http url

Example:

Router(cfg-call-home-profile)# destination address http https://example.url.com

Configures the destination URL to which Call Home messages are sent.

Note

 
When entering a destination URL, include either http:// or https:// , depending on whether the server is a secure server. If the destination is a secure server, you must also configure a trustpoint CA.

Step 6

destination preferred-msg-format {long-text | short-text | xml }

Example:

Router(cfg-call-home-profile)# destination preferred-msg-format xml

(Optional) Configures a preferred message format. The default is XML.

Step 7

destination message-size bytes

Example:

Router(cfg-call-home-profile)# destination message-size 3,145,728

(Optional) Configures a maximum destination message size for the destination profile.

Step 8

active

Example:

Router(cfg-call-home-profile)# active

Enables the destination profile. By default, a profile is enabled when it is created.

Step 9

exit

Example:

Router(cfg-call-home-profile)# exit

Exits call home destination profile configuration mode and returns to call home configuration mode.

Step 10

end

Example:

Router(cfg-call-home)# end

Returns to privileged EXEC mode.

Configuring a Trustpoint Certificate Authority

If you are using the HTTP transport method and specifying an HTTPS destination URL, then you will also need to configure a trustpoint certificate authority (CA).

For more information about how to configure a trustpoint CA, see the Declare and Authenticate a CA Trustpoint. That section describes how to configure a CA trustpoint for a secure Cisco server to use with the Smart Call Home service, but can be applied to other secure server configuration as needed by your site using the required certificate for your secure server.

Working With Destination Profiles

This section describes some of the tasks that you can complete with destination profiles:

Activating and Deactivating a Destination Profile

Except for the predefined CiscoTAC-1 profile, all Call Home destination profiles are automatically activated once you create them. If you do not want to use a profile right way, you can deactivate the profile. The CiscoTAC-1 profile is inactive by default and must be activated to be used.

To activate or deactivate a destination profile, complete the following steps:

Procedure
  Command or Action Purpose

Step 1

configure terminal

Example:

Router# configure terminal

Enters global configuration mode.

Step 2

call -home

Example:

Router(config)# call-home

Enters call home configuration mode.

Step 3

profile name

Example:

Router(config-call-home)# profile test

Enters call home destination profile configuration mode for the specified destination profile. If the specified destination profile does not exist, it is created.

Step 4

active

Example:

Router(cfg-call-home-profile)# active

Enables the destination profile. By default, a new profile is enabled when it is created.

Step 5

no active

Example:

Router(cfg-call-home-profile)# no active

Disables the destination profile.

Step 6

end

Example:

Router(cfg-call-home)# end

Exits call home destination profile configuration mode and returns to privileged EXEC mode.

Copying a Destination Profile

To create a new destination profile by copying an existing profile, complete the following steps:

Procedure
  Command or Action Purpose

Step 1

configure terminal

Example:

Router# configure terminal

Enters global configuration mode.

Step 2

call-home

Example:

Router(config)# call-home

Enters call home configuration mode.

Step 3

copy profile source-profile target-profile

Example:

Router(cfg-call-home)# copy profile profile1 profile2

Creates a new destination profile with the same configuration settings as the existing destination profile, where:

  • source-profile —Specifies the existing name of the profile.
  • target-profile —Specifies a name for the new copy of the profile.

Renaming a Destination Profile

To change the name of an existing profile, complete the following steps:

Procedure
  Command or Action Purpose

Step 1

configure terminal

Example:

Router# configure terminal

Enters global configuration mode.

Step 2

call-home

Example:

Router(config)# call-home

Enters call home configuration mode.

Step 3

rename profile source-profile target-profile

Example:

Router(cfg-call-home)# rename profile2 testprofile

Renames an existing source file, where:

  • source-profile —Specifies the existing name of the profile.
  • target-profile —Specifies a new name for the existing profile.

Using the Predefined CiscoTAC-1 Destination Profile

The CiscoTAC-1 profile is automatically configured in the Call Home feature for your use with the Cisco Smart Call Home service. This profile includes certain information, such as the destination e-mail address and HTTPS URL, and default alert groups for communication with the Smart Call Home service. Some of these attributes, such as the destination e-mail address, HTTPS URL, and message format cannot be modified.

You can use either email or http transport to communicate with the Smart Call Home service backend server. By default, the CiscoTAC-1 profile is inactive and uses email as the default transport method. To use email transport, you only need to enable the profile. However, to use this profile with the Cisco Smart Call Home service secure server (via HTTPS), you not only must enable the profile, but you must also change the transport method to HTTP as shown in the following example: 


Router# configure terminal
Router(config)# call-home
Router(config-call-home)# profile CiscoTAC-1
Router(cfg-call-home-profile)# destination transport-method http
Router(cfg-call-home-profile)# active

For more information about additional requirements for Configuring the Smart Call Home service, see the How To Configure Call Home to Support the Smart Call Home Service section.

Subscribing to Alert Groups

An alert group is a predefined subset of Call Home alerts supported in all routers. Different types of Call Home alerts are grouped into different alert groups depending on their type. The following alert groups are available on the router:

  • Configuration
  • Diagnostic
  • Environment
  • Inventory
  • Syslog

The triggering events for each alert group are listed in the Alert Group Trigger Events and Commands, and the contents of the alert group messages are listed in the Message Contents.

You can select one or more alert groups to be received by a destination profile.


Note
A Call Home alert is only sent to destination profiles that have subscribed to the alert group containing that Call Home alert. In addition, the alert group must be enabled.

Periodic Notification

When you subscribe a destination profile to either the Configuration or the Inventory alert group, you can choose to receive the alert group messages asynchronously or periodically at a specified time. The sending period can be one of the following:

  • Daily—Specify the time of day to send, using an hour:minute format hh:mm, with a 24-hour clock (for example, 14:30).
  • Weekly—Specify the day of the week and time of day in the format day hh:mm, where the day of the week is spelled out (for example, monday).
  • Monthly—Specify the numeric date, from 1 to 31, and the time of day, in the format date hh:mm.

Message Severity Threshold

When you subscribe a destination profile to the Environment or Syslog alert group, you can set a threshold for the sending of alert group messages based on the message’s level of severity. Any message with a severity lower than the specified threshold of the destination profile is not sent to the destination.


Note
When syslog level is changed via IOS CLI, the new value is propagated to non-IOS processes as well, with the result that these processes no longer send syslog messages of lower priority to IOS to process, thus "saving" CPU cycles for IOS.

The table below lists the keywords used to configure the severity, which range from catastrophic (level 9, highest level of urgency) to debugging (level 0, lowest level of urgency). If no severity threshold is configured, the default is debugging (level 0). However, the default is not recommended due to the number of messages that will be triggered.


Note
Call Home severity levels are not the same as system message logging severity levels.
Table 1. Severity and Syslog Level Mapping

Level

Keyword

Syslog Level

Description

9

catastrophic

N/A

Network-wide catastrophic failure.

8

disaster

N/A

Significant network impact.

7

fatal

Emergency (0)

System is unusable.

6

critical

Alert (1)

Critical conditions, immediate attention needed.

5

major

Critical (2)

Major conditions.

4

minor

Error (3)

Minor conditions.

3

warning

Warning (4)

Warning conditions.

2

notification

Notice (5)

Basic notification and informational messages. Possibly independently insignificant.

1

normal

Information (6)

Normal event signifying return to normal state.

0

debugging

Debug (7)

Debugging messages.

Syslog Pattern Matching

When you subscribe a destination profile to the Syslog alert group, you can optionally specify a text pattern to be matched within each syslog message. If you configure a pattern, a Syslog alert group message is sent only if it contains the specified pattern and meets the severity threshold. If the pattern contains spaces, you must enclose it within double quotation marks(“ ”) when configuring it. You can specify up to five patterns for each destination profile.

To subscribe a destination profile to one or more alert groups, complete the following steps:

Procedure
  Command or Action Purpose

Step 1

configure terminal

Example:

Device# configure terminal

Enters global configuration mode.

Step 2

call-home

Example:

Device(config)# call-home

Enters call home configuration mode.

Step 3

alert-group {all | configuration | environment | inventory | syslog }

Example:

Device(cfg-call-home)# alert-group all

Enables the specified alert group. Use the all keyword to enable all alert groups. By default, all alert groups are enabled.

Step 4

profile name

Example:

Device(cfg-call-home)# profile profile1

Enters call home destination profile configuration mode for the specified destination profile.

Step 5

subscribe-to-alert-group all

Example:

Device(cfg-call-home-profile)# subscribe-to-alert-group all

(Optional) Subscribes this destination profile to all available alert groups.

Note

 
Alternatively, you can also subscribe to alert groups individually by specific type as described in steps 6 through 9.

Step 6

subscribe-to-alert-group configuration [periodic {daily hh:mm | monthly date hh:mm | weekly day hh:mm }]

Example:

Device(cfg-call-home-profile)# subscribe-to-alert-group configuration periodic daily 12:00

Subscribes this destination profile to the Configuration alert group, with an optional periodic value.

Step 7

subscribe-to-alert-group diagnostic [severity {catastrophic | critical | debugging | disaster | fatal | major | minor | normal | notification | warning }]

Example:

Device(cfg-call-home-profile)# subscribe-to-alert-group diagnostic severity critical

Subscribes this destination profile to the Diagnostic alert group, with an optional severity level.

Step 8

subscribe-to-alert-group environment [severity {catastrophic | critical | debugging | disaster | fatal | major | minor | normal | notification | warning }]

Example:

Device(cfg-call-home-profile)# subscribe-to-alert-group environment severity major

Subscribes this destination profile to the Environment alert group, with an optional severity level.

Step 9

subscribe-to-alert-group inventory [periodic {daily hh:mm | monthly date hh:mm | weekly day hh:mm }]

Example:

Device(cfg-call-home-profile)# subscribe-to-alert-group inventory periodic monthly 1 12:00

Subscribes this destination profile to the Inventory alert group, with an optional periodic value.

Step 10

subscribe-to-alert-group syslog [severity {catastrophic | critical | debugging | disaster | fatal | major | minor | normal | notification | warning }][pattern string ]

Example:

Device(cfg-call-home-profile)# subscribe-to-alert-group syslog

Subscribes this destination profile to the Syslog alert group, with an optional severity level. You can specify a pattern to be matched in the syslog message, up to a maximum of five patterns per profile. If the pattern contains spaces, you must enclose it within double quotation marks (“ ”).

Configuring Contact Information

Each router must include a contact email address. You can optionally include a phone number, street address, contract ID, customer ID, and site ID.

To assign the contact information, complete the following steps:

Procedure

  Command or Action Purpose

Step 1

configure terminal

Example:


Router> configure terminal

Enters global configuration mode.

Step 2

call-home

Example:


Router(config)# call-home

Enters call home configuration mode.

Step 3

contact-email-addr email-address

Example:


Router(cfg-call-home)# contact-email-addr username@example.com

Assigns the customer’s email address. Enter up to 200 characters in email address format with no spaces.

Step 4

phone-number + phone-number

Example:


Router(cfg-call-home)# phone-number +1-222-333-4444

(Optional) Assigns the customer’s phone number.

Note

 
The number must start with a plus (+) prefix, and may contain only dashes (-) and numbers. Enter up to 16 characters. If you include spaces, you must enclose your entry within double quotation marks (“ ”).

Step 5

street-address street-address

Example:


Router(cfg-call-home)# street-address “1234 Any Street, Any city, Any state, 12345”

(Optional) Assigns the customer’s street address where RMA equipment can be shipped. Enter up to 200 characters. If you include spaces, you must enclose your entry within double quotation marks (“ ”).

Step 6

customer-id text

Example:


Router(cfg-call-home)# customer-id Customer1234

(Optional) Identifies the customer ID. Enter up to 64 characters. If you include spaces, you must enclose your entry within double quotation marks (“ ”).

Step 7

site-id text

Example:


Router(cfg-call-home)# site-id Site1ManhattanNY

(Optional) Identifies the customer site ID. Enter up to 200 characters. If you include spaces, you must enclose your entry within double quotation marks (“ ”).

Step 8

contract-id text

Example:


Router(cfg-call-home)# contract-id Company1234

(Optional) Identifies the customer’s contract ID for the router. Enter up to 64 characters. If you include spaces, you must enclose your entry within double quotation marks (“ ”).

Example

The following example shows the configuration of contact information: 


Device# configure terminal
 
Enter configuration commands, one per line.  End with CNTL/Z.

Device(config)# call-home 

Device(cfg-call-home)# contact-email-addr username@example.com 

Device(cfg-call-home)# phone-number +1-222-333-4444 

Device(cfg-call-home)# street-address “1234 Any Street, Any city, Any state, 12345” 

Device(cfg-call-home)# customer-id Customer1234  

Device(cfg-call-home)# site-id Site1ManhattanNY 

Device(cfg-call-home)# contract-id Company1234  

Device(cfg-call-home)# exit

Configuring the Number of Call Home Messages Sent Per Minute

The Call Home feature defaults to a maximum of 20 messages per minute. If you want to change that value, complete the following steps:

Procedure

  Command or Action Purpose

Step 1

configure terminal

Example:


Router# configure terminal

Enters global configuration mode.

Step 2

call-home

Example:


Router(config)# call-home

Enters call home configuration mode.

Step 3

rate-limit number

Example:


Router(cfg-call-home)# rate-limit 40

Specifies a limit on the number of messages sent per minute. Range 1 to 60. The default is 20.

Sending Call Home Communications Manually

You can manually send several types of Call Home communications. To send Call Home communications, complete the tasks in this section. This section contains the following subsections:

Sending a Call Home Test Message Manually

You can use the call-home test command to send a user-defined Call Home test message.

Procedure
Command or Action Purpose

call-home test [“ test-message ” ] profile name

Example:

Router# call-home test profile profile1

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 contains spaces. If no user-defined message is configured, a default message is sent.

Sending Call Home Alert Group Messages Manually

You can use the call-home send command to manually send a specific alert group message.

Note the following guidelines when manually sending a Call Home alert group message:

  • Configuration, , and inventory alert groups can be sent manually.
  • When you manually trigger an alert group message and you specify a destination profile name, a message is sent to the destination profile regardless of the active status, subscription status, or severity setting of the profile.
  • When you manually trigger a configuration or inventory alert group message and do not specify a destination profile name, a message is sent to all active profiles that have either a normal or periodic subscription to the specified alert group.
  • When you manually trigger a diagnostic alert group message and do not specify a destination profile name, a message is sent to all active profiles that have a lower severity subscription than the severity of the diagnostic results of the specified slot.

To manually trigger Call Home alert group messages, complete the following steps:

Procedure
  Command or Action Purpose

Step 1

call-home send alert-group configuration [profile name ]

Example:

Device# call-home send alert-group configuration profile CiscoTAC-1

Sends a configuration alert group message to one destination profile if specified, or to all subscribed destination profiles.

Step 2

call-home send alert-group inventory [profile name ]

Example:

Device# call-home send alert-group inventory

Sends an inventory alert group message to one destination profile if specified, or to all subscribed destination profiles.

Submitting Call Home Analysis and Report Requests

The call-home request command allows you to submit the system information to Cisco Systems. The report provides helpful analysis and information specific to your system. You can request various reports, including security alerts, known bugs, recommendations, and the command references.

Note the following guidelines when manually sending Call Home analysis and report requests:

  • If a profile name is specified, the request is sent to the profile. If no profile is specified, the request is sent to the Cisco TAC profile. The Call-home request can have a recipient profile that is not enabled. The recipient profile specifies the email address where the transport gateway is configured. The recipient profile allows the request message to be forwarded to the Cisco TAC and you can receive the reply from the Smart Call Home service.

  • The ccoid user-id is the registered identifier of the Smart Call Home user. If the user-id is specified, the response is sent to the email address of the registered user. If no user-id is specified, the response is sent to the contact email address of the device.

  • Based on the keyword specifying the type of report that is requested, the following information is returned:

    • config-sanity —Information on the recommendations for 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. The PSIRT includes End of Life (EOL) or End of Sales (EOS) notices, or field notices (FN) that may affect devices in your network.

To submit a request for analysis and report information from the Cisco Output Interpreter tool, complete the following steps:

Procedure
  Command or Action Purpose

Step 1

call-home request output-analysis “ show-command ”

Example:

[profile   name ] [ccoid  user-id ]
Example:

Device# call-home request output-analysis “show diag” profile TG

Sends the output of the specified show command for analysis. The show command must be contained in quotes (").

Step 2

call-home request {config-sanity | bugs-list | command-reference | product-advisory }

Example:

[profile   name ] [ccoid  user-id ]
Example:

Device# call-home request config-sanity profile TG

Sends the output of a predetermined set of commands, such as the show running-config all and show version commands, for analysis. In addition, the call home request product-advisory subcommand includes all inventory alert group commands. The keyword that is specified after the call-home request command specifies the type of report requested.

Example

The following example shows a request for analysis of a user-specified show command: 


Router# call-home request output-analysis "show diag" profile TG

Sending the Output of a Command to Cisco or an E-Mail Address

You can use the call-home send command to execute a CLI command and e-mail the command output to Cisco or to an e-mail address that you specify.

Note the following guidelines when sending the output of a command:

  • The specified CLI command can be any run command, including commands for all modules. The command must be contained in quotes (“”).
  • If an e-mail address is specified, the command output is sent to that address. If no e-mail address is specified, the output is sent to the Cisco TAC (attach@cisco.com). The e-mail is sent in long text format with the service number, if specified, in the subject line.
  • The service number is required only if no e-mail address is specified, or if a Cisco TAC e-mail address is specified.

To execute a CLI command and e-mail the command output, complete the following step:

Procedure
Command or Action Purpose

call-home send “ command ”

Example:

{email  email-addr
 [tac-service-request  request-number
] | tac-service-request  request-number 
[email  email-addr
]}
Example:

Router# call-home send “show call-home” email support@example.com

Executes the specified CLI command and e-mails the output, where:

  • email email-addr —Specifies the email address to which the command output should be sent. This keyword is optional if used after entering the tac-service-request option.
  • tac-service-request request-number —Specifies the TAC service request number that will appear in the subject line of the email. This keyword is optional if used after entering the email option.
Example

The following example shows how to send the output of a CLI command to a user-specified e-mail address:

Router# call-home send "show diag" email support@example.com

How To Configure Call Home to Support the Smart Call Home Service

This section provides an overview of the minimum steps required to configure the Call Home feature on a Cisco device, and other required supporting configuration to communicate securely with the Smart Call Home service using HTTPS:

Prerequisites

Before you configure and use the Smart Call Home Service, be sure that you have completed the following prerequisites:

  • Verify that you have an active Cisco Systems service contract for the device being configured.
  • Verify that you have IP connectivity to the Cisco HTTPS server.
  • Obtain the latest Cisco Systems server security certificate. In Cisco IOS XE Release 2.6.0, the following shows the latest text for the Cisco Systems server security certificate: 

MIIDAjCCAmsCEH3Z/gfPqB63EHln+6eJNMYwDQYJKoZIhvcNAQEFBQAwgcExCzAJ
BgNVBAYTAlVTMRcwFQYDVQQKEw5WZXJpU2lnbiwgSW5jLjE8MDoGA1UECxMzQ2xh
c3MgMyBQdWJsaWMgUHJpbWFyeSBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eSAtIEcy
MTowOAYDVQQLEzEoYykgMTk5OCBWZXJpU2lnbiwgSW5jLiAtIEZvciBhdXRob3Jp
emVkIHVzZSBvbmx5MR8wHQYDVQQLExZWZXJpU2lnbiBUcnVzdCBOZXR3b3JrMB4X
DTk4MDUxODAwMDAwMFoXDTI4MDgwMTIzNTk1OVowgcExCzAJBgNVBAYTAlVTMRcw
FQYDVQQKEw5WZXJpU2lnbiwgSW5jLjE8MDoGA1UECxMzQ2xhc3MgMyBQdWJsaWMg
UHJpbWFyeSBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eSAtIEcyMTowOAYDVQQLEzEo
YykgMTk5OCBWZXJpU2lnbiwgSW5jLiAtIEZvciBhdXRob3JpemVkIHVzZSBvbmx5
MR8wHQYDVQQLExZWZXJpU2lnbiBUcnVzdCBOZXR3b3JrMIGfMA0GCSqGSIb3DQEB
AQUAA4GNADCBiQKBgQDMXtERXVxp0KvTuWpMmR9ZmDCOFoUgRm1HP9SFIIThbbP4
pO0M8RcPO/mn+SXXwc+EY/J8Y8+iR/LGWzOOZEAEaMGAuWQcRXfH2G71lSk8UOg0
13gfqLptQ5GVj0VXXn7F+8qkBOvqlzdUMG+7AUcyM83cV5tkaWH4mx0ciU9cZwID
AQABMA0GCSqGSIb3DQEBBQUAA4GBAFFNzb5cy5gZnBWyATl4Lk0PZ3BwmcYQWpSk
U01UbSuvDV1Ai2TT1+7eVmGSX6bEHRBhNtMsJzzoKQm5EWR0zLVznxxIqbxhAe7i
F6YM40AIOw7n60RzKprxaZLvcRTDOaxxp5EJb+RxBrO6WVcmeQD2+A2iMzAo1KpY
oJ2daZH9

Configure and Enable Call Home

To establish the Cisco Smart Call Home service, there are certain steps that must be performed to configure and enable the Call Home feature on the router.

The CiscoTAC-1 profile is predefined in the Call Home feature to communicate using email to the back-end server for the Smart Call Home service. The URL to the Cisco HTTPS back-end server is also predefined. This profile is inactive by default.

However, unlike other profiles that you can configure in Call Home to support both transport methods, the CiscoTAC-1 profile can only use one transport method at a time. Therefore, to use this profile with the Cisco Smart Call Home HTTPS server, you must change the transport method from email to HTTP and enable the profile. In addition, you must minimally specify a contact e-mail address and enable the Call Home feature.

Procedure
  Command or Action Purpose

Step 1

configure terminal

Example:

Router# configure terminal

Enters global configuration mode.

Step 2

call -home

Example:

Router(config)# call-home

Enters call home configuration mode.

Step 3

profile CiscoTAC-1

Example:

Router(config-call-home)# profile CiscoTAC-1

Enters call home destination profile configuration mode for the CiscoTAC-1 destination profile.

Step 4

destination transport-method http

Example:

Router(cfg-call-home-profile)# destination transport-method http

(Required only if using HTTPS) Configures the message transport method for http.

Step 5

active

Example:

Router(cfg-call-home-profile)# active

Enables the destination profile.

Step 6

exit

Example:

Router(cfg-call-home-profile)# exit

Exits call home destination profile configuration mode and returns to call home configuration mode.

Step 7

contact-email-addr email-address

Example:

Router(cfg-call-home)# contact-email-addr username@example.com

Assigns the customer’s e-mail address. Enter up to 200 characters in e-mail address format with no spaces.

Step 8

exit

Example:

Router(cfg-call-home)# exit

Exits call home configuration mode and returns to global configuration mode.

Step 9

service call-home

Example:

Router(config)# service call-home

Enables the Call Home feature.

Step 10

exit

Example:

Router(config)# exit

Exits global configuration mode and returns to privileged EXEC mode.

Step 11

copy running-config startup-config

Example:

Router# copy running-config startup-config

Saves the configuration to NVRAM.

Enabling and Disabling Call Home

To enable or disable the Call Home feature, complete the following steps:

Procedure
  Command or Action Purpose

Step 1

configure terminal

Example:

Router# configure terminal

Enters global configuration mode.

Step 2

service call-home

Example:

Router(config)# service call-home

Enables the Call Home feature.

Step 3

no service call-home

Example:

Router(config)# no service call-home

Disables the Call Home feature.

Declare and Authenticate a CA Trustpoint

To establish communication with the Cisco HTTPS server for Smart Call Home service, you must declare and authenticate the Cisco server security certificate.

Procedure
  Command or Action Purpose

Step 1

configure terminal

Example:

Router# configure terminal

Enters global configuration mode.

Step 2

crypto pki trustpoint name

Example:

Router(config)# crypto pki trustpoint cisco

Declares a CA trustpoint on your router and enters CA trustpoint configuration mode.

Step 3

enrollment terminal

Example:

Router(ca-trustpoint)# enrollment terminal

Specifies a manual cut-and-paste method of certificate enrollment.

Step 4

exit

Example:

Router(ca-trustpoint)# exit

Exits CA trustpoint configuration mode and returns to global configuration mode.

Step 5

crypto pki authenticate name

Example:

Router(config)# crypto pki authenticate cisco

Authenticates the named CA.

Note

 
The CA name should match the name specified in the crypto pki trustpoint command.

Step 6

At the prompt, paste the security certificate text.

Example:

Enter the base 64 encoded CA certificate.
Example:

End with a blank line or the word "quit" on a line by itself
Example:

<Paste certificate text here>

Specifies the security certificate text.

Step 7

quit

Example:
quit

Specifies the end of the security certificate text.

Step 8

yes

Example:
% Do you accept this certificate? [yes/no]: yes

Confirms acceptance of the entered security certificate.

Step 9

end

Example:

Router# end

Exits global configuration mode and returns to privileged EXEC mode.

Step 10

copy running-config startup-config

Example:

Router# copy running-config startup-config

Saves the configuration to NVRAM.

Example: Declaring and authenticating the Cisco server security certificate

The following example shows the configuration for declaring and authenticating the Cisco server security certificate: 


Router# configure terminal
Router(config)# crypto pki trustpoint cisco
Router(ca-trustpoint)# enrollment terminal
Router(ca-trustpoint)# exit
Router(config)# crypto pki authenticate cisco
Enter the base 64 encoded CA certificate.
End with a blank line or the word "quit" on a line by itself
MIIDAjCCAmsCEH3Z/gfPqB63EHln+6eJNMYwDQYJKoZIhvcNAQEFBQAwgcExCzAJ
BgNVBAYTAlVTMRcwFQYDVQQKEw5WZXJpU2lnbiwgSW5jLjE8MDoGA1UECxMzQ2xh
c3MgMyBQdWJsaWMgUHJpbWFyeSBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eSAtIEcy
MTowOAYDVQQLEzEoYykgMTk5OCBWZXJpU2lnbiwgSW5jLiAtIEZvciBhdXRob3Jp
emVkIHVzZSBvbmx5MR8wHQYDVQQLExZWZXJpU2lnbiBUcnVzdCBOZXR3b3JrMB4X
DTk4MDUxODAwMDAwMFoXDTI4MDgwMTIzNTk1OVowgcExCzAJBgNVBAYTAlVTMRcw
FQYDVQQKEw5WZXJpU2lnbiwgSW5jLjE8MDoGA1UECxMzQ2xhc3MgMyBQdWJsaWMg
UHJpbWFyeSBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eSAtIEcyMTowOAYDVQQLEzEo
YykgMTk5OCBWZXJpU2lnbiwgSW5jLiAtIEZvciBhdXRob3JpemVkIHVzZSBvbmx5
MR8wHQYDVQQLExZWZXJpU2lnbiBUcnVzdCBOZXR3b3JrMIGfMA0GCSqGSIb3DQEB
AQUAA4GNADCBiQKBgQDMXtERXVxp0KvTuWpMmR9ZmDCOFoUgRm1HP9SFIIThbbP4
pO0M8RcPO/mn+SXXwc+EY/J8Y8+iR/LGWzOOZEAEaMGAuWQcRXfH2G71lSk8UOg0
13gfqLptQ5GVj0VXXn7F+8qkBOvqlzdUMG+7AUcyM83cV5tkaWH4mx0ciU9cZwID
AQABMA0GCSqGSIb3DQEBBQUAA4GBAFFNzb5cy5gZnBWyATl4Lk0PZ3BwmcYQWpSk
U01UbSuvDV1Ai2TT1+7eVmGSX6bEHRBhNtMsJzzoKQm5EWR0zLVznxxIqbxhAe7i
F6YM40AIOw7n60RzKprxaZLvcRTDOaxxp5EJb+RxBrO6WVcmeQD2+A2iMzAo1KpY
oJ2daZH9
quit
Certificate has the following attributes:
       Fingerprint MD5: A2339B4C 747873D4 6CE7C1F3 8DCB5CE9 
      Fingerprint SHA1: 85371CA6 E550143D CE280347 1BDE3A09 E8F8770F 
% Do you accept this certificate? [yes/no]: yes
Trustpoint CA certificate accepted.
% Certificate successfully imported
Router(config)# end
Router# copy running-config startup-config

Start Smart Call Home Registration

To start the Smart Call Home registration process, manually send an inventory alert-group message to the CiscoTAC-1 profile.

Procedure
Command or Action Purpose

call-home send alert-group inventory profile CiscoTAC-1

Example:

Device# call-home send alert-group inventory profile CiscoTAC-1

Sends an inventory alert group message to the CiscoTAC-1 destination profile.

What To Do Next

To receive an email from Cisco Systems and follow the instructions to complete the device registration in the Smart Call Home web application:

  • Launch the Smart Call Home web application at the following URL:

https://tools.cisco.com/sch/

  • Accept the Legal Agreement.
  • Confirm device registration for Call Home devices with pending registration.

For more information about using the Smart Call Home web application, see Smart Call Home User Guide . This user guide also includes configuration examples for sending Smart Call Home messages directly from your device or through a transport gateway (TG) aggregation point. You can use a TG aggregation point in cases requiring support for multiple devices or in cases where security requirements mandate that your devices must not be connected directly to the Internet.

Displaying Call Home Configuration Information

You can use variations of the show call-home command to display Call Home configuration information.

To display the configured Call Home information, use one or more of the following commands:

Procedure

  Command or Action Purpose

Step 1

show call-home

Example:


Device# show call-home

Displays the Call Home configuration in summary.

Step 2

show call-home detail

Example:


Device# show call-home detail

Displays the Call Home configuration in detail.

Step 3

show call-home alert-group

Example:


Device# show call-home alert-group

Displays the available alert groups and their status.

Step 4

show call-home mail-server status

Example:


Device# show call-home mail-server status

Checks and displays the availability of the configured e-mail server(s).

Step 5

show call-home profile {all | name }

Example:


Device# show call-home profile all

Displays the configuration of the specified destination profile. Use the all keyword to display the configuration of all destination profiles.

Step 6

show call-home statistics

Example:


Device# show call-home statistics

Displays the statistics of Call Home events.

Configuration Examples for Call Home

The following examples show the sample output when using different options of the show call-home command.

Examples

The following examples show the sample output when using different options of the show call-home command.

Configured Call Home Information in Summary 


Router# show call-home
Current call home settings:
    call home feature : disable
    call home message's from address: username@example.com
    call home message's reply-to address: username@example.com
    vrf for call-home messages: Mgmt-intf
    contact person's email address: username@example.com
    contact person's phone number: +14085551234
    street address: 1234 Any Street Any city Any state 12345
    customer ID: customer@example.com
    contract ID: 123456789
    site ID: example.com
    Mail-server[1]: Address: smtp.example.com Priority: 1
    Mail-server[2]: Address: 192.168.0.1 Priority: 2
    Rate-limit: 20 message(s) per minute
Available alert groups:
    Keyword                  State   Description
    ------------------------ ------- -------------------------------
    configuration            Enable  configuration info
    diagnostic               Enable  diagnostic info
    environment              Enable  environmental info
    inventory                Enable  inventory info
    syslog                   Enable  syslog info
Profiles:
    Profile Name: campus-noc
    Profile Name: CiscoTAC-1

Configured Call Home Information in Detail 


Router# show call-home detail
Current call home settings:
    call home feature : disable
    call home message's from address: username@example.com
    call home message's reply-to address: username@example.com
    vrf for call-home messages: Mgmt-intf
    contact person's email address: username@example.com
    contact person's phone number: +14085551234
    street address: 1234 Any Street Any city Any state 12345
    customer ID: customer@example.com
    contract ID: 123456789
    site ID: example.com
    Mail-server[1]: Address: smtp.example.com Priority: 1
    Mail-server[2]: Address: 192.168.0.1 Priority: 2
    Rate-limit: 20 message(s) per minute
Available alert groups:
    Keyword                  State   Description
    ------------------------ ------- -------------------------------
    configuration            Enable  configuration info
    diagnostic               Enable  diagnostic info
    environment              Enable  environmental info
    inventory                Enable  inventory info
    syslog                   Enable  syslog info
Profiles:
Profile Name: campus-noc
    Profile status: ACTIVE
    Preferred Message Format: long-text
    Message Size Limit: 3145728 Bytes
    Transport Method: email
    Email address(es): username@example.com
    HTTP  address(es): Not yet set up
    Alert-group               Severity
    ------------------------  ------------
    inventory                 normal
    Syslog-Pattern            Severity
    ------------------------  ------------
    N/A                       N/A
Profile Name: CiscoTAC-1
    Profile status: INACTIVE
    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 23 day of the month at 10:28
    Periodic inventory info message is scheduled every 23 day of the month at 10:13
    Alert-group               Severity
    ------------------------  ------------
    diagnostic                minor
    environment               minor
    inventory                 normal
    Syslog-Pattern            Severity
    ------------------------  ------------
    .*                        major

Available Call Home Alert Groups 


Router# show call-home alert-group
Available alert groups:
    Keyword                  State   Description
    ------------------------ ------- -------------------------------
    configuration            Enable  configuration info
    crash                    Enable  crash and traceback info
    environment              Enable  environmental info
    inventory                Enable  inventory info
    snapshot                 Enable  snapshot info     
    syslog                   Enable  syslog info

E-Mail Server Status Information 


Router# show call-home mail-server status
Please wait. Checking for mail server status ...
Translating "smtp.example.com"
    Mail-server[1]: Address: smtp.example.com Priority: 1 [Not Available]
    Mail-server[2]: Address: 192.168.0.1 Priority: 2 [Not Available]

Information About All Destination Profiles (Predefined and User-Defined) 


Router# show call-home profile all
Profile Name: campus-noc
    Profile status: ACTIVE
    Preferred Message Format: long-text
    Message Size Limit: 3145728 Bytes
    Transport Method: email
    Email address(es): username@example.com
    HTTP  address(es): Not yet set up
    Alert-group               Severity
    ------------------------  ------------
    inventory                 normal      
    Syslog-Pattern            Severity
    ------------------------  ------------
    N/A                       N/A
Profile Name: CiscoTAC-1
    Profile status: INACTIVE
    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 23 day of the month at 12:13
    Periodic inventory info message is scheduled every 23 day of the month at 11:58
    Alert-group               Severity
    ------------------------  ------------
    diagnostic                minor
    environment               minor       
    inventory                 normal      
    Syslog-Pattern            Severity
    ------------------------  ------------
    .*                        major 
Router#

Information About a User-Defined Destination Profile 


Router# show call-home profile campus-noc
Profile Name: campus-noc
    Profile status: ACTIVE
    Preferred Message Format: long-text
    Message Size Limit: 3145728 Bytes
    Transport Method: email
    Email address(es): username@example.com
    HTTP  address(es): Not yet set up
    Alert-group               Severity
    ------------------------  ------------
    inventory                 normal      
    Syslog-Pattern            Severity
    ------------------------  ------------
    N/A                       N/A

Call Home Statistics 


Router# show call-home statistics
Message Types    Total                Email                HTTP
-------------   -------------------- -------------------- ------------------
Total Success   6                    6                    0                    
    Config      4                    4                    0                    
    Diagnostic  0                    0                    0
    Environment 0                    0                    0                    
    Inventory   2                    2                    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                    
    Diagnostic  0                    0                    0
    Environment 0                    0                    0                    
    Inventory   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                    
    Diagnostic  0                    0                    0
    Environment 0                    0                    0                    
    Inventory   0                    0                    0                    
    SysLog      0                    0                    0                    
    Test        0                    0                    0                    
    Request     0                    0                    0                    
    Send-CLI    0                    0                    0                    
Total Ratelimit
      -dropped  0                    0                    0                    
    Config      0                    0                    0                    
    Diagnostic  0                    0                    0
    Environment 0                    0                    0                    
    Inventory   0                    0                    0                    
    SysLog      0                    0                    0                    
    Test        0                    0                    0                    
    Request     0                    0                    0                    
    Send-CLI    0                    0                    0                    
Last call-home message sent time: 2010-01-11 18:32:32 GMT+00:00

Default Settings

Lists of default Call Home settings.

Parameters

Default

Call Home feature status

Disabled

User-defined profile status

Active

Predefined Cisco TAC profile status

Inactive

Transport method

E-mail

Message format type

XML

Destination message size for a message sent in long text, short text, or XML format

3,145,728

Alert group status

Enabled

Call Home message severity threshold

0 (debugging)

Message rate limit for messages per minute

20

AAA Authorization

Disabled

Call Home syslog message throttling

Enabled

Data privacy level

Normal

Alert Group Trigger Events and Commands

Call Home trigger events are grouped into alert groups, with each alert group assigned CLI commands to execute when an event occurs. The CLI command output is included in the transmitted message. Table 1 lists the trigger events included in each alert group, including the severity level of each event and the executed CLI commands for the alert group.

Table 2. Call Home Alert Groups, Events, and Actions

Alert Group

Call Home Trigger Event

Syslog Event

Severity

Description and CLI Commands Executed

Configuration

—

—

—

User-generated request for configuration. (Sent to TAC.)

CLI commands executed:

show platform show inventory show running-config all show startup-config show version

Crash

Reload

System crash and device reload

7

Crash dump reporting allows crash information to be collected and send to Cisco backend when a system is reloaded due to reload.

Note

 

Kernal crash can't be processed.

CLI commands executed:

show version show logging show region show inventory show stack

Environmental

—

—

—

Events related to power, fan, and environment sensing elements, such as temperature alarms. (Sent to TAC.)

CLI commands executed:

show platform show environment show inventory show logging

—

—

%ENVIRONMENTAL-1-ALERT

1

Any sensor in fp/cc/rp has exceeded a certain threshold and resulted in this environmental alert.

—

ENVM

%ENVIRONMENTAL-1-SENSORFAIL

1

Any sensor in fp/cc/rp has failed and resulted in this environmental alert.

—

—

%ENVIRONMENTAL-1-SENSOROK

1

Any sensor in fp/cc/rp has recovered and resulted in this environmental alert.

Inventory

—

—

—

Inventory status should be provided whenever a unit is cold-booted, or when FRUs are inserted or removed. This is considered a noncritical event, and the information is used for status and entitlement. (Sent to TAC.)

CLI commands executed:

show platform show inventory oid show version show diag all eeprom detail

Syslog

—

—

—

Event logged to syslog.

CLI commands executed:

show inventory show logging

—

SYSLOG

LOG_EMERG

0

System is unusable.

—

SYSLOG

LOG_ALERT

1

Action must be taken immediately.

—

SYSLOG

LOG_CRIT

2

Critical conditions.

—

SYSLOG

LOG_ERR

3

Error conditions.

—

SYSLOG

LOG_WARNING

4

Warning conditions.

—

SYSLOG

LOG_NOTICE

5

Normal but signification condition.

—

SYSLOG

LOG_INFO

6

Informational.

—

SYSLOG

LOG_DEBUG

7

Debug-level messages.

Test

—

TEST

—

User-generated test message. (Sent to TAC.)

CLI commands executed:

show platform show inventory show version

Message Contents

The following tables display the content formats of alert group messages:

  • The Format for a Short Text Message table describes the content fields of a short text message.
  • The Common Fields for All Long Text and XML Messages table describes the content fields that are common to all long text and XML messages. The fields specific to a particular alert group message are inserted at a point between the common fields. The insertion point is identified in the table.
  • The Inserted Fields for a Reactive or Proactive Event Message table describes the inserted content fields for reactive messages (system failures that require a TAC case) and proactive messages (issues that might result in degraded system performance).
  • The Inserted Fields for an Inventory Event Message table describes the inserted content fields for an inventory message.

This section also includes the following subsections that provide sample messages:

Table 3. Format for a Short Text Message

Data Item

Description

Device identification

Configured device name

Date/time stamp

Time stamp of the triggering event

Error isolation message

Plain English description of triggering event

Alarm urgency level

Error level such as that applied to a system message

Table 4. Common Fields for All Long Text and XML Messages

Data Item (Plain Text and XML)

Description (Plain Text and XML)

MML Tag (XML Only)

Time stamp

Date and time stamp of event in ISO time notation:

YYYY-MM-DD HH:MM:SS GMT+HH:MM .

CallHome/EventTime

Message name

Name of message. Specific event names are listed in the Alert Group Trigger Events and Commands section.

For short text message only

Message type

Specifically “Call Home”.

CallHome/Event/Type

Message subtype

Specific type of message: full, delta, test

CallHome/Event/SubType

Message group

Specifically “reactive”. Optional, because default is “reactive”.

Not applicable. For long-text message only

Severity level

Severity level of message.

Body/Block/Severity

Source ID

Product type for routing through the workflow engine. This is typically the product family name.

For long-text message only

Device ID

Unique device identifier (UDI) for end device generating message. This field should be empty if the message is nonspecific 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: ASR1006@C@FOX105101DH

CallHome/CustomerData/ ContractData/DeviceId

Customer ID

Optional user-configurable field used for contract information or other ID by any support service.

CallHome/CustomerData/ ContractData/CustomerId

Contract ID

Optional user-configurable field used for contract information or other ID by any support service.

CallHome/CustomerData/ ContractData/ContractId

Site ID

Optional user-configurable field used for site IDs supplied by Cisco Systems or other data meaningful to alternate support services.

CallHome/CustomerData/ ContractData/SiteId

Server ID

If the message is generated from the fabric switch, this is the unique device identifier (UDI) of the 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: ASR1006@C@FOX105101DH

For long text message only

Message description

Short text describing the error.

CallHome/MessageDescription

Device name

Node that experienced the event. This is the host name of the device.

CallHome/CustomerData/ SystemInfo/NameName

Contact name

Name of person to contact for issues associated with the node experiencing the event.

CallHome/CustomerData/ SystemInfo/Contact

Contact e-mail

E-mail address of person identified as contact for this unit.

CallHome/CustomerData/ SystemInfo/ContactEmail

Contact phone number

Phone number of the person identified as the contact for this unit.

CallHome/CustomerData/ SystemInfo/ContactPhoneNumber

Street address

Optional field containing street address for RMA part shipments associated with this unit.

CallHome/CustomerData/ SystemInfo/StreetAddress

Model name

Model name of the router. This is the “specific model as part of a product family name.

CallHome/Device/Cisco_Chassis/ Model

Serial number

Chassis serial number of the unit.

CallHome/Device/Cisco_Chassis/ SerialNumber

Chassis part number

Top assembly number of the chassis.

CallHome/Device/Cisco_Chassis/ AdditionalInformation/AD@name= “PartNumber”

System object ID

System Object ID that uniquely identifies the system.

CallHome/Device/Cisco_Chassis/ AdditionalInformation/AD@name= “sysObjectID”

System description

System description for the managed element.

CallHome/Device/Cisco_Chassis/ AdditionalInformation/AD@name= “sysDescr”

Fields specific to a particular alert group message are inserted here.

The following fields may be repeated if multiple CLI commands are executed for this alert group.

Command output name

The exact name of the issued CLI command.

/aml/Attachments/Attachment/Name

Attachment type

Attachment type. Usually “inline”.

/aml/Attachments/Attachment@type

MIME type

Normally “text” or “plain” or encoding type.

/aml/Attachments/Attachment/ Data@encoding

Command output text

Output of command automatically executed.

/mml/attachments/attachment/atdata

Table 5. Inserted Fields for a Reactive or Proactive Event Message

Data Item (Plain Text and XML)

Description (Plain Text and XML)

MML Tag (XML Only)

Chassis hardware version

Hardware version of chassis.

CallHome/Device/Cisco_Chassis/ HardwareVersion

Supervisor module software version

Top-level software version.

CallHome/Device/Cisco_Chassis/ AdditionalInformation/AD@name= “SoftwareVersion”

Affected FRU name

Name of the affected FRU generating the event message.

CallHome/Device/Cisco_Chassis/ Cisco_Card/Model

Affected FRU serial number

Serial number of affected FRU.

CallHome/Device/Cisco_Chassis/ Cisco_Card/SerialNumber

Affected FRU part number

Part number of affected FRU.

CallHome/Device/Cisco_Chassis/ Cisco_Card/PartNumber

FRU slot

Slot number of FRU generating the event message.

CallHome/Device/Cisco_Chassis/ Cisco_Card/LocationWithinContainer

FRU hardware version

Hardware version of affected FRU.

CallHome/Device/Cisco_Chassis/ Cisco_Card/HardwareVersion

FRU software version

Software version(s) running on affected FRU.

CallHome/Device/Cisco_Chassis/ Cisco_Card/SoftwareIdentity/ VersionString

Table 6. Inserted Fields for an Inventory Event Message

Data Item (Plain Text and XML)

Description (Plain Text and XML)

MML Tag (XML Only)

Chassis hardware version

Hardware version of chassis.

CallHome/Device/Cisco_Chassis/ HardwareVersion

Supervisor module software version

Top-level software version.

CallHome/Device/Cisco_Chassis/ AdditionalInformation/AD@name= “SoftwareVersion”

FRU name

Name of the affected FRU generating the event message.

CallHome/Device/Cisco_Chassis/ Cisco_Card/Model

FRU s/n

Serial number of FRU.

CallHome/Device/Cisco_Chassis/ Cisco_Card/SerialNumber

FRU part number

Part number of FRU.

CallHome/Device/Cisco_Chassis/ Cisco_Card/PartNumber

FRU slot

Slot number of FRU.

CallHome/Device/Cisco_Chassis/ Cisco_Card/LocationWithinContainer

FRU hardware version

Hardware version of FRU.

CallHome/Device/Cisco_Chassis/ CiscoCard/HardwareVersion

FRU software version

Software version(s) running on FRU.

CallHome/Device/Cisco_Chassis/ Cisco_Card/SoftwareIdentity/ VersionString

Sample Syslog Alert Notification in Long Text Format

The following example shows a Syslog alert notification in long text format: 


TimeStamp : 2014-07-09 09:17 GMT+00:00
Message Name : syslog
Message Type : Call Home
Message Group : reactive
Severity Level : 4
Source ID : ASR920
Device ID : ASR-920@C@CAT1740U01D
Customer ID : 
Contract ID : 
Site ID : 
Server ID : ASR-920@C@CAT1740U01D
Event Description : *Jul  9 09:17:03.055: %LINK-3-UPDOWN: Interface GigabitEthernet0/0/11, changed state to up System Name : Router Contact Email : vmalshet@cisco.com Contact Phone : 
Street Address : 
Affected Chassis : ASR-920
Affected Chassis Serial Number : CAT1740U01D Affected Chassis Part No : 68-3992-01 Affected Chassis Hardware Version : 1.0 Supervisor Software Version : 15.5(20140708:133902) Command Output Name : show logging Attachment Type : command output MIME Type : text/plain Command Output Text : 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 Inactive Message Discriminator.


    Console logging: level debugging, 183 messages logged, xml disabled,
                     filtering disabled
    Monitor logging: level debugging, 0 messages logged, xml disabled,
                     filtering disabled
    Buffer logging:  level debugging, 48 messages logged, xml disabled,
                    filtering disabled
    Exception Logging: size (4096 bytes)
    Count and timestamp logging messages: disabled
    Persistent logging: disabled
    Trap logging: level informational, 114 message lines logged
        Logging Source-Interface:       VRF Name:

Log Buffer (1000000 bytes):

*Jul  9 08:25:11.492: %SYS-5-LOG_CONFIG_CHANGE: Buffer logging: level debugging, xml disabled, filtering disabled, size (1000000) *Jul  9 08:25:17.639: %SYS-5-CONFIG_I: Configured from console by console *Jul  9 08:27:13.757: DEBUG - Found job name 9, to be triggered in 1049 secs, changing to 1 seconds *Jul  9 08:27:13.757: DEBUG - *Jul  9 08:27:14.758: DEBUG - Invoking callback 0x3B9887B0 for job 9 *Jul  9 08:27:14.758: DEBUG - *Jul  9 08:27:14.957: %SSH-5-DISABLED: SSH 1.99 has been disabled *Jul  9 08:27:21.719: %SSH-5-ENABLED: SSH 1.99 has been enabled *Jul  9 08:27:21.910: %PKI-4-NOCONFIGAUTOSAVE: Configuration was modified.  Issue "write memory" to save new IOS PKI configuration *Jul  9 08:27:21.910: DEBUG - Found job name 9, to be triggered in 1 secs, changing to 1189 seconds *Jul  9 08:27:21.910: DEBUG - *Jul  9 08:30:36.996: DEBUG - Found job name 9, to be triggered in 1189 secs, changing to 1 seconds *Jul  9 08:30:36.997: DEBUG - *Jul  9 08:30:37.995: DEBUG - Invoking callback 0x3B9887B0 for job 9 *Jul  9 08:30:37.996: DEBUG - *Jul  9 08:30:38.198: %SSH-5-DISABLED: SSH 1.99 has been disabled *Jul  9 08:30:41.734: %SSH-5-ENABLED: SSH 1.99 has been enabled *Jul  9 08:30:41.935: %PKI-4-NOCONFIGAUTOSAVE: Configuration was modified.  Issue "write memory" to save new IOS PKI configuration *Jul  9 08:30:41.935: DEBUG - Found job name 9, to be triggered in 1 secs, changing to 928 seconds *Jul  9 08:30:41.935: DEBUG - *Jul  9 08:46:09.936: DEBUG - Invoking callback 0x3B9887B0 for job 9 *Jul  9 08:46:09.936: DEBUG - *Jul  9 08:46:10.136: %SSH-5-DISABLED: SSH 1.99 has been disabled *Jul  9 08:46:14.301: %SSH-5-ENABLED: SSH 1.99 has been enabled *Jul  9 08:46:14.483: %PKI-4-NOCONFIGAUTOSAVE: Configuration was modified.  Issue "write memory" to save new IOS PKI configuration *Jul  9 08:46:14.483: DEBUG - Found job name 9, to be triggered in 928 secs, changing to 1033 seconds *Jul  9 08:46:14.483: DEBUG - *Jul  9 09:03:27.484: DEBUG - Invoking callback 0x3B9887B0 for job 9 *Jul  9 09:03:27.484: DEBUG - *Jul  9 09:03:27.688: %SSH-5-DISABLED: SSH 1.99 has been disabled *Jul  9 09:03:33.000: %SSH-5-ENABLED: SSH 1.99 has been enabled *Jul  9 09:03:33.190: %PKI-4-NOCONFIGAUTOSAVE: Configuration was modified.  Issue "write memory" to save new IOS PKI configuration *Jul  9 09:03:33.191: DEBUG - Found job name 9, to be triggered in 1033 secs, changing to 1144 seconds *Jul  9 09:03:33.191: DEBUG - *Jul  9 09:07:03.174: DEBUG - Invoking callback 0x3B988508 for job 12 *Jul  9 09:07:03.174: DEBUG - *Jul  9 09:07:03.174: %SMART_LIC-3-EVAL_EXPIRED_WARNING: Evaluation period expired on Jan  1 00:00:00 1970 UTC where Jan  1 00:00:00 1970 UTC is the UTC date that it expired.
*Jul  9 09:07:03.174: DEBUG - Found job name 12, to be triggered in 3600 secs, changing to 3600 seconds *Jul  9 09:07:03.174: DEBUG - *Jul  9 09:10:32.325: SMART-LICENSE-TRACE: call_home_smart_license_status_get[446], Get smart license status 1 *Jul  9 09:11:14.883: %SYS-5-CONFIG_I: Configured from console by console *Jul  9 09:12:23.087: %SYS-5-CONFIG_I: Configured from console by console *Jul  9 09:12:58.243: %SYS-5-CONFIG_I: Configured from console by console *Jul  9 09:13:29.983: %LINK-5-CHANGED: Interface GigabitEthernet0/0/11, changed state to administratively down *Jul  9 09:13:30.682: %LINEPROTO-5-UPDOWN: Line protocol on Interface GigabitEthernet0/0/11, changed state to down *Jul  9 09:13:43.831: %SYS-5-CONFIG_I: Configured from console by console *Jul  9 09:16:42.319: %SYS-5-CONFIG_I: Configured from console by console *Jul  9 09:16:58.459: %LINK-3-UPDOWN: Interface GigabitEthernet0/0/11, changed state to down Router# Command Output Name : show inventory Attachment Type : command output MIME Type : text/plain Command Output Text : show inventory
NAME: "Chassis", DESCR: "Cisco ASR920 Series - 12GE and 2-10GE - AC model"
PID: ASR-920           , VID: V01, SN: CAT1740U01D

NAME: "IM subslot 0/0", DESCR: "12-port Gig & 2-port Ten Gig Dual Ethernet Interface Module"
PID: 12xGE-2x10GE-FIXED, VID: V00, SN: N/A        

NAME: "subslot 0/0 transceiver 1", DESCR: "GE SX"
PID: GLC-SX-MMD          , VID: A   , SN: FNS17481N4J     

NAME: "subslot 0/0 transceiver 2", DESCR: "GE SX"
PID: FTLF8519P2BCL-CS  , VID: 0000, SN: FNS11270EAW     

NAME: "subslot 0/0 transceiver 3", DESCR: "GE ZX"
PID: GLC-ZX-SMD          , VID: M1  , SN: OPL14450280     

NAME: "subslot 0/0 transceiver 4", DESCR: "GE SX"
PID: GLC-SX-MMD          , VID: A   , SN: FNS17220A5R     

NAME: "subslot 0/0 transceiver 5", DESCR: "GE SX"
PID: QFBR-5766LP       , VID:     , SN: AGS09498EPL     

NAME: "subslot 0/0 transceiver 6", DESCR: "GE SX"
PID: GLC-SX-MMD          , VID: A   , SN: FNS17472EX1     

NAME: "subslot 0/0 transceiver 7", DESCR: "GE SX"
PID: GLC-SX-MMD          , VID: A   , SN: FNS17372HFX     

NAME: "subslot 0/0 transceiver 9", DESCR: "GE SX"
PID: GLC-SX-MMD          , VID: A   , SN: FNS17481M3M     

NAME: "subslot 0/0 transceiver 13", DESCR: "SFP+ 10GBASE-SR"
PID: SFP-10G-SR          , VID: G4.1, SN: AVD1744A0UW     

NAME: "module R0", DESCR: "ASR 920 Route Switch Processor , Base Scale, 64Gbps "
PID: ASR-920-12CZ-A    , VID: V00, SN: CAT1740U01D

Sample Syslog Alert Notification in XML Format

The following example shows a Syslog alert notification in XML format: 


<?xml version="1.0" encoding="UTF-8"?>
<soap-env:Envelope xmlns:soap-env="http://www.w3.org/2003/05/soap-envelope">
<soap-env:Header>
<aml-session:Session xmlns:aml-session="http://www.cisco.com/2004/01/aml-session" soap-env:mustUnderstand="true" soap-env:role="http://www.w3.org/2003/05/soap-envelope/role/next">
<aml-session:To>http://tools.cisco.com/neddce/services/DDCEService</aml-session:To>
<aml-session:Path>
<aml-session:Via>http://www.cisco.com/appliance/uri</aml-session:Via>
</aml-session:Path>
<aml-session:From>http://www.cisco.com/appliance/uri</aml-session:From>
<aml-session:MessageId>M2:CAT1740U01D:53BD07BB</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>2014-07-09 09:13:31 GMT+00:00</aml-block:CreationDate>
<aml-block:Builder>
<aml-block:Name>ASR920</aml-block:Name>
<aml-block:Version>2.0</aml-block:Version>
</aml-block:Builder>
<aml-block:BlockGroup>
<aml-block:GroupId>G3:CAT1740U01D:53BD07BB</aml-block:GroupId>
<aml-block:Number>0</aml-block:Number>
<aml-block:IsLast>true</aml-block:IsLast>
<aml-block:IsPrimary>true</aml-block:IsPrimary>
<aml-block:WaitForPrimary>false</aml-block:WaitForPrimary>
</aml-block:BlockGroup>
<aml-block:Severity>2</aml-block:Severity>
</aml-block:Header>
<aml-block:Content>
<ch:CallHome xmlns:ch="http://www.cisco.com/2005/05/callhome" version="1.0">
<ch:EventTime>2014-07-09 09:13:29 GMT+00:00</ch:EventTime> <ch:MessageDescription>*Jul  9 09:13:29.983: %LINK-5-CHANGED: Interface GigabitEthernet0/0/11, changed state to administratively down</ch:MessageDescription> <ch:Event> <ch:Type>syslog</ch:Type> <ch:SubType></ch:SubType> <ch:Brand>Cisco Systems</ch:Brand>
<ch:Series>ASR920 Series Router</ch:Series> </ch:Event> <ch:CustomerData> <ch:UserData> <ch:Email>vmalshet@cisco.com</ch:Email>
</ch:UserData>
<ch:ContractData>
<ch:CustomerId></ch:CustomerId>
<ch:SiteId></ch:SiteId>
<ch:ContractId></ch:ContractId>
<ch:DeviceId>ASR-920@C@CAT1740U01D</ch:DeviceId>
</ch:ContractData>
<ch:SystemInfo>
<ch:Name>Router</ch:Name>
<ch:Contact></ch:Contact>
<ch:ContactEmail>vmalshet@cisco.com</ch:ContactEmail>
<ch:ContactPhoneNumber></ch:ContactPhoneNumber>
<ch:StreetAddress></ch:StreetAddress>
</ch:SystemInfo>
<ch:CCOID></ch:CCOID>
</ch:CustomerData>
<ch:Device>
<rme:Chassis xmlns:rme="http://www.cisco.com/rme/4.0">
<rme:Model>ASR-920</rme:Model>
<rme:HardwareVersion>1.0</rme:HardwareVersion>
<rme:SerialNumber>CAT1740U01D</rme:SerialNumber>
<rme:AdditionalInformation>
<rme:AD name="PartNumber" value="68-3992-01" /> <rme:AD name="SoftwareVersion" value="15.5(20140708:133902)" /> <rme:AD name="SystemObjectId" value="1.3.6.1.4.1.9.1.2062" /> <rme:AD name="SystemDescription" value="Cisco IOS Software, ASR920 Software (PPC_LINUX_IOSD-UNIVERSALK9_NPE-M), Experimental Version 15.5(20140708:133902) [mcp_dev-mrameshj-july4 114] Copyright (c) 1986-2014 by Cisco Systems, Inc.
Compiled Tue 08-Jul-14 23:52 by mrameshj" /> <rme:AD name="ServiceNumber" value="" /> <rme:AD name="ForwardAddress" 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 Inactive Message Discriminator.


    Console logging: level debugging, 178 messages logged, xml disabled,
                     filtering disabled
    Monitor logging: level debugging, 0 messages logged, xml disabled,
                     filtering disabled
    Buffer logging:  level debugging, 43 messages logged, xml disabled,
                    filtering disabled
    Exception Logging: size (4096 bytes)
    Count and timestamp logging messages: disabled
    Persistent logging: disabled
    Trap logging: level informational, 109 message lines logged
        Logging Source-Interface:       VRF Name:

Log Buffer (1000000 bytes):

*Jul  9 08:25:11.492: %SYS-5-LOG_CONFIG_CHANGE: Buffer logging: level debugging, xml disabled, filtering disabled, size (1000000) *Jul  9 08:25:17.639: %SYS-5-CONFIG_I: Configured from console by console *Jul  9 08:27:13.757: DEBUG - Found job name 9, to be triggered in 1049 secs, changing to 1 seconds *Jul  9 08:27:13.757: DEBUG - *Jul  9 08:27:14.758: DEBUG - Invoking callback 0x3B9887B0 for job 9 *Jul  9 08:27:14.758: DEBUG - *Jul  9 08:27:14.957: %SSH-5-DISABLED: SSH 1.99 has been disabled *Jul  9 08:27:21.719: %SSH-5-ENABLED: SSH 1.99 has been enabled *Jul  9 08:27:21.910: %PKI-4-NOCONFIGAUTOSAVE: Configuration was modified.  Issue "write memory" to save new IOS PKI configuration *Jul  9 08:27:21.910: DEBUG - Found job name 9, to be triggered in 1 secs, changing to 1189 seconds *Jul  9 08:27:21.910: DEBUG - *Jul  9 08:30:36.996: DEBUG - Found job name 9, to be triggered in 1189 secs, changing to 1 seconds *Jul  9 08:30:36.997: DEBUG - *Jul  9 08:30:37.995: DEBUG - Invoking callback 0x3B9887B0 for job 9 *Jul  9 08:30:37.996: DEBUG - *Jul  9 08:30:38.198: %SSH-5-DISABLED: SSH 1.99 has been disabled *Jul  9 08:30:41.734: %SSH-5-ENABLED: SSH 1.99 has been enabled *Jul  9 08:30:41.935: %PKI-4-NOCONFIGAUTOSAVE: Configuration was modified.  Issue "write memory" to save new IOS PKI configuration *Jul  9 08:30:41.935: DEBUG - Found job name 9, to be triggered in 1 secs, changing to 928 seconds *Jul  9 08:30:41.935: DEBUG - *Jul  9 08:46:09.936: DEBUG - Invoking callback 0x3B9887B0 for job 9 *Jul  9 08:46:09.936: DEBUG - *Jul  9 08:46:10.136: %SSH-5-DISABLED: SSH 1.99 has been disabled *Jul  9 08:46:14.301: %SSH-5-ENABLED: SSH 1.99 has been enabled *Jul  9 08:46:14.483: %PKI-4-NOCONFIGAUTOSAVE: Configuration was modified.  Issue "write memory" to save new IOS PKI configuration *Jul  9 08:46:14.483: DEBUG - Found job name 9, to be triggered in 928 secs, changing to 1033 seconds *Jul  9 08:46:14.483: DEBUG - *Jul  9 09:03:27.484: DEBUG - Invoking callback 0x3B9887B0 for job 9 *Jul  9 09:03:27.484: DEBUG - *Jul  9 09:03:27.688: %SSH-5-DISABLED: SSH 1.99 has been disabled *Jul  9 09:03:33.000: %SSH-5-ENABLED: SSH 1.99 has been enabled *Jul  9 09:03:33.190: %PKI-4-NOCONFIGAUTOSAVE: Configuration was modified.  Issue "write memory" to save new IOS PKI configuration *Jul  9 09:03:33.191: DEBUG - Found job name 9, to be triggered in 1033 secs, changing to 1144 seconds *Jul  9 09:03:33.191: DEBUG - *Jul  9 09:07:03.174: DEBUG - Invoking callback 0x3B988508 for job 12 *Jul  9 09:07:03.174: DEBUG - *Jul  9 09:07:03.174: %SMART_LIC-3-EVAL_EXPIRED_WARNING: Evaluation period expired on Jan  1 00:00:00 1970 UTC where Jan  1 00:00:00 1970 UTC is the UTC date that it expired.
*Jul  9 09:07:03.174: DEBUG - Found job name 12, to be triggered in 3600 secs, changing to 3600 seconds *Jul  9 09:07:03.174: DEBUG - *Jul  9 09:10:32.325: SMART-LICENSE-TRACE: call_home_smart_license_status_get[446], Get smart license status 1 *Jul  9 09:11:14.883: %SYS-5-CONFIG_I: Configured from console by console *Jul  9 09:12:23.087: %SYS-5-CONFIG_I: Configured from console by console *Jul  9 09:12:58.243: %SYS-5-CONFIG_I: Configured from console by console Router#]]></aml-block:Data> </aml-block:Attachment> <aml-block:Attachment type="inline"> <aml-block:Name>show inventory</aml-block:Name> <aml-block:Data encoding="plain"> <![CDATA[show inventory
NAME: "Chassis", DESCR: "Cisco ASR920 Series - 12GE and 2-10GE - AC model"
PID: ASR-920           , VID: V01, SN: CAT1740U01D

NAME: "IM subslot 0/0", DESCR: "12-port Gig & 2-port Ten Gig Dual Ethernet Interface Module"
PID: 12xGE-2x10GE-FIXED, VID: V00, SN: N/A        

NAME: "subslot 0/0 transceiver 1", DESCR: "GE SX"
PID: GLC-SX-MMD          , VID: A   , SN: FNS17481N4J     

NAME: "subslot 0/0 transceiver 2", DESCR: "GE SX"
PID: FTLF8519P2BCL-CS  , VID: 0000, SN: FNS11270EAW     

NAME: "subslot 0/0 transceiver 3", DESCR: "GE ZX"
PID: GLC-ZX-SMD          , VID: M1  , SN: OPL14450280     

NAME: "subslot 0/0 transceiver 4", DESCR: "GE SX"
PID: GLC-SX-MMD          , VID: A   , SN: FNS17220A5R     

NAME: "subslot 0/0 transceiver 5", DESCR: "GE SX"
PID: QFBR-5766LP       , VID:     , SN: AGS09498EPL     

NAME: "subslot 0/0 transceiver 6", DESCR: "GE SX"
PID: GLC-SX-MMD          , VID: A   , SN: FNS17472EX1     

NAME: "subslot 0/0 transceiver 7", DESCR: "GE SX"
PID: GLC-SX-MMD          , VID: A   , SN: FNS17372HFX     

NAME: "subslot 0/0 transceiver 9", DESCR: "GE SX"
PID: GLC-SX-MMD          , VID: A   , SN: FNS17481M3M     

NAME: "subslot 0/0 transceiver 13", DESCR: "SFP+ 10GBASE-SR"
PID: SFP-10G-SR          , VID: G4.1, SN: AVD1744A0UW     

NAME: "module R0", DESCR: "ASR 920 Route Switch Processor , Base Scale, 64Gbps "
PID: ASR-920-12CZ-A    , VID: V00, SN: CAT1740U01D


Router#]]></aml-block:Data>
</aml-block:Attachment>
</aml-block:Attachments>
</aml-block:Block>
</soap-env:Body>
</soap-env:Envelope>

Additional References

The following sections provide references related to the Call Home feature.

Related Documents

Related Topic

Title

Cisco IOS XE commands

Cisco IOS Master Commands List, All Releases

Explains how the Smart Call Home service offers web-based access to important information on select Cisco devices and offers higher network availability, and increased operational efficiency by providing

real-time alerts.

Smart Call Home User Guide

Smart Call Home site page on Cisco.com for access to all related product information.

Cisco Smart Call Home site

Public Key Infrastructure (PKI) and Certificate Authority configuration in Cisco IOS XE software

Cisco IOS XE Security Configuration Guide: Secure Connectivity

Standards

Standard

Title

No new or modified standards are supported by this feature, and support for existing standards has not been modified by this feature.

—

MIBs

MIB

MIBs Link

CISCO-CALLHOME-MIB

To locate and download MIBs for selected platforms, Cisco IOS XE software releases, and feature sets, use Cisco MIB Locator found at the following URL:

http://www.cisco.com/go/mibs

RFCs

RFC

Title

No new or modified RFCs are supported by this feature, and support for existing RFCs has not been modified by this feature.

—

Technical Assistance

Description

Link

The Cisco Support website provides extensive online resources, including documentation and tools for troubleshooting and resolving technical issues with Cisco products and technologies.

To receive security and technical information about your products, you can subscribe to various services, such as the Product Alert Tool (accessed from Field Notices), the Cisco Technical Services Newsletter, and Really Simple Syndication (RSS) Feeds.

Access to most tools on the Cisco Support website requires a Cisco.com user ID and password.

http://www.cisco.com/cisco/web/support/index.html

Feature Information for Call Home

The following table provides release information about the feature or features described in this module. This table lists only the software release that introduced support for a given feature in a given software release train. Unless noted otherwise, subsequent releases of that software release train also support that feature.

Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to www.cisco.com/go/cfn. An account on Cisco.com is not required.

Table 7. Feature Information for Call Home

Feature Name

Releases

Feature Information

Call Home

Cisco IOS XE Release 3.13.0S

This feature was introduced on the Cisco ASR 920 Series Aggregation Services Router (ASR-920-12CZ-A, ASR-920-12CZ-D, ASR-920-4SZ-A, ASR-920-4SZ-D).