| 1 | # $Id$ |
|---|
| 2 | |
|---|
| 3 | PyKota - Print Quotas for CUPS |
|---|
| 4 | |
|---|
| 5 | (c) 2003-2009 Jerome Alet <alet@librelogiciel.com> |
|---|
| 6 | This program is free software: you can redistribute it and/or modify |
|---|
| 7 | it under the terms of the GNU General Public License as published by |
|---|
| 8 | the Free Software Foundation, either version 3 of the License, or |
|---|
| 9 | (at your option) any later version. |
|---|
| 10 | |
|---|
| 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. |
|---|
| 15 | |
|---|
| 16 | You should have received a copy of the GNU General Public License |
|---|
| 17 | along with this program. If not, see <http://www.gnu.org/licenses/>. |
|---|
| 18 | |
|---|
| 19 | ============================================================ |
|---|
| 20 | |
|---|
| 21 | Documentation for the pykota-mysql.sql script : |
|---|
| 22 | ----------------------------------------------- |
|---|
| 23 | |
|---|
| 24 | This script is to be used to create an empty Quota Storage |
|---|
| 25 | DataBase using MySQL as a backend. |
|---|
| 26 | |
|---|
| 27 | - edit the pykota-mysql.sql file and modify the passwords at |
|---|
| 28 | the end of the 'GRANT USAGE' lines. |
|---|
| 29 | |
|---|
| 30 | - As MySQL's administrative user, usually root, |
|---|
| 31 | do the following : |
|---|
| 32 | |
|---|
| 33 | # mysql <pykota-mysql.sql |
|---|
| 34 | |
|---|
| 35 | - If no error message appear, your MySQL PyKota storage |
|---|
| 36 | is now ready for use. |
|---|
| 37 | |
|---|
| 38 | - In ~pykota/pykota.conf, ensure that the following lines |
|---|
| 39 | are present and unique inside the [global] section : |
|---|
| 40 | |
|---|
| 41 | storagebackend : mysqlstorage |
|---|
| 42 | storageserver : localhost |
|---|
| 43 | storagename : pykota |
|---|
| 44 | storageuser : pykotauser |
|---|
| 45 | storageuserpw : readonlypw |
|---|
| 46 | |
|---|
| 47 | NB : replace 'readonlypw' with the password you chose |
|---|
| 48 | for user 'pykotauser' when you modified pykota-mysql.sql |
|---|
| 49 | |
|---|
| 50 | - In ~pykota/pykotadmin.conf ensure that the following lines |
|---|
| 51 | are present and unique inside the [global] section : |
|---|
| 52 | |
|---|
| 53 | storageadmin : pykotaadmin |
|---|
| 54 | storageadminpw : readwritepw |
|---|
| 55 | |
|---|
| 56 | NB : replace 'readwritepw' with the password you chose |
|---|
| 57 | for user 'pykotaadmin' when you modified pykota-mysql.sql |
|---|
| 58 | |
|---|
| 59 | - IMPORTANT : if your database is not located on the print server, |
|---|
| 60 | replace 'localhost' in the lines above with your database server's |
|---|
| 61 | hostname or IP address. If your database server doesn't listen on |
|---|
| 62 | its standard port, add the port number at the end of the hostname |
|---|
| 63 | with a colon to separate the hostname from the port. |
|---|
| 64 | See pykota/conf/pykota.conf.sample for examples. |
|---|
| 65 | |
|---|
| 66 | ============================================================ |
|---|
