Manage Aternity Licenses to Limit Devices (License Provisioning)

Use License Provisioning to allocate Aternity licenses to control the number of devices reporting performance to the system. There are four types of Aternity licenses, one for each type of device:

Types of Aternity licenses depending on the type of reporting device
License Type Description

Physical desktop

For Windows computers (laptops, desktop surfaces and so on).

Mobile device

For iOS and Android devices running apps embedded with Aternity monitoring.

Virtual application sessions

For deployments where frontline clients connect via a virtual session to a server which runs the Aternity Agent.

Virtual Desktop sessions (VDI)

For VDI deployments where frontline clients create a virtual desktop, where each virtual desktop runs the Aternity Agent.

For example, if you deployed your Aternity solution which you intend to be for 100,000 monitored devices, use License Provisioning to ensure your system works within those limits, by entering the maximum number of each device type which you want to allow. By default, the system offers unlimited licenses for each type of physical device, and sets a default limit of zero licenses for virtual sessions.

If there is a free license available from the quota, the system assigns the license and then allows a physical device or virtual session to report its performance.

Assigning a named license manually, or automatically from the available quota

There are two ways you can assign a license:

License Type Description
Manual licenses

You can manually assign a named license to a specific hostname/ID (for physical devices) or username (for virtual sessions), if there is a free license available from the quota.

Automatic licenses

Any user can occupy an automatic license on a first-come-first-served basis, if there is a free license available from the quota.


All licenses remain valid unless the user/device stopped reporting data, and did not report for 14 consecutive days. After that, the system frees the license so it is available for another user/device.


  1. Step 1 Open a browser and log in to Aternity.
  2. Step 2 Select the Gear Icon > License Provisioning.
    License Provisioning page
  3. Step 3 To define the quota for your deployment, enter the maximum number of reporting devices or sessions for each type of license, according to your Aternity license agreement.
    Defining a quota for each type of license
    Field Description

    Select this option to have no limits on the number of reporting devices or sessions.

    Limited to

    Select this to enter the maximum number of reporting devices or sessions for this type of license, according to your license agreement.

  4. Step 4 You can add a license by manually assigning it to a username or hostname/device ID.

    Select List to view the list of currently allocated licenses, select Add, and specify the allocation of the license.

    You can add the following named licenses manually:

    • Enter a username for a license to monitor a virtual application session or virtual desktop (VDI) session.

    • Enter a hostname for a license to monitor a physical Windows laptop or desktop.

    • Enter a device ID for a license to monitor a physical mobile device.

    Manually assigning a named license

    Alternatively, select Import to upload a CSV file with details of multiple usernames or device names to be assigned a manual license.

  5. Step 5 You can remove a specific license, so it is freed for allocation elsewhere.

    Select List to view the list of currently allocated licenses, select the check box of the user you want to remove and select Delete at the bottom of the window.

    Use the search box to jump to the username or hostname/ID of the device.

    Freeing a specific license
  6. Step 6 If your quota is full, and there are users or devices which occupy a license needlessly as part of their 14 day grace period, you can release all licenses of one type, by selecting Release to free all occupied licenses of a given type.

    This would allow other devices to be assigned to a free license to report their performance.

    Free all the occupied licenses of one type
  7. Step 7 To troubleshoot a particular device which is not monitored, to determine if it was not granted a license:

    Check the licensing log by selecting Provisioning Events. It displays the recent licensing events, where each entry shows only the latest event for one license (user or device).

    To jump to a specific hostname, device ID or username, enter it in the Name / ID search box.

    Event log for Aternity licenses
    Field Description
    Last occurred at

    Displays the time and date when the last licensing-related event took place for this named user or device.

    Name / ID

    Displays the username (virtual session), hostname (computer) or device ID (mobile) which requested the license.

    License Type

    Displays the type of license for this event. There are four types of licenses: physical desktop, mobile device, virtual application sessions, and virtual desktop sessions (VDI).

    Event Type

    Displays the event's action, for example if the license was approved or rejected.


    Describes the reason for the rejection of a license request. For example:

    • Monitored session limit exceeded indicates that the system already assigned the maximum number of virtual sessions for that server. By default you can have up to 50 simultaneous monitored sessions on a single server.

    • No license available indicates that the system already reached its full quota of licenses.

    License Used

    Displays whether the requested licenses was indeed occupied as a result of this event.

    Serving Hostname

    (For virtual sessions only) In CItrix XenApp sessions, it displays the hostname of the XenApp server. For VDI sessions, it displays the hostname of the virtual desktop (VM) created for this session.