LTU Engine 7.8 setup guide

The LTU Engine installation requires an account in our platform. Please, contact us if you don't have your login/password yet:

This documentation will guide you during the deployment of LTU Engine 7.8.

Please notice that LTU Engine has to be installed on a Debian 8 server. The setup guide only describes how to install LTU Engine on a Debian server. LTU Tech can not guaratee a good working of LTU Engine on another Linux sever.

If you have any question or misunderstanding, do not hesitate to contact our support team at

This part explains you how to configure and setup your server before installing LTU Engine on it.

7.1. Server Configuration

For an optimal running of LTU Engine, LTU Tech recommends this type of server configuration.

7.2. Operating System Setup

Some actions must be performed to configure your server.

  • Operating system update:

Open a terminal and log in as “root” in your server by using the SSH protocol.

$> ssh root@x.x.x.x

Then, execute these commands:

$> apt-get update
$> apt-get upgrade
$> apt-get dist-upgrade

Note: Debian 8 repositories have been archived. A typical list of repositories (/etc/apt/sources.list) is given here for example:

deb wheezy main contrib non-free
deb-src wheezy main contrib non-free
deb wheezy/updates main contrib non-free
deb-src wheezy/updates main contrib non-free
deb wheezy-backports main contrib non-free
deb-src wheezy-backports main contrib non-free

To force the use of archived repositories, you have to create a file “/etc/apt/apt.conf.d/10no–check-valid-until” with the following content:

Acquire::Check-Valid-Until "0";

  • Required or useful tool install

Install the following packages:

$> apt-get install unzip 
$> apt-get install build-essential
$> apt-get install htop iftop iotop

7.3. Environment setup

In order to have an environment correctly configured, please make sure that :

  • The hostname and the Fully Qualified Domain Name are rightly defined in the /etc/hosts and /etc/hostname files.
# IPv4 support
127.x.x.x       hostname.domain.tld        hostname
# IPv6 support 
::1     localhost ip6-localhost ip6-loopback

To check if the hostname is coherent, you can also test if the following command is successful:

$> ping hostname

To control the FQDN, you can also use the following command:

$> python -c "import socket; print(socket.getfqdn())"

  • The locale en_US.UTF8 is installed. To verify that, type the following commands:
$> locale -a | grep en_US.utf8
$> cat /etc/default/locale | grep en_US.UTF-8

You should receive the following the two answers respectively:


If it is not the case, execute the following command:

$> echo "en_US.UTF-8 UTF-8" >> /etc/locale.gen \
&& locale-gen \
&& update-locale LC_ALL=en_US.UTF-8 LANG=en_US.UTF-8

Once your server is correctly configured to support LTU Engine product, you need to get the two essential software components:

  • LTU Engine license file: a machine-specific license key necessary for installing and activating the software.
  • LTU Engine software: delivered as a .zip file

8.1. LTU Engine License

To activate your license, login in our download center.

Once connected to our platform, go to the license tab, a message invites you to finalize the license creation.

To generate a valid license, you have to indicate:

  • the server host name
  • the server MAC address

and save the informations.

Note: To know the server host name, type the following command in a terminal:


Note: To get the MAC address, use the following command:

ip addr

This command returns the list of the network devices. In general, take the MAC address of the device named eth0 and get the address listed after link|ether parameter.

Once the license generated, you can download it.

8.2. LTU Engine Software

You can retreive the LTU Engine Software from our download center in the download section:

8.3. LTU Engine Install

Once all the elements retreived, the LTU Engine install could start.

  • Copy the LTU Engine zip and the license on the server temporary folder.

For that, open a terminal windows and type the following command:

#on local terminal
$> scp my_origin_folder/ root@x.x.x.x:/tmp
$> scp my_origin_folder/license-xxx.lic root@x.x.x.x:/tmp/license.lic
  • Log in as “root” in your server by using the SSH protocol.
ssh root@x.x.x.x
  • Unzip the LTU Engine zip
#connected as root on the server
$> cd /tmp
$> unzip
  • Move the license in the LTU Engine installation folder. Thus, the install program will find automatically the license and won't ask you to specify its path.
$> mv license.lic ltu-engine-7.8.x
  • Launch the installer command
# on server
$> cd ltu-engine-7.8.x
$> ./

All system components will be installed and launched via this single command.

Note: Installation logs can be found in /opt/ltuengine/logs/install.log

LTU Engine server is based on several internal services that communicate together or are opened to external queries.

Ports that must be opened for external queries:

  • NGINX redirecting to LTU Processors 7789
  • NGINX redirecting to LTU Wekis 8080
  • LTU Front Office 8888

Ports used for internal communications:

  • LTU Processor admin 7788
  • LTU Processor 7790
  • Postgresql 7791
  • Rabbit MQ 7792
  • LTU Manager 8081
  • LTU Weki 8082
  • LTU License 27000
  • LTU Kima services - from 8090 to 8190

Installation process can be validated if all process are up and running. To check the services, type the following command as ltu user:

$> su - ltu
$> ltud status all

When swithing to user ltu, it is really important to use the '-' command line parameter.

It stands for:

–login ⇒ make the shell a login shell

It allows the ltu user environnement to fully load.

You should receive the following answer:

license server running.
database service running.
messaging service running.
dispatcher service running.
processor service running.
weki service running.
manager service running.
admin_worker service running.
app_worker service running.
frontoffice service running.

To manage your application, the front office is now available at http://[server IP]:8888/

LTU Engine is started but you don't have an application yet.
Create you application from the “Application” Tab ans start it.

It is important to authorize the IP of your server and of your computer to access to the LTU Engine API.

To manage the API access, go the admin tab.

For more information about the front office interface and what you can do with, please consult the documentation Introduction: LTU engine Administrative Interface

To start to integrate the LTU API, you can consult the documentation: how getting start with the main API's requests.