Phaidra

Phaidra is that system that powers the Historical Language eLearning Project. It will provide distributed eLearning for historical languages such as Greek and Latin, so that more people can delve deeply into primary sources in their original language.

Installing Phaidra

These instructions will assume you are running Ubuntu 12.04, and that you are installing Phaidra in /opt/phaidra.

Push directly to OpenPhilology/Phaidra

Only for authorized contributors

	$ cd /opt
	$ git clone git@github.com:OpenPhilology/phaidra.git

This will create a directory at /opt/phaidra.

Fork from Github

On this page, click "Fork" in the upper right-hand corner.

Clone the project to your local machine.

	$ cd /opt
	$ git clone https://github.com/YOUR_USERNAME/phaidra.git
	$ git remote add upstream https://github.com/YOUR_USERNAME/phaidra.git
	$ git fetch upstream

This will create a directory at /opt/phaidra.

Set up Virtualenv

	$ sudo apt-get install python-virtualenv 
	$ cd /opt/phaidra
	# The name of our virtualenv is "env"
	$ virtualenv --no-site-packages env
	$ source env/bin/activate

Now, in front of your command prompt, you should see (env), which indicates that you are operating within that environment.

Install Requirements

Presuming you are starting with a new machine, you need to install Python-related tools.

	$ sudo pip install -r requirements.txt

Install and configure Nginx with Uwsgi

Phaidra runs on nginx as its web server.

	$ sudo apt-get install nginx uwsgi uwsgi-plugin-python

Make sure you are running the latest version of Uwsgi (at time of writing, 1.9) with uwsgi --version. If this gives you an older version, you will need to upgrade by doing the following:

	$ pip install -U uwsgi
	$ cd /usr/bin
	$ mv uwsgi uwsgi-old
	$ ln -s /usr/local/bin/uwsgi uwsgi

Open /opt/phaidra/extras/nginx/phaidra.conf and set the variables to be appropriate for your server:

	# Can also just be an IP Address
	server_name YOUR_SERVER.com www.YOUR_SERVER.com 

Next we must create a symlink so Nginx uses our configuration file:

	$ ln -s /etc/nginx/sites-enabled/phaidra.conf /opt/phaidra/extras/nginx/phaidra.conf

And do the same to enable Uwsgi:

	$ ln -s /etc/uwsgi/apps-enabled/phaidra.ini /opt/phaidra/extras/uwsgi/phaidra.ini

Create a safe space for the socket to exist, which can be accessed by both Nginx and Uwsgi:

	$ sudo mkdir /var/uwsgi
	$ sudo chown www-data:www-data /var/uwsgi

Start up services:

	$ sudo service nginx start
	$ sudo service uwsgi start