Monitoring vFabric License Usage

vFabric Suite provides Windows command-line tools and a simple Web user interface to monitor vFabric license usage by the VMs.

Note: Although you previously activated vFabric licenses using the vSphere client, you cannot use the vSphere client user interface to monitor the vFabric license usage; rather, you must use the commands described in this chapter.

Subtopics

Monitor License Usage with Command-Line Tools

License Monitoring Command Reference

Monitor License Usage with the vFabric License Server Reporting UI

Display the Component Events File in Readable Format

vCenter License Reporting Manager

Monitor License Usage with Command-Line Tools

vFabric Suite provides four Windows command-line tools to monitor current and periodic vFabric license usage by the VMs. You run these tools on the same Windows computer on which you installed vCenter Server.

See License Monitoring Command Reference for the complete list.

Prerequisites

  • The vFabric license-usage reports require a 64-bit JDK or JRE (version 6). By default, the reports use the JRE installed with vCenter Server (located by default in the c:\Program Files\VMware\Infrastructure\jre directory). The reports use the following line to add these Java binaries to the PATH variable:

    SET PATH=%PATH%;C:\Program Files\VMware\Infrastructure\jre\bin

    If you have installed your own JDK or JRE on the vCenter Server computer, and updated the system PATH variable with its location, the vFabric license-usage reports will use that JDK/JRE instead. This should not cause any problems, as long as the JDK/JRE is 64-bit and version 6. If it is not, then you must change the SET PATH line in the license reports to the following:

    SET PATH=C:\Program Files\VMware\Infrastructure\jre\bin;%PATH%

    The preceding sample assumes the default location of the VMware infrastructure directory; if you installed vCenter into a different directory, then make the appropriate change.

    The vFabric license-usage reports are located by default in C:\Program Files\VMware\Infrastructure\vFabric Platform\Reporting.

Procedure

  1. On the Windows computer on which vCenter Server is running, open a command window and change to the vCenter-Install-Dir\vFabric Platform\Reporting directory, where vCenter-Install-Dir refers to the directory in which you installed vCenter Server (default is C:\Program Files\VMware\Infrastructure.) For example:

    prompt> cd c:\Program Files\VMware\Infrastructure\vFabric Platform\Reporting
  2. Run the desired monitoring command; see Command Reference for reference documentation and examples for each commands.

    For example, run the usage-over-periods.bat command to display vFabric license usage over a period of time. You must specify the start and end dates of the time period, as well as the period, such as monthly or yearly. Output is shown after the command.

    prompt> usage-over-periods.bat -startDate 09/01/2012 -endDate 09/4/2012 -period WEEKLY
    
    Period: WEEKLY
    License Key,Dates,Minimum Usage,Maximum Usage,Average Usage
    123AA-123BB-123CC-123DD-123EE,"Sep 1, 2012 - Sep 7, 2012",2,4,3.1
    123AA-123BB-123CC-123DD-123EE,"Sep 8, 2012 - Sep 14, 2012",2,3,2,5
    123AA-123BB-123CC-123DD-123EE,"Sep 15, 2012 - Sep 21, 2012",1,1,1
    123AA-123BB-123CC-123DD-123EE,"Sep 22, 2012 - Sep 28, 2012",1,1,1
    123AA-123BB-123CC-123DD-123EE,"Sep 29, 2012 - Sept 30, 2012",0,1,0.64