ASR License¶

The CPQD ASR can work as a ‘Cloud License Server’ maintained by CPQD, or the customer can run a ‘Local License Server’ instance in their own environment.

In the case of Cloud License Servers, the ASR license data is defined in the speech recognition engine installation. The license ID and number of channels allocated to each instance must be informed.

In the case of Local License Servers, besides the previous step, users must configure the CPQD ASR as explained in Local license server.

Warning

License validation when using the license server DOES NOT work through proxy. Access must be granted in your network’s FIREWALL. See the section below.

Connection with the license server¶

If the Cloud License Server is going to be used, all the ASR servers must have access to it through the Internet. Make sure the firewall of each machine and your network’s firewall grant access to the address sl.cpqd.com.br:443.

To test access to the license server, run the following command:

curl -k --noproxy "*" https://sl.cpqd.com.br/ping

The result must be “pong.”

License model¶

The license currently works by allocating recognition channels. To this end, when the ASR server is set up, we define the quantity of channels as the maximum number of simultaneous channels it can handle. The sum of the configured quantities of channels of all the ASR servers using a given license ID must be equal to or lower than the number of channels defined in this license.

What the license defines¶

The ASR license defines:

The maximum number of allocated channels
License validity
Which acoustic and free speech models can be used
If continuous mode recognition can be used

The need of the developed application must be aligned with the license configuration.

Changes in the license¶

If the number of allocated channels or the ID or your license has changed, the CPQD ASR configuration must also be changed.

1) Adjust the license configuration

Edit the /opt/cpqd/asr/config/engine/engine.conf file and replace the value of the following parameters with new values:

licenseManager.licenseId
(Required) License ID, provided by CPQD.

licenseManager.channels
(Required) Number of channels allocated for this instance. The total number of channels of all the ASR servers must be the same as the number of license channels.

If the “licenseManager.host” parameter is defined in the file, remove or comment the line with “#”, to make sure the parameter is configured with the default value.

Supposing you have a license with an ID ‘AB9AB9AB9AB9AB9’ and 10 allocated channels, the configuration will be the following:
# ==================================
# Configure License
# ==================================

--licenseManager.licenseId=AB9AB9AB9AB9AB9
--licenseManager.channels=10

2) Restart the CPQD ASR server

To apply the new configuration, please restart the ASR server.

Local license server¶

To use a Local License Server, the CPQD ASR configuration must be edited.

1) Adjust the license configuration

Edit the /opt/cpqd/asr/config/engine/engine.conf file and define the following parameters:

licenseManager.host
(Required) The Local License Server IP.

licenseManager.port
(Optional) The port used to communicate between the ASR and the Local License Server (defaults to 443).

licenseManager.licenseId
(Required) License ID, which is the name of the license file provided by CPQD.

licenseManager.channels
(Required) Number of channels allocated for this instance. The total number of channels of all the ASR servers must be the same as the number of license channels.

The following is an example of a configuration, for a license server with an IP of 172.17.0.2. Since our license server uses the default 443 port, there is no need to define the licenseManager.port parameter.
# ==================================
# Configure License
# ==================================

--licenseManager.host=172.17.0.2
--licenseManager.licenseId=AB9AB9AB9AB9AB9
--licenseManager.channels=10

2) Restart the ASR server

To apply the new configuration, please restart the ASR server.