5.3

42 vFabric Suite
42 Monitoring vFabric License Usage
The output will look something like the following:
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
The output shows the minimum, maximum, and average use (number of active computers, physical or virtual, which are assigned
a license) of a single vFabric license key for each week in the month of September 2012. If you had installed additional vFabric
license keys, then these would also show up in the report.
Another example is to view the year-to-date usage of your vFabric Suite licenses. For example, if today is July 31, 2012:
prompt> usage-over-periods.bat -startDate 08/01/2011 -endDate 07/31/2012 -period YEARLY
The output will look something like the following:
License Key,Period,Minimum Usage,Maximum Usage,Average Usage
123AA-123BB-123CC-123DD-123EE,"Aug 1, 2011 - July 31, 2012",50,75,30.5
To view the daily usage over the last 90 days and group the output by the associated resource pool, run the following command:
prompt> usage-over-periods.bat -days 90 -group resourcePool
versions-over-periods
Displays a report of the computers that have run each vFabric component included in vFabric Suite over a period of time. The
report includes the minimum, maximum, and average number of computers over the specified time period.
When running in a vSphere environment and no relevant options are specified, the command displays information for the entire
vCenter Server.
Syntax
versions-over-periods {-days number | range} [-group group | -cluster name | -datacenter name | -resourcePool name ] [-period period]
The following table lists the options for this command.
Table 6.4. Options of usage-over-periods
Option Description
-days number Specifies a date range in which the end date is today and the start date is the current date minus number of days.
For example, use -days 90 to specify an approximate date range of the last three months.
You must specify either the -days option or the two options to specify a custom data range (-startDate and -
endDate), but not both.
-startDate MM/DD/
YYYY
-endDate MM/DD/YYYY
Used together, these two options specify a custom date range. Use -startDate to specify the start date of
the report; use the form MM/DD/YYYY, such as 06/01/2012 for a start date of June 1, 2012. Use -endDate to
specify the end date of the report.
For example, to specify a date range between April 1, 2012 and June 30, 2012, use the following: -startDate
04/01/2012 -endDate 06/30/2012.
You must specify either the -startDate and -endDate or the -days option, but not both.
-group group (vSphere Environment Only) Groups the output of the versions-over-periods command by cluster,
resource pool, or data center. The output will list the specific cluster, resource pool, or data center for each license
usage entry.
Possible values (specify only one):