Tracking user-based licenses

If you are using user-based licensing, some setup is required, which includes setting values in a properties file.

Before you begin

The adapter is installed.

About this task

To log information about each user, you set values in a properties file. Information is logged in to .csv files that are based on those properties. The .csv files are imported into a spreadsheet so you can view and monitor usage over time.

Procedure

  1. Set up a file for user-based licensing properties, see Setting up debug and user license logs.

View the results of one or more log files.

  1. Point your browser to http://YourJIRAhostname:8080/

    Log in to the JIRA server. Use an account that has administrator privileges, if applicable.

  2. Click Administration > Add ons at the upper right of the page.
  3. On the Administration page, click Manage Add-ons.
  4. In the OSLC section at the lower left of the Administration page, click Rational Adapter Home.

    The Rational Adapter for JIRA page opens.

    The JIRA adapter banner

  5. In the User-Based Licensing Spreadsheet section, click Download User-Based Licensing Spreadsheet.
  6. When prompted, save the file UserLicensing.xltm to a local directory.
  7. Use Microsoft Excel to enable the user licensing macro that you downloaded and run that macro against your log file directory. Save the file with a name such as jira-users-june and a type of Excel Macro Enabled Workbook. Run the macro named UserLicensing and select your log file.

    Each .csv file is imported into the workbook as a separate worksheet. Each worksheet has the same name as the .csv file.

    Each spreadsheet provides this information:
    • Maximum and minimum active user licenses
    • Total users
    • Unique list of users

Results

You can track the number of users that are licensed to use the adapter and can view that information in a spreadsheet.

What to do next

Establish friend relationships and associate projects, see Integrating applications.

Feedback