Show page Old revisions Backlinks Export to PDF This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong. ===== Standard Install/Update Procedures ===== ==== 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. \\ \\ ===== Installing LTU engine on EC2 ===== 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: <file bash> $> echo "<hostname>" > /etc/hostname $> hostname -F /etc/hostname </file> \\ * Add the external Amazon IP and hostname to `/etc/hosts`: <file autoconf /etc/hosts> <external Amazon IP address> <hostname> </file> \\ * Add the external Amazon IP address to `/etc/network/interfaces` as a loopback entry: <file autoconf /etc/network/interfaces> iface lo:0 inet static address <external Amazon IP address> netmask 255.255.255.255 </file> \\ \\ ===== Distributed installation of LTU engine ===== == 1 - On all hosts == * 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 == 2 - On kima hosts == * Install ''rsync'' server * Configure ''rsync'' by editing ''/etc/rsyncd.conf'': <code> 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 ) </code> * Edit /etc/default/rsync.conf and set RSYNC_ENABLE to true * Run "/etc/init.d/rsync start" == 3 - On database host == * 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'': <file> <install_directory>/data/ 10.1.0.0/255.255.0.0(rw,sync,no_subtree_check,insecure) </file> * restart nfs == 4 - On non-database hosts == * 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'': <file> <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 </file> * Create folders: * ''mkdir -p <install_dir>/data/ltu/{storage,queue,query,reports,ftp}'' * Mount all folders: * ''mount -a'' == 5 - On database host == * 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'' == 6 - On all other hosts == * ''/etc/init.d/ltud start all'' ===== Upgrade Steps ===== \\ *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) ===== Backup / Restore Data ===== \\ 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: <file bash> cd <directory/where/you/unzip/your/ltuengine/archive/> ./scripts/backup.sh <directory/to/you/ltuengine/installation> <directory/to/store/your/backup> </file> \\ 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: <file bash> /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 </file> \\ The system will be back to the state it was in right before the backup.