Generating reports to track license usage

The report contains the following information:

• For AR System and application user fixed licenses, the highest number of licenses assigned at the same time during the period covered by the report.
• For AR System and application user floating licenses, the highest number of licenses in use at the same time during the period covered by the report.
• For each type of license, the maximum limit specified in the Add or Remove Licenses form.

• For AR System and application server group licenses, the usage of licenses across the entire server group, including the individual server against which the report is run.

  Although all servers in a server group use licenses from the same Add or Remove Licenses form, each server in a group generates its own LicenseReport.txt file.

• For AR System and application server group licenses, the server group name and the host ID.

The report is written to a file named ReportResult.csv. You can generate it from the AR System License Console.

The following image shows a sample license usage report:

To generate a license usage report

1. In the AR System Administration Console, click System > General > Add or Remove Licenses.
2. In the Add or Remove Licenses form, click Generate License Usage Report.
3. Click the calendar icon next to the License Report Start Date field, and select a date from the calendar.
   The start time is 12:00:00 A.M. on the specified date.
4. Click the calendar icon next to the License Report End Date field, and select a date from the calendar.
   The end time is 11:59:59 P.M. on the specified date.
   If the selected start or end date exceeds the time period covered by the server, the first or last date covered by the server is used instead. The time period covered by the report is specified in the report header.
5. Click Generate Report.
   A message specifying the location of the ReportResult.csv file appears. By default, the file is stored in this directory:
   • (UNIX) ARSystemServerInstallDir/Db
   • (Windows) ARSystemServerInstallDir\ARServer\Db

6. Click OK.
   The license usage report is displayed in a CSV-compatible viewer, such as Microsoft Excel.

   You can also use the produse.exe utility to generate a license usage report. See Alternate method for generating a license usage report.

Generating a license usage report for a specific date range

By default, the information in the license usage report is based on all the license usage data stored on the server. To generate a license usage report for a specific date range, select the date range in the license usage report.

Report of your purchased licenses

To obtain an up-to-date list of your AR System licenses, you can request a reconciliation report of purchased licenses from BMC. Contact your BMC Sales representative or Customer Support. For information about contacting BMC Support, seeSupport-information.

Alternate method for generating  a license usage report

An alternate method to generate the license usage report is to use LicenseReport.txt which is available in the following directory:

• (UNIX) ARSystemServerInstallDir/Db
• (Windows) ARSystemServerInstallDir/ARServer/Db

To gather information about license usage, each AR System server scans the system approximately every 45 minutes and writes the results to LicenseReport.txt. The LicenseReport.txt file is uploaded in the AR System License Report form. As a backup, the server also uploads the LicenseReport.txt file in the database. During the next scan after 45 minutes, if the server does not find the LicenseReport.txt file in the ARServer/Db directory, the backup file is downloaded from the database and is updated. Additionally, you can access this backup file from the AR System License Report form. You can search for this form from the Administration Console.

You can use the produse.exe utility to generate a license usage report based on the information in LicenseReport.txt for each of your AR System servers.

Although all servers in a server group use licenses from the same Add or Remove Licenses form, each server in a group generates its own LicenseReport.txt file.

To use produse.exe to generate a license usage report

1. Go to the directory that contains the produse.exe utility:
   • (UNIX) ARSystemServerInstallDir/bin

   • (Windows) ARSystemServerInstallDir

     Before running produse.exe on UNIX platforms, make sure the ARSystemServerInstallDir/bin directory is in the library path environment variable: LD_LIBRARY_PATH (Linux, Solaris), LIBPATH (AIX), or SHLIB_PATH (HP-UX).

2. At the prompt, enter this command:

   produse [-i <inputFilePath>] [-o <outputFilePath>] [-s <startDate>] [-e <endDate>] [-r]

   Where

   -i	Specifies the full or relative path to the input file. By default, the input file is LicenseReport.txt and is in this directory: (UNIX) ARSystemServerInstallDir/Db (Windows) ARSystemServerInstallDir/ARServer/Db If this parameter is not specified, the current directory and the LicenseReport.txt file name are used.
   -o	Specifies the full or relative path to the output file. By default, the output file name is ReportResult.csv and is in this directory: (UNIX) ARSystemServerInstallDir/Db (Windows) ARSystemServerInstallDir/ARServer/Db To rename it, specify a different file name. If this parameter is not specified, the current directory and the ReportResult.csv file name are used.
   -s	Specifies the start date of the report in M/d/yyyy format. The start time is 12:00 A.M. on the specified date. If this parameter is not specified, the report includes data from the beginning of the LicenseReport.txt file. If this parameter exceeds the range covered by the LicenseReport.txt file, the range covered by the file is used instead, and that range is indicated in the report header.
   -e	Specifies the end date of the report in M/d/yyyy format. The end time is 12:00 A.M. on the immediate next day of the specified date. If this parameter is not specified, the report includes data to the end of the LicenseReport.txt file. If this parameter exceeds the range covered by the LicenseReport.txt file, the range covered by the file is used instead, and that range is indicated in the report header.
   -r	Backs up the current LicenseReport.txt file by renaming it LicenseReport-fileCreateDate-currentDate.txt and generating a new LicenseReport.txt file.