Cluster account management tool.

Karaage manages users and projects in a cluster and can store the data in various backends.

Mailing list: http://lists.vpac.org/cgi-bin/mailman/listinfo/karaage

Gerrit code review tool: https://code.vpac.org/gerrit

Karaage 2.7.x: <http://karaage.readthedocs.org/en/2.7.stable/>`_.

Karaage 3.x User documentation: http://karaage.readthedocs.org/projects/karaage-user/en/latest/

Karaage 3.x Programmer documentation: http://karaage.readthedocs.org/projects/karaage-programmer/en/latest/

Karaage 3.x Admin documentation: http://karaage.readthedocs.org/en/latest/

Software requirements specification: http://karaage.readthedocs.org/projects/karaage-srs/en/latest/

Prior to Karaage 3.1.11, the various Karaage modules had been in seperate repositories. They have now been brought together into one repo.

These modules are:

• karaage-applications (also see Karaage 3 karaage-applications)
• karaage-cluster-tools (also see Karaage 3 karaage-cluster-tools)
• karaage-software (also see Karaage 3 karaage-software)
• karaage-usage (also see Karaage 3 karaage-usage)

.. todo:: Write paragraph about what the usage plugin does.

The karaage-usage plugin provides monitoring of usage information.

This plugin allows users to self register accounts with Karaage.

.. todo:: Write paragraph about what the software plugin does.

The lead developer for Karaage 3 is Brian May.

The steps below will guide you through setting up an instance of Karaage 4.

$ sudo apt-get remove karaage\*
$ sudo apt-get install libcrack2-dev csstidy slapd ldap-utils
$ sudo apt-get build-dep python-cracklib

You may already have these installed. If so, skip this step.

$ sudo apt-get install python-pip
$ sudo pip install virtualenv virtualenvwrapper

Add these lines to the end of your ~/.bashrc file:

export WORKON_HOME=$HOME/.virtualenvs
source /usr/local/bin/virtualenvwrapper.sh

Reload ~/.bashrc:

$ source ~/.bashrc

$ mkvirtualenv karaage3

Add these lines to the end of ~/.virtualenvs/karaage3/bin/postactivate:

export KARAAGE_SECRET_KEY='d4-5vjhdyi)673gd56#ge@3r8t#*)+s8z-z0l!_sy94ol!m'
export KARAAGE_DEBUG='True'
export DJANGO_PIPELINE_ENABLED='False'
export KARAAGE_DB_ENGINE='django.db.backends.mysql'

Restart the virtualenv so that these setting take effect:

$ deactivate
$ workon karaage3

$ pip install -e 'git+https://github.com/vlsci/karaage#egg=karaage3[usage,applications,software]'

$ kg-manage migrate

$ kg-manage runsslserver 0:8000

Browse to https://localhost:8000