Viewing and exporting the Server Endpoints license usage report for TrueSight Infrastructure Management Servers

The license usage report displays information about the exact number of licenses used for each monitoring solution managed under Infrastructure Management. This view and report can be used to know the exact license count under each category of the managed components.

The report is refreshed once every 24 hours. By default, the high count refresh time is configured at 1:00 A.M. every day, but this time is user configurable.

Related topics

Adding and editing components

Managing users and user groups

Managing authorization profiles

Viewing and exporting the Server Endpoints license usage report for App Visibility portals List of Monitoring Solutions and KMs in Infrastructure Management Open link

Prerequisites

You must have installed TrueSight Presentation Server and TrueSight Infrastructure Management Server version 10.7 or later.
You must have configured at least one Infrastructure Management component on the TrueSight console.
Your role must be Super Admin to access the License Usage report. Either you can be an Out-of-the-box administrator user or create a special administrator and assign the Super Admin role to access the report.

To view the license usage details

The report is available on the TrueSight console under the License > License Usage menu option.

From the TrueSight console, expand License Usage.

By default, the selected Component Type is Infrastructure Management Server.
Currently, only the Infrastructure Management Server is available and therefore, the Component Type does not support additional values in the drop-down.
Click Server Endpoints.
From the Component Type drop-down, select the appropriate component to view the license information.
By default, the top-most component is selected.
Two tables are displayed as described under License usage report details.
Click the current count link to view the instances and managed assets details.
Click the high count link to view the instances and managed assets details.
Note

For a Group Tree View, the current and high count links are not clickable.

To export the license usage report

You must tune the timeout settings before generating a PDF export for medium and large deployments.
Export as CSV works without an additional timeout settings to be done in all types of deployments.

From the toolbar section, click and select one of the export types: PDF or CSV.
Wait for the zipped report to be downloaded.
Click and open the zipped file to view the generated report.

To configure the high count refresh time

From the custom/conf/ folder, edit the pronet.conf file and add the property pronet.licenseusage.report.daily.hour=<HH>.
Example
To refresh the daily report at 11:00 P.M., you would enter 23: pronet.licenseusage.report.daily.hour=23
Restart the Infrastructure Management Server by entering the following command: pw sys start.

License Usage report details

By default, the component type is set to Infrastructure Management Server. You are required to select a component to view the following report for the TrueSight Infrastructure Manager:

Field	Description
Report Date	Displays the date and time stamp of the current report run.
Host Name/IP Address	Displays the name of the Infrastructure Management host name or IP address along with the port number.
Tenant	Displays the tenant name.
OS Version	Displays the operating system details.
Component Version	Displays the component version. For example, 10.7.00.
License Category	Displays all license categories that are managed under the selected host name.
Unit	Displays the unit of measurement: Server endpoint or Instance.
Current Count	Displays the number of licenses used for each category on the date of report generation with a clickable link. Click the link to view the instances and managed assets details. Because only one Group Tree View is possible for a component, the count is not a clickable link for that category.
High Count	Displays the highest number of licenses used for each category with a clickable link. Click the link to view the instances and managed assets details. For example, this count could be displayed as 100, while the current count as on the report date could be just 50. It indicates, at least once in the life cycle the highest count of licenses against a particular category has reached up to 100
High Count Date	Displays the date on which the High Count was reached.

The following license categories are available for Infrastructure Monitor component:

Limitation

The host name cannot be displayed for solutions with no Instance to Devices data.

License Category	Details
Server Monitoring and Analytics		Counts the number of unique devices monitored by the following PATROL KMs: PATROL for Microsoft Windows PATROL for Microsoft Windows Remote PATROL for UNIX/Linux PATROL for UNIX/Linux Remote Remote PATROL for Amazon Web Services PATROL for Virtual Servers PATROL for Citrix XenServer PATROL for iSeries
Application, Database and Middleware Monitoring and Analytics		Counts the number of unique devices monitored by the following PATROL KMs: PATROL for Oracle PATROL for Oracle WebLogic PATROL for JBoss AS PATROL for WebSphere Application Server Performance Manager for SAP Solution Manager PATROL for Siebel eBusiness Applicataions PATROL for PeopleSoft PATROL for Oracle E-Business Suite PATROL for BEA Tuxedo PATROL for Internet Server Manager PATROL for Microsoft Exchange Server PATROL for Force.com PATROL for Microsoft SQL Server PATROL for Sybase PATROL for DB2 Universal Database PATROL for Informix PATROL for Windows Azure
Converged Infrastructure Monitoring		Counts the number of unique devices monitored by the following PATROL KMs: PATROL for CISCO Nexus Converged Infrastructure
Group Tree Views		Counts a single instance of the Infrastructure Management server where the hyperbolic tree is used for group or SLO views. The count is one at all times.
Sentry Hardware Monitoring and Analytics Note: Sentry Hardware Analyzer for TrueSight Operations Management		(For non-storage monitoring) Counts the number of managed asset-server endpoints from Hardware Sentry KM for PATROL.
Sentry Storage Monitoring and Analytics Note: Sentry Hardware Analyzer for TrueSight Operations Management		Counts the number of ports from the following PATROL KMs: Dell Compellent KM for PATROL Dell EMC Unity KM for PATROL EMC Disk Arrays KM for PATROL EMC XtremIO KM for PATROL HP EVA KM for PATROL HP 3PAR KM for PATROL Hitachi Disk Arrays KM for PATROL IBM DS3000, DS4000, DS5000 Series KM for PATROL IBM DS6000, DS8000 Series KM for PATROL IBM SVC KM for PATROL IBM XiV KM for PATROL NetApp Filers KM for PATROL Pure Storage KM for PATROL
Sentry Monitoring Studio Note: It is currently known as Sentry Monitoring Studio for TrueSight Operations Management.		(For non-storage monitoring) Counts unique managed asset-server endpoints from the Monitoring Studio KM for PATROL.
Sentry Backup Analyzer Note: It is currently known as Sentry Backup Analyzer for TrueSight Operations Management		Counts the number of managed asset-server endpoints from the following KMs for PATROL: CA ARCServe Backup KM for PATROL Veritas NetBackup KM for PATROL Symantec Backup Exec KM for PATROL EMC NetWorker KM for PATROL Tivoli Storage Manager KM for PATROL HP Data Protector KM for PATROL
Sentry High Availability Analyzer		Counts the number of managed asset-server endpoints from the following KMs for PATROL: Veritas Cluster Server KM for PATROL Veritas File System KM for PATROL Veritas Volume Manager KM for PATROL
Custom Monitoring and Analytics		Counts all the devices that are being monitored by the custom KMs. The custom KM names must be updated in the license-report-custom-conf.xml. For custom solutions, you must edit the custom-solutions-license-report.conf file in the pronet/conf folder: <custom-solutions> <mo-types solution-name="My custom solution"> P_PATROL_MSC_MAIN,_PATROL_MSC_SEC</mo-types> <mo-types solution-name="Another custom solution"> P_PATROL_ACS</mo-types> </custom-solutions mo-types element: Solution name - The name of your solution Element value - List of monitor types representing devices in the solution, separated by comma
Third-party and Custom Analytics Add-on		Counts all the devices that are being monitored by the third-party adapters. Only unique devices are counted. The following third-party adapters are monitored: Adapter for Microsoft Operations Manager (MOM) 2005 Adapter for HP OpenView Adapter for Microsoft System Center Operations Manager (SCOM) Adapter for IBM Tivoli
Impact Management		Counts the server endpoints when the following criteria are met: Sever Endpoint was imported from Atrium CMDB in a Service Model Has a relationship to another CI in the Service Model Has a CI class of Computer System Has a Primary Capability value of Server
Event Management		Counts the servers where the host ID is provided in the event. In most cases, this does not count any third-party event management servers. The devices mentioned in the mc_host slot of all the events present in THIRD_PARTY_EVENTS table are counted. Events from the network devices are not considered. Events of the following classes are ignored: ABNORMALITY ALARM BCO_EV MC_ADAPTER_CONTROL MC_ADAPTER_ERROR MC_ADAPTER_START MC_ADAPTER_STOP MC_CELL_ACTION_RESULT MC_CELL_ACTIVITY_CHANGED MC_CELL_ALLOWED_CONNECT MC_CELL_CLIENT MC_CELL_CONNECT MC_CELL_CONTROL MC_CELL_DB_CLEANUP MC_CELL_DESTINATION_UNREACHABLE MC_CELL_DISCONNECT MC_CELL_DUPLICATE_EVT MC_CELL_HEARTBEAT_EVT MC_CELL_LOG_CHANGED MC_CELL_LOG_MSG MC_CELL_MODIFIED_EVENT MC_CELL_PUBLISH_RESULT MC_CELL_RELOADED MC_CELL_RESOURCE MC_CELL_STATBLD_START MC_CELL_STATBLD_STOP MC_CELL_START MC_CELL_STOP MC_CELL_TICK MC_CELL_UNALLOWED_CONNECT PPM_EV PPM_MFD_EV PPM_SM_EV PROACTIVE_CONF_CHANGE Note the following information: The licensed events are synchronized once every hour (60 mins.) with the EG_EVENT table.
Simple Network Management Protocol		Counts the number of unique SNMP devices monitored by the PATROL for Light Weight Protocols.
Unique Servers		Counts the number of unique server instances within the following license categories (described in this table): Server monitoring and analytics Application, database and middleware monitoring and analytics Event and impact management App Visibility

Note

To add new monitor types or KMs to licensing, contact BMC Support.

For more details on PATROL KMs and the list of monitoring solutions, see List of Monitoring Solutions and KMs in Infrastructure Management. Open link

Instances and managed assets details

You can view additional details about instances and managed assets by clicking on the Current Count and High Count links. This page displays the details of the instances or managed assets that were counted in the license usage report.

The table shows the managed asset host name (Server Endpoint), relevant data to the license category, and IP address, as shown in the following images:

Notes

The Server Endpoint list is a de-duplicated list. That is, multiple host names with the same IP address or hosts with alias names are counted only once. For example, a host "abc.example.com" having an IP address 192.1.1.1 and a host "abc" having an IP address 192.1.1.1 are considered as a single entry.
Hosts with the same name but with different IP addresses are considered as different entries. For example, a host "abc.example.com" having an IP address 192.1.1.1 and a host "abc.example.com" having an IP address 192.2.1.1 are considered as two different entries.
When a host name does not contain an IP address or if the IP address is masked due to security reasons, the information is displayed with a blank IP address field.

Troubleshooting export to PDF

While generating a PDF export for medium or large deployments, there could be some delay before the output is generated. You must tune the timeout settings to accommodate this delay to avoid the system timeout before generating a PDF output. After resetting the timeout parameter, you must restart the httpd process.

Run pw process restart httpd to restart.

Use the following table to perform the settings:

Apache tuning parameters for License Usage report

Parameter name

File name

Description

Recommended value
(in seconds)

Timeout

installedDirectory\pw\apache\conf\httpd.conf

The number of seconds before send and receive requests time out.

The default is 300 seconds.

Small: 300
Medium: 600
Large: 900

Hardware Sentry KM for PATROL
Dell Compellent KM for PATROL
Dell EMC Unity KM for PATROL
EMC Disk Arrays KM for PATROL
EMC XtremIO KM for PATROL

HP EVA KM for PATROL
HP 3PAR KM for PATROL

Hitachi Disk Arrays KM for PATROL

IBM DS3000, DS4000, DS5000 Series KM for PATROL

IBM DS6000, DS8000 Series KM for PATROL
IBM SVC KM for PATROL
IBM XiV KM for PATROL
Monitoring Studio KM for PATROL

NetApp Filers KM for PATROL
Pure Storage KM for PATROL