The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
This chapter includes the following sections:
Cisco UCS Central supports global call home policies for notifying all email recipients defined in call home profiles to specific Cisco UCS Manager events. (There is no call home support for Cisco UCS Central in this release.) Profiles define lists of email recipients that receive alert notifications (to a maximum defined message size in full text, short text, or XML format) and alert criteria for triggering notifications.
Alert notifications are sent with predefined content based on alert levels (including major, minor, normal, notification and warning) and selected alert groups identifying events that trigger notification (such as diagnostic, environmental, inventory, license and other predefined events). Individual email recipients may be individually added to existing profiles. Registered Cisco UCS domains choosing to define security policies globally within that client's policy resolution control will defer all call home policies to its registration with Cisco UCS Central.
A call home policy is created from a domain group under the domain group root. Call home policies under the Domain Groups root that were already created by the system are ready to configure.
The following example shows how to scope into the domain group domaingroup01, create the Call Home policy, configure the Call Home policy, and commit the transaction:
UCSC # connect policy-mgr UCSC(policy-mgr)# scope domain-group domaingroup01 UCSC(policy-mgr) /domain-group # create callhome UCSC(policy-mgr) /domain-group/callhome* # set contract-id contract0995 UCSC(policy-mgr) /domain-group/callhome* # set customer-id customer112 UCSC(policy-mgr) /domain-group/callhome* # set hostname 0.0.0.0 UCSC(policy-mgr) /domain-group/callhome* # set phone-contact +1-011-408-555-1212 UCSC(policy-mgr) /domain-group/callhome* # set port 65535 UCSC(policy-mgr) /domain-group/callhome* # set site-id site15 UCSC(policy-mgr) /domain-group/callhome* # set street-address "75 Main St, Any Town, CA 90000" UCSC(policy-mgr) /domain-group/callhome* # set switch-priority notifications UCSC(policy-mgr) /domain-group/callhome* # set throttling on UCSC(policy-mgr) /domain-group/callhome* # commit-buffer UCSC(policy-mgr) /domain-group/callhome #
The following example shows how to scope into the domain group domaingroup01, scope the Call Home policy, set the customer's contact email, from email, and reply to email, and commit the transaction:
UCSC # connect policy-mgr UCSC(policy-mgr)# scope domain-group domaingroup01 UCSC(policy-mgr) /domain-group # scope callhome UCSC(policy-mgr) /domain-group/callhome # set email customer@email.com UCSC(policy-mgr) /domain-group/callhome # set from-email from@email.com UCSC(policy-mgr) /domain-group/callhome # set reply-to-email reply-to@email.com UCSC(policy-mgr) /domain-group/callhome* # commit-buffer UCSC(policy-mgr) /domain-group #
A call home policy is deleted from a domain group under the Domain Group root. Call home policies under the Domain Group root cannot be deleted.
Deleting a call home policy will remove all profiles, policies and system inventory settings within that policy.
The following example shows how to scope into the domain group domaingroup01, delete the Call Home policy, and commit the transaction:
UCSC # connect policy-mgr UCSC(policy-mgr)# scope domain-group domaingroup01 UCSC(policy-mgr) /domain-group # delete callhome UCSC(policy-mgr) /domain-group* # commit-buffer UCSC(policy-mgr) /domain-group #
Command or Action | Purpose | |||
---|---|---|---|---|
Step 1 | UCSC# connect policy-mgr | Enters policy manager mode. |
||
Step 2 | UCSC(policy-mgr)# scope domain-group domain-group | Enters domain group root mode and (optionally) enters a domain group under the domain group root. To enter the domain group root mode, type / as the domain-group. |
||
Step 3 | UCSC(policy-mgr) /domain-group # scope callhome | Scopes the default Call Home policy's configuration mode. |
||
Step 4 | UCSC(policy-mgr) /domain-group/callhome # create | scope profile profile-name | Creates a Call Home policy profile name and enters profile mode, or scopes an existing Call Home policy's profile mode. |
||
Step 5 | UCSC(policy-mgr) /domain-group/callhome/profile* # set alertgroups alert-group | Sets the profile alert group: |
||
Step 6 | UCSC(policy-mgr) /domain-group/callhome/profile* # add alertgroups alert-group | (Optional) Adds an additional profile alert group:
|
||
Step 7 | UCSC(policy-mgr) /domain-group/callhome/profile* # remove alertgroups alert-group | (Optional) Removes a specific profile alert groups from the buffer:
|
||
Step 8 | UCSC(policy-mgr) /domain-group/callhome/profile* # clear alertgroups | (Optional) Clears all profile alert groups from the buffer. |
||
Step 9 | UCSC(policy-mgr) /domain-group/callhome/profile* # set format format | Sets the format: |
||
Step 10 | UCSC(policy-mgr) /domain-group/callhome/profile* # set level level | Sets the level: |
||
Step 11 | UCSC(policy-mgr) /domain-group/callhome/profile* # set maxsize maximum-size | Sets the maximum size in megabytes (0-5000000). |
||
Step 12 | UCSC(policy-mgr) /domain-group/callhome/profile* # create | delete | scope destination destination-name | destination-email | Creates, deletes, or scopes the profile destination name or email address. |
||
Step 13 | UCSC(policy-mgr) /domain-group/callhome/profile/destination* # commit-buffer | Commits the transaction to the system configuration. |
The following example shows how to scope into the domain group domaingroup01, scope the Call Home policy, scope the policy profile chprofile01, configure the policy profile, and commit the transaction:
UCSC # connect policy-mgr UCSC(policy-mgr)# scope domain-group domaingroup01 UCSC(policy-mgr) /domain-group # scope callhome UCSC(policy-mgr) /domain-group/callhome # scope profile chprofile01 UCSC(policy-mgr) /domain-group/callhome/profile # set alertgroups diagnostic UCSC(policy-mgr) /domain-group/callhome/profile* # add alertgroups lifecycle UCSC(policy-mgr) /domain-group/callhome/profile* # set level normal UCSC(policy-mgr) /domain-group/callhome/profile* # set maxsize 5000000 UCSC(policy-mgr) /domain-group/callhome/profile* # create destination destination@cisco.com UCSC(policy-mgr) /domain-group/callhome/profile/destination* # commit-buffer UCSC(policy-mgr) /domain-group/callhome/profile/destination #
Command or Action | Purpose | |
---|---|---|
Step 1 | UCSC# connect policy-mgr | Enters policy manager mode. |
Step 2 | UCSC(policy-mgr)# scope domain-group domain-group | Enters domain group root mode and (optionally) enters a domain group under the domain group root. To enter the domain group root mode, type / as the domain-group. |
Step 3 | UCSC(policy-mgr) /domain-group # scope callhome | Scopes the default Call Home policy's configuration mode. |
Step 4 | UCSC(policy-mgr) /domain-group/callhome # delete profile profile-name | Deletes a Call Home policy's profile. |
Step 5 | UCSC(policy-mgr) /domain-group/callhome* # commit-buffer | Commits the transaction to the system configuration. |
The following example shows how to scope into the domain group domaingroup01, scope the Call Home policy, delete the policy profile chprofile01, and commit the transaction:
UCSC # connect policy-mgr UCSC(policy-mgr)# scope domain-group domaingroup01 UCSC(policy-mgr) /domain-group # scope callhome UCSC(policy-mgr) /domain-group/callhome # delete profile chprofile01 UCSC(policy-mgr) /domain-group/callhome* # commit-buffer UCSC(policy-mgr) /domain-group/callhome #
Before configuring a policy for a call home policy under a domain group, this policy must first be created. Policies for call home policies under the Domain Groups root that were already created by the system are ready to configure.
Create a Call Home Policy.
Command or Action | Purpose | |
---|---|---|
Step 1 | UCSC# connect policy-mgr | Enters policy manager mode. |
Step 2 | UCSC(policy-mgr)# scope domain-group domain-group | Enters domain group root mode and (optionally) enters a domain group under the domain group root. To enter the domain group root mode, type / as the domain-group. |
Step 3 | UCSC(policy-mgr) /domain-group # scope callhome | Scopes the default Call Home policy's configuration mode. |
Step 4 | UCSC(policy-mgr) /domain-group/callhome # create | scope policy policy-name | Creates a policy for a Call Home policy and enters that policy's mode, or scopes an existing policy for a Call Home policy. Policies for the Call Home policy include:
|
Step 5 | UCSC(policy-mgr) /domain-group/callhome/policy* # enable | disable | Enables or disables the policy for the Call Home policy. |
Step 6 | UCSC(policy-mgr) /domain-group/callhome/policy* # set admin-state enabled | disabled | Enables or disables the admin state of the policy for the Call Home policy. |
Step 7 | UCSC(policy-mgr) /domain-group/callhome/policy* # exit | (Optional) Moves up one level to create or scope and configure the next policy for the Call Home policy. Repeating the above three steps until all required policies for the Call Home policy are scoped or created and configured. |
Step 8 | UCSC(policy-mgr) /domain-group/callhome/profile/destination* # commit-buffer | Commits the transaction to the system configuration. |
The following example shows how to scope into the domain group domaingroup01, scope the Call Home policy, recursively create policies license-graceperiod-expired and management-services-failure, enable these policies for the Call Home policy, enable the admin-state for each, and commit the transaction:
UCSC # connect policy-mgr UCSC(policy-mgr)# scope domain-group domaingroup01 UCSC(policy-mgr) /domain-group # scope callhome UCSC(policy-mgr) /domain-group/callhome # create policy license-graceperiod-expired UCSC(policy-mgr) /domain-group/callhome/policy* # enable UCSC(policy-mgr) /domain-group/callhome/policy* # set admin-state enable UCSC(policy-mgr) /domain-group/callhome/policy* # exit UCSC(policy-mgr) /domain-group/callhome # create policy management-services-failure UCSC(policy-mgr) /domain-group/callhome/policy* # enable UCSC(policy-mgr) /domain-group/callhome/policy* # set admin-state enable UCSC(policy-mgr) /domain-group/callhome/policy* # commit-buffer UCSC(policy-mgr) /domain-group/callhome/policy #
The following example shows how to scope into the domain group domaingroup01, scope the Call Home policy, recursively scope existing policies connectivity-problem, management-services-unresponsive, and thermal-problem, enable these policies for the Call Home policy, enable the admin-state for each, and commit the transaction:
UCSC # connect policy-mgr UCSC(policy-mgr)# scope domain-group domaingroup01 UCSC(policy-mgr) /domain-group # scope callhome UCSC(policy-mgr) /domain-group/callhome # scope policy connectivity-problem UCSC(policy-mgr) /domain-group/callhome/policy # enable UCSC(policy-mgr) /domain-group/callhome/policy* # set admin-state enable UCSC(policy-mgr) /domain-group/callhome/policy* # exit UCSC(policy-mgr) /domain-group/callhome* # scope policy management-services-unresponsive UCSC(policy-mgr) /domain-group/callhome/policy* # enable UCSC(policy-mgr) /domain-group/callhome/policy* # set admin-state enable UCSC(policy-mgr) /domain-group/callhome/policy* # exit UCSC(policy-mgr) /domain-group/callhome* # scope policy thermal-problem UCSC(policy-mgr) /domain-group/callhome/policy* # enable UCSC(policy-mgr) /domain-group/callhome/policy* # set admin-state enable UCSC(policy-mgr) /domain-group/callhome/policy* # commit-buffer UCSC(policy-mgr) /domain-group/callhome/policy #
Command or Action | Purpose | |
---|---|---|
Step 1 | UCSC# connect policy-mgr | Enters policy manager mode. |
Step 2 | UCSC(policy-mgr)# scope domain-group domain-group | Enters domain group root mode and (optionally) enters a domain group under the domain group root. To enter the domain group root mode, type / as the domain-group. |
Step 3 | UCSC(policy-mgr) /domain-group # scope callhome | Scopes the default Call Home policy's configuration mode. |
Step 4 | UCSC(policy-mgr) /domain-group/callhome # delete policy policy-name | Deletes a policy for a Call Home policy. |
Step 5 | UCSC(policy-mgr) /domain-group/callhome* # commit-buffer | Commits the transaction to the system configuration. |
The following example shows how to scope into the domain group domaingroup01, scope the Call Home policy, delete the policy chpolicy01 from within the Call Home policy, and commit the transaction:
UCSC # connect policy-mgr UCSC(policy-mgr)# scope domain-group domaingroup01 UCSC(policy-mgr) /domain-group # scope callhome UCSC(policy-mgr) /domain-group/callhome # delete policy chpolicy01 UCSC(policy-mgr) /domain-group/callhome* # commit-buffer UCSC(policy-mgr) /domain-group/callhome #