[695] | 1 | # $Id$ |
---|
| 2 | |
---|
[3259] | 3 | PyKota - Print Quotas for CUPS |
---|
[695] | 4 | |
---|
[3561] | 5 | (c) 2003-2013 Jerome Alet <alet@librelogiciel.com> |
---|
[3259] | 6 | This program is free software: you can redistribute it and/or modify |
---|
[873] | 7 | it under the terms of the GNU General Public License as published by |
---|
[3259] | 8 | the Free Software Foundation, either version 3 of the License, or |
---|
[873] | 9 | (at your option) any later version. |
---|
[695] | 10 | |
---|
[873] | 11 | This program is distributed in the hope that it will be useful, |
---|
| 12 | but WITHOUT ANY WARRANTY; without even the implied warranty of |
---|
| 13 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
---|
| 14 | GNU General Public License for more details. |
---|
[695] | 15 | |
---|
[873] | 16 | You should have received a copy of the GNU General Public License |
---|
[3259] | 17 | along with this program. If not, see <http://www.gnu.org/licenses/>. |
---|
[873] | 18 | |
---|
[695] | 19 | ============================================================ |
---|
| 20 | |
---|
| 21 | This directory contains scripts to initialise the PyKota |
---|
| 22 | storage database. Use the one which best suits your need |
---|
[887] | 23 | depending on the storage backend you want to use. |
---|
[695] | 24 | |
---|
[1015] | 25 | There's one subdirectory per backend type supported. |
---|
[887] | 26 | |
---|
| 27 | Files : |
---|
| 28 | ======= |
---|
| 29 | |
---|
[1015] | 30 | * postgresql/pykota-postgresql.sql : |
---|
[3413] | 31 | |
---|
[887] | 32 | This file creates an empty Quota Storage Database, using PostgreSQL |
---|
| 33 | as a backend. You have to use it the first time you install PyKota |
---|
| 34 | if you want to use PostgreSQL as the Quota Storage Backend. |
---|
[3413] | 35 | |
---|
| 36 | * ldap/pykota.schema : |
---|
| 37 | |
---|
[1007] | 38 | This file adds the necessary classes and attributes to an existing |
---|
[3413] | 39 | LDAP directory for use with PyKota. Read this file and the |
---|
[1037] | 40 | associated ldap/README.ldap files for details. |
---|
[3413] | 41 | |
---|
| 42 | |
---|
| 43 | Old files, kept to allow people to upgrade from very old versions of PyKota : |
---|
[1015] | 44 | ============================================================================= |
---|
[3413] | 45 | |
---|
| 46 | * upgrade-to-1.19.sql : |
---|
| 47 | |
---|
[1473] | 48 | This file upgrades the PostgreSQL Quota Storage Database schema |
---|
| 49 | from versions before 1.19alpha7 to version 1.19alpha7 and above. |
---|
| 50 | NEVER USE IT IF YOU ALREADY RUN 1.19alpha7 OR ABOVE ! |
---|
[3413] | 51 | |
---|
| 52 | * upgrade-to-1.16.sql : |
---|
| 53 | |
---|
[1200] | 54 | This file upgrades the PostgreSQL Quota Storage Database schema |
---|
| 55 | from versions before 1.16 to version 1.16. |
---|
| 56 | NEVER USE IT IF YOU ALREADY RUN 1.16 OR ABOVE ! |
---|
[3413] | 57 | |
---|
| 58 | * upgrade-to-1.14.sql : |
---|
| 59 | |
---|
[1200] | 60 | This file upgrades the PostgreSQL Quota Storage Database schema |
---|
| 61 | from versions before 1.14 to version 1.14. |
---|
| 62 | NEVER USE IT IF YOU ALREADY RUN 1.14 OR ABOVE ! |
---|
[3413] | 63 | |
---|
[942] | 64 | * VERYOLDpykota-upgrade-postgresql.sql : |
---|
[3413] | 65 | |
---|
[889] | 66 | This file upgrades the PostgreSQL Quota Storage Database schema |
---|
[887] | 67 | from versions before 1.01 to version 1.01. |
---|
[3413] | 68 | |
---|
[951] | 69 | IT'S THERE FOR HISTORICAL REASONS ONLY : DON'T USE IT, USE |
---|
| 70 | THE SCRIPT DESCRIBED BELOW INSTEAD ! |
---|
[3413] | 71 | |
---|
[942] | 72 | * upgrade-from-before-1.03.py : |
---|
[3413] | 73 | |
---|
[887] | 74 | This shell script upgrades the PostgreSQL Quota Storage Database schema |
---|
| 75 | from versions 1.01 or 1.02 to version 1.03. |
---|
| 76 | PLEASE DO A BACKUP OF YOUR PYKOTA DATABASE BEFORE RUNNING THIS SCRIPT ! |
---|
| 77 | Also this script will try to connect to PostgreSQL as the postgres user |
---|
[3413] | 78 | (i.e. PostgreSQL's administrator), on the local machine (PyKota Storage |
---|
| 79 | Server), without prompting for a password. Please read this script and |
---|
[887] | 80 | adapt it to your own configuration before running it. THIS IS IMPORTANT. |
---|
[3413] | 81 | |
---|
| 82 | THIS SCRIPT MAKES ANY REASONABLE CHECK TO ENSURE THAT YOUR DATAS WON'T |
---|
[942] | 83 | BE LOST, AND ALSO DUMPS YOUR OLD DATABASE TO A TEXT FILE BEFORE DOING |
---|
| 84 | ANYTHING. IT WAS TESTED SEVERAL TIMES AND SHOULDN'T PRODUCE ANY ERROR |
---|
[3413] | 85 | EXCEPT ABOUT THE pykotaadmin and pykotauser POSTGRESQL USERS WHO |
---|
[942] | 86 | ALREADY EXIST WHEN THE DATABASE SCHEMA IS UPGRADED. THIS IS NORMAL ! |
---|