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.
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
###################################################
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.
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.
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.
LumenVox currently does not offer support for 64-bit operating systems.