Page History

This is a working a draft - please do not use the installation manual until this remark is removed!

Install Zend Framework

MySQL - TODO

Hostname - TODO

Download and install Translate5

First create a translate5 directory:

sudo mkdir /var/www/translate5

Download the Translate5 core package Download the Zend Framework version currently used by translate5 from

http://www.translate5.net/downloads/Zendtranslate5.zip

Unzip the file. 

Move the contained folder "Zend" to "/usr/share/php". The resulting path should look like

/usr/share/php/Zend

Open your php.ini-file for editing (on Ubuntu it resides in /etc/php5/apache2/php.ini)

Look for a line starting with

;include_path = "

Uncomment it (remove the starting ";") and make sure it contains the path /usr/share/php. It should look like this:

include_path = ".:/usr/share/php"

Save the php.ini file

Configure translate5 apache vhost

Create translate5 directory

and save and unpack it directly in the above directory. This can be done with the following commands:

cd /var/www/translate5
sudo wget http://www.translate5.net/downloads/translate5.zip
sudo unzip translate5.zip

Since apache must be able to create files in the translate5 directory, the permissions have to be changed:

sudo chown www-data:www-data /var/www/translate5

Then run the Translate5 installation and update script as www-data user, follow the instructions in the script.

cd sudo mkdir /var/www/translate5
sudo chown apache:apache /var/www/translate5su -c ./install-and-update.sh www-data

Configure translate5 apache vhost

Create the apache vhost Create config file

sudo touch /etc/apache2/sites-available/translate5.conf
sudo chmod 550 /etc/apache2/sites-available/translate5.conf
sudo ln -s ../sites-available/translate5.conf /etc/apache2/sites-enabled/translate5.conf

Edit the config Open the file and paste the following content to it

<VirtualHost *:80>
  DocumentRoot "/var/www/translate5/public"
  ServerAlias translate5.llocal
  SetEnv APPLICATION_ENV application
  php_value include_path .:/var/www/translate5/library/zend/:/usr/share/php5:/usr/share/php
  <Directory "/var/www/translate5/public">
    AllowOverride All
    Options Indexes FollowSymLinks
    Order allow,deny
    Allow from all
    Require all granted
  </Directory>
</VirtualHost>

...

Please be aware, that you have to check your webserver and this apache configuration regarding security, if you oppose your translate5 instance to the internet. Your security is your responsibility and can not be covered by this manual.

Install git

The easiest way to install and update translate5 with its submodules and dependencies is so use git.

sudo apt-get update
sudo apt-get install git

Install translate5

Install files from git

The public git master branch of translate5 will always contain the latest stable version of the master branch. New features may not be in the master branch for a longer time, though.

cd /var/www/translate5

Change your user to the Linux apache user, to give the files the correct rights from the start

su apache

Get translate5

git clone https://bitbucket.org/mittagqi/translate5_released.git .

The trailing "." is important, otherwise you will get another directory inside your directory.

git submodule sync
git submodule update --init
git submodule foreach git checkout master
git submodule foreach git pull

Get the submodules of the ZfExtended library and the translate5 editor module

cd library/ZfExtended 
git submodule sync
git submodule update --init
git submodule foreach git checkout master
git submodule foreach git pull

cd /var/www/translate5/application/modules/editor
git submodule sync
git submodule update --init
git submodule foreach git checkout master
git submodule foreach git pull

Import database bootstrap

Download database bootstrap from

.

...

Unzip it. On the command line change to the directory with the extracted DbInit.sql

cd /path_to_your_dir/

Import the DbInit.sql to your MySQL

mysql -u root -p < DbInit.sql

Restart apache

You have to restart apache to apply all changes made to configuration.

...

You are done 

Open your browser and call call http://translate5.l and local (or whatever hostname you have configured) and have fun with translate5.