4.29 LicenseUsage

Use this Knowledge Script to monitor authorized, used, and remaining phone and node licenses on a Cisco Unified Communications Manager cluster. This script raises an event if the number of remaining licenses falls below a threshold, or if the percentage of licenses used exceeds a threshold you set.

In addition, this script generates data streams for authorized licenses, used licenses, and remaining licenses for both phones and Cisco Unified Communications Manager nodes. The script also generates data streams for the percentage of licenses used by phones and nodes.

4.29.1 Resource Object

Cluster object

4.29.2 Default Schedule

By default, this script runs every day.

4.29.3 Setting Parameter Values

Set the following parameters as needed:

Parameter	How to Set It
General Settings
Job Failure Notification
Event severity when job fails	Set the event severity level, from 1 to 40, to indicate the importance of the failure of the LicenseUsage job. The default is 5.
Phone License Units
Monitor Phone License Units Authorized
Data Collection
Collect data for phone license units authorized?	Select Yes to collect data for charts and reports. If enabled, data collection returns the number of authorized phone licenses on the License Server. The default is Yes.
Monitor Phone License Units Used
Data Collection
Collect data for phone license units used?	Select Yes to collect data for charts and reports. If enabled, data collection returns the number of phone licenses currently being used on the License Server. The default is Yes.
Monitor Phone License Units Remaining
Event Notification
Raise event if phone license units remaining fall below threshold?	Select Yes to raise an event if the number of remaining phone licenses falls below the threshold you set. The default is unselected.
Threshold -- Minimum phone license units remaining	Specify the minimum number of phone license units that must be remaining and not in use before an event is raised. The default is 0.
Event severity when phone license units remaining fall below threshold	Set the event severity level, from 1 to 40, to indicate the importance of an event in which the number of phone licenses that must be remaining and not in use falls below the threshold. The default is 25.
Data Collection
Collect data for phone license units remaining?	Select Yes to collect data for charts and reports. If enabled, data collection returns the number of remaining phone licenses remaining on the License Server. The default is Yes.
Monitor the Percentage of Phone Licenses Used
Event Notification
Raise event if the percentage of phone licenses used exceeds threshold?	Select Yes to raise an event if the percentage of phone licenses in use exceeds the threshold you set. The default is unselected.
Threshold -- Maximum percentage of phone licenses used	Specify the highest percentage of phone licenses that must be in use before an event is raised. The default is 90%.
Event severity when the percentage of phone licenses used exceeds threshold	Set the event severity level, from 1 to 40, to indicate the importance of an event in which the percentage of phone licenses that are in use exceeds the threshold. The default is 25.
Data Collection
Collect data for the percentage of phone licenses used?	Select Yes to collect data for charts and reports. If enabled, data collection returns the percentage of phone licenses currently being used on the License Server. The default is Yes.
Node License Units
Monitor Node License Units Authorized
Data Collection
Collect data for node license units authorized?	Select Yes to collect data for charts and reports. If enabled, data collection returns the number of authorized node licenses on the License Server. The default is Yes.
Monitor Node License Units Used
Data Collection
Collect data for node license units used?	Select Yes to collect data for charts and reports. If enabled, data collection returns the number of node licenses currently being used on the License Server. The default is Yes.
Monitor Node License Units Remaining
Event Notification
Raise event if node license units remaining fall below threshold?	Select Yes to raise an event if the number of remaining node licenses falls below the threshold you set. The default is unselected.
Threshold -- Minimum node license units remaining	Specify the minimum number of node licenses that must be remaining and not in use before an event is raised. The default is 0.
Event severity when node license units remaining fall below threshold	Set the event severity level, from 1 to 40, to indicate the importance of an event in which the number of node licenses that must be remaining and not in use falls below the threshold. The default is 25.
Data Collection
Collect data for node license units remaining?	Select Yes to collect data for charts and reports. If enabled, data collection returns the number of remaining node licenses remaining on the License Server. The default is Yes.
Monitor the Percentage of Node Licenses Used
Event Notification
Raise event if the percentage of node licenses used exceeds threshold?	Select Yes to raise an event if the percentage of node licenses in use exceeds the threshold you set. The default is unselected.
Threshold -- Maximum percentage of node licenses used	Specify the highest percentage of node licenses that must be in use before an event is raised. The default is 90%.
Event severity when the percentage of node licenses used exceeds threshold	Set the event severity level, from 1 to 40, to indicate the importance of an event in which the percentage of node license units exceed the threshold. The default is 25.
Data Collection
Collect data for the percentage of node licenses used?	Select Yes to collect data for charts and reports. If enabled, data collection returns the percentage of node licenses currently being used on the License Server. The default is Yes.
Overdraft License Options
Include overdraft licenses in authorized counts and calculations?	Select Yes to count the overdraft value of your license into the authorized licenses and when calculating the remaining Units. The default is Yes.