This is a working a draft - please do not use the installation manual until this remark is removed!
MySQL
...
Translate5 needs a own database with character set utf8. Connect to mysql
Code Block |
---|
|
mysql -h localhost -u root |
Then create the database, for example "translate5":
Code Block |
---|
|
CREATE DATABASE IF NOT EXISTS `translate5` DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci; |
Hostname
If you are using translate5 locally, you have to to specify a hostname for your local configuration. Please add the following line to the /etc/hosts file, so that your browser can reach Translate5. We assume "translate5.local" as hostname here.
Code Block |
---|
language | text |
---|
title | Add to the file /etc/hosts |
---|
|
127.0.0.1 translate5.local |
...
Download and install Translate5
First create a translate5 directory:
Code Block |
---|
|
sudo mkdir /var/www/translate5 |
Download the Translate5 core package from
http://www.translate5.net/downloads/translate5.zip
and save and unpack it directly in the above directory. This can be done with the following commands:
Code Block |
---|
|
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:
Code Block |
---|
|
sudo chown -R 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.
Code Block |
---|
|
cd /var/www/translate5 |
...
sudo su -c ./install-and-update.sh www-data |
In the "Translate5 Installation" step the script will ask you for the database credentials. If you have your database set up as described in configuration from scratch then all default values can be used.
The script asks also for the virtual host hostname, this must be the same hostname as specified above for the /etc/hosts file. The example name "translate5.local" is also the default in the script.
Code Block |
---|
language | text |
---|
title | Example output of install-and-update.sh |
---|
collapse | true |
---|
|
Checking server for updates and packages:
=========================================
Downloader: Downloading Translate5 X.Y.Z from http://www.translate5.net/downloads/translate5.zip
Downloader: Updated application translate5
Downloader: Downloading translate5 DB init from http://www.translate5.net/downloads/translate5-DB-init.zip
Downloader: Fetched dependency translate5-DB-init
Downloader: Installed dependency translate5-DB-init
[... more dependency downloads ...]
Translate5 Installation
=======================
Please enter the MySQL database settings, the database must already exist.
Default character set must be utf8. This can be done for example with the following command:
CREATE DATABASE IF NOT EXISTS `translate5` DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;
Please enter the DB host (default: localhost):
Please enter the DB username (default: root):
Please enter the DB password:
Please enter the DB database (default: translate5):
Creating the database base layout...
Translate5 tables created.
DB Config successfully stored in ./application/config/installation.ini!
Please enter the hostname of the virtual host which will serve Translate5 (default: translate5.local):
Updating Translate5 database scheme
===================================
DB Update OK
New statement files: 14
Modified statement files: 21
Translate5 installation / update done.
Please visit http://translate5.local/ to enjoy Translate5.
In case of errors on installation / update please contact support@translate5.net |
Configure translate5 apache vhost
Create the apache vhost config file
Code Block |
---|
|
sudo touch /etc/apache2/sites-available/translate5.conf |
...
...
550 /etc/apache2/sites-available/translate5.conf |
...
sudo ln -s ../sites-available/translate5.conf /etc/apache2/sites-enabled/translate5.conf |
Edit the config file and paste the following content to it
Code Block |
---|
language | text |
---|
title | /etc/apache2/sites-available/translate5.conf |
---|
|
<VirtualHost *:80> |
...
DocumentRoot "/var/www/translate5/public" |
...
ServerAlias translate5.local |
...
SetEnv APPLICATION_ENV application |
...
php_value include_path .:/var/www/translate5/library/zend/:/usr/share/php5:/usr/share/php |
...
<Directory "/var/www/translate5/public"> |
...
...
Options Indexes FollowSymLinks |
...
...
...
...
...
Save the file.
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.
...
You have to restart apache to apply all changes made to configuration.
Code Block |
---|
|
sudo /etc/init.d/apache2 restart |
TermTagger Configuration - TODO
You are done
Open your browser and call http://translate5.local (or whatever hostname you have configured) and have fun with translate5.