The information on this page refers to License Statistics v6.8 and newer, which added new columns to the Realtime License Servers grid. If you are using a version previous to v6.8, see documentation for previous versions.
You can add realtime license servers and edit information for existing realtime license servers using the page, found under the Administration section in the left navigation pane. (This page is visible only for License Statistics administrator users.) Note: This page also lets you add and edit imported license servers.
Realtime License Servers grid
The Realtime License Servers grid in the License Servers page lists information for each currently configured realtime license server, including:
|License Server||The display name for the license server.|
|License Server ID||The ID of the License Server.|
|License Server Description||The optional user-defined description for the license server.|
|Hostname||The 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.|
|Port||The 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 Manager||The license manager type (can be any supported license manager or a custom license manager).|
|Status||The status of the license server. For detailed information about license server status, see License Servers.|
|Enabled||Indicates (Yes/No) whether monitoring is enabled for the license server.|
|Redundant||An icon showing one computer indicates that the license server is not redundant. An icon showing three computers indicates the license server is redundant.|
|Realtime Denials||Indicates (Yes/No) whether monitoring Realtime Denials is enabled for the license server.|
|Feature Versioning||Indicates (Yes/No) whether Feature Versioning is enabled for the license server.|
|Anonymous Usernames||Indicates (Yes/No) whether use of anonymous usernames is enabled for the license server.|
|Anonymous Hostnames||Indicates (Yes/No) whether use of anonymous hostnames is enabled for the license server.|
|Query Interval||Sets the time interval (in minutes) between queries.|
Some columns, as noted above, are hidden by default. To control the visibility of these and other columns, see instructions for filtering grid content.
If the Realtime License Servers grid's "Action" column contains a link icon, you can click this icon to obtain a URL that is used for License Statistics Agent.
Adding or editing a realtime license server
License Statistics lets you add realtime 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, like Realtime Denials, Feature Versioning, etc. 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 :
- To edit an existing license server, click the 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.
To add a new license server, click Add 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.
- Complete the information in the Add New/Edit License Server dialog's License Server tab as described below in "Realtime License Server settings."
- If you are ready to verify the license server configuration, click Verify. Verification may take a long time depending on the license manager’s response time, and the status will show that the server is being verified. You cannot perform any other operations for setting up the license server until verification is complete. 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 to a file if desired.
If you want to verify the license server at a later time, you can save the license server configuration (see step 6 below) without verifying it, and then edit the license server at a later time to complete the verification process. However, you won't be able to monitor the license server and you cannot access the Aliases or Merge tabs until the license server has been verified and License Statistics is able to gather data from the license server.
- To assign or edit server aliases, go to the Aliases tab.
- To merge license server data, go to the Merge tab.
- After completing all settings as needed, click Save or Save and Close to save the license server. You can click Close at any time if you do not wish to save your changes.
Realtime License Server settings
The Realtime License Server settings are described below. Note that only the settings that are valid for the selected License Manager Type will be visible. For example, if you select a License Manager Type other than FlexNet, RLM or OLicense, the "Vendor Daemon Name" setting will not display.
|Name||The name for the |
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.
Check this box to enable monitoring for the license server. When this box is not checked, monitoring for the license server is disabled. The license server will appear in License Statistics pages as "Down."
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 supported license managers.
|Query Tool Path |
The path to the license manager's query tool 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:
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, JetBrains, License4J, and oXygen license manager types.
|Description||An optional description for the license server. The Description can be entered/edited only after the license server has been validated.|
Check this box to specify that redundant servers are being used (for example, in LM-X you would check Redundant if you are using HAL). When Redundant is checked, you must enter the hostname and port number for all three servers.
The Redundant setting is applicable only for LM-X, FlexNet, BetaLM, Dassault, IBM LUM and GNS license manager types.
The license server hostname. This entry cannot contain spaces or special characters, except underscores, hyphens and periods.
Hostname is not applicable when using the LICMAN license manager type.
When using the Custom license manager type, you must specify the path to your custom XML file in this field.
The license server port number, which may have a default setting depending on the license manager selected, as follows.
The Port Number setting is not applicable when using the IBM LUM, LICMAN, Sentinel RMS, MathLM, and Custom license manager types.
The username to access protected resources.
This setting is applicable only for JetBrains and oXygen license manager types.
The password to access protected resources..
This setting is applicable only for Dassault, JetBrains and oXygen license manager types.
|Vendor 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, 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.
|Vendor Display Name||An optional name to display for the vendor in reports. The Vendor Display Name can be entered/edited only after the license server has been validated.|
|Vendor Name||The vendor name.|
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:
Time in minutes between each license server query.
Choose between 1, 2, 5 (default) and 10 minutes.
Anonymous Usernames/ Hostnames
Make users and/or hosts anonymous in the database and HTML output (normally used to protect users for legal reasons, as is required in some countries).
Note that you can set this additional option only when adding a license server; you cannot edit this option after adding the server.
Enable monitoring denials data in real time. This option works only with the following license servers:
Enable Feature Versioning for the supported license server types. Currently this option works with the following license servers: