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: support@ltutech.com

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 7 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 support@ltutech.com.

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

1.1. Server Configuration

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

1.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


  • Required or useful tool install

Install the following packages:

#required
$> apt-get install unzip
 
#recommended
$> apt-get install htop iftop iotop


1.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.
/etc/hosts
# IPv4 support
127.x.x.x       hostname.domain.tld        hostname
 
# IPv6 support 
::1     localhost ip6-localhost ip6-loopback
/etc/hostname
hostname

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:

en_US.utf8
 
LANG=en_US.UTF-8
LC_ALL=en_US.UTF-8

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


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

hostname

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.



2.2. LTU Engine Software

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



2.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/ltu-engine-7.8.x.zip 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 ltu-engine-7.8.x.zip
  • 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
$> ./install.sh

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://x.x.x.x:8888/

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