From dfb1fafad192af8ea03258cf2d1e2bb9666970e8 Mon Sep 17 00:00:00 2001 From: Antony Chazapis Date: Sun, 26 Feb 2012 01:01:32 +0200 Subject: [PATCH] Make proper README files for each package. --- LICENSE | 32 ------------ README | 62 ----------------------- snf-pithos-app/COPYRIGHT | 2 +- snf-pithos-app/README | 51 +++++++++++++++++++ README.upgrade => snf-pithos-app/README.upgrade | 45 ++++++++-------- snf-pithos-backend/COPYRIGHT | 2 +- snf-pithos-backend/README | 11 ++++ snf-pithos-tools/COPYRIGHT | 2 +- snf-pithos-tools/README | 29 +++++++++++ 9 files changed, 118 insertions(+), 118 deletions(-) delete mode 100644 LICENSE delete mode 100644 README rename README.upgrade => snf-pithos-app/README.upgrade (66%) diff --git a/LICENSE b/LICENSE deleted file mode 100644 index aa12569..0000000 --- a/LICENSE +++ /dev/null @@ -1,32 +0,0 @@ -Copyright 2011-2012 GRNET S.A. All rights reserved. - -Redistribution and use in source and binary forms, with or -without modification, are permitted provided that the following -conditions are met: - - 1. Redistributions of source code must retain the above - copyright notice, this list of conditions and the following - disclaimer. - - 2. Redistributions in binary form must reproduce the above - copyright notice, this list of conditions and the following - disclaimer in the documentation and/or other materials - provided with the distribution. - -THIS SOFTWARE IS PROVIDED BY GRNET S.A. ``AS IS'' AND ANY EXPRESS -OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED -WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR -PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL GRNET S.A OR -CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, -SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT -LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF -USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED -AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN -ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE -POSSIBILITY OF SUCH DAMAGE. - -The views and conclusions contained in the software and -documentation are those of the authors and should not be -interpreted as representing official policies, either expressed -or implied, of GRNET S.A. diff --git a/README b/README deleted file mode 100644 index ddee9dd..0000000 --- a/README +++ /dev/null @@ -1,62 +0,0 @@ -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 LICENSE for licensing information. - -Documentation -------------- - -All docs are in the docs/source directory. The .rst files are perfectly readable in source form. - -To build the documentation you need to have Sphinx (http://sphinx.pocoo.org/) installed. - -On a typical debian-based Linux system run: - apt-get install python-django python-setuptools python-sphinx - apt-get install python-sqlalchemy python-mysqldb python-psycopg2 - -Then run: - python setup.py build_sphinx - -The documentation will be built in the docs/build/html directory. - -Also run: - python setup.py build_sphinx -b text - -Then find the plain text version of the docs in docs/build/text. - -Running the server ------------------- - -Make sure you have all required packages installed: - apt-get install python-django python-setuptools python-sphinx - apt-get install python-sqlalchemy python-mysqldb python-psycopg2 - -Then run: - python manage.py syncdb - python manage.py runserver - -This server is useful during development, but should not be used for deployment. -To deploy Pithos using Apache, take a look at the Administrator Guide in docs. - -Using the tools ---------------- - -In the pithos/tools directory you will find the following utilities: - - pithos-sh Pithos shell - pithos-sync Pithos synchronization client - pithos-fs Pithos FUSE implementation - pithos-test Pithos server tests - -Also, the pithos/lib directory contains a python library that can be used -to access Pithos and manage stored objects. All tools use the included lib. - -Connection options can be set via environmental variables: - - PITHOS_USER Login user - PITHOS_AUTH Login token - PITHOS_SERVER Pithos server (default: plus.pithos.grnet.gr) - PITHOS_API Pithos server path (default: v1) - PITHOS_SYNC_CONTAINER Container to sync with (default: pithos) diff --git a/snf-pithos-app/COPYRIGHT b/snf-pithos-app/COPYRIGHT index 6f7fb94..aa12569 100644 --- a/snf-pithos-app/COPYRIGHT +++ b/snf-pithos-app/COPYRIGHT @@ -1,4 +1,4 @@ -Copyright 2011 GRNET S.A. All rights reserved. +Copyright 2011-2012 GRNET S.A. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following diff --git a/snf-pithos-app/README b/snf-pithos-app/README index 8b13789..c8a1513 100644 --- a/snf-pithos-app/README +++ b/snf-pithos-app/README @@ -1 +1,52 @@ +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``. + +Settings +-------- + +Configure in ``settings.py`` or a ``.conf`` file in ``/etc/synnefo`` if using snf-webproject. + +=============================== ================================================ ============================================================ +Name Default value Description +=============================== ================================================ ============================================================ +PITHOS_AUTHENTICATION_URL \http://127.0.0.1:8000/im/authenticate Astakos API 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_QUEUE_MODULE None Use ``pithos.backends.lib.rabbitmq`` to enable +PITHOS_BACKEND_QUEUE_CONNECTION None Format like ``rabbitmq://guest:guest@localhost:5672/pithos`` +PITHOS_BACKEND_QUOTA 50 GB (50 * 1024 ** 3) Default user quota +PITHOS_BACKEND_VERSIONING auto Default versioning policy for containers +=============================== ================================================ ============================================================ + +Administrator functions +----------------------- + +Available as extensions to Django's command-line management utility: + +============ ====================== +Name Description +============ ====================== +storagequota Get/set a user's quota +============ ====================== + diff --git a/README.upgrade b/snf-pithos-app/README.upgrade similarity index 66% rename from README.upgrade rename to snf-pithos-app/README.upgrade index 896e637..4201c58 100644 --- a/README.upgrade +++ b/snf-pithos-app/README.upgrade @@ -3,47 +3,50 @@ UPGRADE 0.7.9 -> 0.7.10 --------------- -* Update settings.py (BACKEND_*, SERVICE_NAME, *_EMAIL, *_TARGET, IM_*) -* Update 'attributes' table in mysql (backend): +* Update settings.py (BACKEND_*, SERVICE_NAME, \*_EMAIL, \*_TARGET, IM_*) +* Update ``attributes`` table in mysql (backend):: mysql> update attributes set `key`='ETag' where `key`='hash'; -* Upgrade 'im_user' table (im app): +* Upgrade ``im_user`` table (im app):: ALTER TABLE im_user ADD COLUMN 'password' VARCHAR(255); 0.7.10 -> 0.8.0 --------------- -* Upgrade 'public' table in mysql (backend): - * Run: mysqldump pithosdb public > public-table.sql - * mysql> drop table public; - * Update the codebase and run the server so the new public table is created - * From the sql dump above, take the row: - - INSERT INTO `public` VALUES (...); - - Rewrite as: - - INSERT INTO `public`(`path`) VALUES (...); - - And execute in the database +* Upgrade ``public`` table in mysql (backend): + + * Run: mysqldump pithosdb public > public-table.sql + * mysql> drop table public; + * Update the codebase and run the server so the new public table is created + * From the sql dump above, take the row:: + + INSERT INTO `public` VALUES (...); + + Rewrite as:: + + INSERT INTO `public`(`path`) VALUES (...); + + And execute in the database + * Create settings.local with local setting overrides * Install python-django-south -* Setup south: +* Setup south:: + python manage.py syncdb python manage.py migrate im 0001 --fake python manage.py migrate im 0.8.0 -> 0.8.1 -------------- -* Reset 'policy' table in mysql (backend): +* Reset ``policy`` table in mysql (backend):: mysql> update policy set `value`='auto' where `key`='versioning'; 0.8.1 -> 0.8.2 -------------- -* Add the 'X-Forwarded-Protocol' header directive in the apache configuration, as described in the admin guide -* Update 'attributes' table in mysql (backend): +* Add the ``X-Forwarded-Protocol`` header directive in the apache configuration, as described in the admin guide +* Update ``attributes`` table in mysql (backend):: mysql> CREATE TABLE `attributes_new` ( `serial` int(11) NOT NULL, @@ -57,7 +60,7 @@ UPGRADE mysql> drop table attributes; mysql> alter table attributes_new rename to attributes; -* Update 'versions' table in mysql (backend): +* Update ``versions`` table in mysql (backend):: mysql> create temporary table tmp_uuids as select distinct node, uuid() as `uuid` from versions; mysql> alter table versions add column `uuid` varchar(64) DEFAULT '' NOT NULL after `muser`; diff --git a/snf-pithos-backend/COPYRIGHT b/snf-pithos-backend/COPYRIGHT index 6f7fb94..aa12569 100644 --- a/snf-pithos-backend/COPYRIGHT +++ b/snf-pithos-backend/COPYRIGHT @@ -1,4 +1,4 @@ -Copyright 2011 GRNET S.A. All rights reserved. +Copyright 2011-2012 GRNET S.A. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following diff --git a/snf-pithos-backend/README b/snf-pithos-backend/README index 8b13789..9fafe1a 100644 --- a/snf-pithos-backend/README +++ b/snf-pithos-backend/README @@ -1 +1,12 @@ +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 backend +-------------------- + +The backend is the library that handles the actual data storage and metadata management for Pithos. It is required by the Pithos application and can be used by any python script in need of direct access to Pithos storage services. diff --git a/snf-pithos-tools/COPYRIGHT b/snf-pithos-tools/COPYRIGHT index 6f7fb94..aa12569 100644 --- a/snf-pithos-tools/COPYRIGHT +++ b/snf-pithos-tools/COPYRIGHT @@ -1,4 +1,4 @@ -Copyright 2011 GRNET S.A. All rights reserved. +Copyright 2011-2012 GRNET S.A. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following diff --git a/snf-pithos-tools/README b/snf-pithos-tools/README index 8b13789..a11655e 100644 --- a/snf-pithos-tools/README +++ b/snf-pithos-tools/README @@ -1 +1,30 @@ +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 tools +------------------ + +This packange contains the following utilities: + +============== ============================= +pithos-sh Pithos shell +pithos-sync Pithos synchronization client +pithos-fs Pithos FUSE implementation +pithos-test Pithos server tests +============== ============================= + +Also, installs the pithos.tools.lib, which contains a python library that can be used to access Pithos and manage stored objects. All tools use the included lib. + +Connection options can be set via environmental variables: + +====================== ========================================================= +PITHOS_USER Login user +PITHOS_TOKEN Login token +PITHOS_URL Pithos server (default: \https://plus.pithos.grnet.gr/v1) +PITHOS_SYNC_CONTAINER Container to sync with (default: pithos) +====================== ========================================================= -- 1.7.10.4