Projects/Memopol/Installation

From La Quadrature du Net
< Projects‎ | Memopol
Revision as of 19:13, 29 July 2015 by Piks3l (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigationJump to search


Political Memory is a toolbox designed by La Quadrature du Net to help european citizens to reach members of European Parliament (MEPs), and track their voting records.


Installation for development[edit]

Memopol with lqdn's customization is little bit more complex to install than a normal django project, but not that much more complicated.

Since the entire historic of MEPs and votes is kept, the install will be long.

Architecture specific[edit]

Debian and debian-based[edit]

Install the base python virtualenv tools (on Ubuntu you have to enable universe):

   sudo apt-get install python-setuptools python-dev libxml2-dev libxslt1-dev libfreetype6-dev libpng12-dev python-pip
   libatlas-base-dev g++ mercurial git libtidy-dev imagemagick ruby-sass
   sudo pip install virtualenv

Archlinux[edit]

Install the following to have the tools on Archlinux (please note that you may have to adapt the following install procedure):

   pacman -S python2 libxml2 libxslt freetype2 python-lxml python2-pip python2-virtualenv libpng mercurial git imagemagick
   tidyhtml ruby-sass

Fedora[edit]

Install the following to have the tools on Fedora (please note that you may have to adapt the following install procedure):

   yum install python-setuptools python-devel libxml2-devel libxslt-devel freetype freetype-devel libpng libpng-devel python-lxml
   python-pip atlas-devel g++ mercurial git imagemagick rubygem-sass
   pip-python install virtualenv

OpenSuse[edit]

Install the following to have the tools on OpenSuse (please note that you may have to adapt the following install procedure):

   to come...


Python dependencies[edit]

In a directory:

   git clone git://gitorious.org/memopol2-0/memopol2-0.git
   git clone git://gitorious.org/memopol2-0/memopol-core.git
   cd memopol2-0
   ln -s ../memopol-core/memopol .
   virtualenv ve
   source ve/bin/activate
   pip install -r requirements-dev.txt
   pip install -r ../memopol-core/requirements.txt

Virtualenv[edit]

To enter the virtualenv

   source ve/bin/activate

To quit the virtualenv

   deactivate

Build the db[edit]

Db creation[edit]

For debug installations, you could keep the sqlite3 database as is. But for production environment you should modify the settings.py file in order to select another DB engine.

Simply:

   python manage.py init

You will have an error like this "ContentType matching query does not exist.", just redo the command a second time and this will be working. This is a known bug that we haven't got the time to fix.

Db update[edit]

You'll probably want to run this command to update your database:

   python manage.py update_meps

And you should be done.


Run the server[edit]

   python manage.py runserver

Your application is available on http://localhost:8000/

And you're done, but you might want to take a look at the next section depending on what you want to dev.

You can find more informations on how to use memopol in the memopol-core [README.md](https://gitorious.org/memopol2-0/memopol-core/blobs/master/README.md)