Troubleshooting Installation

Postgres

If, while you're installing, you encounter problems with postgres, such as:

locale: Cannot set LC_MESSAGES to default locale: No such file or directory
locale: Cannot set LC_ALL to default locale: No such file or directory

Try copying the environment file we've provided in /extras/etc/.

sudo cp /opt/phaidra/extras/etc/environment /etc/environment
sudo reboot

This has to do with the virtual machine you're on being incorrectly configured. See related Stackoverflow post.

---

Bad Gateway

This generally indicates that uwsgi is not actually running. You can debug uwsgi by stopping the process, uncommenting the daemon line in its config file, and launching it again.

killall uwsgi
vim extras/uwsgi/phaidra.ini
# Find the line that starts with 'daemon', and comment it out with a #
uwsgi /opt/phaidra/extras/uwsgi/phaidra.ini

Open up any page on the website in your browser and see what happens in your terminal. You should see an error come up in the terminal. Ctrl + C to kill the process, fix your error, and run the uwsgi command again until things work normally.

Once you've debugged the problem, simply git checkout the uwsgi conf file and you're back to normal.

---

Error: You must put some source URIs in your sources.list

This error has to do with a problem with your Ubuntu install itself. You are probably trying to apt-get install something, but don't have updated sources. This especially occurs when trying to apt-get build-dep.

What worked for us (per this ticket on Ubuntu's launchpad ):

sudo apt-get install software-properties-gtk
gksu software-properties-gtk

# Check the box for 'Source Code' and close the window.

sudo apt-get update

Wait a minute or two, as the files you need might still be "in use" by the system. Then go on with the installation process as normal.

---

Fatal error: local() encountered an error (return code 1) while executing "./manage.py createsuperuser"

This is most likely occurring as a result of the virtual environment not being correctly activated during installation. This should be fixed in the most recent fabfile.py version.

If you encounter this issue, you can pick up the install after you have activated the virtual environment with:

source env/bin/activate

---

Rights and Permissions

If you encounter issues with not having rights to certain files, you should consider running the installation process as root.

If you would prefer not to do this, you can open fabfile.py and run the commands that install frontend tools as a typical user. You should be able to tell from this file which commands must be run as root.