README.rst 2.51 KB
Newer Older
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
=========================
Pootle Translation Server
=========================

This document describes how to install a personal Pootle translation server.

Requirements
============

* `Ansible <http://docs.ansible.com/>`_. We use Ansible to easily deploy Pootle and scripts to the server. The deployment receipes and scripts are found in this Git project.
* Linux server. We will use a blank `Debian AMD64 <https://www.debian.org/CD/netinst/>`_ virtual machine to start with. Installation was done with only a SSH server running and command :command:`sudo` being available.


Installing Ansible
------------------

Ansible is needed on a so-called "Control Machine"; that is, a computer that will control the Pootle server. This is typically your personal computer.

We will install Ansible from source since this is the recommended method. Just pick your preferred user directory and:

::

    $ sudo easy_install pip
    $ sudo pip install paramiko PyYAML Jinja2 httplib2 six
    $ git clone git://github.com/ansible/ansible.git --recursive
    $ cd ./ansible
    $ source ./hacking/env-setup

Configuring Ansible
-------------------

Edit or create file :file:`/etc/ansible/hosts` and put a reference to your (blank) server::

    [pootle]
    192.168.81.128

Provisioning Pootle server
--------------------------

Run::

    $ ansible-playbook -s install.yml

Administrating Pootle
---------------------

In default Pootle installations, an admin account (the password matches the username) is created with superuser privileges which can be used to administer the whole site.

.. note::
    It's highly recommended that you change the password for the default admin account on your first login, or even delete the account
    and assign superuser rights to another user.

When logging onto your server, you are encouraged to work as user "pootle" and follow the guide::

    $ sudo su - pootle

Migrating data from production
------------------------------

- Copy po files from production and deploy to new server
- Dump the production database
- Remove every database table from new Pootle server
- Import production database dump
- Run::

      $ sudo -u pootle /opt/local/pootle/bin/pootle --config=/etc/pootle/pootle.conf setup

- Migrate XLIFF to global space with unique id::

      $ sudo su - pootle
71
72
	  $ ~/scripts/bin/migration/1-migrate-typo3-xliff
	  $ ~/scripts/bin/migration/2-project-renamer
73
74
75
76
77

- Update your password to be "password"::

      UPDATE auth_user SET password='sha1$b5711$bb690a5a16cff60ae3b01fa285bcb2e68cd244f7' WHERE username='admin';