Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

License Statistics version 6.0 .0 includes the enhancements and fixes detailed below. Most of these improvements were made in response to customer feedback. For more information on how we incorporate customer feedback into our development process, see Customer-driven development. For  

For information about activating your License Statistics license, see Activating a License Statistics license on Windows or Activating a License Statistics license online.

Info
titleUser Interface

This release is a result of our hard work to improve the License Statistics user interface's performance and usability. We achieved these improvements by replacing the outdated ExtJS Ext JS 4 framework with ExtJS Ext JS 6 and by reducing the number of technologies used (including removing PHP, OpenSSL and Apache HTTP Server for easier maintenance).

Details about the changes introduced in this release are given below. For larger installations, we strongly recommend testing the upgrade procedure before running License Statistics v6.0 in production. If you have any questions or problems, please contact X-Formation Support.


Info
titleUpgradingLicensing

License Statistics v6.0 introduced a new licensing model (2019) that significantly simplifies licensing rules. The old licensing model (2013) is still available to customers for a limited time, as described in License Transition.Even if the


Warning
titleDatabase StructureConfiguration file

Due to technological stack changes, we This release significantly modified the database structure . Make sure you follow the License Statistics upgrade procedure for embedded or external database, especially:

  • Create a backup of the License Statistics database in case of any issues with the data migration.
  • Use the new configuration file (xflicstat.cfg) delivered with License Statistics,

    of the xflicstat.cfg configuration file. A number of configuration options were removed and new options added. In addition, stricter validation of the file was introduced. As a result, you must use the new configuration file delivered with License Statistics v6.0 and adjust it to your needs instead of

    copying your previous configuration file to the new installation.
    Warning
    titleSQL Console

    Due to significant changes in database structure, we are not able to deliver backward compatibility for custom queries saved in SQL Console. Saved queries may stop working after upgrading to License Statistics v5.14, and they will have to be removed or adjusted to accommodate the new structure.

    simply copying the old xflicstat.cfg file from previous installations.

    Highlight of configuration file changes

    • Strict validation of the configuration file structure will block any xflicstat.cfg file that contains deprecated options and License Statistics will fail to start.
    • Removed options (related to removed PHP, OpenSSL and Apache HTTP Server) include:
      • CORE_HTTP_PORT
      • SSL_CERTIFICATE_FILE
      • SSL_CERTIFICATE_KEY_FILE
      • WEBSERVER_USER
      • WEBSERVER_GROUP
      • TIMEZONE
    • Newly introduced options (related to new licensing model and new SSL configuration) include:
      • LICENSE_TOTAL_USER
      • LICENSE_TOTAL_SERVER
      • SSL_KEYSTORE
      • SSL_KEYSTORE_PASSWORD
      • SSL_KEYSTORE_KEY_ALIAS
      • SSL_PROTOCOLS
      • SSL_CIPHERS
      • LDAP_SSL_KEYSTORE
      • LDAP_SSL_KEYSTORE_PASSWORD
    • Options that were available for troubleshooting, but were previously undocumented include:
      • CORE_MIN_RAM
      • CORE_MAX_RAM
      • CORE_JAVA_FLAGS

    See Configuring License Statistics for details on configuration file settings

    Warning
    titleConfiguration file

    Renaming of the REPORTSERVER_PORT key to CORE_HTTP_PORT is a breaking change in xflicstat.cfg. License Statistics won't start if this configuration key isn't changed.


    Enhancements

    License Statistics v5v6.14 0 includes the following enhancements.

    Issue #Description
    New
    database structure
    user interface
    LICSTAT-
    14327
    15100
    LICSTAT-
    14104
    12718

    New layout of login screen.

    LICSTAT-
    13025

    Made significant performance improvements in terms of:

    • report generation
    • increased maximum number of monitored license servers, features and users
    • reduced resource consumption (less CPU, memory and storage capacity required for larger application setups)

    LICSTAT-14106

    LICSTAT-13820

    LICSTAT-12715

    LICSTAT-10995

    Redesigned data aggregation system to gain report performance improvement.LICSTAT-13024Changed the method of executing migrations by one component instead of two.LICSTAT-12573Migrated from old sampling-based data structure to new event-based data structure.

    LICSTAT-12062

    LICSTAT-12048

    LICSTAT-11931

    Removed all database views, triggers and stored procedures.Improved application architecture

    LICSTAT-14381

    LICSTAT-14251

    LICSTAT-10973

    Separate Java components were merged into single multi-module Java component to reduce resource consumption and simplify maintenance.

    Old componentsNew component
    • api.jar
    • core.jar
    • parser.jar
    • querytool.jar
    • report.jar
    • core.jar

    LICSTAT-14381

    Made changes in configuration file (xflicstat.cfg):

    • Renamed key:
      • REPORTSERVER_PORT to CORE_HTTP_PORT (default 8060)
    • Removed keys:
      • MYSQL_CONNECTION_SHARE_CORE
      • MYSQL_CONNECTION_SHARE_REPORT
      • RPCSERVER_PORT
      • CORE_SERVICE_PORT
      • DENYLOG_FEATURE_VERSIONING
    LICSTAT-14235Former C++ code responsible for querying, parsing and analyzing data from License Servers was re-designed and re-implemented in Java.

    LICSTAT-13342

    Separate C++ libraries were rewritten to single multi-module Java component to reduce technological stack and simplify architecture.

    Old componentsNew component
    • libxflicstat_core.so
    • xflicstat_core.dll
    • core.jar
    Parser adjustments LICSTAT-14849

    Implemented stricter xsd structure for custom license server:

    Attribute nameRequiredPreviously allowed valuesCurrently allowed values
    EXPIRESNo

    Any string

    • Empty string
    • "permanent"
    • A date in the format:
      YYYY-MM-dd
    CHECKOUT_TIMEYes

    Any string

    A date in the format:
    YYYY-MM-dd HH:mm

    BORROW_EXPIRE_TIMENo

    Any string

    A date in the format:
    YYYY-MM-dd HH:mm

    LICSTAT-14400

    LICSTAT-14377

    LICSTAT-13656

    Unified algorithm for parsing Reserved and Borrowed licenses, regardless of license manager type:

    • Borrowed licenses are always included in usage
    • Reserved licenses are never included in usage

    Note: Previously, reserved licenses were considered as used for FlexNet License Manager, but were not considered used for LM-X, Custom and DSLS license managers.

    LICSTAT-12884Introduced consistent parsing results across all supported license managers compatible with previously gathered data and new database structure.LICSTAT-4198Dropped support for disabling Feature Versioning for IBM LUM import usage parser in configuration file (DENYLOG_FEATURE_VERSIONING).API enhancements

    LICSTAT-14401

    LICSTAT-14380

    LICSTAT-14343

    Extended API endpoints for operations on license servers.

    LICSTAT-14386

    LICSTAT-14336

    LICSTAT-14076

    Added API endpoints for operations on license server aliases.LICSTAT-14069Added API endpoint to get status of scheduled tasks (previously requested asynchronous operation).LICSTAT-12379Added API endpoints for operations on features.LICSTAT-12378Added API endpoints for operations on feature composites (lists of matching features on different license servers that are part of the same license server group).LICSTAT-12364Added API endpoints for Database Management operations.Licensing

    LICSTAT-14468

    LICSTAT-13279

    Improved handling when the License Statistics license's expiration date or limit on monitored users is exceeded.

    License exceeded scenarioPrevious handlingCurrent handling1

    Expiration date expires while application is running.

    (Not applicable to Perpetual license.)

    All license servers are disabled.

    User needs to enable them manually after the license is renewed.

    Monitoring of all license servers is turned off, but license servers are not disabled (enabled flag is not changed).

    After license renewal, license server monitoring is automatically turned on, up to the new license limit. If the maximum number of allowed license servers is fewer than in the previously expired license, then the maximum number of oldest license servers will be turned on.

    2Maximum allowed user count from last 14 days was exceeded while monitoring license server.

    All data read from license server in current iteration is not saved in database. License server is DISABLED.

    User needs to enable them manually after the license is renewed.

    All data read from license server in current iteration is not saved in database and email notification is sent (if configured). License server is NOT DISABLED. Data from future iterations will be stored if the license allows for it.

    Note: Licensing rules and types of supported licenses are not changed. All existing licenses remain active on the same conditions as before.

    Additional enhancementsLICSTAT-14860

    Added new email alert for exceeding License Statistics license's user limit.

    LICSTAT-14856Changed calculation of users for Current License Usage pie chart on Current Users report to match calculation used for licensing (user-host pairs or usernames only).LICSTAT-14822Extended SQL Console with ability to make queries returning results in addition to SELECT (for example, SHOW or EXPLAIN queries can now be used).LICSTAT-14669Importing LDAP User Groups functionality no longer creates empty User Groups.

    LICSTAT-14655

    LICSTAT-14645

    LICSTAT-14644

    Links to services that are no longer supported have been removed from email templates, GUI, installer, etc.:

    • https://feedback.x-formation.com
    • https://kb.x-formation.com
    • https://support.x-formation.com

    LICSTAT-14649

    LICSTAT-14647

    EULA in installer has been updated to newest available version.LICSTAT-14513Dropped ability to "Remove historical data" using the License Server tab. The entire license server can now be removed using the Administration tab, even if there is no configuration for it.LICSTAT-14490

    Introduced information about newest available License Statistics version on page footer.

    Note: This feature requires an internet connection; otherwise, no information about new versions will be visible.

    LICSTAT-14460Removed functionality of merging two realtime license servers, which was conditionally possible due to an old bug in v4.6.1.LICSTAT-14342

    After making changes to user, host, or license server groups, License Statistics automatically re-generates the reports according to the changes.

    Note: It typically takes a few minutes before changes are visible on reports using the edited groups.

    LICSTAT-13490Improved label for the Data Removal feature to clarify that the selected day is removed inclusively.LICSTAT-12940Improved quality of data presented on Usage Per User report. Max columns for group aggregations are calculated based on maximum concurrent usage, not the sum of user maximum usages.LICSTAT-12449Changed Realtime Users Count report to show Denied Users count for the particular date, instead of an incremental sum of historical denials.LICSTAT-12390Prevented removing data from current day using the Data Removal feature.LICSTAT-10995Changed Usage Per User report data aggregation to delay until end of the first day of running License Statistics. All Usage Per User reports are now automatically available starting the day following the day that the first data was gathered.

    ...

    License Statistics v5.14 includes the following fixes.

    13410New Dashboard.
    LICSTAT-13311 to LICSTAT-13318
    LICSTAT-13281
    LICSTAT-13280
    LICSTAT-13217

    New layout of Administration pages.

    LICSTAT-13306 to LICSTAT-13310

    New layout of Preference pages.

    LICSTAT-13297 to LICSTAT-13305

    New layout of Report pages.

    LICSTAT-13294 to LICSTAT-13296

    New layout of License Servers pages.

    LICSTAT-13290 to LICSTAT-13293
    LICSTAT-13267
    LICSTAT-13218

    New layout of Feature pages.

    Additional user interface enhancements
    LICSTAT-15920
    LICSTAT-15712
    LICSTAT-15711
    LICSTAT-15706

    Improved consistency of error messages.

    LICSTAT-15673

    Landing page is displayed whenever License Statistics is upgrading or initializing.

    LICSTAT-15544
    LICSTAT-15403

    Redesigned layouts to manage email notifications.

    LICSTAT-15512

    Redesigned layouts to configure LDAP and mail servers.

    LICSTAT-15485

    Improved combo boxes displaying long lists with additional filter.

    LICSTAT-15484

    Reorganized Settings panels on reports.

    LICSTAT-15457

    Extended Current License Usage chart with additional data.

    LICSTAT-15216

    Improved General Panel with additional information.

    LICSTAT-15126

    Saving license server verification report is now independent from application server.

    LICSTAT-15089

    Introduced navigator in all charts with large amount of data to support zooming.

    LICSTAT-15011

    Introduced new notification popups.

    LICSTAT-13919

    Charts are now hidden when there is no data to show.

    LICSTAT-13187

    Extended routing now allows for external links to various pages.

    LICSTAT-12958

    Replaced automated redirects with suggestions to move to different section.

    LICSTAT-10121

    Introduced ability to add custom message on login page.

    Improved application architecture
    LICSTAT-15976Update lacutil to v5.
    LICSTAT-15814

    Upgraded Java JDK to v12.0.1.

    LICSTAT-15653

    Upgraded list of supported platforms and browsers.

    LICSTAT-15572

    Upgraded LM-X to v4.9.12.

    LICSTAT-15534

    Changed folder structure due to architectural changes.

    LICSTAT-15402

    Removed OpenSSL.

    LICSTAT-15356Removed PHP.
    LICSTAT-15220

    Upgraded Ext JS to v6.6.0.

    LICSTAT-14980

    Replaced Apache HTTP Server with Apache Tomcat.

    Licensing
    LICSTAT-15831

    Support for new structure of the license file.

    LICSTAT-15821

    Removed support of user-host calculation for new licensing model.

    LICSTAT-15768

    Presentation of new licensing model values on License Detail page while using old licensing model for easier transition.

    LICSTAT-15728

    Introduced documentation describing old and new licensing models with comparison.

    LICSTAT-15626
    LICSTAT-5291

    Introduced new License Detail page presenting License Statistics license details.

    LICSTAT-15551
    LICSTAT-15422

    Upgrading license server version without valid maintenance was prevented.

    LICSTAT-15464

    Added support for new licensing model rules while maintaining old licensing model.

    LICSTAT-15390
    API enhancements
    LICSTAT-15918
    LICSTAT-5291

    Added API endpoint to get licensing details.

    LICSTAT-15897

    Translation of license server status on exported reports.

    LICSTAT-15812
    LICSTAT-15803

    Removed inconsistencies of exported reports with user interface.

    LICSTAT-15762

    Extended API endpoint for Current Users report.

    LICSTAT-15687

    Improved API endpoint for license servers in terms of handling host names and ports.

    LICSTAT-15613

    Improved consistency of parameter names for various endpoints.

    LICSTAT-15584

    Extended API endpoint for listing license servers.

    LICSTAT-15559

    Extended API endpoints for operations on general options.

    LICSTAT-15545

    Extended API endpoints for operations on Misc options.

    LICSTAT-15527

    Improved consistency of filter parameter types for various endpoints.

    LICSTAT-15377

    Improved consistency of parameter types for various endpoints.

    LICSTAT-15370

    Improved error message for invalid email address.

    LICSTAT-15319

    Improved validation while editing License Statistics user's email address.

    LICSTAT-15188

    Added API endpoints to configure importing data from LDAP.

    LICSTAT-15062

    Added API endpoints to configure authentication rules using LDAP.

    LICSTAT-14305

    Extended API endpoints for getting session details.

    LICSTAT-12376

    Added API endpoints to control email subscriptions.

    LICSTAT-12374

    Added API endpoints to authenticate License Statistics users.

    LICSTAT-12372

    Added API endpoints to configure connection to email server.

    LICSTAT-12367

    Added API endpoints to configure connection to LDAP server.

    Configuration changes
    LICSTAT-15813

    More strict validation of xflicstat.cfg configuration file.

    LICSTAT-15671

    Improved xflicstat.cfg configuration file structure and description.

    LICSTAT-15343

    All historically hidden configuration file options have been published and documented.

    Removed features
    LICSTAT-15826

    Removed ability to remove historical data older than specified date.

    LICSTAT-15550

    Removed internal mechanism that attempted to rerun License Statistics after a single component failure.

    LICSTAT-15492

    Dropped functionality of grouping rows on Current Users grid.

    LICSTAT-15178

    Database structure file (database_structure.sql) has been removed from installer files.

    LICSTAT-13597

    Ability to store User Interface preferences in database per user account has been temporarily disabled.

    Additional enhancements
    LICSTAT-15717

    Logging failed query results.

    LICSTAT-15705

    Redirection to HTTPS is gracefully disabled for non-root user on Linux.

    LICSTAT-15675

    Refreshed graphics in the Windows installer.

    LICSTAT-15616

    Improved database validation on startup.

    LICSTAT-15615

    Introduced mechanism controlling size and number of stored log files.

    LICSTAT-15434

    Obsolete License Statistics options have been cleared out.

    LICSTAT-15396

    Improved consistency of license server statuses.

    LICSTAT-15393

    SSL implementation replaced with Java.

    LICSTAT-15383

    Add ability to set email address when creating user.


    Fixes

    License Statistics v6.0 includes the following fixes.

    Issue #Description
    Issues related to previous User Interface
    LICSTAT-15697 LICSTAT-13875Fixed an issue with Cancel button not working properly when adding a new license server.
    LICSTAT-15107Fixed an issue with obtaining proper timezone for PHP.
    LICSTAT-13553Fixed an issue with missing gaps on Usage History Comparison chart.
    LICSTAT-13038Fixed an issue with missing logout warning message on session expired.
    LICSTAT-12781Fixed an issue with incorrect column behavior while hiding and resizing Feature sub-columns on grids.
    LICSTAT-12015 LICSTAT-11628Fixed an issue with failing to saving state of form settings on some reports.
    LICSTAT-8695Fixed an issue with incorrect behavior of Settings panel after it was collapsed.
    LICSTAT-6735Fixed an issue with unresponsive user interface while loading Usage Comparison chart that was too complex.
    Additional issues
    LICSTAT-16057Fixed an issue with querying redundant Dassault license servers
    Issue #DescriptionLICSTAT-14913Fixed an issue with inability to import usage from SPLM log file.LICSTAT-14910Fixed an issue with invalid link to Current Usage for feature group.LICSTAT-14875Fixed an issue with expired features being visible on tooltip on Expiring Features Chart.LICSTAT-14870Fixed an issue with misleading text for empty Imported License Servers grid.LICSTAT-14864Fixed an issue with filter not working on Feature drop-down list.LICSTAT-14863Fixed an issue with error when timeout occurred on one of redundant DSLS license servers.LICSTAT-14862Fixed an issue with error when importing FlexNet log file.LICSTAT-14855Fixed an issue with error when exporting a report with a large number of columns to PDF.LICSTAT-14824Fixed an issue with SQL Console result grid visible for some queries that were returning no output.

    LICSTAT-14823

    LICSTAT-14783

    Fixed an issue with failing migration 102.

    LICSTAT-14816

    LICSTAT-14801

    Fixed an issue with slow rendering of some charts.LICSTAT-14800Fixed an issue with broken grid pagination on Expiring Features report.LICSTAT-14782Fixed an issue with incorrect documentation for Hours Used for Usage Per User report.LICSTAT-14780Fixed an issue with inability to add Email Subscription for License Server with one Feature using "All" option.LICSTAT-14775Fixed an issue with incorrect date format saved in GUI Preferences for Feature Usage History grid on Dashboard.LICSTAT-14771Fixed an issue with too long LDAP connection timeout for authorization and settings verification.LICSTAT-14768Fixed an issue with invalid End Date saved for Time Interval settings in GUI Preferences.LICSTAT-14761Fixed an issue with misleading text on Current Feature Usage grid when no data is visible.LICSTAT-14746Fixed an issue with invalid rounding of values for Feature Utilization.

    LICSTAT-14744

    LICSTAT-12145

    LICSTAT-11268

    Fixed an issue with not closing some open sessions in database on time.LICSTAT-14741Fixed an issue with missing text for empty Feature Usage History grid when Hours Used column is hidden.

    LICSTAT-14719

    LICSTAT-12267

    Fixed an issue with stopping application processes.LICSTAT-14615Fixed an issue with active link to hidden license server on Administration page
    .