Installation and Setup 
======================

Requirements
------------

The qcat application needs a whole range of server applications:

* Apache webserver
* Postgresql >= 9.4 with postgis extension
* uwsgi: application server for python web applications together
* elasticsearch: search engine based on Lucene
* memcached:  Memory caching

Postgresql
..........

Postgresql 9.4 or bigger is needed as JSONP is used. Postgis 2.1 or bigger is needed as well.


uwsgi
.....

uwsgi is needed at least in version 2.x or bigger. In the following explanations we use uwsgi in emperor mode.
Furthermore uwsgi needs the python3 plugin and apache needs the uwsgi-proxy module::

	apt-get install uwsgi-emperor uwsgi-plugin-python3 libapache2-mod-proxy-uwsgi


Other required packages
........................

::

	sudo apt-get install python3-pip  python3-psycopg2 libpg-dev python3-pil memcached libmemcached-dev nodejs nodejs-legacy npm


wkhtmltopdf: a version with patched QT is required. Get the current stable version at http://wkhtmltopdf.org/downloads.html ::

    cd /tmp
    wget <download_file>
    sudo tar xvf wkhtmltox-0.12.3_linux-generic-amd64.tar.xz
    sudo mv wkhtmltox/bin/wkhtmlto* /usr/bin


Installation
------------

Backend installation
......................


#. Creating user 'qcat'::

	sudo adduser qcat && addgroup qcat:qcat

#. Create the application folder::

	sudo mkdir qcat-live
	chown qcat:qcat qcat-live

#. Install virtualenv::

	sudo pip3 install virtualenv

#. Now change privileges to user 'qcat'::

	sudo -u qcat -i
	cd qcat-live

#. Get the application from the github repository::

	git clone https://github.com/CDE-UNIBE/qcat.git source

#. Create virtualenv and activate it::

	virtualenv -p python3 virtualenv
	source virtualenv/bin/activate

#. Install all requirements python requirements for the application::

	cd source
	pip3 install -r requirements/production.txt

#. Now we are ready to install the system based stuff. This is done with fabric from another computer::

	fab deploy_demo

#. Now we can try, if the Django applicatio is valid::

	cd qcat-live/source
	python3 manage.py validate


Frontend installation
.....................

#. Change to project folder and use NPM to install Bower and Grunt::

	cd qcat-live/source
	npm install -g grunt-cli bower

#. Install the project dependencies::

	npm install

#. Change to qcat user and let Bower collect the required libraries::

	bower install

#. Use Grunt to build the static files::

	grunt build