Installing the LumenVox Software

Please read our preliminary notes before you begin your installation.

The LumenVox software consists of several packages. There is a Core package, which is required with any LumenVox installation. Beyond that, there is a Client package that must be installed on your Asterisk system, and an SRE server package that installs the software that actually performs the recognition (the speech client package integrates with Asterisk and sends recognition requests to the SRE server).

There is also a LicenseServer package that handles licensing. The client will communicate with the License Server in order to get licenses. You may install the Client, SRE, and LicenseServer packages all on separate machines or the same machine.

Finally, if you are using MRCP to communicate with LumenVox, you will also need to install the MediaServer package that handles MRCP traffic. Most Asterisk installations will not use this package.

The following instructions will cover installation on systems that can use RPM files, such as Red Hat EL, CentOS, and Fedora Core. For Debian package information, see Debian Installation.

Installation will require root privileges. You will need free space in /usr/bin/, /usr/lib, and /etc/.

LumenVox does not currently support 64-bit operating systems. In version 10.0 we will be adding 64-bit builds; this is due out later in 2010.

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 enter the following in the file for Fedora Core (be sure to save the file after entering the text):

###################################################
[LumenVox]
name=LumenVox Products for Fedora Core $releasever - $basearch
baseurl=https://www.lumenvox.com/packages/FC$releasever/i386/
enabled=1
gpgcheck=0
###################################################

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, you must then obtain and install licenses.

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:

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 will know that you are experiencing this problem if you see an error such as: Missing Dependency: libjs.so.1 is needed by package LumenVoxCore

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/

Please ensure that you download the normal js package, and not just the js-devel package.

Installing RPMs Without YUM

Without using YUM, you can use RPM to install the software. Log in to your account at https://www.lumenvox.com/customers/ and download the appropriate RPMs.

You can install an RPM by typing rpm -Uvh filename

After you have installed the software, you must then obtain and install licenses.

Please note that we strongly recommend using YUM, as you may have to manually resolve dependency issues yourself if you just use RPM.

64-Bit LumenVox Software

At this time, the only 64-bit Linux distributions that LumenVox supports are Red Hat Enterprise Linux 5, 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.

© 2012 LumenVox LLC. All rights reserved.