Licensing

There are two means of obtaining licenses for the LumenVox Speech Engine. One is to purchase them outright, and install them locally on a License Server. The other is to purchase a subscription to the LumenVox-hosted Subscription Licensing Server. Instructions on using subscription licenses can be found in our Speech Engine help document.

The instructions below pertain to purchasing licenses outright and installing them locally.

How LumenVox Licenses Work

LumenVox licensing uses a client-server model. On startup, the LumenVox License Server creates a token pool based on the license file. The Speech Engine requests licenses and the License Server checks to see if there are enough tokens available in its pool. If so, then the request is accepted and a token is sent back. One of the benefits of having a client-server model is the License Server may be configured to run on a remote machine allowing centralized control over available licenses.

The LumenVox Speech Engine requires a valid license for each port -- each active connection between the Engine and a speech application. To determine whether a license is available, the Speech Engine queries another application, called the LumenVox License Server. The License Server can be running on the same machine as the Engine or on a different computer. If you wish to access a license on a different machine, see client_property.conf.

A Speech Engine license is tied to the machine the License Server is running on.

Setting up licenses consists of several steps. First, you generate a server ID file that will be used to tie the license files to the hardware of your license server. Next, you will upload that file to our Web site, where it will be used to generate a unique license file that contains the licenses for your products. Finally, you will download and install that license file.

Generating the Server ID File

The following instructions should be performed on the machine that will host your licenses. First ensure that lv_license_server is running.

Run the following command: /usr/bin/lv_license_manager -g path where path is the you would like to use for the Server ID file. For example, if you wanted to create the server ID file in the root directory, you would type /usr/bin/lv_license_manager -g /Info.bts

(If you do not have a Web browser installed on the same machine as the License Server, use a tool such as scp to move the Info.bts file to a computer with a Web browser and an Internet connection.)

Uploading the Server ID File and Downloading the License

1. Open a Web browser and go to https://www.lumenvox.com/customers/. Log in using your LumenVox username and password. Please contact LumenVox support if you do not know your account information.
2. Click the "View Licenses" link:
3. This will display a list of your deployments. Click on the "Upload License" link:
4. You will be directed to a page to upload your server ID file. Select the Info.bts file you generated.
5. You will then be redirected to the deployments page, and the "License Upload" link will have changed to a "License Download" link. Click that link to download the license file, and save the license.

Installing a License

Type /usr/bin/lv_license_manager -m Licensefile where Licensefile is the path to the license file you downloaded earlier.

Once your license is installed, you need to configure the Asterisk-LumenVox connector bridge.