Synnefo

README

======

Pithos is a file storage service, built by GRNET using Django (https://www.djangoproject.com/).

Learn more about Pithos at: http://code.grnet.gr/projects/pithos

Consult COPYRIGHT for licensing information.

About Pithos application

------------------------

This package contains the Django application that implements the Pithos v2 API. It depends on the Pithos backend, which does the actual data and metadata operations.

How to run

----------

Use snf-webproject to run Pithos automatically.

To use Pithos in a custom Django project, just add ``pithos.api`` to ``INSTALLED_APPS``.

Pithos has been tested with SQLite and PostgreSQL backend databases. When using PostgreSQL, ensure that the has been created with the appropriate encoding and collation::

    CREATE DATABASE pithos WITH ENCODING 'UTF8' LC_COLLATE='C' LC_CTYPE='C' TEMPLATE=template0;

Settings

--------

Configure in ``settings.py`` or a ``.conf`` file in ``/etc/synnefo`` if using snf-webproject.

===============================  =====================================================  ============================================================

Name                             Default value                                          Description

===============================  =====================================================  ============================================================

PITHOS_PROXY_USER_SERVICES       True                                                   Whether to proxy user feedback and catalog services

PITHOS_USER_CATALOG_URL          \http://<astakos.host>/im/service/api/v2.0/users/      Astakos User Catalog URL

PITHOS_USER_FEEDBACK_URL         \http://<astakos.host>/im/service/api/v2.0/feedback/   Astakos User Feedback URL

PITHOS_USER_LOGIN_URL            \http://<astakos.host>/login/                          Astakos User Login URL

PITHOS_AUTHENTICATION_URL        \http://<astakos.host>/im/authenticate/                Astakos Authentication URL

PITHOS_AUTHENTICATION_USERS      A dictionary of sample users (token to username)       Set to empty or None to disable

PITHOS_BACKEND_DB_MODULE         pithos.backends.lib.sqlalchemy

PITHOS_BACKEND_DB_CONNECTION     sqlite:////tmp/pithos-backend.db                       SQLAlchemy database connection string

PITHOS_BACKEND_BLOCK_MODULE      pithos.backends.lib.hashfiler

PITHOS_BACKEND_BLOCK_PATH        /tmp/pithos-data/                                      Map and block storage path

PITHOS_BACKEND_BLOCK_UMASK       0o022                                                  Map and block storage umask

PITHOS_BACKEND_QUEUE_MODULE      None                                                   Use ``pithos.backends.lib.rabbitmq`` to enable

PITHOS_BACKEND_QUEUE_HOSTS       None                                                   Format like [``amqp://guest:guest@localhost:5672``

PITHOS_BACKEND_QUEUE_EXCHANGE    pithos

PITHOS_BACKEND_QUOTA             50 GB (50 * 1024 ** 3)                                 Default user quota

PITHOS_BACKEND_VERSIONING        auto                                                   Default versioning policy for containers

PITHOS_BACKEND_FREE_VERSIONING   True                                                   Default versioning debit policy (default free)

PITHOS_UPDATE_MD5                True                                                   Update object checksums when using hashmaps

PITHOS_SERVICE_TOKEN             ''                                                     Service token acquired by the identity provider (astakos)

PITHOS_RADOS_STORAGE             False                                                  Enables or disables secondary Pithos storage on RADOS

PITHOS_RADOS_POOL_BLOCKS         None                                                   RADOS pool to be used for block storage

PITHOS_RADOS_POOL_MAPS           None                                                   RADOS pool to be used for maps storage

===============================  ==================================================     ============================================================

To update checksums asynchronously, enable the queue, install snf-pithos-tools and use ``pithos-dispatcher``::

    pithos-dispatcher --exchange=pithos --key=pithos.object --callback=pithos.api.dispatch.update_md5

To send sharing notifications::

    pithos-dispatcher --exchange=pithos --key=pithos.sharing --callback=pithos.api.dispatch.send_sharing_notification

Administrator functions

-----------------------

Available as extensions to Django's command-line management utility:

============  ======================

Name          Description

============  ======================

storagequota  Get/set a user's quota

============  ======================