This documentation supports the 19.11 version of Remedy Action Request System, which is available only to BMC Helix subscribers (SaaS).
To view an earlier version, select the version from the Product version menu.

Generating a license usage report

Best practice

We recommend that you generate a license usage report from the Administration Console. See Reviewing license usage.
This topic discusses an alternate method to generate the license usage report using LicenseReport.txt. Do not delete this file, which is available in the following directory:

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

To gather information about license usage, each BMC Remedy AR System server scans the system approximately every 45 minutes and writes the results to LicenseReport.txt. 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 gets downloaded from the database and is updated. Additionally, a backup of this file is also available through 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 BMC Remedy AR System servers.

Note

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

      Important

      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.

Related topics


Was this page helpful? Yes No Submitting... Thank you

Comments