Call-Home Profile Configuration Mode

The Call-Home Profile Configuration Mode is used to create groups of users that will receive alerts when events occur. The Smart Call Home service sends real-time alerts, remediation, and personalized web-based reports to the Cisco Technical Assistance Center (TAC) and other configured receivers.

IMPORTANT:

The commands or keywords/variables that are available are dependent on platform type, product version, and installed license(s).

active

Activates this Smart Call Home profile.

Platform:

ASR 5000

Product:

All


Privilege:

Security Administrator, Administrator


Syntax
active 
default active 
no active 
default

Configures the call-home profile back to default settings. By default, the profile is enabled.

no

Deletes the call-home profile.

activate

Activates this Smart Call Home profile.


Usage:

Use this command to activate or deactivate this call-home profile. By default, the profile is enabled.


Example:
The following command disables the call-home profile:
no active 
destination

Configures the message destinations for this Smart Call Home profile.

Platform:

ASR 5000

Product:

All


Privilege:

Security Administrator, Administrator


Syntax
destination [ address [ email email_address | http http_url ] | message-size-limit size  | preferred-msg-format [ long-text | short-text | xml ] | transport-method [ email email_address | http http_url] ] 
default destination [ message-size-limit | preferred-msg-format | transport-method ] 
no destination [ address [ email email_address | http http_url ] | message-size-limit size  | preferred-msg-format [ long-text |short-text | xml ] | transport-method [ email email_address | http http_url ] ] 
address [ email email_address | http http_url ]

Configures an destination e-mail address or HTTP URL where short-text/long-text call-home message and XML-based call-home messages will be sent.

  • email: Use this option to add an e-mail address to this profile. email_addr is an alphanumeric string of the form local-part@domain where domain can be made up of a number of labels, each separated by a period and between 1 and 63 characters in length. The local-part can be 1-64 characters. The domain-label can be 1-63 characters. The domain can be 1-135 characters. The entire alphanumeric string can be a no larger than 200 characters.
  • http: Use this option to add an HTTP URL to this profile. http_url is an alphanumeric string of 1 through 200 characters.
default

Configures the call-home profile back to default settings. By default, the profile is enabled.

message-size-limit size

Specifies the message size (in bytes) for this profile as an integer from 50 to 3145728. The default is 3145728.

no

Deletes the call-home profile.

preferred-msg-format [ long-text | short-text | xml]

Specifies the message format for the profile. The default is xml.

  • long-text: Use this option to set long-text messages as the preferred message format. The long message format has all the details related to the event, including information related to chassis, card, and outputs of show commands for the alert group.
  • short-text: Use this option to set short-text messages as the preferred message format. The short message has information on the severity of event, a short description of the event, the event time, and the device ID.
  • xml: Use this option to set XML as the preferred message format. (Default)
transport-method [ email email_address | http http_url] ]

Specifies the transport-method for the messages. The default is e-mail. For the user profile, both e-mail and http can be enabled. If all are options are disabled, e-mail will be set for the profile.

For the Cisco TAC profile, only one transport method can be enabled. If the user enables a second transport method, the first one will be automatically disabled.

  • email: Enables an e-mail address for this profile. This is the default.
  • http: Enables an HTTP URL for this profile.

Usage:

Use this command to activate the current call-home profile. By default, the profile is enabled.


Example:
The following command disables the call-home profile:
no destination 
The following command sets the preferred message format for the profile to the call-home profile to short text:
destination preferred-msg-format
short-text  
end

Exits the current configuration mode and returns to the Exec mode.

Product:

All


Privilege:

Security Administrator, Administrator


Syntax
end

Usage:

Use this command to return to the Exec mode.

exit

Exits the current mode and returns to the parent configuration mode.

Product:

All


Privilege:

Security Administrator, Administrator


Syntax
exit

Usage:

Use this command to return to the parent configuration mode.

subscribe-to-alert-group

Subscribes this profile to the alert group for the call-home profile.

Platform:

ASR 5000

Product:

All


Privilege:

Security Administrator, Administrator


Syntax
subscribe-to-alert-group [ all {severity [ catastrophic | diasaster | fatal | critical | major | minor | warning | notification | normal ] }  | configuration { periodic [ daily | monthly | weekly] } 
 | crashinfo | diagnostic { severity [ catastrophic | diasaster | fatal | critical | major | minor | warning | notification | normal ] } | environment { severity [catastrophic | diasaster | fatal | critical | major | minor | warning | notification | normal ] }  | inventory { periodic [ daily | monthly | weekly] }  | syslog {severity [catastrophic | diasaster | fatal | critical | major | minor | warning | notification | normal ] } ]
default subscribe-to-alert-group 
no subscribe-to-alert-group [ all {severity [catastrophic | diasaster | fatal | critical | major | minor | warning | notification | normal ] }  | configuration { periodic [ daily | monthly | weekly] } | crashinfo | diagnostic {severity [catastrophic | diasaster | fatal | critical | major | minor | warning | notification | normal ] } | environment {severity [catastrophic | diasaster | fatal | critical | major | minor | warning | notification | normal ] }  | inventory { periodic [ daily | monthly | weekly] }  | syslog {severity [catastrophic | diasaster | fatal | critical | major | minor | warning | notification | normal ] [pattern pattern_to_match] } ]
all {severity [catastrophic | diasaster | fatal | critical | major | minor | warning | notification | normal ] }

Enables call-home messages based for all group-types and severity for the profile. The following severities are supported:

  • catastrophic– Level 1: catastrophic event, matches platform logging level critical.
  • disaster – Level 2: disaster event, matches platform logging level critical.
  • fatal – Level 3: fatal event, matches platform logging level critical.
  • critical – Level 4: critical event, matches platform logging level critical.
  • major – Level 5: major event, matches platform logging level error.
  • minor – Level 6: minor event, matches platform logging level warning.
  • warning – Level 7: warning event, matches platform logging level warning.
  • notification – Level 8: notification event, matches platform logging level unusual.
  • normal – Level 9: normal event, matches platform logging level info.
configuration { periodic [ daily | monthly | weekly] }

Enables call-home messages based for configuration alert groups. The messages are sent at periodic intervals such as:

  • daily: Sends a daily call-home message.
  • monthly: Sends a monthly call-home message.
  • weekly: Sends a weekly call-home message.
crashinfo

Configures the call-home profile back to default settings. By default, the profile is enabled.

default

Restores the parameter back to the default value.

diagnostic { severity [ catastrophic | diasaster | fatal | critical | major | minor | warning | notification | normal ] }

Enables call-home messages based for diagnostic group-types and severity for the profile. The following severities are supported:

  • catastrophic– Level 1: catastrophic event, matches platform logging level critical.
  • disaster – Level 2: disaster event, matches platform logging level critical.
  • fatal – Level 3: fatal event, matches platform logging level critical.
  • critical – Level 4: critical event, matches platform logging level critical.
  • major – Level 5: major event, matches platform logging level error.
  • minor – Level 6: minor event, matches platform logging level warning.
  • warning – Level 7: warning event, matches platform logging level warning.
  • notification – Level 8: notification event, matches platform logging level unusual.
  • normal – Level 9: normal event, matches platform logging level info.
environment {severity [ catastrophic | diasaster | fatal | critical | major | minor | warning | notification | normal ] }

Enables call-home messages based for environment group-types and severity for the profile. The following severities are supported:

  • catastrophic– Level 1: catastrophic event, matches platform logging level critical.
  • disaster – Level 2: disaster event, matches platform logging level critical.
  • fatal – Level 3: fatal event, matches platform logging level critical.
  • critical – Level 4: critical event, matches platform logging level critical.
  • major – Level 5: major event, matches platform logging level error.
  • minor – Level 6: minor event, matches platform logging level warning.
  • warning – Level 7: warning event, matches platform logging level warning.
  • notification – Level 8: notification event, matches platform logging level unusual.
  • normal – Level 9: normal event, matches platform logging level info.
inventory { periodic [ daily | monthly | weekly ] }

Enables call-home messages based for inventory alert groups. The messages are sent at periodic intervals such as:

  • daily: Sends a daily call-home message.
  • monthly: Sends a monthly call-home message.
  • weekly: Sends a weekly call-home message.
no

Deletes the alert groups.

syslog { severity [catastrophic | diasaster | fatal | critical | major | minor | warning | notification | normal ] [ pattern pattern_to_match] } ]

Enables and disables call-home messages based on severity and syslog string pattern match for the profile. The following severities are supported:

  • catastrophic– Level 1: catastrophic event, matches platform logging level critical.
  • disaster – Level 2: disaster event, matches platform logging level critical.
  • fatal – Level 3: fatal event, matches platform logging level critical.
  • critical – Level 4: critical event, matches platform logging level critical.
  • major – Level 5: major event, matches platform logging level error.
  • minor – Level 6: minor event, matches platform logging level warning.
  • warning – Level 7: warning event, matches platform logging level warning.
  • notification – Level 8: notification event, matches platform logging level unusual.
  • normal – Level 9: normal event, matches platform logging level info.

pattern_to_match is an alphanumeric string of 1 through 80 characters.

Note:

If no pattern_to_match is specified, the system will use a “.*” (dot asterisk) pattern.


Usage:

Use this command to enable or disable the call-home messages based on specified alert-groups and severities for the profile.


Example:
The following command sets an alert group for the profile to send a daily inventory message:
subscribe-to-alert-group
inventory periodic daily