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=http://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=http://www.LumenVox.com/packages/EL4/i386/
enabled=1
gpgcheck=0
###################################################

For RHEL 5 and CentOS 5, use:

###################################################
[LumenVox]
name=LumenVox Products $basearch
baseurl=http://www.LumenVox.com/packages/EL5/i386/
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 everything installed. To download and install everything, you could run the following command:

yum install LumenVoxCore LumenVoxClient LumenVoxSRE LumenVoxLicenseServer

The products you install will register themselves as services in /etc/init.d/ called lvsred (the speech server) and lvlicensed (the License Server). By default, they will be started automatically when you login. They are not started by default after installation -- you must either start them using the service name start command or by logging out and back in after installation.

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

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 http://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.

Instructions for 64-bit Users

LumenVox currently does not offer support for 64-bit operating systems.

© 2010 LumenVox LLC. All rights reserved.