License Monitor Portal

The License Monitor Portal displays the real-time monitoring interface of all the collected data from various supported license managers.

NOTE

The License Monitor Portal interface varies depending on the value of the Root.Level configuration key. Follow the instructions in the Setting Open iT Level section to change it accordingly.

It has the following parts:

a. Global Filters
b. Search
c. Collection Details and Data Reload
d. Sort and Reset
e. Filter Portal
f. Details View

Analysis Server Home - License Monitor Portal

Loading Data

The data displayed on the License Monitor Portal page is loaded and refreshed every 5 minutes. This is embedded in the Open iT Alerts service, along with the sending of configured email alerts. If immediate loading is necessary, please use the instructions in the SyncLicenseStatus section to run the command SyncLicenseStatus /reload.

If data is still not showing, please use the instructions in the License Monitor Portal - No data displayed section to troubleshoot the issue.

Global Filters

Follow these steps to use global filters and refine the details view:

1. Click the desired button to filter the details view.

   Filter	Description
   All	Displays all users whether active or inactive.
   Active	Display all active users.
   Inactive	Displays all inactive users.

   Global Filters

   The Active and Inactive license usage details will be displayed when you set the Root.Level configuration key to Level2 or Level3, and the corresponding app-status data is available in the Core Server database. Follow the instructions in the Setting Open iT Level section to change the Root.Level value accordingly.

   warning

   Make sure to restart the OpeniTAlerts service after changing the value of the Root.Level configuration key. Follow the instructions in the Alerts Service Jobs Configuration section to restart the service.

   NOTE

   timeout is not included in the criteria for the Active and Inactive real-time status.

2. The details view will be filtered accordingly. The following colors indicate the status:

   Color	Description
   Green	Active
   Yellow	Inactive

   User Activity Status Colors

   

   License Monitor Portal Global Filters

   Notice that the active and inactive users details are based on the filter.

Search

Follow these steps to search a specific item:

1. Choose from the search by options:

   

   License Monitor Portal Search

   Filter	Description
   Vendor License	Search from all the vendor licenses.
   Package	Search from all the packages.
   Feature	Search from all the features.
   Users	Search from all the users.

   Search Filter

2. Type in the keyword to search in the provided textbox.

   An autocomplete should appear listing all the possible items.

3. Click the desired item from the autocomplete options.

   

   License Monitor Portal Search Autocomplete

   The details view should be filtered accordingly.

Collection Details and Data Reload

Use the collection details to monitor data consistency and the data reload to synchronize web interface data from the background processing. The collection details contain:

Label	Description
Current Users	Number of distinct users for all the vendor licenses.
Collection Time	Date and time the data was last collected.

Collection Details

Click the Reload button to reload the data. The collection details and the details view should be updated.

License Monitor Portal Reload

Sort and Reset

Use the sort functionality to arrange the items in the details view in ascending or descending order based on the sorting criteria. Follow these steps to sort and reset:

1. Choose from the sort criteria.

   Criteria	Description
   Name	Sort by vendor license name.
   License Expiration	Sort by the date of license expiration.
   Distinct Users	Sort by the number of distinct users.
   Active Users	Sort by the number of active users.
   Inactive Users	Sort by the number of inactive users.

   Sort Criteria
   
   
   NOTE

   If the Root.Level configuration key is set to either Level1 or Level3, only Name, License Expiration, and Distinct Users will be available.

   Refer to the Setting Open iT Level section to learn more about Root.Level.

   
   

2. Click the desired order (ascending or descending) of arrangement.

   The details view should be sorted accordingly.

3. Click the Reset button to set the filter and search selection to its default state. The page should be refreshed.

License Monitor Portal Sort and Reset

Filter Portal

Use the Filter Portal functionality to refine the data presented to various components of the License Monitor Portal. The current option is filtering the Denial Reason included in the Utilization Trend quick chart. Follow these instructions to filter:

NOTE

This functionality is only available for service account and web interface administrators.

1. In the upper-right corner of the page, beside the Reload button, click the gear icon.

2. The Filter Portal pane should appear. Choose among the available Denial Reasons.

   NOTE

   Initially, all the Denial Reasons are selected.

   At least one (1) selected Denial Reason is required. Use the search option to further filter the items in the list.

3. Click Save to apply changes.

   warning

   The filter is only applied in the Utilization Trend quick chart.

Details View

This part contains the lists of vendor licenses, features, and users. It provides essential information about the license usage from vendor license level up to the user level.

Follow these steps to navigate the details view:

1. Click the desired item from the list of vendor licenses.

   The vendor license item contains the following information:

   a. Vendor License Name
   b. Server Status - the icon beside the vendor license name that indicates whether the server is collecting data or not. This icon can be one of the following:
   

   • Server - a server or vendor license directly collected without any mapping
   • Globe - a grouped vendor license or a result of product mapping
     

   c. Active/Inactive Usage Bar - displays the percentage of licenses that are currently in active and inactive state.

   NOTE

   Hover over the bar to see the exact number of usage.

   This is only visible if Root.Level is set to either Level2 or Level3.

   d. Distinct User - number of distinct users.

   

   Vendor License View

2. The vendor license information should appear that contains the following:

   • Server(s) - list of server hostnames with its port.
   • Daemon - the name of the running daemon or background process.
   • License File - the full path of the license file.
   
   
   NOTE

   Hover over the vendor license information to show the Daemon status.

   The vendor license information is not available in a grouped vendor license.

3. Click the desired item from the list of features.

   The feature item contains the following information:

   a. Feature Name

   NOTE

   The total number of usage can be seen next to the Feature Name.

   b. Export - export the list of users under the feature. Only visible when users are available.

   c. Utilization Trend - a quick link to the Utilization Trend chart of the specific feature. It provides a historical view of its license usage.

   d. License Efficiency - a quick link to the License Efficiency chart of the specific feature. It provides information on how efficient the licenses are used.

   e. Week Hour Heatmap - a quick link to the Week Hour Heatmap chart of the specific feature. It provides a weekly overview in hourly basis of the license usage.

   f. License Usage - a progress bar that shows the available licenses and the licenses in use. The licenses in use bar are separated into various colors:

   Color	Description
   Dark Gray	Unused (Reserve). The number of available reserved licenses. Only applicable for Flex.
   Gray	Unused. The number of available licenses.
   Green	In Use (Online). The maximum number of licenses in use (online).
   Light Green	In Use (Shadow Package). The number of licenses in use for features with package.
   Dark Blue	In Use (Reserve). The maximum number of licenses in use (reserved). Only applicable for Flex.
   Orange	In Use (Offline) or In Use (Linger). The number of licenses in use categorized as Offline or Linger. Only applicable to DSLS, Flex, and V-Ray license managers.
   Blue	In Use (Token). The number of licenses in use categorized as Token-based. Only applicable to AVEVA and DSLS license managers.
   Brown	In Use (NamedUser). The number of licenses in use categorized as NamedUser. Only applicable to Bluebeam Revu 21, Esri, DSLS, RLM, and SketchUp license managers.
   Violet	In use (Dongle). The number of licenses in use categorized as Dongle. Only applicable to V-Ray license manager.

   License Usage Colors

   The smaller progress bar at the bottom of each license usage bar indicates the number of active (darker) and inactive (lighter) licenses.

   

   Features View

   Showing Package

   To show the Package name where the specific component belongs, follow these instructions:

   Display the package in the License Monitor Portal.

   a. Display the package in the License Monitor Portal.

   Displaying Package in the Dashboard and License Monitor Portal

   b. Go to the LM Portal > License Monitor Portal, and verify that the feature name (components) that belongs to a package have the format <package_name> - <component_name>.

   

   Package View

   Showing Feature Version

   To show the Feature Version, follow these instructions:

   Display the feature version in the License Monitor Portal.

   Displaying Feature Version in the License Monitor Portal

   b. Go to LM Portal > License Monitor Portal, and verify that the feature name have the format <feature_name> [<feature_version>].

   

   Feature Version

   NOTE

   When the Feature Version is shown, Denials measure in the Utilization Trend chart is not available.

4. The users list should be displayed and contain the following information:

   a. User Name

   b. User Activity Status - an indicator about the license usage activity status of the user. The following colors indicate the status:

   Color	Description
   Green	Active
   Yellow	Inactive

   User Activity Status Colors
   
   
   NOTE

   Make sure to set the Root.Level configuration key to Level2. Follow the instructions in the Setting Open iT Level section.

   c. Offline License Expiration - an icon indicating that the license in use by the user is offline or borrowed.

   NOTE

   Hovering over the icon displays the date and time when the offline license expires.

   

   Offline License Expiration

   d. Host Name - the host used by the user to checkout the license.

   e. Usage Time - based on the license manager, it can be one of the following:

   • For DSLS, it is the date and time the license was last used by the user.
   • For other license managers, it is the date, time, and duration the user checked out a license.

   f. In Use - the number of license in use by the user.

   

   Users

Recommended Reading

The following configuration is applied to the License Monitor Portal, review and determine if necessary.

Configure Roles for Data Restrictions

Configure Roles for Web Interface Components Restrictions

Manage License Metadata

Configure License Metadata