Installation

Abstrackr Setup Instructions

Please ensure that you have the following programs installed

• Git (link)
• virtualenv (optional, but highly recommended) (link)
• virtualenvwrapper (optional, but highly recommended) (link)

I will be covering installation that has been tested in a Linux environment. Windows installations will be similar but will require some modifications to the commands. The order of operations should be identical for the most part.

Step one: Clone abstrackr project

git clone [email protected]:bwallace/abstrackr-web.git abstrackr

Enter the project folder and switch to experimental branch

git checkout experimental_plus_plus

Create virtualenv with python2

mkvirtualenv --python=python2 abs

With the new environment activated, load dependencies with

easy_install abstrackr-0.2dev-py2.7.egg

Eutils, Pygooglechart and numpy cannot be build with easy_install. The next steps describe how to install these. You may want to perform the next steps outside the Abstrackr project directory.

Install eutils

git clone https://github.com/hpiwowar/eutils
cd eutils
python setup.py build
python setup.py install

Install PyGoogleChart

pip install pygooglechart

Install Numpy

pip install numpy

Prepare database

CREATE USER 'username'@'localhost' IDENTIFY BY 'password';
GRANT ALL PRIVILEGES ON <database>.* TO 'username'@'localhost';
CREATE SCHEMA <database>;

Make a copy of the sample.ini (call it development.ini for example) and modify the following line

sqlalchemy.url = mysql://<username>:<password>@127.0.0.1:3306/<database>

Remove the following comment in the .ini file when you are ready for production

set debug = false

The next command will build your database tables, provided the database has been setup correctly and the user has the proper rights

From the root directory run the following command

paster setup-app development.ini

Correct outgoing email server

Start the server

paster serve developement.ini