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
- 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.
- Point your browser to http://YourJIRAhostname:8080/
Log in to the JIRA server. Use an account that has administrator
privileges, if applicable.
- Click at the upper right of
the page.
- On the Administration page, click Manage
Add-ons.
- In the OSLC section at the lower left of the Administration page,
click Rational Adapter Home.
The Rational
Adapter for JIRA page opens.

- In the User-Based Licensing Spreadsheet section, click Download
User-Based Licensing Spreadsheet.
- When prompted, save the file UserLicensing.xltm to
a local directory.
- 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.