Metadata-Version: 1.0
Name: slapos.toolbox
Version: 0.4
Summary: SlapOS toolbox.
Home-page: UNKNOWN
Author: UNKNOWN
Author-email: UNKNOWN
License: GPLv3
Description: slapos.toolbox
        ==============
        
        0.4 (1011-07-11)
        ================
        
        * Update slaprunner to run on newer slapos (requires at least 0.10
        to work). [Cedric de Saint Martin]
        
        0.3 (2011-06-27)
        ================
        
        * slapbuilder: use slapos provided networkcached buildout.
        * slapbuilder: fix network issues on busy networks ("Neighbour table
        overflow.")
        
        0.2 (2011-06-10)
        ================
        
        * In slapbuilder: drop to 100 partitions by default, move out PKI from USB key
        to real disk. [Łukasz Nowak]
        
        0.1 (2011-05-27)
        ================
        
        * Created slapos.toolbox from slapos.tool.builder, slapos.tool.runner,
        slapos.tool.cloudmgr, slapos.tool.ontimeupload and slapos.tool.networkcache.
        [Łukasz Nowak]
        
        
        builder
        =======
        
        builder is a program to install a slapos image.
        
        
        cloudmgr
        ========
        
        
        monitor
        =======
        
        Monitoring for SLAP (Simple Language for Accounting and Provisioning) python library.
        
        
        
        onetimeupload
        =============
        
        onetimeupload is an HTTP application which only accepts one file to be
        uploaded.
        
        
        shacache
        ========
        
        The network cache server is a NoSQL storage with a REST API.
        
        
        How does it works
        -----------------
        
        ::
        
        _______________
        /               \
        |               |
        ------>| NETWORKCACHED |
        |  ----|               |<-----
        |  |   \_______________/     |
        GET /key  |  |                         |
        |  | File                    | PUT / <- data
        __|__v______             ______|_____
        |            |           |            |
        |   Client   |           |   Client   |
        |____________|           |____________|
        
        
        Basically, the networkcached archives the files through HTTP PUT method.
        When a client want to download the file it just need to provide the key
        value and the server will send a response with the file data.
        
        ::
        
        API:
        PUT / :
        parameter: file uploaded
        Used to upload/modify an entry
        
        GET /<key>
        Return raw content
        Raise HTTP error (404) if key does not exist
        
        
        Installation
        ------------
        
        ::
        
        $ python2.6 setup.py install
        
        Now it is time to create the 'networkcached.conf' file in /etc/networkcached.conf
        directory, using your preferred text editor (gedit, kate, vim.).
        Follow text shall be put in this file::
        
        [networkcached]
        host = 127.0.0.1
        port = 5001
        cache_base_folder = /var/cache/networkcached/
        
        Run the server::
        
        # networkcached networkcached.conf
        
        
        Setup Develoment Environment
        ----------------------------
        
        ::
        
        $ mkdir -p ~/networkcached/downloads
        $ cd ~/networkcached
        
        Now it is time to create 'buildout.cfg' file in ~/networkcached directory,
        using your preferred text editor (gedit, kate, vim.).
        Follow text shall be put in this file::
        
        [buildout]
        extensions = mr.developer
        auto-checkout = slapos.tool.networkcached
        download-cache = /nexedi/buildout-networkcached/downloads
        eggs-directory = /nexedi/buildout-networkcached/eggs
        
        parts =
        networkcached
        
        [sources]
        slapos.tool.networkcached = svn https://svn.erp5.org/repos/vifib/trunk/utils/slapos.tool.networkcached
        
        [networkcached]
        recipe = zc.recipe.egg
        eggs =
        slapos.tool.networkcached
        
        Now you bootstrap the buildout::
        
        $ python -S -c 'import urllib;print urllib.urlopen(\
        "http://svn.zope.org/*checkout*/zc.buildout/trunk/bootstrap/bootstrap.py"\
        ).read()' | python -S -
        
        Run the buildout::
        
        $ bin/buildout -v
        
        Now it is time to create the 'networkcached.conf' file in ~/networkcached
        directory, using your preferred text editor (gedit, kate, vim.).
        Follow text shall be put in this file::
        
        [networkcached]
        host = 127.0.0.1
        port = 5001
        cache_base_folder = ~/networkcached/networkcached-database
        
        Now you can start your networkcached server:
        $ bin/networkcached networkcached.conf
        or
        $ bin/networkcached -d networkcached-database -a 127.0.0.1 -p 5002
        
        
        webrunner
        =========
        
        
        
Keywords: slapos toolbox
Platform: UNKNOWN
Classifier: Programming Language :: Python
