Install instructions

Welcome to the web-vis wiki!

Instructions for deployment on Ubuntu server (you have to adapt it for other OS)

• Install compiling essentials

sudo apt install build-essential
sudo apt install python-dev

• Install R:

R is a fast-moving project, and the latest stable version isn't always available from Ubuntu's repositories, so we'll start by adding the external repository maintained by CRAN, add the repository, update in order to include packages from the new repository, and the install R

sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys E298A3A825C0D65DFD57CBB651716619E084DAB9
sudo add-apt-repository 'deb [arch=amd64,i386] https://cran.rstudio.com/bin/linux/ubuntu xenial/'
sudo apt-get update
sudo apt-get install r-base

• Install R packages

sudo -i R
install.packages(‘ggplot2’)

• Install Lilypond (follow instructions on http://lilypond.org/macos-x.html for Mac OS)

sudo apt install lilypond

• Install virtualenv

sudo apt install virtualenv

Clone the web-vis project from the Github repo

git clone https://github.com/ELVIS-Project/web-vis.git

• cd to the folder where the application is

virtualenv webvis
source webvis/bin/activate

• update pip

pip install -U pip

• install requirements

pip install -r requirements.txt

• Restart the virtual environment if needed (most likely) and allow the port for accessing the app (or use other firewall method)

deactivate
source webvis/bin/activate
sudo ufw allow PORTNUMBER

• Synchronize Django and runserver

python manage.py migrate
python manage.py runserver YOURIPADDRESS:PORTNUMBER

• If everything went well, grab a soda and go for a walk