If python is not installed, run

sudo apt-get install python

Install django

wget "http://www.djangoproject.com/download/1.4/tarball/" -O Django-1.4.tar.gz
tar xzvf Django-1.4.tar.gz
cd Django-1.4
sudo python setup.py install

Install Git

sudo apt-get install git

Install Fabric

sudo apt-get install fabric

Install other dependencies

sudo apt-get install python-setuptools libmysqlclient-dev python-dev python-mysqldb python-libxml2 python-libxslt1 libxml2-dev libxslt1-dev

Currently the LRS supports both Postgres and MySQL backends. Depending on which you want to use, comment out the backend you don't want and follow the instructions below for the one you chose. When xAPI 1.0 is released we will be moving to Postgres full time

MySQL

Install MySQL

sudo apt-get install mysql-server

Create LRS database

mysqladmin -h localhost -u {username} -p create lrs

End MySQL

Postgres

Install Postgres

sudo apt-get install postgresql-9.1

Set postgres user password

sudo passwd postgres

Create user for postgres that will own LRS database

sudo -u postgres createuser -P {username}

Switch to postgres user

su postgres

Enter Postgres shell

psql template1

Create DB and owner

CREATE DATABASE lrs OWNER {username} ENCODING 'UTF8';
(To exit shell - '\q', then switch back to your normal Linux user)

Download python-psycopg2 and libpq-dev

sudo apt-get install python-psycopg2 libpq-dev

End Postgres

Navigate to desired repository directory and clone LRS repository

git clone https://github.com/adlnet/ADL_LRS.git
cd ADL_LRS

NOTE: Be sure in your settings file (ADL_LRS/adl_lrs/settings.py) your USER and PASSWORD entries are correct for your DB)

Run fabric file to install all local dependencies and create needed directories

sudo fab deps_local

Activate your virtual environment (while still in ADL_LRS)

. env/bin/activate

Create LRS cache table

python manage.py createcachetable cache_statement_list

While still in the ADL_LRS directory, update the database

python manage.py syncdb

When prompted to create a superuser, say yes

OPTIONAL: This next step creates the 'all' resource for OAuth. If plan on implementing OAuth now, perform this step. It can always get ran later if you decide to implement OAuth

python manage.py loaddata resources.json

While still in the ADL_LRS directory, run

supervisord

To verify it's running

supervisorctl

You should see a task named web running. This will host the application using gunicorn with 2 worker processes

fab test_lrs