Powered by Universal Speech Solutions LLC


Deb Installation Manual

Administrator Guide


Revision: 1

Created: September 1, 2017

Last updated: September 1, 2017

Author: Arsen Chaloyan


Table of Contents

1 Overview.. 3

1.1 Applicable Versions. 3

1.2 Supported Distributions. 3

1.3 Authentication. 3

2 Installing Deb Packages Using Apt-Get 4

2.1 Repository Configuration. 4

2.2 GnuPG Key. 4

2.3 Repository Update. 4

2.4 License Server Installation. 4

2.5 License Toolkit Installation. 5

3 Installing Deb Packages Manually. 6

3.1 Package List 6

3.2 Package Installation Order 6

4 Installing License Files. 8

4.1 Host Information. 8

4.2 License Installation. 8

5 System Daemon. 9

5.1 Starting Daemon. 9

5.2 Stopping Daemon. 9

5.3 Retrieving Daemon Status. 9

5.4 Setting Auto-start on Next Boot 9



1       Overview

This guide describes how to obtain and install Unispeech License Server on Debian-based Linux distributions. The document is intended for system administrators and developers.

1.1      Applicable Versions

Instructions provided in this guide are applicable to the following versions.


Unispeech License Server 1.0.0 and above

1.2      Supported Distributions

Packages are currently available only for x86_64 (64-bit) architecture.


Operating System



Ubuntu 16.04 LTS (xenial)




Note: packages for other distributions can be made available upon request.

1.3      Authentication

An elevated UniMRCP user account is required to obtain the packages. Send a request to




2       Installing Deb Packages Using Apt-Get

Using the APT package handling utility (apt-get) is recommended for installation of packages.

2.1      Repository Configuration

The content of a typical configuration file of the APT repository, to be placed in /etc/apt/sources.list.d/unimrcp.list, is provided below.


deb [arch=amd64] https://username:password@unimrcp.org/repo/apt/ distr main unilickit


The username and password fields included in the HTTPS URI must be replaced with the corresponding account credentials.

The distr field must be replaced with the corresponding distribution code name such as trusty, xenial, etc.

2.2      GnuPG Key

For verification of binary packages, UniMRCP provides a public GnuPG key, which can be retrieved and installed as follows.


wget -O - https://unimrcp.org/keys/unimrcp-gpg-key.public | sudo apt-key add -


2.3      Repository Update

In order to check for updates and apply the changes in the APT configuration, use the following command.


sudo apt-get update


2.4      License Server Installation

In order to install the license server, including the dependencies, the following command can be used.


sudo apt-get install unilic-server


As a result, apt-get will check and prompt to download all the required packages by installing them in the directory /opt/unimrcp.


2.5      License Toolkit Installation

In order to install the license toolkit only, which provides status retrieval and sample client applications to connect to the license server, the following command can be used.


sudo apt-get install unilic-toolkit


As a result, apt-get will check and prompt to download all the required packages by installing them in the directory /opt/unimrcp.


3       Installing Deb Packages Manually

Packages can be installed manually using the dpkg utility. Note, however, that the system administrator should take care of package dependencies and install all the packages in appropriate order.


The deb packages have the following naming convention:





         packagename is the name of a package

         universion is the version number of license toolkit

         distr is the distribution code name (trusty, xenial, )

         arch is the architecture (amd64, i386, all, )

3.1      Package List

The following is a complete list of deb packages.


Package Name



Unispeech license toolkit.


Unispeech license server.


UniMRCP edition of the Apache Portable Runtime (APR) library.


3.2      Package Installation Order

A package for the APR library must be installed first.


sudo dpkg --install uniapr_$aprversion-$distr_$arch.deb


Then, a package containing the license toolkit should follow.


sudo dpkg --install unilic-toolkit_$universion-$distr_$arch.deb


Finally, a package containing the license server should follow.


sudo dpkg --install unilic-server_$universion-$distr_$arch.deb


4       Installing License Files

4.1      Host Information

Host information the license server is installed on needs to be retrieved and submitted for generation of license files.


Use the installed tool unilicadmin to retrieve the host information.


sudo /opt/unimrcp/bin/unilicadmin i


As a result, a text file uninode.info will be saved in the current directory. Submit the file uninode.info for license generation to




4.2      License Installation

The obtained license files must be placed into the directory /opt/unimrcp/data/license.


sudo cp *.lic /opt/unimrcp/data/license


5       System Daemon

This section outlines how to start/stop the license server as a daemon.


Upon installation of the server package, a systemd unit file unilic.service is installed in the directory /lib/systemd/system and can be used as follows.

5.1      Starting Daemon


systemctl start unilic.service


5.2      Stopping Daemon


systemctl stop unilic.service


5.3      Retrieving Daemon Status


systemctl status unilic.service


5.4      Setting Auto-start on Next Boot


systemctl enable unilic.service