Page tree

Skip to end of metadata
Go to start of metadata

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 Infrastructure Management Server
Managing users and user groups
Managing authorization profiles

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 Administration > License Usage menu option.

  1. From the TrueSight console, select Administration > 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.

  2. Select a component from the Components list.
    By default, the top-most component is selected.
    Two tables are displayed as described under 760879500.
  3. Click the current count link to 760879500.
  4. Click the high count link to 760879500.

    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.

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

To configure the high count refresh time

  1. 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

  2. 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:

FieldDescription
Report DateDisplays the date and time stamp of the current report run.
Host Name/IP AddressDisplays the name of the Infrastructure Management host name or IP address along with the port number.
TenantDisplays the tenant name.
OS VersionDisplays the operating system details.
Component VersionDisplays the component version. For example, 10.7.00.
License CategoryDisplays all license categories that are managed under the selected host name.
UnitDisplays 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 760879500.

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 760879500.

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 DateDisplays 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 CategoryDetails
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 ViewsCounts 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

Counts the number of unique devices from the following PATROL KMs:

  • Hardware Sentry KM for PATROL
  • EMC Disk Arrays KM for PATROL
  • HP EVA KM for PATROL
  • Hitachi Disk Arrays KM for PATROL
  • IBM DS3000, DS4000, DS5000 Series KM for PATROL
  • IBM DS6000, DS8000 Series KM for PATROL
  • NetApp Filers KM for PATROL
Sentry Storage Monitoring and Analytics

Counts the number unique devices from the following PATROL KMs:

  • EMC Disk Arrays KM for PATROL
  • HP EVA KM for PATROL
  • Hitachi Disk Arrays KM for PATROL
  • IBM DS3000, DS4000, DS5000 Series KM for PATROL
  • IBM DS6000, DS8000 Series KM for PATROL
  • NetApp Filers KM for PATROL
Sentry Microsoft Applications Monitoring and Analytics

Counts the number of unique devices from the following PATROL KMs:

  • Microsoft Search KM for PATROL version 1.0.01
  • SharePoint KM for PATROL
Sentry Monitoring Studio

Counts unique devices from the Monitoring Studio 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 ProtocolCounts 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
  • Application diagnostics


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.

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 nameFile nameDescriptionRecommended value
(in seconds)
TimeoutinstalledDirectory\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