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.

Create a virtualenv with python2

mkvirtualenv --python=python2 abstrackr

Create a root folder for the app, and enter

mkdir abstrackr
cd abstrackr

Eutils, Pygooglechart and numpy cannot be build with easy_install and thus are not included as prerequisites in the egg. The next steps describe how to install these manually.

With the new environment activated, install Eutils

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

Install PyGoogleChart

pip install pygooglechart

Install Numpy

pip install numpy

Install Abstrackr

easy_install abstrackr

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>

In development.ini look for "# Mailing configurations" within the [app:main] section and modify accordingly

smtp_host = localhost
smtp_port = 25
sender = [email protected]

Prepare the database

CREATE USER 'username'@'localhost' IDENTIFY BY 'password';
GRANT ALL PRIVILEGES ON <database>.* TO 'username'@'localhost';
CREATE SCHEMA <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

Run the following command from the directory development.ini

paster setup-app development.ini

Start the server

paster serve developement.ini