root / pykota / trunk / NEWS @ 1203

Revision 1203, 22.0 kB (checked in by jalet, 20 years ago)

Job price added to history

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