Versions Compared

Key

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


The information on this page refers to License Statistics v6.19 and newer, which added filtering for the Anonymization column in the License Servers grid. If you are using a version previous to v6.19, see documentation for previous versions.

You can add and configure license servers and edit information for existing license servers using the General tab in the Realtime License Servers tab page, found under the Administration section in the Administration page. left navigation pane. (This page is visible only for License Statistics administrator users.) You can also verify your License Statistics configuration, which may be useful for troubleshooting purposes. 

License Servers grid

The License Servers grid in the The Realtime License Servers page lists information for all each currently configured license servers in the Realtime License Servers grid, including: server, as described in the following table.

Column NameDescription
License Server
The display name for the license server
.Hostname
.
License Server IDThe ID of the license server. 
License Server DescriptionThe optional user-defined description for the license server. 
License ManagerThe license manager type (can be any supported license manager or a custom license manager).
HostThe hostname of the license server. If the license server is configured to be redundant (three servers are used) this is the hostname of the main license server. 
PortThe port to use for the license server. If the license server is configured to be redundant (three servers are used) this is the port for the main license server.
Lic ManagerThe license manager type (can be any supported license manager).StatusThe status of the configuration.RedundantAn icon showing one computer indicates that the license server configuration is not redundant. An icon showing three computers indicates the license server configuration is redundant.

...

 

Anchor
DataSourceStatus
DataSourceStatus
Data Source Status

The status of the license server for each applicable data source, including Remote, Import, and End User (e.g., Agents). 

You can hover over each data source status to see its details, including Last Update Time and, for "Failure" status, the relevant error message.

For detailed information about license server status, see License Servers

Enabled

Indicates whether monitoring is enabled for the license server. A toggle in the Action column indicates the enabled status and allows you to enable/disable the license server as needed.

Image Added

Last Update TimeIndicates the time the data for the license server was last updated for all data sources. A status of "Never" indicates that the server was created but doesn't have any data yet (for example, the server has not yet had its first query or it was disabled before it was queried for the first time, or it was never imported). 
Query IntervalIndicates the time interval (in minutes) between queries.
RedundantIndicates (Yes/No) whether the license server is redundant.
Feature VersioningIndicates (Yes/No) whether Feature Versioning is enabled for the license server.

Anchor
anon
anon
Anonymization 

Indicates whether users, hosts, or both are anonymized for the license server. A Filters option allows you to show/hide servers according to their anonymization of users and/or hosts:

 Image Added

Note

Some columns are hidden by default. To control the visibility of columns, see instructions for filtering grid content. 

Anchor
add_edit_ls
add_edit_ls
Adding or editing a license server

License Statistics lets you add license servers with the same hostname, port, and other settings multiple times, which may be useful when you want to experiment with using different features, such as Feature Versioning. You should note, however, that the name you give to the license server must be unique; i.e., different than other names already assigned to existing servers.

To add or edit a license server configuration:

  1. To edit an existing license server configuration, click the edit Edit icon in the Action column of the Realtime License Servers grid row for the license server you want to change. An Edit License Server dialog opens to allow you to change the existing settings for that license server.

    or

    To add
    and configure a new license server, click the Add New button at the bottom of the Realtime License Servers grid.
    An Add New License Server dialog opens to allow you to configure the new license server. 

  2. The dialog will contain tabs for General information and for each data source that is applicable to the license server type (Remote Monitoring, Importing, and/or End User Monitoring). Complete the information in the Add New/Edit License Server dialog 's General tab as described in the table below.below in "License Server settings."

  3. Anchor
    remote_monitoring
    remote_monitoring
    The Remote Monitoring tab lets you verify the license server configuration manually.

    If you would like to verify the configuration, click Verify at the bottom of the Remote Monitoring tab. (This step is not necessary; the configuration will automatically be verified when you save the license server, as described in the next step.)

    Image Added

    After you enter all the information for the license server in the General tab, you can click Verify to ensure that you can connect to the license server. Verification may take a long time depending on the license manager’s response time. (Setting the query interval in the Additional Options tab to 1 minute may make verification faster.) The results , and the status will show that the server is being verified. The verification results will include the status (success or failure), the reason for the failure if verification failed, and the query tool output. You can save the output . The output should look similar to the following. 
    Image Added

    When the verification is complete, you can use Save to File to export and save the data to a file if desired
    .    
    ; for example, X-Formation Support may request this file for troubleshooting.To continue to the Additional Options tab, click Next. Complete the information in the Additional Options tab as described in the table below.  

  4. After completing all settings as needed, click Save or Save and Close to save the configuration settingslicense server. You can click Cancel Close at any time if you do not wish to save your changes.

Anchor
lic_server_settings
lic_server_settings
License Server settings

License Server settings, described below, are divided into tabs, including General; Remote Monitoring; End User Monitoring (currently for the Autodesk license manager type only); Importing (for license manager types for which importing license server data is supported); and Custom Application Monitoring (for the Custom Application license manager type only). Within each tab, only the settings that are valid for the selected License Manager Type will be shown. For example, the "Vendor Daemon Name" setting is applicable only to FlexNet, RLM and OLicense license manager types, so this setting will not display for other license manager types.

SettingDescription
General tab 
General settings
Name The name for the license server that will be displayed in License Statistics. This can be any descriptive, unique name that helps you identify the license server in License Statistics pages.
Enabled

Check this box to enable monitoring for the license server. When this box is not checked, monitoring for the license server is disabled. 

Only enabled license servers are counted in the number of license servers you can monitor according to your License Statistics license agreement. You can add any number of disabled license servers. If you have reached your limit of license servers you can monitor, you can disable any license servers that you do not need to monitor and enable the license servers you do need to monitor.

License Manager Type

The type of license manager you are using for the license server. This selection list includes all supported license managers. You can begin typing the license manager type to limit the selection list to entries that contain the characters you type. 

If you select Custom as the license manager type, you must specify the path to your custom XML file in the File Path field under Connection settings. See Supporting a custom license server for information on adding a custom license server.

If you select Custom Application as the license manager type, you must set up custom application monitoring.

DescriptionAn optional description for the license server. 
Vendor settings
NameThe vendor name read from the license server output. Read-only field is set to the proper value on the first query.

Anchor
daemon
daemon
Daemon Name

An optional vendor daemon name for the license server. This entry cannot contain spaces or special characters, except underscores, hyphens and periods. 

Applicable only for FlexNet, RLM, CodeMeter and OLicense license manager types.  

FlexNet license servers are configured with case-sensitive names by default, so make sure the vendor name uses the correct case when configuring a FlexNet license server. An error in the vendor name may cause problems with License Statistics usage monitoring. See "Failure to find licenses for FlexNet license server" in FLEXlm and FlexNet license server issues for more information.

For CodeMeter license server use Firm Code.

Display Name
An optional name to display for the vendor in reports. 
Gathering settings

Anchor
anon_names
anon_names
Anonymous Usernames/ Hostnames

Make users and/or hosts anonymous in the database and reports (normally used to protect users for legal reasons, as is required in some countries). When enabled:

  • Usernames will be hashed, and LDAP details will be removed 
  • Hostnames and IP addresses will be hashed

Note that you can set this additional option only when adding a license server; you cannot edit this option after adding the server. If you do not choose to anonymize data for the license server, note that you can perform "on-demand" data anonymization of historical data as needed. 


Feature Versioning

Enable Feature Versioning for the supported license server types. 

Note that you can set this additional option only when adding a license server; you cannot edit this option after adding the server.

Currently this option works with the following license servers:

  • LM-X License Manager
  • IBM LUM
  • FlexNet
  • Reprise License Manager (RLM)
  • Sentinel RMS
  • License4J
  • TLM

Toggle on to enable Collections. Applies only to Autodesk and Dassault license managers.

Note that this setting cannot be changed for Autodesk license servers after the license server has been created. However, this setting may be enabled/disabled for Dassault at any time.

Remote Monitoring tab

To view remote monitoring settings, toggle on Enable Remote Monitoring at the top of the Remote Monitoring tab (enabled by default).

General settings

Anchor
queryTool
queryTool
Query Tool Path

The path to the license manager's query tool

, which

defaults to license_statistics_installation_directory/query_tool_default_name, where the query tool default name is specific to the license manager being used, as follows:

License managerQuery tool default name
LM-Xlmxendutil
BETA LM
:
beta_lm_stat
 
Dassault
: DSLicSrv
DSLicSrv
EPLAN LMElmMonitor
 
FlexNet
: lmutil
lmutil
GHSlic_find_licenses
GNS
:
licstat
IBM LUM
:
i4blt
 
LICMAN
:
licman20_appl
 
  • LM-X: lmxendutil
  • LS-Dyna
    :
    lstc_qrun
    MathLM
    : monitorlm 
    monitorlm
    OLicenseolixtool
    RLM
    :
    rlmutil
     

    Sentinel RMS
    : lsmon and lsmon parameters

    The path is filled in automatically; edit the path if needed. 

    lsmon
    TLMlicdstat

    Edit the path if needed, and make sure the query tool is in the specified path. 

    Important: The query tool executable (and the path provided in the License Statistics UI) must be local. If you edit the path, ensure that the query tool executable is located on the same machine as the License Statistics installation.  

    Query Tool Path is not applicable when using the Custom, Autodesk, JetBrains, License4J, oXygen and Zoo license manager types.

    Encoding

    Changes the encoding used by License Statistics when analyzing data from a license server.

    By default, this is set to UTF-8. For a list of supported encodings, see:

    https://docs.oracle.com/en/java/javase/13/intl/supported-encodings.html

    Locale

    Applies only to Altium license manager type.

    This optional setting can be used to change the locale assumed by License Statistics when parsing output from the server. This setting is empty by default, and should be specified only if necessary.

    A list of available locale values can be found at https://www.oracle.com/java/technologies/javase/jdk17-suported-locales.html, under the Language Tag column.

    Query Interval

    Time in minutes between each license server query.

    Choose between 1, 2, 5 (default), 10, 15 and 20 minutes. 

    Gathering DataToggle on data gathering for usage and/or denials (choices depend on license manager type selected).
    EPLAN BundleApplies only to EPLAN LM license manager type. See EPLAN Bundles for more information. 
    Connection settings
    Vendor daemon name

    The vendor daemon name for the license server. This entry cannot contain spaces or special characters, except underscores, hyphens and periods.

    Applicable only for FlexNet and RLM license manager types.

    Hostname 
    The license server hostname. This entry cannot contain spaces or special characters, except underscores, hyphens and periods.Port NumberThe license server port number. This entry defaults to 6200 for LM-X license manager.

    Redundant

    Check this box to specify that redundant servers are being used

    (for

    . For example,

    in

    for LM-X, you would

    check

    toggle on the Redundant setting if you are using a HAL (High Availability License) license server.

    When Redundant is checked, you must enter the hostname and port number for all three servers.

    For LM-X, the server order is indicated as "#1 HAL server," "#2 HAL server," and "#3 HAL server." 

    The Redundant setting is applicable

    Applicable

    only for LM-X, FlexNet, BetaLM, Dassault, IBM LUM

    ,

    and GNS license manager types.

      

    Additional Options tab settings

    Secured

    Check this box to force HTTPS connection for servers using HTTP monitoring.

    The Secured setting is applicable for oXygen, JetBrains, Zoo and CodeMeter license managers only.

    Hostname

    The license server hostname. This entry must be a hostname or domain value, and cannot contain spaces, special characters (underscores, hyphens and periods are allowed), or protocols (e.g., "http(s)://").

    File Path

    For Custom license servers, the Hostname field (described above) is replaced by a "File Path" field, which is used to provide the path to the file to be monitored.

    Port

    The license server port number, which may have a default setting depending on the license manager selected, as follows.

    License serverPort number
    LM-X6200
    RLM5053
    Dassault4084
    GHS2009
    GNS7200
    Altair6200
    JetBrains8080
    License4J16090
    Oxygen8080
    TLM9090
    AIS/PLS9780

    The Port number setting is not applicable when using the IBM LUM, LICMAN, Sentinel RMS, MathLM, and Custom license manager types.

    Login

    The username to access protected resources.

    This setting is applicable only for JetBrains and oXygen license manager types.

    Password

    The password to access protected resources..

    This setting is applicable only for LM-X, Dassault, JetBrains and oXygen license manager types.

    Importing tab

    To enable importing the logfile using the License Statistics UI or API, toggle on Enable Importing at the top of the Importing tab.

    There are no settings for the Importing tab.

    End User Monitoring tab
    This tab currently applies only to the Autodesk license manager type. To view End User Monitoring settings, toggle on Enable End User Monitoring at the top of the End User Monitoring tab.
    Agent Groups

    Agent Group(s) that will be used to automatically monitor Autodesk applications on their hosts.

    This setting is applicable only for the Autodesk license manager type

    SettingDescriptionQuery IntervalLicense Statistics data update interval in minutes. You can select 1, 2, 5, or 10 minutes as the update interval. The 1-minute interval should be used only for testing purposes.
    Reader TimeoutTimeout setting for reader (Windows only) in seconds. Leave this box unchecked to indicate that there is no timeout.Anonymous Usernames/Anonymous HostnamesMake users and hosts anonymous in database and HTML output (normally used to protect users for legal reasons, as is required in some countries)

    .