Policy Compass Services

Web Services for the Policy Compass

Manual

This manual is tested under Ubuntu 14.04!

Requirements

• Python 3.4 should be already installed, but make sure with the following command:

  python3

• Install the following packages:

  apt-get install python-virtualenv python3-dev libpq-dev

• Install SQLite (easier for development) or PostgreSQL:

Either do

  apt-get install sqlite3

or

  apt-get install postgresql
  pip install psycopg2==2.5.4

If you chose PostgreSQL, you want to create a postgres user and a database:

  sudo -u postgres createuser pcompass -W
  sudo -u postgres createdb pcompass --owner pcompass

Installation

• Create a new directory for the project

  mkdir services

• Create a Python Virtual Environment with Python 3 and activate it

  virtualenv services --python=python3
  cd services
  source bin/activate

• Clone the repository including submodules
• Note: The submodule are configured for use with SSH, so configure your access to GitHub: https://help.github.com/articles/generating-ssh-keys

  git clone [email protected]:policycompass/policycompass-services.git
  cd policycompass-services

• Install the Requirements

  pip install -r requirements.txt

• Create a local settings file

  cp config/settings.sample.py config/settings.py

• Edit the settings.py according to your needs. See: https://docs.djangoproject.com/en/1.6/ref/settings/#databases
• Initialize the Database

	python manage.py migrate
    python manage.py syncdb
	python manage.py loaddata metrics events common references visualizations

• Start the application

	python manage.py runserver

• Browse for example to: http://localhost:8000/api/v1/metrics

Elastic search setup

• Download the elasticsearch from http://www.elasticsearch.org/download/
• Unzip elasticsearch into a folder
• Run ./bin/elasticsearch
• Check elasticsearch URL setting in policycompass-services/settings.py (should be ok by default localhost:9200)
• With elasticsearch and policy-compass backend services running execute the following command to rebuild index

	python manage.py rebuild_index