destination-profile (Call Home)
To create a user-defined destination profile, or modify a predefined or user-defined destination profile, and configure the message format for that new destination profile, use the destination-profile command. To remove the destination profile, use the no form of this command.
destination-profile {CiscoTAC-1 | {full-txt-destination | short-txt-destination} {message-level level | message-size size}} {alert-group alert | email-addr email-address | http url | transport-method {email | http}}
destination-profile profile-name [alert-group alert | email-addr email-address | format {XML | full-txt | short-txt} | http url | message-level level | message-size size | transport-method {email | http}]
no destination-profile
Syntax Description
CiscoTAC-1 |
Configures a destination profile for Extensible Markup Language (XML) messages. |
full-txt-destination |
Configures a destination profile for plain text messages. |
short-txt-destination |
Configures a destination profile for short text message. |
message-level level |
Specifies the Call Home message severity level. The range is from 0 to 9, with 0 being the lowest urgency, and 9 the highest urgency. |
message-size size |
Specifies the maximum message size. The range is as follows:
|
alert-group alert |
Associates one or more alert groups with a destination profile. The alert group can be one of the following:
|
email-addr |
Specifies the e-mail address to which the alert should be sent. |
email-address |
E-mail address in email address format. The address can be a maximum of 255 alphanumeric characters and cannot contain white spaces; for example, personname@companyname.com . |
http url |
Specifies the HTTP or HTTPS URL. The url can be a maximum of 255 alphanumeric characters and cannot contain white spaces; for example, http://site.com/services/callserv https://site2.com/serv/CALL |
transport-method |
Specifies the transport method for sending Call Home messages. |
|
Specifies that Call Home messages be sent through e-mail. |
http |
Specifies that Call Home messages be sent using HTTP. |
profile-name |
User-defined profile name. The profile name can be a maximum of 31 alphanumeric characters. |
format |
(Optional) Specifies the Call Home message format. The default is XML. |
XML |
Specifies that the Call Home message format is XML. |
full-txt |
Specifies that the Call Home message format is plain text. |
short-txt |
Specifies that the Call Home message format is a short text message. |
Command Default
Message format: XML.
Message size: 2500000 for full-txt-destination, 4000 for short-txt-destination, and 4000000 for XML format.
Message level: 0
Alert group: All for full-text-destination and short-text-destination profiles. The cisco-tac alert group for the CiscoTAC-1 destination profile.
Command Modes
Callhome configuration mode
Command History
Release |
Modification |
---|---|
This command was introduced. |
Usage Guidelines
You can modify the following attributes for a predefined or user-defined destination profile:
- Destination e-mail address—The e-mail address to which the alert should be sent.
- Message formatting—The message format used for sending the alert (full text, short text, or XML).
- Message level—The Call Home message severity level for this destination profile.
- Message size—The allowed length of a Call Home message sent to the e-mail addresses in this destination profile.
Note |
You cannot modify or delete the CiscoTAC-1 destination profile. |
The Cisco Nexus 5000 Series switch does not generate an alert if the Call Home severity level of the alert is lower than the message severity level set for the destination profile.
Table 1 lists each Call Home message level keyword.
Call Home Level |
Keyword |
Description |
---|---|---|
9 |
Catastrophic |
Network-wide catastrophic failure. |
8 |
Disaster |
Significant network impact. |
7 |
Fatal |
System is unusable. |
6 |
Critical |
Critical conditions that indicate that immediate attention is needed. |
5 |
Major |
Major conditions. |
4 |
Minor |
Minor conditions. |
3 |
Warning |
Warning conditions. |
2 |
Notification |
Basic notification and informational messages. |
1 |
Normal |
Normal event signifying return to normal state. |
0 |
Debugging |
Debugging messages. |
Examples
This example shows how to create a user-defined Call Home destination profile to send Call Home messages through e-mail:
switch(config-callhome)# destination-profile myProfile alert-group Configuration email-addr myname@somecompany.com message-level 3 transport-method email
switch(config-callhome)#