This documentation supports the 20.08 version of BMC Discovery.

To view an earlier version of the product, select the version from the Product version menu.

tw_license_report

The tw_license_report utility enables you to track and manage your BMC Discovery license usage.

Recommendation

Use the BMC Discovery user interface to perform the functionality provided by the tw_license_report command line utility (see Managing licences). If you choose to run the utility, read the documentation in this section to learn its usage and to understand the risks and potential impact on your environment.

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:

tw_license_report [options] 

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: yyyy-mm-dd


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:

[tideway@appliance_01 ~]$ tw_license_report --username=system
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.

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

Comments