root / pykota / trunk / docs / repykota.sgml @ 1117

<!-- $Id$ -->

<chapter>
  <title id="repykota">Create print quota usage reports with repykota</title>
  <para>Last modified on $Date$</para>
  
  <para>
    To account for print usage is good, however there must be a way to easily
    query the <emphasis>Quota Storage Server</emphasis> and generate
    reports describing current usage for every user on every printer.
  </para>
  
  <sect1>
    <title>Command line based Print Quota reports</title>
    
    <para>
      PyKota features a quota report generator, named <application>repykota</application>,
      with which you can print the current state of the quota database.
    </para>
  
    <sect2>
      <title>Reference</title>
      <para>
        <cmdsynopsis>
          <command>repykota</command>
          <group choice="opt"><arg>-v</arg><arg>--version</arg></group>
          <group choice="opt"><arg>-h</arg><arg>--help</arg></group>
          <group choice="opt"><arg>-u</arg><arg>--users</arg></group>
          <group choice="opt"><arg>-g</arg><arg>--groups</arg></group>
          <group choice="opt">
            <arg>-P <replaceable>printername</replaceable></arg>
            <arg>--printer <replaceable>printername</replaceable></arg>
          </group>  
          <group choice="opt">
            <arg><replaceable>name1</replaceable></arg>
            <arg><replaceable>name2</replaceable></arg>
            <arg><replaceable>...</replaceable></arg>
            <arg><replaceable>nameN</replaceable></arg>
          </group>  
        </cmdsynopsis>
      </para>
    </sect2>
  </sect1>
  
  <sect1>
    <title>Web based Print Quota reports</title>
    
    <para>
      <application>PyKota</application> also features a CGI script to remotely access
      to print quota reports with a web browser, it is called <application>printquota.cgi</application>
      and you can put it in your web server's <filename>cgi-bin</filename> directory if a web server is installed on
      any machine on which <application>PyKota</application> is also installed and configured
      correctly.
    </para>
    
    <para>
      You can find <filename>printquota.cgi</filename> in the <filename>pykota/cgi-bin</filename>
      directory. Here's how to install it, provided that your web server's <filename>cgi-bin</filename>
      directory is <filename>/usr/lib/cgi-bin</filename> :
<screen>      
port50-2:/home/jerome/pykota$ cp cgi-bin/printquota.cgi /usr/lib/cgi-bin
port50-2:/home/jerome/pykota$ chmod 755 /usr/lib/cgi-bin/printquota.cgi
</screen>

      <note>
        <title>Note</title>
        <para>
          Please ensure that the user your web server is run as, for example <literal>www-data</literal> under
          Debian, is allowed to read <filename>/etc/pykota/pykota.conf</filename> but for security reasons you
          must ensure that this user <emphasis>is not</emphasis> allowed to read <filename>/etc/pykota/pykotadmin.conf</filename>
        </para>
      </note>  
    </para>
  </sect1>
</chapter>

<!--

$Log$
Revision 1.5  2003/07/25 13:10:58  jalet
Improved documentation

Revision 1.4  2003/04/24 21:09:47  jalet
Documentation slightly improved.

Revision 1.3  2003/03/25 09:32:06  jalet
Improved documentation.

Revision 1.2  2003/03/08 22:22:40  jalet
First bit of documentation

Revision 1.1  2003/02/08 00:03:35  jalet
Documentation skeleton added


-->