This version (2015/05/04 17:49) is a draft.
Approvals: 0/1

Required Files


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.

Installation Steps


  • 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




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

Upgrade Engine 6.2.X to Engine 7

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