License Parser

To inspect a FlexLM license file before it reaches a license server, upload it to License Parser. License Parser converts the file into a structured, readable report that confirms the features you expect and that you can share with procurement, finance, or other readers who don't read raw license text.

What you can do with License Parser

With License Parser, you can do the following:

• Upload a FlexLM license file by drag and drop or by selecting it from your computer.
• View parsed features in a sortable, searchable data grid.
• Filter results by vendor, license type, or feature name.
• View file-level summary fields, including format, primary vendor, server, MAC address, and port.
• Export the current view to CSV.

Before you begin

Confirm these prerequisites:

• An active OpenLM Platform account with License Parser activated in Products.
• One of the following roles assigned to your account:
  • sys_admin_role: System Administrator
  • account_admin_role: Account Administrator
  • LicenseParser_Admin: License Parser Admin
• Access to the FlexLM license file you want to inspect.
• A FlexLM (FLEXnet) license file. License Parser supports FlexLM license files only, and uploading a file in any other format produces an error.

If your account doesn't have one of these roles, you see Not Enough Permissions. Ask your OpenLM administrator for access.

Open License Parser

To open License Parser, select Navigation (the grid icon in the OpenLM Platform header), then Licenses and Features, then License Parser.

On the Parsing page, upload your file. The following image shows the drag-and-drop upload area:

Upload area on the Parsing page

Upload a license file

To upload a license file, drag it onto the upload area or browse for it.

Upload by drag and drop

To upload a file by drag and drop:

1. Locate the license file on your computer.

2. Drag the file onto the upload area labeled Drag & Drop your files here.

   The upload starts automatically.

Upload by selecting a file

To upload a file by browsing for it:

1. Select Choose File Manually under the drag-and-drop area.

2. Select the license file in the file browser dialog.

   The upload starts automatically after you select the file.

Upload results

After you upload a file, the following happens:

• The file uploads to the server. A progress bar shows progress during the transfer.
• The server parses the file using the FlexLM parser.
• After parsing succeeds, License Parser opens the Report page with the results.

If the file isn't a valid FlexLM license file, you see an error notification. Upload a different file.

View parsed features

To see every feature in the file, open the Features tab on the Report page. The following image shows the parsed license features:

Parsed license features on the Features tab

To see the totals for the whole file, check the three counters at the top of the Report page:

Counter	What it counts
Seats owned	Total seats across all parsed features: the sum of the Quantity column.
Features parsed	Number of license features found in the file, one per row of the features grid.
Expiring soon	Number of features that expire within the next 30 days, counting from today. Expired features and permanent licenses aren't counted.

Features grid columns

To read a feature in the grid, use the following columns:

Column	Description
Quantity	Number of license seats available for the feature.
Vendor	Software vendor that issued the license, for example adskflex.
Version	Version of the licensed feature.
Issued At	Date the license was issued.
Expiration Date	Date the license expires. For a FlexLM permanent license, the cell shows a far-future placeholder date. See the note after this table.
License Type	Type of license, for example Floating, Node-Locked, or Named User.
Feature	Name of the licensed software feature.

Note

For a FlexLM permanent license, the Expiration Date cell shows a placeholder date at the end of the year 3000. License Parser parses it as December 31, 3000, so it can show as December 30 depending on your time zone. The cell reads Permanent only when License Parser finds no expiration date for the feature.

Grid actions

To work with the grid, use the following toolbar actions on the Features tab:

• Export: Downloads the current view as a CSV file.
• Refresh: Parses the same license file again.
• Filter Toggle: Shows or hides the filter row.
• Search: Filters the grid by keyword across all columns. Matching text is highlighted.

Sort, resize, and select columns

Select any column header to sort the grid by that column. Select the header again to reverse the sort order. Drag column edges to resize columns. To show or hide individual columns, use the three-dot menu (⋮) in the grid header.

Page through results

If the parsed file contains many features, the grid splits the results across multiple pages. Use the pagination controls at the bottom of the grid to switch pages or change the number of items per page.

Filter results

To narrow the features in the grid, use the filter drop-down lists:

1. Select the filter toggle (funnel icon) in the actions toolbar.

   In the filter row, you can now select values. The following image shows the filter row:

   Filter row with Vendor, License Type, and Feature drop-down lists

2. Select values in any of the three drop-down lists:

   • Vendor: One or more software vendors, for example adskflex.
   • License Type: One or more license types, for example Floating or Node-Locked.
   • Feature: One or more feature names.

   Each drop-down list supports multiple selection and includes a search box for finding specific values.

3. Select Apply to filter the grid.

To remove all filters, select Clear.

Check the filtered results

After you select Apply, the grid shows only the features that match your filter criteria. The active filter values remain visible in the filter row, so you can see what is applied.

The following image shows filtered results:

Filtered results for the selected criteria

In this example, a vendor and a feature name are selected, reducing the results to a single matching license feature. The pagination at the bottom reflects the filtered count (1-1 of 1).

Keep these points in mind when you filter:

• Combine filters across columns, for example by vendor and license type at the same time.
• Search works on the filtered set, so you can search within filtered results.
• Exporting to CSV while filters are active exports only the filtered data.
• Changing filters resets the grid to the first page.

View the file summary

To see file-level details, select the Summary tab next to the Features tab. The following image shows the file metadata:

File metadata on the Summary tab

The Summary tab lists the following fields:

Field	Description
File Format	Detected license file format, for example FlexLM license.
Lines Parsed	Number of non-blank lines in the uploaded file.
Vendor	Primary vendor identified in the license file.
Server	License server host name.
Mac	MAC address of the license server.
Port	Port number used by the license server.

Note

The Server, Mac, and Port fields appear only when this information is present in the license file header. Not every license file contains these details.

Other tasks

The following tasks help you work with the report.

Return to the upload page

To parse a different license file, select the back arrow next to the Report title. License Parser returns to the Parsing page.

Export data to CSV

To export the parsed features:

1. Open the Features tab on the Report page.
2. (Optional) Apply filters or a search keyword to narrow the data.
3. Select the export button (download icon) in the actions toolbar.

License Parser downloads license-features.csv to your browser's default download location.

Refresh results

To parse the same license file again, select the refresh button (circular arrow icon) in the actions toolbar. If the file has changed, upload it again. For more information, see Return to the upload page.

Configure columns

To show or hide columns in the grid, select the three-dot menu (⋮) in the grid header. The column chooser opens.

Search with highlighting

To filter the grid across all columns, enter a keyword in the Search box. License Parser highlights matching text within cells.

Troubleshooting

Why do I see "Not Enough Permissions"?

Your account doesn't have the required role. Contact your OpenLM administrator to assign one of the following: sys_admin_role, account_admin_role, or LicenseParser_Admin.

Why do I see an error notification after a file upload?

The file might not be a valid FlexLM license file. You also see an error notification when the file is empty or has no INCREMENT, FEATURE, or PACKAGE lines. Confirm you are uploading a plain text FlexLM file. License Parser doesn't support other license formats.

Why is the upload slow or stuck?

Larger files take longer to upload and parse. Check your network connection and wait for the progress bar to complete. If the upload stops responding, refresh the page and try again.

Why are the filter drop-down lists empty?

Each filter drop-down list lists the distinct values found in the parsed features. If every feature has the same value for a field, for example the same vendor, that drop-down list offers a single value. A drop-down list is empty only when no parsed feature has a value for that field.

Related

For related tasks, see the following pages:

• License File Management
• Licenses
• License Servers