Installation on Linux (Ubuntu example)

Installation mandatory dependencies

• Apache2 webserver >= 2.2.x with the following Apache modules enabled

  • rewrite 

  • filter

  • deflate

  • headers

  • expires

• MySQL database >= 5.1
  (Please note, that translate5 used to run on MSSQL. translate5 still is able to run on other SQL-Databases than MySQL with some testing and smaller adjustments to the code. Please contact the developers, if you need this.)
• PHP 5.6 or higher with the extensions installed and enabled
  • dom
  • fileinfo
  • gd with Freetype-Support
  • iconv
  • mbstring
  • pdo_mysql
  • zip

Configuring the environment from scratch

(you can skip this step, if your environment matches the above dependencies. In this case continue with "Installing translate5")

The setup requires root access privileges. You need to open the command line and enter the listed commands. After each command press ENTER.

Install Apache

sudo apt-get install apache2

Enable Additional Modules for Apache

Apache web server needs to be fine tuned for translate5 to work properly. Switch to Apache directory with

cd /etc/apache2

and enter these commands to enable required Apache submodules

sudo a2enmod rewrite filter deflate headers expires

sudo apache2ctl restart

Last command is mandatory for changes to take effect. If you see, upon issuing sudo apache2ctl restart, the following warning:

Could not reliably determine the server's fully qualified domain name, using 127.0.1.1 for ServerName
do not worry, it’s not important.

Install MySQL

sudo apt-get install mysql-server mysql-client

The installation process will prompt a few times for a new root password access for MySQL. It’s fine leaving it blank; otherwise, please ensure you type the same every time. You can test the reachability of the database by issuing at a terminal:

mysql -u root -p

If you specified a password during MySQL setup, type it when prompted; otherwise, just hit Return. If everything went fine, you should see the greeting message and the shell prompt:

mysql>

Leave mysql shell prompt with

exit;

Install PHP5 core

Add the php 5.6 repository, since it is not yet included in Ubuntu

sudo add-apt-repository ppa:ondrej/php5-5.6

If you get an error here, you need to install python-software-properties first (and then do the line above again):

sudo apt-get update
sudo apt-get install python-software-properties

Now refresh your package list

sudo apt-get update

and install php

sudo apt-get install php5

Check if you have the correct version of php installed

php5 -v

Install php extensions

Install the extension dom, fileinfo, iconv, mbstring, zip

sudo apt-get install libapache2-mod-php5

Install extensions pdo_mysql and gd

sudo apt-get install php5-mysql php5-gd

Install Oracle Java

(needed by openTMStermTagger, which is used by translate5)

sudo apt-add-repository ppa:webupd8team/java 

sudo apt-get update 

sudo apt-get install oracle-java8-installer

Install Zend Framework

Download the Zend Framework version currently used by translate5 from

http://www.translate5.net/downloads/Zend.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

sudo mkdir /var/www/translate5
sudo chown apache:apache /var/www/translate5

Create config file

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

Open the file and paste the following content to it

<VirtualHost *:80>
DocumentRoot "/home/marcstandard/NetBeansProjects/app-mittagqi-translate5Net/public"

ServerAlias translate5.l

SetEnv APPLICATION_ENV application
SetEnv APPLICATION_AGENCY marc
<Directory "/home/marcstandard/NetBeansProjects/app-mittagqi-translate5Net/public">

AllowOverride All

Options Indexes FollowSymLinks

Order allow,deny

Allow from all
 Require all granted
</Directory>
</VirtualHost>

Restart apache

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

sudo /etc/init.d/apache2 restart

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

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.

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

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

Step-by-step guide

Related articles