This file controls settings related to the License Server.
It is located by default in /etc/lumenvox/ on Linux and in C:\Program Files\LumenVox\License Server\config\ on Windows. See Configuration Files for more information about other configuration files.
The following parameters can be set. The format to use within the configuration file is PROPERTY_NAME = VALUE
[GLOBAL]
This section contains global configuration settings for the License Server.
VERSION
Description: Contains information about the version of the software that created the configuration file. Do not modify this.
Possible Values: This should not be modified by users.
PORT_NUMBER
Description: The port number that the license server will use to listen for connecting clients (both ASR and TTS).
Possible Values: A valid port number.
Default Value: 7569
FLEXIBLE_LICENSING_MODE
Description: Controls whether the license server should start in flexible licensing mode.
Please see our Flexible Licensing Overview article for more details.
Possible Values:
- 0 - Disabled (don't use Flexible licensing mode)
- 1 - Enabled (use Flexible licensing mode)
Default Value: 0
LICENSE_SERVER_GUID
Description: The unique ID associated with this license server in the LumenVox Flexible Licensing Reporting Nodes.
Please see our Flexible Licensing Overview article for more details.
Possible Values:
A GUID obtained from the LumenVox licensing website or LumenVox Support
Default Value:
USE_FLEX_REPORTING_HTTPS
Description: Use a HTTPS connection in communicating with the LumenVox Flexible Licensing Reporting Nodes.
Please see our Flexible Licensing Overview article for more details.
Possible Values:
- 0 - Disabled (use HTTP when communicating with LumenVox - less secure)
- 1 - Enabled (use HTTPS when communicating with LumenVox - more secure)
Default Value: 0
FLEX_REPORTING_PORT
Description: Use this port in communicating with the LumenVox Flexible Licensing Reporting Nodes
Users can choose one of these ports in the LumenVox cloud servers to be used when performing a Flexible licensing exchange. This allows a number of alternate options to navigate through your network firewall rules as needed. You only need to select one of these ports (whichever you prefer) - this will be the port at the LumenVox end that will be used.
Please see our Flexible Licensing Overview article for more details.
Note that in version 15.0.100 onward, this setting is only used when using HTTP protocol, so only designated HTTP ports can be used for this setting in this version onward. See FLEX_REPORTING_PORT_HTTP for details. Older versions use this setting for HTTP and HTTPS port selection.
Possible Values:
- 80, 8080, 13449, 24963, 43038 - HTTP
- 443, 8443, 23028, 39520, 48846 - HTTPS (only in versions prior to 15.0.100 - see FLEX_REPORTING_PORT_HTTPS)
Default Value: 80
Added in 15.0.100
FLEX_REPORTING_PORT_HTTPS
Description: Use this port in communicating with the LumenVox Flexible Licensing Reporting HTTPS Nodes
Users can choose one of these ports in the LumenVox cloud servers to be used when performing a Flexible licensing exchange. This allows a number of alternate options to navigate through your network firewall rules as needed. You only need to select one of these ports (whichever you prefer) - this will be the port at the LumenVox end that will be used.
Please see our Flexible Licensing Overview article for more details.
Possible Values:
- 443, 8443, 23028, 39520, 48846
Default Value: 443
Added in 15.0.100
FLEX_DESIRED_SYNC_HOUR
Description: The hour at which flexible licensing reports should be initiated.
Note that if both FLEX_DESIRED_SYNC_HOUR and FLEX_DESIRED_SYNC_MINUTE are 0, no preset sync time will be used, so reporting will be based on interval since last sync.
Possible Values:
Default Value: 0
Added in 15.0.100
FLEX_DESIRED_SYNC_MINUTE
Description: The minute at which flexible licensing reports should be initiated.
Note that if both FLEX_DESIRED_SYNC_HOUR and FLEX_DESIRED_SYNC_MINUTE are 0, no preset sync time will be used, so reporting will be based on interval since last sync.
Possible Values:
- 0 - 59 (local time minute)
Default Value: 0
FLEX_NODE_LIST
Description: List of flexible licensing nodes the License server is going to communicate with in flexible licensing mode. The list is separated by semicolons and should not have white spaces
Note that in versions 15.0.100 onward, this value is only used for HTTP connectivity. HTTP connections will use the FLEX_NODE_LIST_HTTP value instead.
Please see our Flexible Licensing Overview article for more details.
Note that this should point to a list of LumenVox Licensing Nodes in the Internet, and should not be altered, unless there is good reason to do so (in special cases where DNS is not available, or some special NAT handling needs to be performed, for instance).
Important:
LumenVox periodically changes the IP addresses associated with these servers, so we strongly recommend using the default Fully Qualified Domain Names (FQDNs) and allow DNS to resolve the current IP addresses at runtime, unless there is a compelling reason to not do this. If you use a list of IP addresses here, you will need to periodically update these to ensure their validity - this periodic checking and updating would be something your IT team would need to manage.
Typically, users should leave this setting at the default value. If this is set incorrectly, the system may not be able to access licensing resources.
Default Value: (shown here with carriage-returns for readability purposes only!)
flexlicense1.lumenvox.com;
flexlicense2.lumenvox.com;
flexlicense3.lumenvox.com;
flexlicense4.lumenvox.com;
flexlicense5.lumenvox.com;
flexlicense6.lumenvox.com;
flexlicense7.lumenvox.com;
flexlicense8.lumenvox.com;
flexlicense9.lumenvox.com;
flexlicense10.lumenvox.com
Added in 15.0.100
FLEX_NODE_LIST_HTTPS
Description: List of flexible licensing nodes the License server is going to communicate with in flexible licensing mode, when using version 15.0.100 onward - older versions use the FLEX_NODE_LIST for both HTTP and HTTPS connectivity. The list is separated by semicolons and should not have white spaces
Please see our Flexible Licensing Overview article for more details.
Note that this should point to a list of LumenVox Licensing Nodes in the Internet, and should not be altered, unless there is good reason to do so (in special cases where DNS is not available, or some special NAT handling needs to be performed, for instance).
Important:
LumenVox periodically changes the IP addresses associated with these servers, so we strongly recommend using the default Fully Qualified Domain Names (FQDNs) and allow DNS to resolve the current IP addresses at runtime, unless there is a compelling reason to not do this. If you use a list of IP addresses here, you will need to periodically update these to ensure their validity - this periodic checking and updating would be something your IT team would need to manage.
Typically, users should leave this setting at the default value. If this is set incorrectly, the system may not be able to access licensing resources.
Default Value: (shown here with carriage-returns for readability purposes only!)
flexlicense-s01.lumenvox.com;
flexlicense-s02.lumenvox.com;
flexlicense-s03.lumenvox.com;
flexlicense-s04.lumenvox.com;
flexlicense-s05.lumenvox.com;
flexlicense-s06.lumenvox.com;
flexlicense-s07.lumenvox.com;
flexlicense-s08.lumenvox.com;
flexlicense-s09.lumenvox.com;
flexlicense-s10.lumenvox.com
LOGGING_VERBOSITY
Description: Controls the verbosity of event logging. This can be used to increase or decrease the amount of information logged by the application. Note that increasing the logging verbosity causes increase in CPU usage, and should therefore be avoided wherever possible in a production environment where optimal performance is critical.
Possible Values: 1 - 3
- 1 = Minimal logging. Logs only errors and critical issues.
- 2 = Medium logging. Logs all non-debug information, includes types covered in Minimal logging as well.
- 3 = Maximum logging. Logs all types of events. This will include any and all informational and debugging activity.
Default Value: 1