tw_license_report
The tw_license_report utility enables you to track and manage your BMC Discovery license usage.
Options in the utility specify how the license reports can be configured, exported, and imported, or downloaded from another BMC Discovery appliance. To use the utility, enter the following command:
where options are any of the options described in the following table and the common command line options described in Using-command-line-utilities.
Command Line Option | Description |
---|---|
--anonymized | Output an anonymized version of the detailed report. |
--download=HOST | Download and import license data from a remote appliance. The remote appliance must have HTTPS enabled. Specify the appliance by hostname or IP address. |
--end-date=DATE | Specify the report end date in the following date format: yyyy-mm-dd |
--export=FILE | Export raw license data to a zip file. |
--export-csv=FILE | Export all license data to a zip file containing multiple csv files. |
--ignore-cert-failure | Ignore certificate verification failures. |
--import=FILE | Import raw license data from a zip file. Used to produce a consolidated report from multiple appliances. You can also download and import directly from a remote appliance using the --download option. |
--output-file=FILE | Write the license report to a file. |
--password=PASSWD | The local password. |
--remote-pass=PASSWORD | The password for downloading from a remote BMC Discovery appliance. Used with --download and --remote-user. |
--remote-user=USER | The username for downloading from a remote BMC Discovery appliance. Used with --download and --remote-user. |
--start-date=DATE | Specify the report start date in the following date format: {{code language="none"}} |
User example
In the following example, type the commands on a single line. Line breaks are provided to make the example easier to read.
Running a report
The first example is a default report run by the system user:
Password for BMC Discovery UI user system:
Collecting for: Cloud Hosted Databases
Collecting data from: local data of Cluster-01 (11.2)
Processed 8 live entries
Processed 0 destroyed entries
...
...
License report
==============
Report start time: 2016-09-04 16:13:04.411508+00:00
Report end time : 2017-09-04 16:13:04.411545+00:00
Highest monthly average capacity for Cloud Resources: 1628 (2017-02)
Highest monthly average capacity for Hosts: 1204 (2017-02)
Aggregating data from these directories:
/usr/tideway/var/license_data - local data of Cluster-01 (11.2)
...
...
Installed additional content:
TKU-Storage-2067-08-1-ADDM-11.2+ (First seen: 2017-09-03, Last seen: 2017-09-03)
EDP-2067-08-1-ADDM-11.2+ (First seen: 2017-09-03, Last seen: 2017-09-03)
Cloud Hosted Databases (Cloud Resources)
----------------------------------------
Average numbers per month:
2017-01 - 870
2017-02 - 900
2017-03 - 300
2017-04 - 300
2017-05 - 300
2017-06 - 590
2017-07 - 590
2017-08 - 302
2017-09 - 70
Cloud Virtual Machines (Cloud Resources)
----------------------------------------
Average numbers per month:
2017-01 - 290
2017-02 - 728
2017-03 - 870
2017-04 - 600
2017-05 - 445
2017-06 - 590
2017-07 - 870
2017-08 - 304
2017-09 - 71
Hosts (Hosts)
-------------
Average numbers per month:
2017-01 - 951
2017-02 - 1204
2017-03 - 1000
2017-04 - 853
2017-05 - 650
2017-06 - 351
2017-07 - 302
2017-08 - 567
2017-09 - 86
[tideway@appliance_01 ~]$
For more information about using licensing management, see Managing-licenses.