root / pykota / trunk / NEWS @ 1197

Revision 1196, 21.3 kB (checked in by jalet, 21 years ago)

Code refactoring work.
Explicit redirection to /dev/null has to be set in external policy now, just
like in external mailto.

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
Line 
1# $Id$
2
3PyKota - Print Quota for CUPS
4
5(c) 2003 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
22PyKota NEWS :
23
24    - 1.16alpha10 :
25       
26        - Some modifications done to external policy handling.
27          See sample configuration file for details.
28   
29        - Spanish translation added.
30       
31    - 1.16alpha9 :
32   
33        - mailto can be set to external(...) to warn users above
34          quota with any command of your choice (e.g. linpopup).
35          Several parameters are available, see sample configuration
36          file for details.
37         
38    - 1.16alpha8 :
39   
40        - Now cupspykota transmits SIGTERMS to the original 
41          backend when the user deletes a job being processed.
42         
43        - The documentation is now licensed under the terms of the
44          GNU GPL too.
45         
46    - 1.16alpha7 :
47   
48        - The CUPS backend is now fully functionnal (it seems).
49       
50        - From now on, the use of the pykota filter with CUPS
51          is deprecated. The pykota filter still has to be
52          used with LPRng though.
53       
54    - 1.16alpha6 :
55   
56        - Bug fixed : when edpykota was used to add a printer
57          with no user or group name, a bad user/group name "*" was
58          added to the database.
59         
60    - 1.16alpha5 :
61   
62        - New CUPS backend supports device enumeration !
63          This means that NO manual CUPS configuration has to
64          be done. All can now be done from CUPS web interface.
65       
66    - 1.16alpha4 :
67   
68        - New CUPS backend added.
69       
70    - 1.16alpha3 :
71       
72        - Minimal FAQ document added.
73       
74    - 1.16alpha2 :
75   
76        - CGI script now partially supports browser's language preference
77       
78    - 1.16alpha1 :
79   
80        - Ensures that the LDAP connection is really closed at end.
81       
82        - More complete error messages in case of LDAP operation failure.
83       
84    - 1.15 :
85     
86        - Documentation improved.
87       
88    - 1.15beta :
89   
90        - Command line tools now accept multiple printer
91          names or wildcards, separated with commas.
92         
93    - 1.15alpha9 :
94   
95        - External policy can be used to auto-add unknown users
96          and any other interesting things you may want to do.
97          WARNING : You can't auto-add printers for now.
98          They have to be created manually before.
99          Look at sample configuration file for examples.
100         
101    - 1.15alpha8 :
102   
103        - Job history can be disabled if needed.
104          This feature may be useful for people who use the LDAP
105          backend and don't want their LDAP tree to grow out of
106          control.
107       
108    - 1.15alpha7 :
109   
110        - More work done on caching wrt groups.
111       
112    - 1.15alpha6 :
113   
114        - Performance bottleneck with LDAP solved.
115       
116    - 1.15alpha5 :
117   
118        - Caching mechanism for all database queries.
119
120    - 1.15alpha4 :
121   
122        - Problem with Python 2.3 fixed. Needs some definitive
123          modification.
124         
125    - 1.15alpha3 :
126   
127        - CGI script now tries to restrict view when the
128          REMOTE_USER environment variable is set. This allows
129          people to protect its use with .htaccess files.
130          When unprotected, or if REMOTE_USER is 'root', then
131          unrestricted access is granted.
132          NB : REMOTE_USER is automatically set by the web server
133          (e.g. Apache) when a page with restricted access is viewed.
134         
135    - 1.15alpha2 :
136   
137        - Better detection of LPRng.
138       
139        - Outputs a warning if printing system is unknown.
140       
141    - 1.15alpha1 :
142   
143        - Bug fix in SQL code.
144       
145    - 1.14 :
146   
147        - The PostgreSQL database connection is now always closed before
148          exit. The LDAP database connection too, but it didn't suffer
149          from the problem anyway, AFAICT.
150       
151    - 1.14beta2 :
152   
153        - An LDAP-specific configuration field was introduced, usermail.
154          Use it to specify which LDAP attribute contains a valid email
155          address for the user. See sample configuration file for
156          details.
157       
158    - 1.14beta :
159   
160        - Two new LDAP-specific configuration fields were introduced,
161          newuser and newgroup. Use them to specify if you want to add
162          quota information to existing entries or elsewhere.
163          See sample configuration file for details.
164         
165    - 1.14alpha9 :
166   
167        - Documentation improved.
168       
169        - pykotme now also prints the user's account balance value
170          if the user is registered in the Quota Storage and his
171          limiting factor is "balance".
172         
173    - 1.14alpha8 :
174   
175        - bin/waitprinter.sh is now included to wait for
176          SNMP enabled printers to be idle again before
177          asking for their internal page counter.
178          See sample configuration file for details.
179         
180    - 1.14alpha7 :
181   
182        - edpykota now doesn't check if the user/group is above
183          quota. The check is only done at print time. This
184          prevents the sending of email messages when creating
185          user quotas if quota is already reached at creation
186          time.
187         
188    - 1.14alpha6 :
189   
190        - Configuration file split and moved to /etc/pykota/pykota.conf
191          and /etc/pykota/pykotadmin.conf to prevent simple users to
192          have Read/Write access to the Quota Database.
193          Don't forget to :
194         
195                $ chmod 640 /etc/pykota/pykotadmin.conf
196               
197        - storageuser and storageuserpw configuration fields reintroduced
198          for the same reason.
199         
200        - Code cleaning for future implementation of email addresses
201          support in the PostgreSQL and LDAP backends.
202         
203    - 1.14alpha5 :
204       
205        - Big bug fixed when changing the prices for a printer
206       
207    - 1.14alpha4 :
208   
209        - When adding an user, the user itself and its account balance
210          are now added in the same LDAP entry. Before they were added
211          as two different LDAP entries.
212         
213    - 1.14alpha3 :
214   
215        - Email field added to PostgreSQL database. An upgrade script
216          is included in initscripts/postgresql.
217       
218    - 1.14alpha2 :
219   
220        - Typo fixed when using the --prototype option to edpykota
221       
222    - 1.14alpha1 :
223   
224        - Poor man's treshold included : users with a low account
225          balance (below 1.0 by default, configurable) are sent
226          a warning message.
227         
228        - All warning messages to users are now configurable. 
229          NB : Warning messages to the administrator are not.
230       
231    - 1.13 :
232   
233        - Some small fixes wrt group handling.
234       
235        - The whole module code was passed through PyChecker and
236          several small code inconsistencies were fixed,
237          as well as a bug in the groups code.
238         
239    - 1.13alpha1 :
240   
241        - Bug fix wrt LDAP.
242       
243    - 1.12 :
244   
245        - More complete test added in edpykota.
246       
247    - 1.12alpha2 :
248   
249        - The previous bug fix was incomplete. This is corrected.
250       
251    - 1.12alpha1 :
252   
253        - Small bug fix.
254       
255    - 1.11 :
256   
257        - Now includes the pykotme command line tool, to produce
258          printing quotes for users.
259         
260    - 1.10 :
261   
262        - Bug fixed wrt quota reports when print limiting is by
263          account balance.
264         
265    - 1.09 :
266   
267        - Translations finalized.
268       
269        - Manpages updated.
270       
271        - Installation documentation improved wrt LDAP support.
272       
273    - 1.09beta2 :
274   
275        - The CGI script for quota reports works again, and
276          is much more powerful.
277       
278    - 1.09beta :
279   
280        - edpykota finalized
281       
282    - 1.09alpha2 :
283   
284        - LDAP schema modified a bit. Please upgrade.
285       
286        - LDAP backend works !
287       
288        - repykota and warnpykota allow the root user to pass
289          users or groups names on the command line. Users
290          and groups names may contain wildcards.
291         
292        - repykota and warnpykota only reports or warns the
293          current user when launched by non-root users.
294         
295        - Minor bug fixes. 
296   
297    - 1.09alpha1 :
298   
299        - More work on LDAP storage backend. Many options
300          were added to /etc/pykota.conf to give some
301          hints to the LDAP storage backend.
302         
303        - Severe database access optimizations were done by
304          rewriting most of the Quota Storage backends drivers.
305     
306    - 1.08 :
307   
308        - Major bug fix wrt LPRng support for remote jobs.
309       
310        - Major bug fix wrt increase/decrease account balances.
311       
312    - 1.08alpha8 :
313   
314        - Code refactoring.
315       
316        - A single user/password pair is used to connect
317          to the database backend. The storageuser configuration
318          field, and its associated passwords storageuserpw, are
319          not used anymore.
320         
321        - You can now set PyKota in debug mode, see sample configuration 
322          file for details.
323          WARNING : only Quota Storage backend queries are logged in
324          debug mode, for now.
325       
326    - 1.08alpha7 :
327   
328        - Very latest LDAP schema.
329       
330        - Code enhancement wrt easy pluggability of PyKota attributes
331          and object classes into an existing LDAP directory.
332       
333    - 1.08alpha6 :
334   
335        - Minor bug corrections
336       
337        - More work on LDAP : new schema
338       
339    - 1.08alpha5 :
340   
341        - More good work on LDAP storage.
342          repykota now works reasonably well with the sample LDAP directory.
343       
344    - 1.08alpha4 :
345   
346        - LDAP schema included.
347          THIS IS JUST FOR PEOPLE TO DISCUSS ABOUT THIS.
348          LDAP SUPPORT DOESN'T WORK YET, AND THE SCHEMA
349          MAY CHANGE IN THE FUTURE. PLEASE TELL US
350          WHAT YOU THINK ABOUT THIS SCHEMA ON THE
351          MAILING LIST.
352         
353    - 1.08alpha3 :
354   
355        - External accounting methods were partly rewritten :
356         
357          - No more "broken pipe" should happen.
358         
359          - They now take care of the number of copies
360            This may be unneeded though, if the postscript
361            file already does this, because this would
362            overcharge users (number of copies counted
363            two times). NEEDS MORE TESTING.
364           
365          - The sample configuration file now contains 
366            an external accounting method example which should
367            work with all DSC compliant Postscript files.
368           
369        - Some small bugs were fixed.   
370       
371    - 1.08alpha2 :
372   
373        - Now works with net-snmp v5.0 and above.
374          It already worked, but the sample configuration
375          file didn't contain appropriate values...
376       
377    - 1.07 : Release of the Shame !
378   
379        - The external accounting methods driver was left out of
380          the CVS tree. Nobody could use it since it wasn't included !
381         
382    - 1.06 :
383   
384        - Severe bug fixed : if you had a printer in
385          power saving state which couldn't answer immediately,
386          a bug was triggered.
387          It was caused by a bad copy/paste which
388          forgot to import a Python module at run time.
389         
390    - 1.05 :
391   
392        - External accounters are finally available !
393          This means that you can plug any page accounting
394          method you like by setting the appropriate
395          'accounter' field in /etc/pykota.conf
396          See the sample conf/pykota.conf.sample to
397          learn how to do.
398         
399          NB : Both 'external' and 'stupid' accounting methods
400               account a job size just before *this* job is
401               sent to the printer.
402               The original 'querying' method accounts a job
403               size just before *the next* job is sent to
404               the printer.
405       
406    - 1.05alpha3 :
407   
408        - A 'stupid' and unreliable accounting method was
409          implemented to serve as an example on how to
410          do this sort of things. This method only counts
411          the 'showpage' statements in the input data.
412          See sample configuration file for details.
413          Pluggable accounting methods work, but I advise
414          you TO NOT USE THIS ONE WHICH IS JUST AN EXAMPLE.
415          It is not reliable enough to be used.
416          Use the 'querying' accounting method instead.
417         
418    - 1.05alpha2 :
419   
420        - Pluggable accounting methods.
421       
422        - Better error handling.
423       
424    - 1.05alpha1 :
425   
426        - SECURITY file added to help improve PyKota's security.
427       
428        - Extracting the printer's internal page counter is now
429          tried several times, waiting several seconds between
430          two tries. This lets the time to warm up for some printers
431          which don't answer when they are sleeping (my Apple
432          LaserWriter 16/600 PS is in this case, maybe others too)
433         
434        - Small display bug fixed in repykota
435         
436    - 1.04 :
437   
438        - Default print policy for users/groups unknown from
439          the print quota system is now DENY instead of ALLOW,
440          since ALLOW can generate inaccurate results
441          (incorrect job sizes charged to the wrong persons)
442         
443        - LPRng support works !
444       
445        - A bug was introduced some time ago wrt printers' default
446          policy for unknown users. It is now corrected.
447       
448        - repykota now displays prices per job and per page for each
449          printer, if they are defined.
450         
451        - Minor display bug fixed in repykota.
452       
453        - Problem when running repykota with an empty database was fixed.
454       
455    - 1.03 :
456   
457        - Upgrade script included for earlier versions.
458          Please look inside the initscripts subdirectory.
459          THE DATABASE SCHEMA HAS CHANGED, PLEASE UPGRADE.
460         
461        - repykota now reports account balances too.
462       
463        - PyKota now has a nice logo, see the logos
464          subdirectory.
465       
466        - Manual pages were finally updated.
467       
468        - Group quotas seem to work now !
469       
470        - The new database schema allows to keep an history of all
471          jobs as well as charge users per page and/or per job,
472          and track users' account balance.
473         
474        - edpykota now accepts much more command line options to 
475          use the new functionnalities. See edpykota --help for
476          details.
477         
478        - The installation script now allows to install the sample
479          configuration file during first installation.
480         
481        - More group quota code works, but still not finished. 
482       
483        - The CGI script displays a link to PyKota's website.
484       
485        - The job history is now kept, this will allow per-period
486          reports in the future.
487         
488        - After having modified the quota for an user with edpykota,
489          a quota check is done to eventually warn the user/admin about
490          a quota which is too low to print.
491         
492        - A workaround is provided for HP Printers : their internal
493          page counter is only saved to NVRAM in a 10 increment, so
494          if you switch them off and then on, the reported page counter
495          may be lower than the real number of pages printed.
496          See http://web.mit.edu/source/third/lprng/doc/LPRng-HOWTO-15.html
497          We unconditionnally set the last job's page count to
498          abs(int((10 - abs(lastcounter(snmp) - lastcounter(storage)) / 2))
499          in this case.
500          For a more accurate accounting, never switch your HP printers
501          off.
502         
503        - A fix is provided for printers which only have a volatile 
504          page counter (reset to 0 every time you switch the printer on)
505          This should allow PyKota to work reasonably fine with HP Laserjet
506          4L/5L/6L, not perfect, but better than nothing.
507          See http://web.mit.edu/source/third/lprng/doc/LPRng-HOWTO-15.html
508          For a more accurate accounting, never switch your HP printers
509          off. This is untested, please report any problem.
510         
511        - A bug was fixed when edpykota --add was used with users who already
512          had a quota on the specified printer.
513         
514        - A small display bug in repykota was introduced in preliminary
515          1.03 versions, and fixed later on.
516         
517        - Some minor bugs which happened in rare situations were fixed.
518       
519        - Support for AppleTalk printers was added, see sample configuration
520          file for details.
521         
522        - Users and group printing can now be controlled (limited) either by 
523          print quota or by account balance.
524       
525    - 1.02 :
526   
527        - The installation script now checks for software availability
528          and in case a software is missing asks the user if he
529          wants to continue with the installation or abort it.
530         
531        - The configuration file pykota.conf is now expected to be
532          found in /etc instead of in /etc/cups
533          The installation script prompts the user to see if he
534          wants to move an old configuration file to the new location
535          if needed.
536         
537        - Improved documentation.
538       
539        - You can now set the tcp/ip port on which the Quota Storage
540          Server is listening, see sample configuration file for details.
541       
542        - Better general error handling.
543       
544        - Upgrade script for pre 1.01 PostgreSQL database schema is now
545          included as well.
546       
547    - 1.01 :
548   
549        - The configuration file now accepts an option   
550          to choose the recipient(s) of the email messages :
551         
552            - DevNull means no one will receive them.
553            - User means only the user will receive them.
554            - Admin means only the admin will receive them.
555            - Both means the User and the Admin will receive them.
556           
557        - The configuration file now uses hard-coded default values
558          when an option is not set. See sample configuration file
559          for details.
560         
561        - Manual pages are included since 1.00, but I forgot to   
562          add this information to this file.
563         
564        - Redistribution terms for the official package have 
565          softened and are now fully GPL compatible :
566          unrestricted modification is now allowed even for
567          the version number.
568         
569    - 1.00 :
570   
571        - edpykota now accepts a --noquota option. This
572          disable quota checking while still doing page
573          accounting. This is really useful for people
574          who don't want to limit their users but want
575          to know how much pages they print.
576         
577        - Some untested scripts were added to retrieve
578          the life time page counter of non-SNMP printers.
579         
580        - Every directory now has a specific README file. 
581       
582    - 0.99 :
583   
584        - Under some circumstances while the user wasn't allowed
585          to print, he didn't receive any email message. It is
586          now fixed.
587         
588        - When an user wasn't allowed to print, the quota for
589          the previous user wasn't updated. This is now fixed.
590         
591    - 0.98 :
592   
593        - Correctly handle the case where the printer is switched off.
594       
595        - Small bug wrt syslog fixed.
596       
597    - 0.97 :
598   
599        - edpykota accepts wildcards on its command line for users/groups too
600          if the --add option is not set, e.g. :
601         
602              $ edpykota --printer lp --softlimit 50 --hardlimit 100 "jer*"
603             
604        - If no user name is passed at all, then a default wildcard of "*"
605          which means apply the command on ALL users for this printer is used.
606         
607        - Small bug fixes.
608       
609    - 0.96 :
610
611        - Options requester, policy, admin, adminmail and gracedelay can now
612          be set either globally or per printer. The printer option has
613          priority if both are defined.
614
615        - More powerful configuration parser.
616       
617        - If all options are defined globally, there's no need to
618          define a section for each printer in the configuration
619          file anymore. Just define a [global] section and it's ok.
620
621    - 0.95 :
622
623        - External requesters for printers finally added.
624
625        - Full internationalization (english and french are supported)
626 
627        - More complete quota usage report
628
629        - CGI script to access to the quota usage report
630
631        - Several bugs fixed.
632
633
634    - 0.9 :
635
636        - First public version
Note: See TracBrowser for help on using the browser.