[753] | 1 | <!-- $Id$ --> |
---|
| 2 | |
---|
| 3 | <chapter> |
---|
[2237] | 4 | <title id="edpykota">Manage the Print Quota DataBase with edpykota</title> |
---|
[865] | 5 | <para>Last modified on $Date$</para> |
---|
| 6 | |
---|
[753] | 7 | <para> |
---|
[2237] | 8 | <command>edpykota</command> is the main command line tool with which you will |
---|
[959] | 9 | maintain your print quota database. |
---|
[753] | 10 | </para> |
---|
[959] | 11 | |
---|
| 12 | <para> |
---|
[2237] | 13 | You'll use this tool to create, manage or delete print quota entries for users |
---|
| 14 | or users groups on printers or printers groups. |
---|
| 15 | </para> |
---|
| 16 | |
---|
| 17 | <para> |
---|
| 18 | By default, before being allowed to print through <application>PyKota</application>, |
---|
| 19 | an user must exist in the database and have a print quota entry on every printer |
---|
| 20 | he should be allowed to use. The simplest way to add an user named <literal>jerome</literal> to the database is |
---|
| 21 | to type : |
---|
| 22 | <screen> |
---|
| 23 | $ edpykota --add --noquota jerome |
---|
| 24 | </screen> |
---|
| 25 | </para> |
---|
| 26 | |
---|
| 27 | <para> |
---|
| 28 | The command above has created user <literal>jerome</literal> in the database, and has automatically |
---|
| 29 | created print quota entries with no limit for this user on all existing printers. This means |
---|
| 30 | that user <literal>jerome</literal> is allowed to print without limitation, but that full accounting |
---|
| 31 | will still be done for this user : you'll know whenever he prints and how much. |
---|
| 32 | </para> |
---|
| 33 | |
---|
| 34 | <para> |
---|
| 35 | You can apply two sorts of print quotas to users : page quotas, and account balance quotas. |
---|
| 36 | <itemizedlist> |
---|
| 37 | <listitem> |
---|
| 38 | <para> |
---|
| 39 | Page quotas are defined for each user on each printer. This means that an user can be |
---|
| 40 | limited to print more than 20 pages on printer <literal>HP2100</literal> while still |
---|
| 41 | being allowed to print 500 pages on printer <literal>TekTro</literal>. |
---|
| 42 | </para> |
---|
| 43 | </listitem> |
---|
| 44 | <listitem> |
---|
| 45 | <para> |
---|
| 46 | Account balance quotas are defined once for each user. You give a number of credits |
---|
| 47 | to an user, and whenever he prints on any printer, his number of credits diminishes |
---|
| 48 | by the cost of the current print job, until his balance reaches 0. |
---|
| 49 | In other terms, while page quotas are specific to a particular printer for a particular |
---|
| 50 | user, account balance quotas are shared between all printers for a particular user. |
---|
| 51 | </para> |
---|
| 52 | </listitem> |
---|
| 53 | </itemizedlist> |
---|
| 54 | This means that you have to choose which type of quota you want for each user. |
---|
| 55 | The default mode is page quotas, but if you pass <literal>--limitby balance</literal> |
---|
| 56 | as command line options to <command>edpykota</command>, the users onto which the command |
---|
| 57 | will apply will be limited by the value of their account instead of by a number of |
---|
| 58 | pages. |
---|
| 59 | </para> |
---|
| 60 | |
---|
| 61 | <para> |
---|
[2452] | 62 | In addition to <literal>balance</literal> and <literal>quota</literal>, several other values |
---|
| 63 | are allowed for the <literal>--limitby</literal> command line option : |
---|
| 64 | <itemizedlist> |
---|
| 65 | <listitem> |
---|
| 66 | <para> |
---|
| 67 | <literal>noquota</literal> : the user or group can print without any limitation, but |
---|
| 68 | accounting continues to be done. |
---|
| 69 | </para> |
---|
| 70 | </listitem> |
---|
| 71 | <listitem> |
---|
| 72 | <para> |
---|
| 73 | <literal>nochange</literal> : the user can print without any limitation, but |
---|
| 74 | accounting is not done. |
---|
| 75 | This value is not supported for users groups. |
---|
| 76 | </para> |
---|
| 77 | </listitem> |
---|
| 78 | <listitem> |
---|
| 79 | <para> |
---|
| 80 | <literal>noprint</literal> : the user can not print. |
---|
| 81 | This value is not supported for users groups. |
---|
| 82 | </para> |
---|
| 83 | </listitem> |
---|
| 84 | </itemizedlist> |
---|
| 85 | </para> |
---|
| 86 | |
---|
| 87 | <para> |
---|
[2118] | 88 | Here's an incomplete list of features : |
---|
[959] | 89 | |
---|
| 90 | <itemizedlist> |
---|
| 91 | <listitem> |
---|
| 92 | <para> |
---|
[2115] | 93 | Add printers (it's preferable to use the <command>pkprinters</command> command for this though) ; |
---|
[959] | 94 | </para> |
---|
| 95 | </listitem> |
---|
| 96 | <listitem> |
---|
| 97 | <para> |
---|
| 98 | Add and delete users and groups ; |
---|
| 99 | </para> |
---|
| 100 | </listitem> |
---|
| 101 | <listitem> |
---|
| 102 | <para> |
---|
| 103 | Set users' account balances ; |
---|
| 104 | </para> |
---|
| 105 | </listitem> |
---|
| 106 | <listitem> |
---|
| 107 | <para> |
---|
| 108 | Set users and groups print quotas on printers, eventually by using another user |
---|
| 109 | or group as a template ; |
---|
| 110 | </para> |
---|
| 111 | </listitem> |
---|
| 112 | <listitem> |
---|
| 113 | <para> |
---|
[2118] | 114 | Set price per page and price per job for printers (it's preferable to use the <command>pkprinters</command> command for this though) ; |
---|
[959] | 115 | </para> |
---|
| 116 | </listitem> |
---|
| 117 | <listitem> |
---|
| 118 | <para> |
---|
[1168] | 119 | Switch users or groups to or from <quote>account only</quote> mode (no quota enforcement) ; |
---|
[959] | 120 | </para> |
---|
| 121 | </listitem> |
---|
| 122 | <listitem> |
---|
| 123 | <para> |
---|
| 124 | Define hard and soft limits for users ou groups quotas, on a per printer basis ; |
---|
| 125 | </para> |
---|
| 126 | </listitem> |
---|
| 127 | <listitem> |
---|
| 128 | <para> |
---|
[2452] | 129 | Choose the way you will limit printing ; |
---|
[959] | 130 | </para> |
---|
| 131 | </listitem> |
---|
[1755] | 132 | <listitem> |
---|
| 133 | <para> |
---|
[2452] | 134 | Reset page counters ; |
---|
[1755] | 135 | </para> |
---|
| 136 | </listitem> |
---|
[2118] | 137 | <listitem> |
---|
| 138 | <para> |
---|
| 139 | Etc... |
---|
| 140 | </para> |
---|
| 141 | </listitem> |
---|
[959] | 142 | </itemizedlist> |
---|
| 143 | </para> |
---|
| 144 | |
---|
[2237] | 145 | <para> |
---|
| 146 | For more details on the use of <command>edpykota</command>, please see this command's manual |
---|
| 147 | page or help. |
---|
| 148 | </para> |
---|
| 149 | |
---|
[753] | 150 | </chapter> |
---|
| 151 | |
---|