Evaluating license and product usage trends


Beginning in version 8.7, you can track your license usage for BMC Server Automation, and also how to view trends for agent deployment. The topic includes the following sections:

Listing of license types

The following table lists the types of licenses and corresponding entitlements.

License

Applies to these job types

BMC BladeLogic Server Automation Suite 

All types of jobs

BMC Server Automation - License Add-on

All types of jobs

BMC BladeLogic Server Automation – Compliance Module

Compliance, SCAP, Audit, Snapshot

BMC Server Automation – Compliance License Add-on

Compliance, SCAP, Audit, Snapshot

BMC BladeLogic Server Automation – Configuration Module

NSH, Deploy

BMC Server Automation – Configuration License Add-on

NSH, Deploy

BMC BladeLogic Server Automation – Provisioning Module

Bare Metal , Virtual Guest Job

BMC Server Automation – Provisioning License Add‐on

Bare Metal , Virtual Guest Job

BMC Server Automation – Patch License Add‐on

Patch Analysis

To evaluate product usage trends

On the Health and Value Dashboard, select the Product Usage Trends option:

product_usage_trends_option.gif

When you select the Product Usage Trends option, the following report is displayed. There are two sections to the report:

  • License Usage Trends–This graph provides information about the number of BMC Server Automation licenses purchased against the number of licenses actually being used each month, for a period of one year (by default). The threshold line represents the number of BMC Server Automation Suite Level licenses that you have purchased. Note that a device that has a valid BMC Server Automation agent installed or deployed is considered for license counts. A device that is enrolled but does not have an active agent installed on it, is not considered for license counts, although some jobs are run against such a device.
    license_usage_trends.gif
  • Agent Deployment Trends –This graph provides information about the number of BMC Server Automation agents that have been added (commissioned) against the number of agents that have been removed (decommissioned) each month, for a period of one year (by default).
    agent_deployment_trends.gif

You can also perform the following tasks for the graphs:

Task

Description

To populate or refresh the graphs

Do one of the following:

  • Run the Dashboard Update Job from the console (Jobs > BMC Maintenance > Dashboard > Dashboard Update Job).
    dashboard_report_job.gif
  • Execute the following BLCLI command:

(blcli -v <profile name> -r BLAdmins Utility generateDashboardReport)

Once the job or command completes successfully, the report will be populated.

To change the time period for the License Usage Trends graph

Run the following command using the BMC Server Automation Application Server Administration console (the blasadmin utility):

Dashboard LicenseInfoDisplayTimePeriod <months>

Where <months> is the number of months for which you want the report displayed. The default is 12 months.

To display the number of licenses trend line in the License Usage Trends graph

Run the following commands using the blasadmin utility:

Command

Used to...

show licenseusage

Provide a list of types of licenses.

set licenseusage <licenseSKUType> <no. of licenses>

Set number of licenses for a particular module type, where <licenseSKUType> is one of the following:

  • NumberOfSuiteLicenses
  • NumberOfSuiteAddonLicenses
  • NumberOfComplianceLicenses
  • NumberOfComplianceAddonLicenses
  • NumberOfConfigurationLicenses
  • NumberOfConfigurationAddonLicenses
  • NumberOfProvisioningLicenses
  • NumberOfProvisioningAddonLicenses
  • NumberOfPatchAddonLicenses

For example:
set licenseusage NumberOfComplianceLicenses 15000

To generate summary and detail reports in CSV format for license usage

You can generate reports within a relative date range that you specify, or an absolute date range.

Warning

Note

The BLCLI commands for generating license usage reports have been optimized in version 8.7 of BMC Server Automation. For earlier versions of BMC Server Automation (8.6.x or earlier), it is recommended that you do not use these BLCLI commands. Instead, you can use a script provided by BMC.

Log in or register to download the script.

Generating reports within a specified relative date range

To generate summary and detail reports of active agents, and the kinds of jobs performed on these agents within a specified relative date range, enter the following BLCLI Utility command:

agentLicenseUsageReportByRelativeDateRange <reportFilePath> <relativeRangeValue>

Where:

  • reportFilePath is the path to the location where you want to write the CSV report and the filename. The report names will have _summary.csv and _details.csv as suffixes. For example: using /tmp/reportName would output reports names reportName_summary.csv and reportName_details.csv in the /tmp dir.
  • relativeRangeValue is the number of days, months, or years
  • daysMonthsOrYears is the relative time frame to use for the reports. You can choose day(s), month(s), or year(s)

The following example shows how to use this command to obtain a report for the last month.

blcli Utility agentLicenseUsageReportByRelativeDateRange /mydir/report 1 month

Generating reports within an absolute date range

To generate summary and details report of active agents and the types of jobs performed on these agents within an absolute date range, use following BLCLI Utility command:

agentLicenseUsageReportByAbsoluteDateRange <reportFilePath> <"startDateString"> <"endDateString">

Where:

  • reportFilePath is the path to the location where you want to write the CSV report and the filename. The report names will have _summary.csv and _details.csv as suffixes. For example: using /tmp/reportName would output reports names reportName_summary.csv and reportName_details.csv in the /tmp dir.
  • startDateString is the start date for the report, enclosed in double quotes. Use the format "yyyy/MM/dd HH:mm:ss"
  • endDateString is the ending date for the report, enclosed in double quotes. Use the format "yyyy/MM/dd HH:mm:ss" or "" (an empty string) to indicate the current date and time.

The following example shows how to use this command to obtain a report for a specific date range:

blcli Utility agentLicenseUsageReportByAbsoluteDateRange /mydir/report "2010/01/12 01:02:04--‐0500" ""

Summary report example

The following is an example of the summary report that is generated in CSV format.

license_usage_summary_report_example.gif

Detail report example

The following is an example of the summary report that is generated in CSV format.

license_usage_detail_report_example.gif

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

Server Automation Documentation