V-Blaze and V-Cloud Online Help

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 match maxdecoders. 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 the models.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 the license.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