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