4 Pithos is a file storage service, built by GRNET using Django (https://www.djangoproject.com/).
5 Learn more about Pithos at: http://code.grnet.gr/projects/pithos
6 Consult LICENSE for licensing information.
11 All docs are in the docs/source directory. The .rst files are perfectly readable in source form.
13 To build the documentation you need to have Sphinx (http://sphinx.pocoo.org/) installed.
15 On a typical debian-based Linux system run:
16 apt-get install python-django python-django-south python-setuptools python-sphinx python-httplib2
17 apt-get install python-sqlalchemy python-mysqldb python-psycopg2
20 python setup.py build_sphinx
22 The documentation will be built in the docs/build/html directory.
25 python setup.py build_sphinx -b text
27 Then find the plain text version of the docs in docs/build/text.
32 Make sure you have all required packages installed:
33 apt-get install python-django python-setuptools python-sphinx python-httplib2
34 apt-get install python-sqlalchemy python-mysqldb python-psycopg2
37 python manage.py syncdb
38 python manage.py schemamigration im --initial
39 python manage.py loaddata admin_user
40 python manage.py runserver
43 http://127.0.0.1:8000/im/admin?user=admin&token=0000
45 This server is useful during development, but should not be used for deployment.
46 To deploy Pithos using Apache, take a look at the Administrator Guide in docs.
51 In the pithos/tools directory you will find the following utilities:
53 pithos-sh Pithos shell
54 pithos-sync Pithos synchronization client
55 pithos-fs Pithos FUSE implementation
56 pithos-test Pithos server tests
58 Also, the pithos/lib directory contains a python library that can be used
59 to access Pithos and manage stored objects. All tools use the included lib.
61 Connection options can be set via environmental variables:
63 PITHOS_USER Login user
64 PITHOS_AUTH Login token
65 PITHOS_SERVER Pithos server (default: plus.pithos.grnet.gr)
66 PITHOS_API Pithos server path (default: v1)
67 PITHOS_SYNC_CONTAINER Container to sync with (default: pithos)