The information on this page refers to License Statistics 4.9 or newer, which now includes an option to enable/disable license server monitoring; supports specifying an XML file for Custom license managers; supports the Reader Timeout setting for Linux; no longer accommodates more than one name for the Sentinel RMS query tool; and made minor changes to the form for adding/editing license servers. If you are running an older version of License Statistics, see documentation for previous versions.
You can add and edit license servers using the Realtime License Servers tab in the Administration page. (This page is visible only for License Statistics administrator users.)
The Realtime License Servers page lists information for all currently configured license servers in the Realtime License Servers grid, including:
|Name||The display name 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.|
|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.|
Adding or editing a license server
To add or edit a license server:
- To edit an existing license server, click the edit icon in 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 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.
- Complete the information in the Add New/Edit License Server dialog's General tab as described in the table below.
- 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 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.
- To continue to the Additional Options tab, click Next. Complete the information in the Additional Options tab as described in the table below.
- After completing all settings as needed, click Save or Save and Close to save the license server. You can click Cancel at any time if you do not wish to save your changes.
General tab 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. |
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 license manager you are using for the license server. This selection list includes all 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.
Query Tool Path is not applicable when using the Custom license manager type.
|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.
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 License server issues for more information.
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.
Port is not applicable when using the IBM LUM, LICMAN, Sentinel RMS, MathLM, and Custom license manager types.
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.
Applicable only for LM-X, FlexNet, BetaLM, IBM LUM and GNS license manager types.
Additional Options tab settings
|Query Interval||License 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 Timeout||Timeout setting for reader in seconds. Leave this box unchecked to indicate that there is no timeout.|
|Anonymous Usernames/Anonymous Hostnames||Make users and hosts anonymous in database and HTML output (normally used to protect users for legal reasons, as is required in some countries).|
License server status
The license server status can be one of the following:
|License Server Status||Description|
|Up||The current license server configuration is correct and the license server can be monitored successfully.|
|Down||The license server cannot be monitored successfully because its configuration is incorrect or there are parsing failures.|
|Disabled||The license server has been disabled in the license server configuration or cannot be enabled because you have reached your limit of license servers you can monitor. (For more details, see the information about the Enabled checkbox in the Adding and editing license servers, above). This status may also indicate that enabling the license server failed or there are problems reading the configuration file for the license server when starting License Statistics.|
|Verifying||The license server is under verification after being added or edited.|