System Management Configuration Guide for Cisco 8000 Series Routers, Cisco IOS XR Releases

PDF

System Management Configuration Guide for Cisco 8000 Series Routers, Cisco IOS XR Releases

Destination Profiles

Want to summarize with AI?

Log in

Describes how destination profiles manage Call Home alerts by defining recipient lists, message formats, severity thresholds, and alert group subscriptions to ensure critical system information reaches the appropriate support channels.


A destination profile includes the following information:

  • One or more alert groups—The group of alerts that trigger a specific Call Home message if the alert occurs.

  • One or more e-mail or HTTPS destinations—The list of recipients for the Call Home messages generated by alert groups assigned to this destination profile.

  • Message format—The format for the Call Home message (short text, full text, or XML).

  • Message severity level—The Call Home severity level that the alert must meet before a Call Home message is sent to all e-mail and HTTPS URL addresses in the destination profile. An alert is not generated if the Call Home severity level of the alert is lower than the message severity level set for the destination profile. The inventory and configuration alert groups do not have concept of severity level. They are generated directly.

You can also configure a destination profile to allow periodic inventory update messages by using the inventory alert group that will send out periodic messages daily, weekly, or monthly.

The following predefined destination profiles are supported:

  • CiscoTAC-1—Supports the Cisco-TAC alert group in XML message format.


Configuring and Activating Destination Profiles

You must have at least one activated destination profile for Call Home messages to be sent. The CiscoTAC-1 profile exists by default but is not active.

Procedure

1.

call-home

Example:


Router(config)# call-home
Router(config-call-home)#

Enters call home configuration mode.

2.

profile profile-name

Example:


Router(config-call-home)# profile my_profile
Router(config-call-home-profile)#

Enters call home profile configuration mode to configure a new or existing profile.

3.

destination address email email-address

Example:


Router(config-call-home-profile)# destination 
address email support_me@cisco.com

Configures an email address to which Call Home messages are sent for this profile.

4.

destination message-size-limit max-size

Example:


Router(config-call-home-profile)# destination 
message-size-limit 1000

Configures the maximum size of Call Home messages for this profile. Values can be between 50 and 3145728 characters.

5.

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

Example:


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

Configures the message format for this profile. The default is xml.

6.

destination transport-method [ email | hhtp ]

Example:


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

Configures the transport method for this profile.

7.

active

Example:


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

Activates the destination profile.

Note

At least one destination profile must be active for Call Home messages to be sent.

8.

show call-home profile {all | profile-name}

Example:


Router# show call-home profile all

Displays information about the destination profile.