root / pykoticon / trunk / README @ 71

Revision 71, 3.6 kB (checked in by jerome, 20 years ago)

Completed the installation documentation

  • Property svn:keywords set to Id
Line 
1# $Id$
2
3PyKotIcon - An end user companion to PyKota
4
5(c) 2005 Jerome Alet <alet@librelogiciel.com>
6This program is free software; you can redistribute it and/or modify
7it under the terms of the GNU General Public License as published by
8the Free Software Foundation; either version 2 of the License, or
9(at your option) any later version.
10
11This program is distributed in the hope that it will be useful,
12but WITHOUT ANY WARRANTY; without even the implied warranty of
13MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14GNU General Public License for more details.
15
16You should have received a copy of the GNU General Public License
17along with this program; if not, write to the Free Software
18Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
19
20====================================================================
21
22PyKotIcon is a cross-platform client-side print quota monitor for PyKota.
23
24It is meant to be launched whenever the user logs in, and stay in
25the taskbar (depending on the client operating system) until the
26user closes his session.
27
28It's icon represents a green dollar sign when the user is still allowed
29to print, and a red dollar sign when he is forbidden to print on at
30least one printer.
31
32When the user clicks (or double-clicks, depending on the client operating
33system) on the icon, a table is displayed showing how many pages the
34user has printed on each printer, as well as if he can still print or not,
35and if is PyKota account is limited by a number of credits, the number
36of credits remaining in his account is displayed.
37
38INSTALLATION :
39--------------
40
41  1 - On a web server :
42 
43      The first thing to do is to configure a web server to serve
44      PyKota's dumpykota.cgi CGI script. The best place to do so
45      is on the print server itself, but for performance reasons
46      you may prefer installing it elsewhere.
47     
48      When installing, you have to ensure that the dumpykota.cgi
49      script will be able to read PyKota's configuration and to
50      access to PyKota's database, whatever it is, as a PyKota
51      administrator. Please refer to PyKota's documentaton for
52      details on how to do this.
53     
54      You can protect access to this CGI script with a username
55      and password if you want. Please refer to your web server's
56      documentation for details on how to do this.
57     
58  2 - On each client :
59 
60      Execute (double-click) on PyKotIcon's installation program,
61      and the software will install itself onto the local hard disk.
62     
63      The installation procedure will ask you for the full URL to
64      dumpykota.cgi which should be installed and working on a
65      web server, accessible from the current computer. For example
66      enter :
67     
68        http://printserver.example.com/cgi-bin/dumpykota.cgi
69       
70      Then the insallation procedure will ask you to enter an optional
71      username and password, in the case the access to dumpykota.cgi
72      is protected. Just leave the fields blank if access is unrestricted,
73      else type in the correct username and password.
74     
75  3 - You can now execute the pykoticon software. A good place to put
76      it under MS Windows is in the Startup folder, or in a netlogon
77      script. Under GNU/Linux and similar system, you can put a
78      command line to pykoticon in your ~/.Xsession file or configure
79      your desktop environment to automatically start it when opening
80      the session.
81     
82====================================================================
83   
84Please e-mail bugs to the PyKota mailing list at : pykota@librelogiciel.com
85or to the main author at : alet@librelogiciel.com (Jerome Alet)
Note: See TracBrowser for help on using the browser.