The two essential software components for installing LTU engine are:

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

• Logged in as “root”, in the temporary directory, execute the script install.sh

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

Before unzipping the ltu-engine.zip:

1. On your EC2 admin interface, go to Security policy:

• add tcp port 8888
• add tcp port 7789
• add tcp port 8080
• add tcp port 8081

2. System configuration :

• Add your hostname to `/etc/hostname` and Refresh the hostname configuration:

$> echo "<hostname>" > /etc/hostname
$> hostname -F /etc/hostname

• Add the external Amazon IP and hostname to `/etc/hosts`:

/etc/hosts

<external Amazon IP address>     <hostname>

• Add the external Amazon IP address to `/etc/network/interfaces` as a loopback entry:

/etc/network/interfaces

iface lo:0 inet static 
  address <external Amazon IP address>
  netmask 255.255.255.255

• Install unzip command.
• Edit /etc/hosts in order to add all IP and hostnames of the hosts that will be used for the installation:
  • Make sure machine hostname do not refer to the loopback address (127.0.0.1) for license subsystem to work correctly.
• Unzip ltu-engine archive
• Copy the spec and the license files provided by JASTEC France in the extracted folder

• Install rsync server
• Configure rsync by editing /etc/rsyncd.conf:

    uid     = ltu
    gid     = ltu                                                                                                                                                                                                       
    list    = yes
    [saas]
    path = <install_dir>/data/ltu
    comment = sql lite folder for kima
    read only = false
    hosts allow = <database host> ( support mask 10.1.0.0/16 )

• Edit /etc/default/rsync.conf and set RSYNC_ENABLE to true
• Run “/etc/init.d/rsync start”

• Go to the ltu-engine extracted folder
• Run ./install.sh -i <path_to_spec>
• Run /etc/init.d/ltud stop all
• Configure NFS to share <install_directory>/data among all cluster hosts:
  • Make sure NFS server is started at system start and words correctly
  • Edit /etc/exports:

<install_directory>/data/ 10.1.0.0/255.255.0.0(rw,sync,no_subtree_check,insecure)

• restart nfs

• Go to the ltu-engine extracted folder
• Run ./install.sh -i <path_to_spec> -n
• Run “/etc/init.d/ltud stop all”
• Configure you system to mount shared folder at the right place in /etc/fstab:

<database_host>:<install_dir>/data/ltu/storage <install_dir>/data/ltu/storage nfs rw,noatime,sync 0 0
<database_host>:<install_dir>/data/ltu/queue <install_dir>/data/ltu/queue nfs rw,noatime,sync 0 0
<database_host>:<install_dir>/data/ltu/query <install_dir>/data/ltu/query nfs rw,noatime,sync 0 0
<database_host>:<install_dir>/data/ltu/reports <install_dir>/data/ltu/reports nfs rw,noatime,sync 0 0
<database_host>:<install_dir>/data/ltu/ftp <install_dir>/data/ltu/ftp nfs rw,noatime,sync 0 0

• Create folders:
  • mkdir -p <install_dir>/data/ltu/{storage,queue,query,reports,ftp}
• Mount all folders:
  • mount -a

• Generate and distribute a suitable ssh configuration for ltu user:
  • ssh-keygen -t rsa -P“” # will generate ssh key
  • cat ~/.ssh/id_rsa.pub > ~/.ssh/authorized_keys # will add this key to the authorized keys
  • Run the following command will add all cluster hosts to the known_hosts file:
    • for host in [<list_of_hosts>]; do ssh-keyscan -t rsa $host » ~/.ssh/known_hosts; done
  • Copy the .ssh folder located in the ltu home directory on every hosts
• /etc/init.d/ltud start all

• /etc/init.d/ltud start all

• Unzip the installation software to a temporary directory.

• Logged in as “root”, in the temporary directory, execute the script install.sh and follow the instructions.

• stop services

• apt-get update

• apt-get upgrade

• modify /etc/apt/source.list

• change to wheezy

• apt-get update

• apt-get dist-upgrade
• apt-get install lsb-multimedia erlang

• reboot

• stop services

• unzip engine 7 release archive

• go to your archive folder

• ./install.sh

• answer yes

• answer yes (or no if you have a too big database for your disk or save some time)

The procedures described below are not available for distributed installations. Also it is not yet possible to restore the installation directly on a different machine. For such cases please contact us at support@ltutech.com

Backup

To help you backup your LTU engine installation we have created a script located in the archive file given to you under the scripts directory. However if you wish to backup your installation but have an earlier version please contact us at support@ltutech.com

What this script does:

• Save all your data related to your LTU engine installation in a single archive file.
• Enables you to keep doing searches while the system is being backed up. However it is impossible to add or remove images during the backup i.e. the Modify API will not be available.

To backup your LTU engine installation run the following commands as root:

cd <directory/where/you/unzip/your/ltuengine/archive/>
./scripts/backup.sh <directory/to/you/ltuengine/installation> <directory/to/store/your/backup>

Note that the backup file will get bigger as you add content to your LTU engine installation.

Restore

Important: If you're restoring your engine's backup on a fresh instance, please install the product first and then follow the procedure below.

The following steps can only be used to restore a backup file created via the backup script described above.

To restore your LTU engine installation run the following commands as root:

/etc/init.d/ltud stop
cd <directory/to/you/ltuengine/installation>
rm -rf <installation/directory>
tar xvf <path/to/your/archive/file> 
/etc/init.d/ltud start

The system will be back to the state it was in right before the backup.