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 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:

• LumenVoxCore which contains core files shared across all packages. This is required.
• LumenVoxClient which contains the speech client.
• LumenVoxSRE which contains the speech server.
• LumenVoxLicenseServer which contains the License Server.
• LumenVoxMediaServer which contains both the MRCPv1 and MRCPv2 Server.
• LumenVoxMRCPServer is our legacy MRCPv1 Server. The LumenVoxMediaServer should be used whenever possible.

Typical installations will require the Core, Client, SRE, and License Server packages and the appropriate MRCP Server (only if your platform uses MRCP). To download and install everything for a typical installation, 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), lvlicensed (the License Server), and lvmrcpv1d and lvmediaserverd. 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, see Licensing Overview to get started licensing your software.

Testing the Installation

In our Linux packages, there's an application called SimpleClient 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 and 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. Compile the program by typing make
3. Run the program called SimpleClient and uses the following parameters:
1. <grammar-label> = 1
2. <grammar-file> = ABNFDigits.gram
3. <sound-format> = 2
4. <audio-file> = 8587070707.pcm
5. <server-ip> = 127.0.0.1
4. To test an installation on the local machine you would type: ./SimpleClient 1 ABNFDigits.gram 2 8587070707.pcm 127.0.0.1
5. 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