Required License Configuration
V‑Blaze's Internet licensing file worker.cfg
is located in /opt/voci/state/license
. The following is a typical example of the worker.cfg
file:
[requester]
auth_token=token
Important
The lines included in the worker.cfg
sample above are the only required settings. The first line in worker.cfg
must be the [requester]
statement. Set the value of auth_token
to the authorization token provided to you by Voci. Each subsequent line must start in column 1 and there cannot be any spaces on either side of the =
character.
Optional License Configuration Parameters
There are a number of optional parameters that can be included to override default communications, sizing, and operational parameters. Contact support@vocitec.com to determine whether your configuration should include customized parameters. The following list explains the optional worker.cfg
parameters:
The following parameters override both license server configured settings and autosizing defaults. The ASR Engine may not start if the settings are not compatible with the server resources available.
maxdecoders
specifies the number of language model decoding processes to start. Only set if automatic sizing is not appropriate for the use case or server configuration.maxstreams
specifies the maximum number of incoming audio streams that V‑Blaze can interface with. Generally, this number defaults to matchmaxdecoders
. Set lower to limit concurrency and decrease latency, or increase to support real-time use cases.maxgpus
specifies a maximum number of acoustic models processes that can run across all system GPUs.numgpus
specifies the number of processes that the ASR engine will attempt to start across all of the system GPUs for each acoustic model. It is useful in rare cases where autosizing does not produce an optimal configuration. This setting can be overridden by model-based configuration in themodels.list
configuration file.
maxdecoders=integer
maxstreams=integer
maxgpus=integer
numgpus=integer
The following parameters override default or custom settings suggested by the license server:
ttl
(time-to-live) specifies the maximum time (seconds) a granted license will remain valid (and the ASR engine operational) without contacting the license server to renew. The requester attempts to renew licenses with the server at an interval of 20% of the ttl value.usage_size
specifies the number of hours checked out from a usage license in a single operation. This is the smallest unit of usage that will be checked out in a single operation.usage_threshold
alerts the license server if the duration of the current audio file to be processed is below the specified threshold. If the number of hours remaining in the local usage bank falls below usage_threshold, the requester will attempt to check out more usage from the server until the local bank is greater than the threshold.
ttl=integer
usage_size=integer
usage_threshold=integer
proxy
can be set to an HTTPS proxy server that relays communications between a requester
and the license server.
login
- optional login ID of a user on the proxy server.password
- optional password of the user on the proxy server.server
- IP address or name of the proxy server.port
- port number used by the proxy server.The server and port are required. If the proxy server does not require user information, the proxy value should be
server:port
.
proxy=login
:password
@server
:port
debug
enables more verbose logging information in thelicense.log
log files when set to true.
debug=true
The following parameters are used to manually set a custom license server name/IP address and configure SSL/TLS certificate validation:
server
can be set to the custom hostname or IP address.
server=hostname
:port
Include
-nocert
between the hostname/IP and port to proceed with SSL/TLS connection even if certificate validation fails.
server=hostname
-nocert:port
SSL
can be set to true or false.
ssl=true
Important
Only set SSL to false if a license server connection is not protected by SSL/TLS.
name
is a unique name to identify the requester.name
should only be set in rare cases when requester names based on the system hostname/IP are not appropriate.
name=requester-name