Linux Installation Using RPMs

The following instructions will cover installation on systems that can use RPM files, such as Red Hat Enterprise Linux, CentOS, or Fedora Core. You may also see Debian Installation for distributions that use Debian packages.

Installation will require root privileges for both the Speech Engine and License Server.

Using YUM to Install and Update

The tool YUM (available on many RPM-enabled systems) can be used to easily manage your LumenVox installations.

First, create a file named LumenVox.repo in /etc/yum.repos.d/ and add the following lines to the file:

For RedHat Enterprise Linux 4 and CentOS 4, use:

###################################################
[LumenVox]
name=LumenVox Products $basearch
baseurl=https://www.lumenvox.com/packages/EL4/i386/
enabled=1
gpgcheck=0
###################################################

For RHEL 5 and CentOS 5, use:

###################################################
[LumenVox]
name=LumenVox Products $basearch
baseurl=https://www.lumenvox.com/packages/EL5/$basearch/
enabled=1
gpgcheck=0
###################################################

Installation

Once the repository is configured, you can use yum to automatically download and install the packages. From a command line, you may then type yum install <package>, replacing package with the appropriate package name.

The available packages are:

Typical installations will require the Core, Client, SRE, and License Server packages and the Media Server (if your platform uses MRCP). If TTS is required, then the TTS package will also be installed. To download and install everything for a typical installation, you could run the following command:

yum install LumenVoxCore LumenVoxClient LumenVoxSRE LumenVoxTTS LumenVoxLicenseServer

If you receive an error about a missing dependency related to a package with js in the name, please see "Libjs Problems on Red Hat ES or CentOS" below.

The necessary scripts to start the products are placed in /etc/init.d/ and are called lvsred (the speech server), lvlicensed (the License Server), lvmediaserverd and lvttsd. They are not started by default after installation -- you must either start them using the service name start command or executing them directly.

After you have installed the software, see Licensing Overview to get started licensing your software.

Language and Voice Packs

You may also download and install additional language packs for the Speech Engine (US English is included in the default SRE package). These are all best installed using yum as described above. The package names are as follows:

When installing the LumenVox TTS Server, you must install at least one TTS voice. If you do not know which voices you have licensed, please contact LumenVox support. The valid voice package names are:

Testing the Installation

In our Linux packages, there's an application called SimpleSREClient that tests to make sure that the software has been installed and licensed properly. The program takes a predefined grammar and audio utterance and passes them to the Engine to get a decode.

To build run the program:

  1. Navigate to the examples directory inside the Engine installation directory. By default it is /usr/share/doc/lumenvox/client/examples/
  2. Run the program called SimpleSREClient and uses the following parameters:
    1. <grammar-label> = 1
    2. <grammar-file> = ABNFDigits.gram
    3. <sound-format> = 3
    4. <audio-file> = 8587070707.pcm
    5. <server-ip> = 127.0.0.1
  3. To test an installation on the local machine you would type: ./SimpleSREClient 1 ABNFDigits.gram 2 8587070707.pcm 127.0.0.1
  4. The program should then decode the audio file, and output any alternative decodes (nBest results), along with their interpretation info, including input sentence, interpretation string and interpretation score:

Loaded Grammar!
Loaded Audio!
Decode returned!
Alternative 1:
  Interpretation 1 of 1:
    Grammar Label        : 1
    Input Sentence       : EIGHT FIVE EIGHT SEVEN O SEVEN O SEVEN O SEVEN
    Interpretation String: 8587070707
    Interpretation Score : 918
Alternative 2:
  Interpretation 1 of 1:
    Grammar Label        : 1
    Input Sentence       : EIGHT FIVE EIGHT SEVEN O SEVEN O SEVEN O SEVEN EIGHT
    Interpretation String: 85870707078
    Interpretation Score : 914
Alternative 3:
  Interpretation 1 of 1:
    Grammar Label        : 1
    Input Sentence       : EIGHT FIVE EIGHT SEVEN O SEVEN O SEVEN O SEVEN TWO
    Interpretation String: 85870707072
    Interpretation Score : 909

64-Bit LumenVox Software

At this time, the only 64-bit Linux distributions that LumenVox supports are Red Hat Enterprise Linux 5 and CentOS 5. As long as your repository files are setup correctly as described above using the $basearch variable, yum should automatically download and install the 32- or 64-bit version to fit your architecture.

Currently, some TTS packages are only available as 32-bit packages. These are tested on 64-bit CentOS 5 and should install and run alongside the the other 64-bit packages.

Libjs Problems on Red Hat ES or CentOS

The Engine requires that you have libjs, the Mozilla implementation of JavaScript, installed on your system. It is not available in the Red Hat or CentOS yum repositories, so you will have to get it separately if you do not already have it.

You can obtain the source from the official Mozilla site and build it yourself. Alternatively, many sites offer compiled RPMs of the library. LumenVox cannot certify or support these third-party RPMs, but for your convenience one such location is http://dag.wieers.com/rpm/packages/js/

Installing RPMs Without YUM

See Downloading the Software for instructions on obtaining the License Server and Speech Engine RPMs. They are named in the format LumenVoxLicenseServer-X. Y-Z.DISTRIBUTION.i386.rpm where X.Y-Z represents the software's version number, and DISTRIBUTION is the Linux distribution they are to be used for.

You can install an RPM by typing rpm -Uvh LumenVoxLicenseServer-X.Y-Z.DISTRIBUTION.i386.rpm

Log out and log back in to your machine after installation completes.

After you have installed the software, see Licensing Overview to get started licensing your software.

© 2012 LumenVox LLC. All rights reserved.