Tracking license usage of your environment

Use the License Tracking utility to generate license usage reports (XML and HTML formats). These reports provide the count or number of managed services and average number of server endpoints that are currently consumed in your environment. You can then compare these numbers with the numbers that you are entitled to use based on your license.

For more information, see the following sections:

Related topic


Tracking license usage for TrueSight Cloud Cost Control

Performing system maintenance tasks


Overview

The license summary for TrueSight Capacity Optimization for Servers provides the following details:

  • Overall number of managed systems
  • Overall number of managed systems that are distinct by name
  • Total number of managed systems imported from Capacity Agents
  • Total number of managed systems imported from Capacity Agents that are distinct by name
  • Overall number of managed network devices
  • Overall number of managed ports

To view details of the count of product licenses reported by License Tracking utility, you can create diagnostic reports using the following Advanced report templates:

  • Auditing - Managed Servers - Provides the count and details of managed systems. 
  • Auditing - Managed Network and Storage Entities - Provides the count and details of managed network and storage entities.

The report templates enable you to identify the distinct managed systems, network devices, and storage entities to optimize the number of product licenses.

For example, if the total number of managed systems is 70 and total number of managed systems that are distinct by name is 50, using the Auditing - Managed Servers as the template for Diagnostic report, you can identify the systems that have the same name and are using product licenses.

If you have installed the BMC License Usage Collection Utility, you can enter the host name and port number to connect to the TrueSight Capacity Optimization server and generate the license summary. The BMC License Usage Collection Utility uses the License Utility REST API in the backend. For more information, see the following topics:

  •   BMC License Usage Collection Utility
  • License Utility REST API

Workflow for using the License Tracking utility

Each of the boxes in the following diagram links to the corresponding step/topic.

License tracking

Restrictions in the license summary

The following restrictions are applicable in the license summary:

  • The license summary counts only distributed (not mainframe related) entities according to the managed systems, even when the “BMC TrueSight Capacity Optimization for Mainframe” add-on is installed. 
  • The license summary does not support tracking of the number of CPU sockets, which can represent the Unit of Measure used for your TrueSight Capacity Optimization license entitlement. The number of CPU sockets is usually not a configuration metric provided by the data sources integrated by TrueSight Capacity Optimization.


To generate a license report 

  1. Log on to the TrueSight Capacity Optimization console.
  2. In Administration > SYSTEM > Maintenance, select the Maintenance Activities tab.
    A table with maintenance activities are listed.
  3. In the row for the License Tracking utility, click .
    The Overview page of Run: License Tracking is displayed.
  4. Click Next.
    The Hosts selection page of Run: License Tracking is displayed.
  5. Select the required hosts and click Proceed.
    The License Tracking utility runs and generates the license report. The Maintenance page refreshes and the License Tracking record in the table displays an updated execution date and status. 
  6. To access the report:
    1. Ensure that the status of the License Tracking record shows ENDED. 
    2. Click   to view the the deployment log. In the Deployment logs for the License Tracking utility, click . to download a zip file that contains the license.xml and license.html summary files and other detailed report files.

Sample license reports

 Sample license report in XML format
 <?xml version="1.0" encoding="UTF-8"?><bmc_license_xml_report  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="LicenseDataXMLSimplifiedSample.xsd">
  <entry>
    <field_value>
      <name>AuditCount</name>
      <value>1067</value>
    </field_value>
    <field_value>
      <name>Host</name>
      <value>vl-pun-bco-dv05.bmc.com</value>
    </field_value>
    <field_value>
      <name>LicenseChecksum</name>
      <value>1379327313</value>
    </field_value>
    <field_value>
      <name>LicenseDescription</name>
      <value>Overall number of managed systems</value>
    </field_value>
    <field_value>
      <name>LicenseRequestedFrom</name>
      <value>1502044200000</value>
    </field_value>
    <field_value>
      <name>LicenseRequestedTo</name>
      <value>1502217000000</value>
    </field_value>
    <field_value>
      <name>LicenseType</name>
      <value>20</value>
    </field_value>
    <field_value>
      <name>ProductName</name>
      <value>TrueSight Capacity Optimizer for Servers</value>
    </field_value>
    <field_value>
      <name>ReportDate</name>
      <value>1502258204381</value>
    </field_value>
    <field_value>
      <name>SuiteName</name>
      <value>TrueSight Capacity Optimization</value>
    </field_value>
  </entry>
  <entry>
    <field_value>
      <name>AuditCount</name>
      <value>840</value>
    </field_value>
    <field_value>
      <name>Host</name>
      <value>vl-pun-bco-dv05.bmc.com</value>
    </field_value>
    <field_value>
      <name>LicenseChecksum</name>
      <value>1719767504</value>
    </field_value>
    <field_value>
      <name>LicenseDescription</name>
      <value>Overall number of managed systems - distinct by name</value>
    </field_value>
    <field_value>
      <name>LicenseRequestedFrom</name>
      <value>1502044200000</value>
    </field_value>
    <field_value>
      <name>LicenseRequestedTo</name>
      <value>1502217000000</value>
    </field_value>
    <field_value>
      <name>LicenseType</name>
      <value>20</value>
    </field_value>
    <field_value>
      <name>ProductName</name>
      <value>TrueSight Capacity Optimizer for Servers</value>
    </field_value>
    <field_value>
      <name>ReportDate</name>
      <value>1502258204381</value>
    </field_value>
    <field_value>
      <name>SuiteName</name>
      <value>TrueSight Capacity Optimization</value>
    </field_value>
  </entry>
  <entry>
    <field_value>
      <name>AuditCount</name>
      <value>689</value>
    </field_value>
    <field_value>
      <name>Host</name>
      <value>vl-pun-bco-dv05.bmc.com</value>
    </field_value>
    <field_value>
      <name>LicenseChecksum</name>
      <value>728271848</value>
    </field_value>
    <field_value>
      <name>LicenseDescription</name>
      <value>Number of managed systems imported from Capacity Agents</value>
    </field_value>
    <field_value>
      <name>LicenseRequestedFrom</name>
      <value>1502044200000</value>
    </field_value>
    <field_value>
      <name>LicenseRequestedTo</name>
      <value>1502217000000</value>
    </field_value>
    <field_value>
      <name>LicenseType</name>
      <value>20</value>
    </field_value>
    <field_value>
      <name>ProductName</name>
      <value>TrueSight Capacity Optimizer for Servers [Capacity Agents]</value>
    </field_value>
    <field_value>
      <name>ReportDate</name>
      <value>1502258204381</value>
    </field_value>
    <field_value>
      <name>SuiteName</name>
      <value>TrueSight Capacity Optimization</value>
    </field_value>
  </entry>
  <entry>
    <field_value>
      <name>AuditCount</name>
      <value>584</value>
    </field_value>
    <field_value>
      <name>Host</name>
      <value>vl-pun-bco-dv05.bmc.com</value>
    </field_value>
    <field_value>
      <name>LicenseChecksum</name>
      <value>1855693660</value>
    </field_value>
    <field_value>
      <name>LicenseDescription</name>
      <value>Number of managed systems imported from Capacity Agents - distinct by name</value>
    </field_value>
    <field_value>
      <name>LicenseRequestedFrom</name>
      <value>1502044200000</value>
    </field_value>
    <field_value>
      <name>LicenseRequestedTo</name>
      <value>1502217000000</value>
    </field_value>
    <field_value>
      <name>LicenseType</name>
      <value>20</value>
    </field_value>
    <field_value>
      <name>ProductName</name>
      <value>TrueSight Capacity Optimizer for Servers [Capacity Agents]</value>
    </field_value>
    <field_value>
      <name>ReportDate</name>
      <value>1502258204381</value>
    </field_value>
    <field_value>
      <name>SuiteName</name>
      <value>TrueSight Capacity Optimization</value>
    </field_value>
  </entry>
  <entry>
    <field_value>
      <name>AuditCount</name>
      <value>0</value>
    </field_value>
    <field_value>
      <name>Host</name>
      <value>vl-pun-bco-dv05.bmc.com</value>
    </field_value>
    <field_value>
      <name>LicenseChecksum</name>
      <value>765203939</value>
    </field_value>
    <field_value>
      <name>LicenseDescription</name>
      <value>Overall number of managed network devices</value>
    </field_value>
    <field_value>
      <name>LicenseRequestedFrom</name>
      <value>1502044200000</value>
    </field_value>
    <field_value>
      <name>LicenseRequestedTo</name>
      <value>1502217000000</value>
    </field_value>
    <field_value>
      <name>LicenseType</name>
      <value>20</value>
    </field_value>
    <field_value>
      <name>ProductName</name>
      <value>TrueSight Capacity Optimizer for Network</value>
    </field_value>
    <field_value>
      <name>ReportDate</name>
      <value>1502258204381</value>
    </field_value>
    <field_value>
      <name>SuiteName</name>
      <value>TrueSight Capacity Optimization</value>
    </field_value>
  </entry>
  <entry>
    <field_value>
      <name>AuditCount</name>
      <value>0</value>
    </field_value>
    <field_value>
      <name>Host</name>
      <value>vl-pun-bco-dv05.bmc.com</value>
    </field_value>
    <field_value>
      <name>LicenseChecksum</name>
      <value>1513139949</value>
    </field_value>
    <field_value>
      <name>LicenseDescription</name>
      <value>Overall number of managed ports</value>
    </field_value>
    <field_value>
      <name>LicenseRequestedFrom</name>
      <value>1502044200000</value>
    </field_value>
    <field_value>
      <name>LicenseRequestedTo</name>
      <value>1502217000000</value>
    </field_value>
    <field_value>
      <name>LicenseType</name>
      <value>20</value>
    </field_value>
    <field_value>
      <name>ProductName</name>
      <value>TrueSight Capacity Optimizer for Storage</value>
    </field_value>
    <field_value>
      <name>ReportDate</name>
      <value>1502258204381</value>
    </field_value>
    <field_value>
      <name>SuiteName</name>
      <value>TrueSight Capacity Optimization</value>
    </field_value>
  </entry>
  <entry>
    <field_value>
      <name>AuditCount</name>
      <value>0</value>
    </field_value>
    <field_value>
      <name>Host</name>
      <value>vl-pun-bco-dv05.bmc.com</value>
    </field_value>
    <field_value>
      <name>LicenseChecksum</name>
      <value>587024910</value>
    </field_value>
    <field_value>
      <name>LicenseDescription</name>
      <value>Average number of server endpoints</value>
    </field_value>
    <field_value>
      <name>LicenseRequestedFrom</name>
      <value>1469989800000</value>
    </field_value>
    <field_value>
      <name>LicenseRequestedTo</name>
      <value>1502217000000</value>
    </field_value>
    <field_value>
      <name>LicenseType</name>
      <value>20</value>
    </field_value>
    <field_value>
      <name>ProductName</name>
      <value>TrueSight Cloud Cost Control</value>
    </field_value>
    <field_value>
      <name>ReportDate</name>
      <value>1502258204381</value>
    </field_value>
    <field_value>
      <name>SuiteName</name>
      <value>TrueSight Capacity Optimization</value>
    </field_value>
  </entry>
  <entry>
    <field_value>
      <name>AuditCount</name>
      <value>0</value>
    </field_value>
    <field_value>
      <name>Host</name>
      <value>vl-pun-bco-dv05.bmc.com</value>
    </field_value>
    <field_value>
      <name>LicenseChecksum</name>
      <value>542437754</value>
    </field_value>
    <field_value>
      <name>LicenseDescription</name>
      <value>Average number of server endpoints - distinct by name</value>
    </field_value>
    <field_value>
      <name>LicenseRequestedFrom</name>
      <value>1469989800000</value>
    </field_value>
    <field_value>
      <name>LicenseRequestedTo</name>
      <value>1502217000000</value>
    </field_value>
    <field_value>
      <name>LicenseType</name>
      <value>20</value>
    </field_value>
    <field_value>
      <name>ProductName</name>
      <value>TrueSight Cloud Cost Control</value>
    </field_value>
    <field_value>
      <name>ReportDate</name>
      <value>1502258204381</value>
    </field_value>
    <field_value>
      <name>SuiteName</name>
      <value>TrueSight Capacity Optimization</value>
    </field_value>
  </entry>
</bmc_license_xml_report>

 Sample license report in HTML format


Where to go from here

Create an advanced report based on an advanced report template

 

Was this page helpful? Yes No Submitting... Thank you

Comments