Share this page

# Viewing on-premises site license usage (technical preview)

Using the REST API, on-premises site admins can view the maximum number of users in the site working concurrently in ALM Octane for a specific date range. For details on how this is calculated, see View concurrent site license usage.

In this topic:

## Prerequisite

To view the maximum number of users working concurrently in a site (for on-premises only), you must be authenticated as the site admin. For details, see Authenticating.

Note that this report is available only for the concurrent license model (and not named).

Back to top

## Calculate site concurrent license usage

Maximum concurrent license usage for the entire site is calculated periodically. In addition, site admins can trigger the calculation on demand, using the following:

Request

`POST.../admin/license_usage/`

Response

204 No Content

Back to top

## Define time units

You can view license used per day, week, or month. By default the last day is shown.

The meaning of time_unit is to return the maximum usage in the context of the time_unit requested. For example, asking for license usage in the weeks time unit generates a response containing one result per week, which is the date of the highest result of that week.

Asking for the months time_unit generates a response containing one (maximum) result for each month.

Example:

    http://localhost:8080/admin/license_usage/?start_date=2018-10-04&end_date=2017-11-05&time_unit=weeks

You can also use the time unit without specific dates, for example:

    http://localhost:8080/admin/license_usage/?time_unit=months

Back to top

## Example of viewing site usage

The site admin can view the maximum number of licenses in use concurrently per day, for the site.

Request

`GET .../admin/license_usage/?start_date=2019-10-17&end_date=2019-10-21`

Response

    {
      "license_usage": {
           "2019-10-17:00:00.000+0000": 61,
           "2019-10-18:00:00.000+0000": 72,
           "2019-10-19:00:00.000+0000": 53,
           "2019-10-20:00:00.000+0000": 64,
           "2019-10-21:00:00.000+0000": 74
           }
           "start_date": "2019-10-17",
           "end_date": "2019-10-21",
    }

Back to top

See also:

- Administering the site

https://admhelp.microfocus.com ALM Octane 8942
Tips to improve your search results... ALM Octane Help Center ALM Octane Help 15.1.90 All View Local Help Center View Online Help Center back Go back in browser history forward Go forward in browser history Remove search highlights next topic Go to next topic previous topic Go to previous topic Print the current topic Version: