[753] | 1 | <!-- $Id$ --> |
---|
| 2 | |
---|
| 3 | <chapter> |
---|
[865] | 4 | <title id="repykota">Create print quota usage reports with repykota</title> |
---|
| 5 | <para>Last modified on $Date$</para> |
---|
[836] | 6 | |
---|
[753] | 7 | <para> |
---|
[836] | 8 | To account for print usage is good, however there must be a way to easily |
---|
| 9 | query the <emphasis>Quota Storage Server</emphasis> and generate |
---|
| 10 | reports describing current usage for every user on every printer. |
---|
[753] | 11 | </para> |
---|
[836] | 12 | |
---|
| 13 | <sect1> |
---|
[1101] | 14 | <title>Command line based Print Quota reports</title> |
---|
| 15 | |
---|
[836] | 16 | <para> |
---|
[1101] | 17 | PyKota features a quota report generator, named <application>repykota</application>, |
---|
| 18 | with which you can print the current state of the quota database. |
---|
[836] | 19 | </para> |
---|
[1101] | 20 | |
---|
| 21 | <sect2> |
---|
| 22 | <title>Reference</title> |
---|
| 23 | <para> |
---|
| 24 | <cmdsynopsis> |
---|
| 25 | <command>repykota</command> |
---|
| 26 | <group choice="opt"><arg>-v</arg><arg>--version</arg></group> |
---|
| 27 | <group choice="opt"><arg>-h</arg><arg>--help</arg></group> |
---|
| 28 | <group choice="opt"><arg>-u</arg><arg>--users</arg></group> |
---|
| 29 | <group choice="opt"><arg>-g</arg><arg>--groups</arg></group> |
---|
| 30 | <group choice="opt"> |
---|
| 31 | <arg>-P <replaceable>printername</replaceable></arg> |
---|
| 32 | <arg>--printer <replaceable>printername</replaceable></arg> |
---|
| 33 | </group> |
---|
| 34 | <group choice="opt"> |
---|
| 35 | <arg><replaceable>name1</replaceable></arg> |
---|
| 36 | <arg><replaceable>name2</replaceable></arg> |
---|
| 37 | <arg><replaceable>...</replaceable></arg> |
---|
| 38 | <arg><replaceable>nameN</replaceable></arg> |
---|
| 39 | </group> |
---|
| 40 | </cmdsynopsis> |
---|
| 41 | </para> |
---|
| 42 | </sect2> |
---|
[836] | 43 | </sect1> |
---|
| 44 | |
---|
| 45 | <sect1> |
---|
[1101] | 46 | <title>Web based Print Quota reports</title> |
---|
| 47 | |
---|
[836] | 48 | <para> |
---|
[1101] | 49 | <application>PyKota</application> also features a CGI script to remotely access |
---|
| 50 | to print quota reports with a web browser, it is called <application>printquota.cgi</application> |
---|
| 51 | and you can put it in your web server's <filename>cgi-bin</filename> directory if a web server is installed on |
---|
| 52 | any machine on which <application>PyKota</application> is also installed and configured |
---|
| 53 | correctly. |
---|
[836] | 54 | </para> |
---|
[1101] | 55 | |
---|
| 56 | <para> |
---|
| 57 | You can find <filename>printquota.cgi</filename> in the <filename>pykota/cgi-bin</filename> |
---|
| 58 | directory. Here's how to install it, provided that your web server's <filename>cgi-bin</filename> |
---|
| 59 | directory is <filename>/usr/lib/cgi-bin</filename> : |
---|
| 60 | <screen> |
---|
| 61 | port50-2:/home/jerome/pykota$ cp cgi-bin/printquota.cgi /usr/lib/cgi-bin |
---|
| 62 | port50-2:/home/jerome/pykota$ chmod 755 /usr/lib/cgi-bin/printquota.cgi |
---|
| 63 | </screen> |
---|
| 64 | |
---|
| 65 | <note> |
---|
| 66 | <title>Note</title> |
---|
| 67 | <para> |
---|
| 68 | Please ensure that the user your web server is run as, for example <literal>www-data</literal> under |
---|
| 69 | Debian, is allowed to read <filename>/etc/pykota/pykota.conf</filename> but for security reasons you |
---|
| 70 | must ensure that this user <emphasis>is not</emphasis> allowed to read <filename>/etc/pykota/pykotadmin.conf</filename> |
---|
| 71 | </para> |
---|
| 72 | </note> |
---|
| 73 | </para> |
---|
[836] | 74 | </sect1> |
---|
[753] | 75 | </chapter> |
---|
| 76 | |
---|
| 77 | <!-- |
---|
| 78 | |
---|
| 79 | $Log$ |
---|
[1101] | 80 | Revision 1.5 2003/07/25 13:10:58 jalet |
---|
| 81 | Improved documentation |
---|
| 82 | |
---|
[959] | 83 | Revision 1.4 2003/04/24 21:09:47 jalet |
---|
| 84 | Documentation slightly improved. |
---|
| 85 | |
---|
[865] | 86 | Revision 1.3 2003/03/25 09:32:06 jalet |
---|
| 87 | Improved documentation. |
---|
| 88 | |
---|
[836] | 89 | Revision 1.2 2003/03/08 22:22:40 jalet |
---|
| 90 | First bit of documentation |
---|
| 91 | |
---|
[753] | 92 | Revision 1.1 2003/02/08 00:03:35 jalet |
---|
| 93 | Documentation skeleton added |
---|
| 94 | |
---|
| 95 | |
---|
| 96 | --> |
---|