Cluster account management tool.

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

Karaage 4 will extend Karaage 3 to allow management of resource allocations to projects based on grants. It will also make Karaage faster and more responsive.

A Karaage Enhancement Proposal -- KEP 4000 -- similar to a Python Enhancement Proposal is being developed.

A link to KEP 4000 will being added to this README once the draft is complete, and comment from the Karaage community will be sought.

The Karaage 4 documentation will be available soon on ReadTheDocs.

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

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

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

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

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

Admin documentation: http://karaage.readthedocs.org/en/latest/

Prior to Karaage 4, 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 4 is Tyson Clugg.

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 karaage4

Add these lines to the end of ~/.virtualenvs/karaage4/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 karaage4

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

$ kg-manage migrate

$ kg-manage runsslserver 0:8000

Browse to https://localhost:8000