root / pykota / trunk / NEWS @ 1152

Revision 1152, 19.3 kB (checked in by jalet, 21 years ago)

External policies for printers works !
We can now auto-add users on first print, and do other useful things if needed.

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