The License Usage Pack provides a collection of DTP widgets and reports that present information regarding license usage of Parasoft tools whose licenses are being managed in DTP. It allows you to monitor how many Parasoft tools are being used in your organization, who is using these tools, and show if there were any license shortages or if license requests were close to your token limit.

Requirements

• DTP and DTP Enterprise Pack with Enterprise license.

Process Overview

1. Download and install the License Usage Pack (license-usage-pack-<version>.zip) into your DTP environment. Installing the package adds several files that configure DTP to report license usage. 
2. Configure and deploy the new flows included with the pack.
3. Add the license usage widgets to a new or existing DTP dashboard. A dashboard template including all the widgets is available.
4. Interact with the widgets and reports to track license usage and token requests.

Installation

Parasoft provides the license usage pack as a compressed folder (.zip) which you can download from the Parasoft Marketplace. Extension Designer will expand the .zip file and move the contents to the appropriate location when uploaded. The following process is also described in the Downloading and Installing Artifacts section:

1. Choose Extension Designer from the DTP settings menu (gear icon).
   
2. Click the Configuration tab and click Upload Artifact. 
   
3. Browse for the .zip file when prompted and click Install. 

Importing and Configuring License Usage Flows

1. Choose Extension Designer from the DTP settings menu (gear icon).
   
2. Click the Services tab, click Add Service and add a new service called something memorable (for example, "License Usage") to the category of your choice.
3. Two new flows are included with the pack. Import them to this new service. See "Importing and Exporting Flows" on Working with Flows for more information about importing flows. The flows can be found under Local > Flows > Workflows > License Server.
   

4. Click Deploy.
   

   Imported dashboards and widgets are not available in Report Center until the browser is refreshed.

Usage

After installing the license usage pack and configuring then deploying its flows, you can set up a dashboard and start using its widgets and reports.

Dashboard

The License Usage pack includes a dashboard template called "License Server Usage Dashboard" that contains all the license usage widgets and reports in one, convenient dashboard. See Adding Dashboards for more information about adding dashboards to DTP, including from a template.

Widgets

There are several license usage widgets available for you to use in a new category "License Server" that was added with this pack. If you added a new dashboard from the License Server Usage Dashboard template as described above, all of these widgets are shown there. You can also add any or all of these widgets to an existing dashboard. See Adding Widgets for more information about adding widgets to a dashboard. A brief overview of these widgets can be found below.

Upon adding widgets, you might find that some of them have no data. This can be because no licenses have actually been used yet, or it could be because the cache file the widgets use is empty. This cache file is automatically updated every day at midnight and license usage is shown from that data. You can manually update this cache file by clicking Update Data on the "Update Data" widget with current data.

Period Chart - Token Usage

This chart provides the total tokens used for all Licensed Parasoft tools. The data is presented for the specified period of time.

Period Table - Features Denied

This table widget shows information about requests that were rejected by the License Server because the specific feature requested by Parasoft tool from License Server was not available in the license. Note that this data concerns specific features of license, not the entire license token. For that data, see the “Period Table - No More Tokens” widget. The data is presented for specified period of time.

Period Table - No More Tokens

This table widget shows information about the requests that were rejected by the License Server because the license token requested was not available on License Server. This generally happens when a specific license is not present in License Server or it is present but all available tokens for the license are already taken by other Parasoft tools. The data is presented for specified period of time.

Period Table - Users Denied

This table widget shows information about requests that were rejected by the License Server because the user making the request has had their permissions removed. The data is presented for specified period of time.

Trend - Daily Rejections

This chart graphs three rejection types–No More Tokens, Users Denials, and License Feature Denials–over the specified time period, as determined by the Start Date and End Date you set.

Trend - Daily Hours

This chart graphs daily tool usage, by hour, for each Parasoft tool over the specified time period, as determined by the Start Date and End Date you set.

Trend - Daily Tokens

This chart graphs daily token usage for each Parasoft tool over the specified time period, as determined by the Start Date and End Date you set.

Period Table - License Usage Hours

This table widget shows information about the total usage hours for Parasoft tools over a specified period of time. Click the more... link to show all tools and their usage hours in the period.

Upgrading

Although Parasoft extensions are designed to be forward compatible, they are not guaranteed to work in newer versions of DTP or Extension Designer. We strongly recommend installing the latest version of the artifact and removing the previous version. 

1. Install the newer artifact as described in Installation. 
2. Un-deploy older artifact from Extension Designer by deleting its nodes and clicking Deploy. 
3. Deploy the newer version.