Context Navigation

NEWS @ 3504

Revision 2872, 77.6 kB (checked in by jerome, 18 years ago)
v1.24HotFix1 now in svn.
Property svn:eol-style set to `native` Property svn:keywords set to `Author Date Id Revision`

Line
1	# $Id$
2
3	PyKota - Print Quotas for CUPS and LPRng
4
5	(c) 2003, 2004, 2005, 2006 Jerome Alet <alet@librelogiciel.com>
6	This program is free software; you can redistribute it and/or modify
7	it under the terms of the GNU General Public License as published by
8	the Free Software Foundation; either version 2 of the License, or
9	(at your option) any later version.
10
11	This program is distributed in the hope that it will be useful,
12	but WITHOUT ANY WARRANTY; without even the implied warranty of
13	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14	GNU General Public License for more details.
15
16	You should have received a copy of the GNU General Public License
17	along with this program; if not, write to the Free Software
18	Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
19
20	============================================================
21
22	PyKota NEWS :
23
24	- 1.24HotFix1 (2006-04-17) :
25
26	- Several fixes for database related problems.
27
28	- 1.24 (2006-04-08) :
29
30	- Improved documentation and packaging stuff.
31
32	- 1.24beta (2006-03-26) :
33
34	- Finalized the pknotify command.
35
36	- Updated the messages catalogs for translations.
37
38	- 1.24alpha18 (2006-03-15) :
39
40	- Now uses MIME encapsulation for email messages to avoid
41	some problems with 8 bits messages being rejected.
42
43	- 1.24alpha17 (2006-03-06) :
44
45	- Fixed a major problem in the PostgreSQL backend.
46
47	- pknotify can now check a remote user's name and password.
48
49	- 1.24alpha16 (2006-03-02) :
50
51	- Introduced the pknotify command line tool to dialog
52	with remote PyKotIcon applications.
53
54	- 1.24alpha15 (2006-03-02) :
55
56	- optimized pkbcodes, pkprinters and pkusers using edpykota as
57	the model.
58
59	- 'edpykota --list' and 'pkusers --list' are now authorized
60	to mere mortal users, but the list is restricted to informations
61	about the current user.
62
63	- Extended the functionnality of the 'onbackenderror' directive to
64	allow for configurable retries.
65
66	- 1.24alpha14 :
67
68	- Finished optimizations in edpykota and fixed some minor
69	problems with LDAP.
70
71	- 1.24alpha13 :
72
73	- Introduced the pkusers command line tool to manage users and
74	users groups. This command doesn't deal with print quota entries,
75	which continue to be managed through the edpykota command line
76	tool.
77
78	- Major rewrite and incompatible changes to command line options
79	in edpykota. This command now only deals with print quota
80	entries. Printers, users (or users groups) now have to be created
81	first using pkprinters or pkusers.
82
83	- 1.24alpha12 :
84
85	- Introduced the 'duplicatesdelay' directive to specify after
86	which duration two duplicate jobs are not considered duplicate
87	jobs anymore.
88
89	- Introduced the 'balancezero' directive to specify any value
90	as the balance limit instead of 0.0. This can allow admins to
91	give a few free credits to users, for example.
92
93	- 1.24alpha11 :
94
95	- Huge speed improvements when modifying billing codes and
96	printers.
97
98	- Both pkbcodes and pkprinters now display the percent done
99	for all actions.
100
101	- The pkinvoice invoice generator command line utility is now
102	included.
103
104	- 1.24alpha10 :
105
106	- Huge speed improvements when deleting users, printers, and
107	billing codes.
108
109	- 1.24alpha9 :
110
111	- Preliminary support for MySQL, thanks to Matt Hyclak.
112
113	- 1.24alpha8 :
114
115	- The 'preaccounter' configuration directive was introduced to control
116	which parser to use for precomputation of the job's size. When unset,
117	the internal parser is used just like it was previously. See
118	conf/pykota.conf.sample for more details.
119
120	- Now subprocesses launched through the overwrite_jobticket directive
121	can also output 'CANCEL', to represent the user's own choice to
122	cancel the print job.
123
124	- 1.24alpha7 :
125
126	- pkbanner now handles new print limiting modes correctly.
127
128	- The cupspykota backend wrapper now accepts to be interrupted
129	with a kill -INT. This causes an immediate and clean abort
130	of the current print job.
131
132	- Matt Hyclak contributed the possibility to store the printing
133	history in a MySQL database. See the contributed/ directory
134	for details.
135
136	- Added 2006 to the copyright's years.
137
138	- 1.24alpha6 :
139
140	- Fixed internal SNMP and PJL handling code for very fast
141	printers : PyKota didn't see them going from 'idle'
142	to 'printing' to 'idle' again.
143
144	- Now waitprinter.sh accepts SNMP version number and
145	community name as arguments, thanks to Brandon
146	Holbrook.
147
148	- Now command line errors and Ctrl+C repectively cause
149	PyKota commands to exit with status -2 and -3.
150
151	- 1.24alpha5 :
152
153	- All command line tools now accept -A \| --arguments filename.args
154	as a way to bypass the shell's maximal command line size :
155	just put each argument on a line by itself in a file, and
156	pass the file's name as the -A \| --arguments command line
157	option's argument. For now this won't be documented in
158	commands' helps.
159
160	- dumpykota can now dump the complete database in XML
161	format.
162
163	- 1.24alpha4 :
164
165	- Added support for the SQLite3 backend.
166	See pykota/initscripts/sqlite/README.sqlite
167
168	- 1.24alpha3 :
169
170	- Fix for mailandpopup.sh : smbstatus can't be run setuid,
171	so we regain priviledges before running an external
172	mailto directive.
173
174	- 1.24alpha2 :
175
176	- Introduce the "onbackenderror" directive in pykota.conf, to
177	control if the user must be charged or not whenever a real
178	CUPS backend fails. The default value is 'nocharge'.
179	Set it to 'charge' if you think your users can cause a CUPS
180	backend to fail.
181
182	- Now mark original backends related problems as such in the
183	printing history. Modified printquota.cgi and pykota.css
184	to make them be more visible.
185
186	- 1.24alpha1 :
187
188	- Fixed a problem which caused backend errors to be ignored.
189
190	- The sample LDIF file now contains the two necessary user
191	entries to have an LDAP PyKota Admin and an LDAP PyKota
192	ReadOnly user. The sample configuration files were updated
193	to contain the default passwords used in the LDIF file.
194
195	- dumpykota is now more strict when checking arguments.
196
197	- 1.23 :
198
199	- Many minor bug fixes and code cleaning.
200
201	- Improved documentation.
202
203	- Added Polish translation.
204
205	- Improved French and Swedish translations.
206
207	- 1.23beta :
208
209	- Now the mailto directive is honored in all cases where the job is
210	denied or a warning has to be issued, and the correct reason
211	can be sent back to the user.
212
213	- The PYKOTAREASON environment variable, if defined, contains the
214	textual reason why the job was denied or a warning has to be
215	issued.
216
217	- 1.23alpha31 :
218
219	- Added support for --maxjobsize, --passthrough and --nopassthrough
220	in pkprinters. These modes are now also honored when printing.
221
222	- Allows the admin to restrict the number of print queues which will
223	be treated by pkturnkey by passing queues' names as additionnal
224	arguments on pkturnkey's command line.
225
226	- pkturnkey now supersedes pkhint with the help of the -c \| --doconf
227	command line option.
228
229	- 1.23alpha30 :
230
231	- Database changes : you MUST use upgrade-to-1.23.sql again if you
232	use PostgreSQL, or copy the new schema and restart your LDAP
233	server if you use LDAP.
234
235	- The -C \| --comment command line switch was added to edpykota to
236	attach textual information to modifications done to a user's
237	account balance.
238
239	- The -l \| --limitby command line switch to edpykota was modified
240	to allow 'noquota', 'nochange', and 'noprint'. See the edpykota
241	command's help or manual page for details.
242
243	- The -i \| --ingroups command line switch to repykota allows
244	PyKota Administrators to only lists members of the specified
245	group or groups (separated with commas).
246
247	- The -I \| --increase command line switch to edpykota allows
248	to increase or decrease page limits.
249
250	- Added the precomputed job's size and price to the history
251	for controlling purpose.
252
253	- 1.23alpha29 :
254
255	- Fixed a small problem with billing codes.
256
257	- Exports some environment variables earlier, to render the script
258	launched by the overwrite_jobticket directive more powerful.
259
260	- Now autopykota also creates print quota entries for the user on the
261	printers groups the current printer is a member of.
262
263	- 1.23alpha28 :
264
265	- Added users groups management to pkturnkey.
266
267	- Fixed umask in setup script.
268
269	- 1.23alpha27 :
270
271	- Replaced the --dryrun command line option by the --force
272	command line option in pkturnkey, with exactly the opposite
273	effect (for security reasons).
274
275	- 1.23alpha26 :
276
277	- Allows parametrized pjl and snmp hardware accounting methods,
278	to be able to respectively set the TCP port and the SNMP
279	community.
280
281	- 1.23alpha25 :
282
283	- Added a --dryrun command line switch to pkturnkey.
284
285	- Improved pkturnkey's general usability.
286
287	- Added a manpage for pkturnkey.
288
289	- 1.23alpha24 :
290
291	- Allows different databases to be used depending on the
292	user's rights. This allows PyKota admins to directly
293	use a master LDAP server for read+write, while letting
294	normal users using the replicas for readonly access.
295	NB : using different storage backends is also possible,
296	but you're on your own there.
297
298	- 1.23alpha23 :
299
300	- Fixed a problem with banner accounting.
301
302	- Introduction of the new 'pkturnkey' command line tool.
303
304	- 1.23alpha22 :
305
306	- The cupspykota backend was almost entirely rewritten from scratch.
307	It's now much more readable, maintainable, etc...
308
309	- LPRng support is OFFICIALLY dropped for now. LPRng users are
310	advised to download earlier releases or purchase the
311	PyKota v1.22HotFix1 Official release. LPRng support
312	MIGHT be re-added later.
313
314	- 1.23alpha21 :
315
316	- Fix for IPP requests which contain more than a single
317	job-originating-host-name attribute.
318
319	- 1.23alpha20 :
320
321	- Added the overwrite_jobticket directive. See pykota.conf.sample
322	for how to use it.
323
324	- 1.23alpha19 :
325
326	- Fixed an LDAP filtering problem when managing billing codes.
327
328	- Added the unknown_billingcode directive. See pykota.conf.sample
329	for how to use it.
330
331	- 1.23alpha18 :
332
333	- Added the dump_bfd.php contribution.
334
335	- Several fixes in the internal PJL accounter.
336
337	- Now autopykota doesn't create unneeded print quota entries anymore.
338
339	- Increased the timeout in the PJL hardware accounting code to
340	accomodate some printers (HP5000 at least).
341
342	- 1.23alpha17 :
343
344	- pkpgcounter is now distributed separately only. This
345	means that people must now download and install pkpgcounter
346	v1.56 or higher prior to being able to run PyKota.
347
348	- Removed all the autoconf/automake stuff which was outdated
349	and confusing.
350
351	- 1.23alpha16 :
352
353	- Extracted the GPL blurb from all commands' help, and use
354	a static version only once. This saves space big time, and
355	eases future translations.
356
357	- 1.23alpha15 :
358
359	- pkbcodes now works with the PostgreSQL backend.
360	NB : PLEASE RUN upgrade-to-1.23.sql AGAIN !!!
361
362	- 1.23alpha14 :
363
364	- Logs a warning when the user/group doesn't exist when running
365	edpykota.
366
367	- 1.23alpha13 :
368
369	- Minor fix for user groups because of latest database changes.
370
371	- 1.23alpha12 :
372
373	- Big database changes, use the migration scripts !
374
375	- 1.23alpha11 :
376
377	- Small fix to the PCL3/4/5 parser for some drivers.
378
379	- 1.23alpha10 :
380
381	- Fixed a bad exception name in cupspykota when parsing IPP messages.
382
383	- Improved the IPP messages module : it can now generate IPP messages
384	in addition to parsing them.
385
386	- 1.23alpha9 :
387
388	- The denyduplicates directive now accepts a command line as an
389	argument beside yes/no. The command is launched and must
390	print either ALLOW or DENY to its standard output. Then the
391	job gets allowed or denied by PyKota.
392	This will allow user interaction in the near future.
393
394	- Introduced the new 'striptitle' directive to remove ugly prefixes
395	from print job's titles whenever a new print job is submitted.
396
397	- Fixed internal SNMP accounter for printers which only have a life time
398	page counter, and not a volatile page counter.
399
400	- 1.23alpha8 :
401
402	- The data dumper can now summarize payments and history with the
403	help of the --sum command line option (or checkbox in the CGI).
404
405	- The message used when the job's filename, title and options are
406	hidden because of the privacy directive is now translated at
407	retrieval time, instead of at saving time.
408
409	- Minor fix in the LDAP backend code.
410
411	- 1.23alpha7 :
412
413	- Improvements to the internal PJL and SNMP accounter : now should
414	support more printers and waste less time.
415
416	- 1.23alpha6 :
417
418	- The data dumper's start= and end= date filtering options now
419	accept a positive or negative offset to be added to the special
420	keywords 'yesterday', 'today', 'now', 'tomorrow'.
421	e.g. : dumpykota --data history start=yesterday-5 end=today
422
423	- 1.23alpha5 :
424
425	- The data dumper's start= and end= date filtering options now accept
426	the special keywords 'yesterday', 'today', 'now' and 'tomorrow'.
427
428	- 1.23alpha4 :
429
430	- The data dumper now accept start= and end= to specify the starting
431	and ending dates to dump the history.
432
433	- 1.23alpha3 :
434
435	- The destination link for the logo used in CGI scripts is
436	configurable.
437
438	- Data dumper improved : it's faster and now datas are correctly
439	escaped.
440
441	- The URL to the logo displayed in the CGI scripts is configurable.
442
443	- 1.23alpha2 :
444
445	- Fixed edpykota --prototype with balance.
446
447	- Major rewrite of the IPP message parsing code to definitely
448	fix the job-originating-hostname IPP attribute problem.
449
450	- 1.23alpha1 :
451
452	- Sets current username to the user CUPS runs as instead of "root"
453	when printing test pages from CUPS' web interface (because
454	the username is empty in this case).
455
456	- Fix for strange values in job-originating-hostname
457
458	- 1.22 :
459
460	- Big improvements to the documentation.
461
462	- 1.22beta :
463
464	- Improved stability in pykotme and pykotme.cgi.
465
466	- Fixed a permission problem in pykotme and pykosd.
467
468	- Fixed an inconsitency between SQL and LDAP backends'
469	behavior in edpykota.
470
471	- Improved stability and allowed tracebacks in CGI scripts.
472
473	- Improved pykotme.cgi
474
475	- 1.22alpha8 :
476
477	- Fixed history retrieval for nonexisting printers or users.
478
479	- Clicking on the billing code in printquota.cgi's job history
480	now shows all jobs matching this billing code.
481
482	- Fixed the dump in CUPS' page_log format which didn't
483	dump the oldest entry.
484
485	- The data dumper now accepts billingcode= and hostname= as
486	filters when dumping the job history.
487
488	- The job billing code if present is now saved into the database,
489	and exported to subprocesses as the PYKOTAJOBBILLING environment
490	variable.
491
492	- Ctrl+C now makes PyKota commands exit without a traceback.
493
494	- Fixed an i18n problem with Python 2.1
495
496	- 1.22alpha7 :
497
498	- Fixed some problems with the retrieval of the history from LDAP.
499
500	- 1.22alpha6 :
501
502	- Early errors now produce meaningful error messages (finally !)
503
504	- 1.22alpha5 :
505
506	- SNMP and PJL improvements with regard to PowerSave / StandBy.
507
508	- 1.22alpha4 :
509
510	- Fixed charset problem under MacOSX.
511
512	- Allows pkbanner to accept more info to display on its
513	command line.
514
515	- 1.22alpha3 :
516
517	- Fixes some case related problems with some LDAP backends.
518
519	- Fixes some problem for printers which directly go from
520	"idle" to "warmup" and never to "printing" before
521	returning to "idle".
522
523	- Some permissions settings may have prevented cupspykota
524	from parsing cupsd.conf, this is now fixed.
525
526	- 1.22alpha2 :
527
528	- Introduction of the web enabled print quote generator.
529
530	- Fixed a potential race condition when several backend
531	wrappers were present in CUPS' backend directory.
532
533	- Fixed dumpykota's output in CUPS' page_log format to better
534	match CUPS format.
535
536	- 1.22alpha1 :
537
538	- Import into Subversion.
539
540	- 1.21 :
541
542	- Improved documentation.
543
544	- Improved dependencies checker.
545
546	- Updated some translation files.
547
548	- 1.21beta2 :
549
550	- Fixed an LPRng specific bug.
551
552	- Several improvements on stability issues with manually modified
553	LDAP trees.
554
555	- Documentation improvements.
556
557	- 1.21beta :
558
559	- Prepared translation files for next release.
560
561	- 1.21alpha27 :
562
563	- Allows software() (no arguments) to the software accounting
564	directive. This saves a lot of CPU since the job is not
565	parsed again : the precomputed size is used directly in this
566	case.
567
568	- epykota's --prototype option now works fine with accounts
569	limited by balance.
570
571	- 1.21alpha26 :
572
573	- Fixed the handling of the 'maxdenybanners' directive.
574
575	- Introduced the 'denyduplicates' directive.
576
577	- Fixed some database related glitches.
578
579	- 1.21alpha25 :
580
581	- The job's size is now always precomputed, even when
582	'enforcement' is not set to 'strict'.
583
584	- Introduction of the new 'trustjobsize' configuration directive
585	to workaround some problematic printers. See the sample
586	configuration file for details.
587
588	- 1.21alpha24 :
589
590	- Big database structure changes. An upgrade script
591	is now included for PostgreSQL. LDAP users may just
592	want to copy the new schema in place.
593
594	- edpykota now recognizes the -o \| --overcharge command line
595	option to set an overcharging or undercharging factor
596	on each print job's cost for a particular user.
597
598	- repykota's output format has changed an is not limited to
599	80 characters wide anymore. People who used to parse
600	repykota's output in their own tools are strongly advised
601	to parse dumpykota's output instead.
602
603	- Introduction of the new 'maxdenybanners' configuration directive
604	to allow up to N (the directive's value) deny banners to be
605	printed even if the print account is forbidden to print.
606
607	- Better detection of the number of copies in the PostScript parser.
608
609	- 1.21alpha23 :
610
611	- Traditional Chinese translation added.
612
613	- Several fixes and performance improvements with the LDAP backend.
614
615	- 1.21alpha22 :
616
617	- edpykota's --delete command line option doesn't consider
618	'*' to be the default argument anymore :-)
619
620	- 1.21alpha21 :
621
622	- dumpykota.cgi can now be run as a normal user as opposed to
623	a PyKota administrator. No read access to pykotadmin.conf is
624	necessary anymore. This CGI scripts now honors the REMOTE_USER
625	environment variable just like printquota.cgi does, see
626	the file cgi-bin/README for details.
627	The command line tool dumpykota must still be run by a PyKota
628	administrator.
629
630	- Fix exception's name error due to a change in recent versions
631	of PygreSQL.
632
633	- 1.21alpha20 :
634
635	- Big bug fix wrt the datelimit field which was never reset.
636
637	- 1.21alpha19 :
638
639	- Introduction of the new dumpykota.cgi CGI script, which
640	allows third party tools like phpPrintAnalyzer to be
641	interfaced in real time with PyKota. To use it you
642	may have to change your web server's configuration,
643	please see pykota/cgi-bin/README
644
645	- 1.21alpha18 :
646
647	- Now dumpykota can dump the job history into CUPS' page_log
648	format (even when the printing system is LPRng). This allows
649	people to use tools like PrintAnalyzer or phpPrintAnalyzer
650	(two completely different beasts) with PyKota.
651
652	- 1.21alpha17 :
653
654	- Fixed field type's name in XML dumps.
655
656	- Now drops priviledges to user 'pykota' when launched as root
657	(directly or as a CUPS backend), if such an user exists.
658
659	- Fixed PCL3/4/5 parser for some drivers' output.
660
661	- 1.21alpha16 :
662
663	- fixed several recently introduced bugs in LDAP backend code,
664	thanks to Matt Hyclak.
665
666	- 1.21alpha15 :
667
668	- Normalized field names between LDAP and PostgreSQL backends
669	in dumpykota's output.
670
671	- dumpykota filtering capabilities are now supported within
672	the LDAP backend too.
673
674	- 1.21alpha14 :
675
676	- dumpykota now supports extended filtering possibilities
677	with the PostgreSQL backend (LDAP support will come soon).
678
679	- 1.21alpha13 :
680
681	- Added a --debug command line option to pkpgcounter, so
682	that people may see what really happens, and what will
683	be available in the future :-)
684
685	- 1.21alpha12 :
686
687	- Fixed a bug with non standard pkbanner command lines.
688
689	- Now logs as errors the differences between precomputed and
690	computed job sizes. CUPS only for now
691
692	- 1.21alpha11 :
693
694	- Now user and group print quota entries can be stored directly
695	below the user or group with the LDAP backend, using them
696	as branches. Thanks to Stefan Wold for the patch.
697	See the sample configuration file for details.
698
699	- TLS is now supported with the LDAP backend. Thanks to Stefan
700	Wold for the patch.
701	See the sample configuration file for details.
702
703	- edpkota now accepts the -U \| --used value command line argument
704	to preset the page counters to an initial value. Thanks to
705	Wilson Roberto Afonso and Matt Hyclak for the patch.
706
707	- 1.21alpha10 :
708
709	- Now automatically reconnects up to three times if the LDAP server
710	returned an error, possibly due to a timeout.
711
712	- 1.21alpha9 :
713
714	- Now searches the configuration files in 'pykota' system user's
715	home directory. The 'pykota' system user and group have
716	to be created by the system administrator, and given
717	sufficient permissions to PyKota's configuration files.
718
719	- 1.21alpha8 :
720
721	- Added the new reject_unknown directive to reject the
722	creation of user or groups which are unknown to the system.
723
724	- 1.21alpha7 :
725
726	- Introduction of the pkmail email gateway.
727
728	- 1.21alpha6 :
729
730	- Fix for LPRng filenames.
731
732	- Added Turkish translation thanks to Baris Cicek.
733
734	- 1.21alpha5 :
735
736	- Improved ESC/P2 miniparser for Stylus Photo printers.
737
738	- Implemented the --savetoner command line option to pkbanner.
739
740	- Improved pkbanner's help and messages.
741
742	- 1.21alpha4 :
743
744	- Fixed job's data file detection code for LPRng.
745
746	- Fixed a problem with PJL and PowerSave mode,
747	thanks to Wilson Roberto Afonso.
748
749	- 1.21alpha3 :
750
751	- PyKota can now generate its own banners, and either account
752	for them or not, depending on newly introduced directives
753	in pykota.conf
754	Thanks to Matt Hyclak for the patch.
755
756	- 1.21alpha2 :
757
758	- Installation script is now non interactive again, as it should
759	have stayed from the beginning. Dependencies checking can
760	be done by launching the checkdeps.py command.
761
762	- 1.21alpha1 :
763
764	- added an IPP messages miniparser. Extraction of the client
765	hostname is now considered to be fiable, at least until
766	the CUPS developpers change something...
767
768	- 1.20 :
769
770	- Version number changed.
771
772	- 1.20beta :
773
774	- Norwegian (Bokm� preliminary translation added.
775
776	- German translation was finalized.
777
778	- Greek translation was finalized.
779
780	- For urgent legal reasons, a "privacy" directive has been added
781	to pykota.conf, to hide jobs' title, filename and options
782	in the history.
783
784	- Minor changes in the debian directory.
785
786	- 1.20alpha27 :
787
788	- Fixed many problems with translation files. In particular
789	the Brazilian Portuguese translation file was incorrectly
790	installed into the french "breton" locale directory.
791
792	- Finished French translation.
793
794	- 1.20alpha26 :
795
796	- LPRng support code should now better detect network
797	printers' hostnames or IP addresses.
798
799	- Fix for recently introduced bug in LPRng support.
800
801	- Fix for incorrect locale setting when starting.
802
803	- 1.20alpha25 :
804
805	- pkprinters allows --list to normal users, but require user
806	to be a PyKota administrator when another command line
807	option is used.
808
809	- pkhint doesn't use absolute path to search for helper commands
810	anymore.
811
812	- Spanish translation ready for 1.20.
813
814	- 1.20alpha24 :
815
816	- Now warnpykota only warns users limited by balance once.
817
818	- Now warnpykota only warns users who have ever printed,
819	to not cause confusion to users who have just opened
820	their account.
821
822	- Prepared help messages for translations.
823
824	- 1.20alpha23 :
825
826	- Add workaround for locale problem.
827
828	- 1.20alpha22 :
829
830	- Hopefully final fix for data encoding charset.
831
832	- edpykota now refuse to work if the user is not a PyKota admin.
833
834	- Fixes a recently introduced bug with users groups and PostgreSQL.
835
836	- 1.20alpha21 :
837
838	- Now dumpykota refuses to launch if the current user is not
839	a PyKota administrator (a PyKota administrator is an user
840	allowed to read the pykotadmin.conf file).
841
842	- Now any PyKota administrator can use repykota and warnpykota
843	with additionnal arguments, not only the root user.
844
845	- Improved documentation a bit.
846
847	- 1.20alpha20 :
848
849	- Reduced delay in internal SNMP and PJL_over_TCP handlers
850	from 2 to 1 second.
851
852	- dumpykota can now output XML.
853
854	- 1.20alpha19 :
855
856	- Improved user groups and user groups quotas dumps in dumpykota.
857
858	- Finished implementation of LDAP support in dumpykota.
859
860	- The md5 sum of the job's datas is now available as an
861	hexadecimal digest in the PYKOTAMD5SUM environment variable.
862
863	- The description, filename, title, and options fields
864	are now stored as UTF-8 strings in both LDAP and PostgreSQL.
865	Proper charset is used during extraction from the database.
866
867	- 1.20alpha18 :
868
869	- Experimental autopykota command to initialize user
870	account and quota entries on first print while not
871	resetting the balance value if not needed.
872
873	- Added the new "winbind_separator" directive to strip
874	out the Samba/Winbind domain name while printing if
875	needed (Off by default).
876
877	- 1.20alpha17 :
878
879	- Added --hardreset command line option to edpykota.
880
881	- Fixed problem with accented chars in title, filename
882	or options and LDAP backend.
883
884	- 1.20alpha16 :
885
886	- Internal handling of socket based PJL queries over
887	port tcp/9100 is now available with the magic
888	'pjl' value in the hardware accounter.
889
890	- 1.20alpha15 :
891
892	- LDAP pykotaAccountBalance objects were always created
893	attached to the pykotaUser objects. This is now
894	fixed and the value of balancebase in pykota.conf
895	is now correctly used.
896
897	- 1.20alpha14 :
898
899	- Belgian translations added (copy of the french ones).
900
901	- External hardware accounter now loops until
902	a result can be read correctly.
903
904	- pkhint now suggest the internal snmp handling instead
905	of the external one.
906
907	- 1.20alpha13 :
908
909	- Hardware accounter now accepts the special
910	'snmp' value, meaning ALL is done from main code
911	without launching any subprocess.
912	You need the http://pysnmp.sf.net Python module
913	for this to work (tested with v3.4.2)
914
915	- Increased delay between two loops iterations
916	to 2 seconds in waitprinter.sh to diminish
917	CPU load.
918
919	- 1.20alpha12 :
920
921	- waitprinter.sh rewritten from scratch to wait
922	for printer status stabilization.
923
924	- 1.20alpha11 :
925
926	- Generic data dumper 'dumpykota' introduced.
927	Works only with PostgreSQL backend for now.
928
929	- 1.20alpha10 :
930
931	- Added fix for incorrect job's size computation when
932	hardware accounting fails.
933
934	- 1.20alpha9 :
935
936	- Small fixes wrt subprocesses.
937
938	- 1.20alpha8 :
939
940	- Added full support of PCL3 : HP Deskjet printers are now
941	supported.
942
943	- 1.20alpha7 :
944
945	- First draft of PCL3GUI (Deskjet 640C for example) analyzer.
946	Needs more work, but no documentation is available.
947
948	- 1.20alpha6 :
949
950	- Improved mailandpopup.sh script.
951
952	- Small fixes for LPRng.
953
954	- Now exports PYKOTAPRINTERHOSTNAME for network printers'
955	hostname or IP address. Set to 'localhost' when not
956	meaningful.
957
958	- Fixed issue with how mod_auth_ldap Apache modules
959	fills the REMOTE_USER environment variable.
960
961	- Fixed a bug in LDAP user deletion code.
962
963	- 1.20alpha5 :
964
965	- Introduces the new configuration directive 'onaccountererror'
966	to specify what must be done whenever the software or
967	hardware accounter fails. Allowed values are 'continue' and
968	'stop' (default).
969
970	- Minor fix in software accounter for a recently introduced
971	problem.
972
973	- 1.20alpha4 :
974
975	- Added support for more ghostscript devices in ESC/P2
976	analyzer : stcolor, st800, escp, escpc are now supported.
977
978	- 1.20alpha3 :
979
980	- Small improvement in PostScript parser to avoid being
981	fooled by a change in number of copies :
982	The user can't ask for 200 copies of page 1 and 1 copy
983	of page 2 to fool PyKota anymore :
984	this would have been accounted for as 1 copy only, but
985	now the maximum value seen is used.
986
987	- Relax checks for PCL5 header to accomodate some strange
988	printer drivers.
989
990	- Now hardware accounting method works like software
991	accounting method wrt the subprocess' output.
992
993	- Hardware and Software accounting stop the print queue
994	when the accounting subprocess didn't work. This will
995	be configurable in the near future.
996
997	- 1.20alpha2 :
998
999	- Now software accounting method reads accounter's
1000	answer until a line with a single integer is
1001	obtained or until all of its output has been read.
1002	This should fix the problem some people have
1003	when strange locale related messages are sent
1004	when running subprocesses (Solaris only ?).
1005
1006	- First version of ESC/P2 analyzer. Seems to work
1007	ok at least with 'epson', 'epsonc', 'eps9mid'
1008	and 'esp9high' ghostscript devices. Needs more
1009	work to correctly analyze other devices.
1010
1011	- 1.20alpha1 :
1012
1013	- Fixed problem with number of copies in PCLXL parser.
1014
1015	- Fixed problem with number of copies in PCL5 parser,
1016	when number of copies was set outside of and before first
1017	page.
1018
1019	- Added workaround for number of copies directly set in
1020	PostScript code.
1021
1022	- Added german translation.
1023
1024	- Fixed problem on first print for user group quota when
1025	"enforcement: strict" is used.
1026
1027	- Fixed interpolation problem in french translation.
1028
1029	- 1.19 :
1030
1031	- Updated existing translations.
1032
1033	- Added final Thai and Greek translations.
1034
1035	- Minor last minute bug fixes.
1036
1037	- 1.19beta :
1038
1039	- LPRng support for both software and hardware accounting seems
1040	to be OK.
1041
1042	- Translation files fixed because of fuzzy matching problem.
1043
1044	- Fixed path to Swedish translation: 'sv' instead of 'se'.
1045
1046	- Added first draft of Thai translation.
1047
1048	- Fixed some minor bugs with Pychecker.
1049
1050	- 1.19alpha35 :
1051
1052	- Generic PDL analyzer now supports Binary PostScript documents
1053	in addition to DSC compliant ones.
1054
1055	- 1.19alpha34 :
1056
1057	- LPRng support : software accounting seems to work fine,
1058	but hardware accounting doesn't work yet.
1059
1060	- 1.19alpha33 :
1061
1062	- pykosd now accepts command line arguments. Enjoy !
1063	NB : due to a bug in xosd, you need xosd version 2.2.8
1064	or higher if you don't use the default C locale.
1065
1066	- 1.19alpha32 :
1067
1068	- Early (not working) version of the LPRng support rewrite.
1069
1070	- Saner default configuration file.
1071
1072	- 1.19alpha31 :
1073
1074	- Fixed a double Python2.1 incompatibility with newer versions,
1075	which prevented the PCL5 and the PCLXL parsers to work with
1076	this older version of Python.
1077
1078	- 1.19alpha30 :
1079
1080	- Introduction of preliminary version of the pykosd command
1081
1082	- Usernames, Groupnames and Printernames can now contain
1083	ANY character, expected '/' and '@'.
1084
1085	- Integrated most of the Debian work from Sergio
1086	Gonz�z Gonz�z
1087
1088	- 1.19alpha29 :
1089
1090	- PCLXL parser should now correctly handle number of
1091	copies set for each page.
1092
1093	- Added testsuite for generic PDL analyzer.
1094
1095	- Typo fixed in PCLXL parser.
1096
1097	- Correctly dispatches error messages depending on the
1098	situation : tools which can be run interactively will
1099	ALWAYS output their logs to stderr, excepted for
1100	their DEBUG messages, for which the "logger:"
1101	directive as set in pykota.conf will be honored.
1102	Tools which can't be run interactively will ALWAYS
1103	honor the "logger:" directive as set in pykota.conf
1104
1105	- 1.19alpha28 :
1106
1107	- The description field for printers can now be set,
1108	and is displayed in reports.
1109
1110	- Fixed a small problem in SQL backend code.
1111
1112	- Improved pkhint
1113
1114	- First working PCL6 (aka PCLXL) parser !
1115	Doesn't handle copies yet.
1116
1117	- 1.19alpha27 :
1118
1119	- Additionnal 10% speed increase in PCL5 parser for GhostScript
1120	generated files (untested yet with other PCL files).
1121
1122	- Reintroduced the use of mmap in PCL5 parser : this speedups
1123	PCL5 parsing by almost 4 times.
1124	This 4x with the 3x below give us in fact a twelvefold increase
1125	in performance for PCL5 parsing !
1126
1127	- The Python accelerator Psyco is now used if available
1128	in the generic PDL parser : it speedups PCL5 parsing by
1129	almost three times automagically.
1130
1131	- 1.19alpha26 :
1132
1133	- Fixed PCL5 parser according to the sources of rastertohp.
1134
1135	- Fixed number of copies handling in PCL5 parser : the number
1136	of copies could vary from page to page.
1137
1138	- Added more debug information to PCLXL parser.
1139
1140	- 1.19alpha25 :
1141
1142	- Added new "description" field to printers in both
1143	PostgreSQL and LDAP. No code to handle this yet.
1144
1145	- Reversed the fix for power save mode in printers :
1146	no paper or tray open would have caused people to
1147	be undercharged.
1148
1149	- Preliminary version of MySQL initialization script.
1150
1151	- 1.19alpha24 :
1152
1153	- Native PDF parsing code now works perfectly with
1154	Python 2.1 and above, and is way faster than before.
1155	GhostScript is not used anymore to convert PDF to PS,
1156	because PDF is parsed directly.
1157
1158	- 1.19alpha23 :
1159
1160	- Fixed waitprinter.sh wrt PowerSave mode and some
1161	printers. Thanks to Ryan Suarez.
1162
1163	- Smart PDL analyzer now recognizes PDF too : two
1164	PDF parsing methods are used : a native one which
1165	is very fast but requires Python 2.3 or above, and
1166	a slower one which uses Ghostscript. PyKota detects
1167	automatically which method to use depending on your
1168	version of Python.
1169
1170	- All tracebacks now include PyKota's version number.
1171
1172	- 1.19alpha22 :
1173
1174	- Ensures that the file pointer for job's data is
1175	reset to the start of the job's datas after the
1176	job's size pre-computation phase.
1177
1178	- Improved PostScript detection code for bad drivers
1179	which don't correctly switch languages between PJL
1180	and PS.
1181
1182	- Even better debugging code.
1183
1184	- 1.19alpha21 :
1185
1186	- Additionnal check.
1187
1188	- 1.19alpha20 :
1189
1190	- More complete logging messages wrt accounters.
1191
1192	- Now catches early failures occuring when the configuration
1193	files are parsed.
1194
1195	- 1.19alpha19 :
1196
1197	- Fixed over-verbose exits when displaying help
1198	or version.
1199
1200	- Extended some PATH in the shell scripts
1201
1202	- Deleting an user now also deletes his payments history.
1203
1204	- Doesn't explicitely ignore SIGCHLD anymore. This seems to
1205	cause problems.
1206
1207	- 1.19alpha18 :
1208
1209	- History of payments is now stored in the database, and
1210	updated each time an user's balance is modified with
1211	edpykota --balance. This history represents each time
1212	the user was given some positive or negative credit,
1213	but doesn't reflect price paid for jobs, which appear
1214	in the jobs history instead.
1215
1216	- Jobs history web reports now include the job's size in
1217	bytes. Also columns were reordered to render the report
1218	more easily readable.
1219
1220	- 1.19alpha17 :
1221
1222	- Mysterious bug (program exited unexpectedly without leaving
1223	any log message) which occured once in a while when
1224	cancelling jobs should be fixed now.
1225
1226	- New 'crashrecipient' directive. Disabled by
1227	default. See sample configuration file to see how
1228	to activate it. It is suggested that you activate it.
1229
1230	- New PYKOTAJOBSIZEBYTES environment variable exported,
1231	which contains the job's size in bytes. Empty jobs
1232	are now denied. This value is now stored in the job
1233	history (but not yet displayed from the web interface)
1234
1235	- Preliminary work on payments storage : the PostgreSQL
1236	and LDAP schemas should be OK now, but no code is written
1237	yet to support this functionnality.
1238
1239	- 1.19alpha16 :
1240
1241	- the newuser and newgroup LDAP specific directives now accept
1242	a second parameter to attach(), "fail" or "warn". If no entry
1243	is found to attach PyKota attributes to, and "fail" was used,
1244	then action is aborted and program exits in error. If "warn"
1245	is used, a new entry is created but a warning message is logged.
1246
1247	- The job's originating hostname is now stored in the database,
1248	and exported as PYKOTAJOBORIGINATINGHOSTNAME in the environment.
1249
1250	- 1.19alpha15 :
1251
1252	- The old pykota filter is now removed. This means that
1253	currently PyKota doesn't support LPRng anymore, but
1254	LPRng support will be re-added, improved, in the near future.
1255
1256	- 1.19alpha14 :
1257
1258	- PYKOTAPRECOMPUTEDJOBSIZE and PYKOTAPRECOMPUTEDJOBPRICE
1259	are now exported as environment variables.
1260
1261	- Heavy CPU usage is now completely fixed it seems, by
1262	introducing some 0.01 second sleeping when nothing to do.
1263
1264	- Pre-computation of the job's size is now only
1265	done when enforcement is "STRICT", this saves
1266	CPU for people who don't want to use this new
1267	feature.
1268
1269	- New 'enforcement' directive which accepts either
1270	STRICT or LAXIST. See sample configuration file
1271	for details.
1272
1273	- 1.19alpha13 :
1274
1275	- Get back to an old version of the polling loop which
1276	worked fine, but non-optimally. Will be optimized
1277	as time permits.
1278
1279	- 1.19alpha12 :
1280
1281	- Job's size is now precomputed unconditionnally using
1282	the generic PDL analyzer.
1283	NB : This value is not yet used to pre-allow/deny the
1284	job.
1285
1286	- 1.19alpha11 :
1287
1288	- The pykota filter is now completely deprecated and
1289	can't be used anymore. LPRng users MUST download
1290	an older version of PyKota. CUPS users MUST use
1291	cupspykota. Better support for LPRng will come
1292	in the near future.
1293
1294	- 1.19alpha10 :
1295
1296	- pykotme now uses generic PDL Analyzer directly instead
1297	of spawning a new process.
1298
1299	- Improvements to generic PDL Analyzer.
1300
1301	- 25% Speedup in PCL parser. Getting more of the Python version
1302	will probably be difficult, since the completely table driven
1303	parser I wrote is slower than the original algorithm. Then,
1304	the original algorithm is still used for now.
1305	Probable that more speed could be achieved using mmap, at the
1306	expense of severe memory consumption.
1307
1308	- configuration simplifications : the "accounter" directive's
1309	'hardware' arguments now accepts what was in the "requester"
1310	directive as it's content. The "requester" directive is not
1311	supported anymore. See sample configuration file for details.
1312
1313	- 1.19alpha9 :
1314
1315	- pkpgcounter is now just a wrapper around the PDLAnalyzer class
1316
1317	- pykotaOptions LDAP attribute now accepts non-ascii characters
1318	too.
1319
1320	- First try at cupspykota main loop rewrite
1321
1322	- 1.19alpha8 :
1323
1324	- 'querying' accounting method is now called 'hardware'
1325
1326	- 'external' accounting method is now called 'software'
1327
1328	- 'stupid' accounting method doesn't exist anymore
1329
1330	- 'snmp' requester doesn't exist anymore
1331
1332	- code simplifications in external requester
1333
1334	- 1.19alpha7 :
1335
1336	- Database schema change (both LDAP and PostgreSQL) to
1337	allow storage of the job-originating-hostname attribute.
1338	An SQL upgrade script is present. The code is not yet
1339	capable of setting/retrieving this attribute. Support
1340	for this functionnality will be added in the future.
1341
1342	- 1.19alpha6 :
1343
1344	- problems connecting to SMTP servers are now catched.
1345
1346	- pykotme now uses pkpgcounter to compute the size of the
1347	job. This modification adds PCL5 and soon PCLXL (PCL6)
1348	support. You can now get quotes for PCL in addition to
1349	PostScript.
1350
1351	- pkpgcounter now includes first try at PCLXL parser.
1352	It is currently disabled until it's finished.
1353
1354	- 1.19alpha5 :
1355
1356	- cupspykota polling loop fix for MacOSX (at least)
1357
1358	- logging subsystem now logs PID too, to ease diagnosing
1359	problems under heavy load.
1360
1361	- pkpgcounter enhancements.
1362
1363	- pkprinters --skipexisting now tells pkprinters to not
1364	modify existing printers when --add is used.
1365	pkprinters logs a warning message whenever --add is
1366	used and a printer already exists.
1367
1368	- LDAP schema now allows accented chars in pykotaFileName
1369	and pykotaTitle attributes.
1370
1371	- 1.19alpha4 :
1372
1373	- a bad copy&paste prevented pkpgcounter to work at all, this
1374	is now fixed.
1375
1376	- improved PCL support in pkpgcounter, with the use of
1377	HP PCL/PJL Reference Set
1378	PCL5 Printer Language Technical Quick Reference Guide
1379
1380	- pkpgcounter now uses mmap to speed things up : duration
1381	is halved with the sample 87 pages PCL document I use for
1382	testing.
1383
1384	- 1.19alpha3 :
1385
1386	- pkprinters now accepts the --list command line argument
1387	to list informations about printers.
1388
1389	- 1.19alpha2 :
1390
1391	- pkpgcounter is now included as a smart external
1392	accounter which can handle both PostScript and PCL.
1393
1394	- 1.19alpha1 :
1395
1396	- PYKOTALIMITBY environment variable is now exported too.
1397
1398	- Inclusion of Michele Baldessari's work on autotools.
1399
1400	- 1.18 :
1401
1402	- Improved documentation
1403
1404	- 1.18beta2 :
1405
1406	- Fix for raw jobs with cupspykota
1407
1408	- 1.18beta :
1409
1410	- Small fix for new waitprinter.sh script
1411
1412	- Better tracebacks on error conditions
1413
1414	- Improved translations
1415
1416	- Improved documentation
1417
1418	- 1.18alpha15 :
1419
1420	- waitprinter.sh replaced by a new and possibly faster
1421	and more powerful one.
1422
1423	- Names can now begin with a digit.
1424
1425	- Stability improvement for quotas set on printers groups.
1426
1427	- 1.18alpha14 :
1428
1429	- Catches more (all ?) problems with SMTP servers instead
1430	of breaking.
1431
1432	- Italian translation added.
1433
1434	- 1.18alpha13 :
1435
1436	- Pre and Post hooks are now available in the pykota
1437	filter as well.
1438
1439	- The pykota filter doesn't check last user's quota
1440	anymore when delayed hardware accounting is used :
1441	this will be done anyway the next time the last
1442	user will print again. This saves some database
1443	queries which are unneeded.
1444
1445	- 1.18alpha12 :
1446
1447	- Pre and Post hooks to external commands with many
1448	many environment variables available are useable
1449	from the cupspykota backend.
1450	See sample configuration file for details and help.
1451
1452	- 1.18alpha11 :
1453
1454	- Hopefully final fix wrt groups (users and printers)
1455
1456	- 1.18alpha10 :
1457
1458	- Fixed nested printer groups accounting.
1459
1460	- Fixed user groups + printer groups problem.
1461
1462	- 1.18alpha9 :
1463
1464	- Fix for LDAP problem when job price was 0.
1465
1466	- Fix for empty user groups with LDAP.
1467
1468	- Preliminary version of the snmpprinterstatus command added.
1469
1470	- 1.18alpha8 :
1471
1472	- Don't retrieve data when not needed.
1473	This avoids many database queries.
1474
1475	- 1.18alpha7 :
1476
1477	- New experimental ldapcache directive to improve
1478	LDAP caching.
1479
1480	- 1.18alpha6 :
1481
1482	- New configuration directive added : maildomain
1483	to specify the domain to send mail to when user
1484	email address is not set in PyKota database.
1485
1486	- More complete email message headers.
1487
1488	- 1.18alpha5 :
1489
1490	- Debian packaging specific files, contributed by
1491	Peter Hawkins are now included in the project's tree.
1492
1493	- Preliminary work on future low-level LDAP caching to speed
1494	up modifications (at least).
1495
1496	- 1.18alpha4 :
1497
1498	- Applied some of the modifications suggested by
1499	Peter Hawkins, for better Debian integration.
1500	Most notably cupspykota, pykota, and the shell
1501	scripts are now installed into /usr/share/pykota
1502	instead of into /usr/bin
1503	BEWARE : double check that your symbolic link
1504	to cupspykota is correct, and that your pykota.conf
1505	file use correct path for the shell scripts like
1506	waitprinter.sh and al.
1507
1508	- pkhint command added, to help in configuring correct
1509	accounting method for PyKota.
1510
1511	- 1.18alpha3 :
1512
1513	- Fixed a rare bug in cupspykota backend which gave
1514	incorrect "CUPS backend died abnormally" messages.
1515
1516	- 1.18alpha2 :
1517
1518	- Added the pkprinters command line tool to manage printers
1519	exclusively.
1520
1521	- 1.18alpha1 :
1522
1523	- Preliminary work on Relationnal Database Independance.
1524
1525	- Sample report made from OpenOffice.org added as PDF and SXC.
1526
1527	- 1.17 :
1528
1529	- Finalized release.
1530
1531	- 1.17alpha2 :
1532
1533	- Fix stupid software accounting bug in the CUPS backend.
1534
1535	- 1.17alpha1 :
1536
1537	- User/Group deletion code in edpykota rewritten.
1538
1539	- 1.16 :
1540
1541	- Preliminary documentation on how to use OpenOffice.org
1542	to create personnalized reports for PyKota + PostgreSQL.
1543
1544	- Spanish installation guide for CUPS+PyKota+PostgreSQL
1545	added to the documentation. Doesn't yet document v1.16
1546	though.
1547
1548	- Portuguese Portuguese translation replaces Brazilian
1549	Portuguese Translation. Brazilian portuguese
1550	translation is still available under the 'br' locale.
1551
1552	- 1.16beta3 :
1553
1554	- Swedish translation added.
1555
1556	- Small fix in documentation.
1557
1558	- 1.16beta2 :
1559
1560	- Small fix for job cancelling code while job already
1561	printing in CUPS backend.
1562
1563	- Big fix wrt printing policies for unknown users.
1564
1565	- 1.16beta1 :
1566
1567	- Manpages upgraded.
1568
1569	- 1.16alpha26 :
1570
1571	- Job price is now computed like this :
1572
1573	SUM((NbPages * PricePerPage) + PricePerJob)
1574
1575	For current printer and all the printers groups it is
1576	a member of, if any.
1577
1578	This may be difficult to grasp, but offers unprecedented
1579	flexibility.
1580
1581	- 1.16alpha25 :
1582
1583	- Email address can be set at user creation time,
1584	using the following syntax :
1585
1586	$ edpykota --add username/email@yourdomain.com
1587
1588	- 1.16alpha24 :
1589
1590	- CGI script now can show the printing history.
1591
1592	- Bug wrt number of copies should be fixed.
1593
1594	- Major code refactoring => It is now possible to
1595	automatically add printers on first print.
1596
1597	- 1.16alpha23 :
1598
1599	- Fixed potential accuracy problem if a user printed on
1600	several printers at the very same time.
1601
1602	- 1.16alpha22 :
1603
1604	- edpykota now allows adding printers to printer groups
1605
1606	- 1.16alpha21 :
1607
1608	- Allows the dot in user and printer names.
1609
1610	- Printer groups are now cached too.
1611
1612	- 1.16alpha20 :
1613
1614	- Fixed several small bugs with the help of PyChecker.
1615
1616	- 1.16alpha19 :
1617
1618	- Fixed a bug in PostgreSQL backend's code.
1619
1620	- 1.16alpha18 :
1621
1622	- Initial code for printer groups support. Printer groups have
1623	to be added with external tools like psql or gq for example.
1624	Printer groups seems to work fine with users. Untested with user
1625	groups for now.
1626
1627	- Several minor visual problems fixed in reports.
1628
1629	- Fixed a bug in LDAP date handling.
1630
1631	- Fix for LDAP problem with some combination of OpenLDAP + Python-LDAP
1632	+ some particular settings.
1633
1634	- mailandpopup.sh shell script added. See sample configuration file
1635	for details.
1636
1637	- Several environment variables are now exported when executing
1638	external commands (accounters, requesters, mailers) :
1639
1640	PYKOTAUSERNAME => user who is printing
1641	PYKOTAPRINTERNAME => printer on which the job is being sent
1642	PYKOTATITLE => Job's title
1643	PYKOTAFILENAME => Job's filename
1644	PYKOTACOPIES => number of copies asked
1645	PYKOTAOPTIONS => print command options (-o with CUPS)
1646
1647	- 1.16alpha17 :
1648
1649	- Added portugues translation.
1650
1651	- Major code refactoring in accounters.
1652
1653	- 1.16alpha16 :
1654
1655	- Code refactoring, and addition of a real HTML reporter, to
1656	have nice looking and useful web based reports (in the future).
1657
1658	- Added utolower configuration option to convert all usernames
1659	to lowercase during printing.
1660
1661	- 1.15alpha15 :
1662
1663	- Now includes the papwaitprinter.sh shell script to wait for
1664	AppleTalk enabled printers.
1665
1666	- 1.16alpha14 :
1667
1668	- Now printing on a printer not defined in the Quota Storage,
1669	results in the job being cancelled or stopped, depending
1670	on the printing system.
1671
1672	- 1.16alpha13 :
1673
1674	- Small bugfix wrt Python v2.1
1675
1676	- If username is an empty string, user root is assumed.
1677
1678	- 'postgresql' is not recognized anymore as a storage backend,
1679	you have to use 'pgstorage' instead. 'postgresql' used to
1680	be supported for compatibility with very old PyKota versions,
1681	this is not the case anymore.
1682
1683	- 1.16alpha12 :
1684
1685	- Job price added to job history, to keep accounting correct
1686	if a printer price per page or per job is modified and the
1687	history is not reset : the history would have given a false
1688	amount of money charged before the printer's prices were
1689	modified, this addition solves the problem.
1690
1691	- 1.16alpha11 :
1692
1693	- Some preliminary modifications to the database structure for
1694	PostgreSQL and OpenLDAP. A script to upgrade a PostgreSQL
1695	database is now provided. LDAP attributes now support
1696	eq, pres and sub indexes.
1697
1698	- Job history now contains additional informations :
1699	number of copies, filename, title and print options.
1700
1701	- 1.16alpha10 :
1702
1703	- Some modifications done to external policy handling.
1704	See sample configuration file for details.
1705
1706	- Spanish translation added.
1707
1708	- 1.16alpha9 :
1709
1710	- mailto can be set to external(...) to warn users above
1711	quota with any command of your choice (e.g. linpopup).
1712	Several parameters are available, see sample configuration
1713	file for details.
1714
1715	- 1.16alpha8 :
1716
1717	- Now cupspykota transmits SIGTERMS to the original
1718	backend when the user deletes a job being processed.
1719
1720	- The documentation is now licensed under the terms of the
1721	GNU GPL too.
1722
1723	- 1.16alpha7 :
1724
1725	- The CUPS backend is now fully functionnal (it seems).
1726
1727	- From now on, the use of the pykota filter with CUPS
1728	is deprecated. The pykota filter still has to be
1729	used with LPRng though.
1730
1731	- 1.16alpha6 :
1732
1733	- Bug fixed : when edpykota was used to add a printer
1734	with no user or group name, a bad user/group name "*" was
1735	added to the database.
1736
1737	- 1.16alpha5 :
1738
1739	- New CUPS backend supports device enumeration !
1740	This means that NO manual CUPS configuration has to
1741	be done. All can now be done from CUPS web interface.
1742
1743	- 1.16alpha4 :
1744
1745	- New CUPS backend added.
1746
1747	- 1.16alpha3 :
1748
1749	- Minimal FAQ document added.
1750
1751	- 1.16alpha2 :
1752
1753	- CGI script now partially supports browser's language preference
1754
1755	- 1.16alpha1 :
1756
1757	- Ensures that the LDAP connection is really closed at end.
1758
1759	- More complete error messages in case of LDAP operation failure.
1760
1761	- 1.15 :
1762
1763	- Documentation improved.
1764
1765	- 1.15beta :
1766
1767	- Command line tools now accept multiple printer
1768	names or wildcards, separated with commas.
1769
1770	- 1.15alpha9 :
1771
1772	- External policy can be used to auto-add unknown users
1773	and any other interesting things you may want to do.
1774	WARNING : You can't auto-add printers for now.
1775	They have to be created manually before.
1776	Look at sample configuration file for examples.
1777
1778	- 1.15alpha8 :
1779
1780	- Job history can be disabled if needed.
1781	This feature may be useful for people who use the LDAP
1782	backend and don't want their LDAP tree to grow out of
1783	control.
1784
1785	- 1.15alpha7 :
1786
1787	- More work done on caching wrt groups.
1788
1789	- 1.15alpha6 :
1790
1791	- Performance bottleneck with LDAP solved.
1792
1793	- 1.15alpha5 :
1794
1795	- Caching mechanism for all database queries.
1796
1797	- 1.15alpha4 :
1798
1799	- Problem with Python 2.3 fixed. Needs some definitive
1800	modification.
1801
1802	- 1.15alpha3 :
1803
1804	- CGI script now tries to restrict view when the
1805	REMOTE_USER environment variable is set. This allows
1806	people to protect its use with .htaccess files.
1807	When unprotected, or if REMOTE_USER is 'root', then
1808	unrestricted access is granted.
1809	NB : REMOTE_USER is automatically set by the web server
1810	(e.g. Apache) when a page with restricted access is viewed.
1811
1812	- 1.15alpha2 :
1813
1814	- Better detection of LPRng.
1815
1816	- Outputs a warning if printing system is unknown.
1817
1818	- 1.15alpha1 :
1819
1820	- Bug fix in SQL code.
1821
1822	- 1.14 :
1823
1824	- The PostgreSQL database connection is now always closed before
1825	exit. The LDAP database connection too, but it didn't suffer
1826	from the problem anyway, AFAICT.
1827
1828	- 1.14beta2 :
1829
1830	- An LDAP-specific configuration field was introduced, usermail.
1831	Use it to specify which LDAP attribute contains a valid email
1832	address for the user. See sample configuration file for
1833	details.
1834
1835	- 1.14beta :
1836
1837	- Two new LDAP-specific configuration fields were introduced,
1838	newuser and newgroup. Use them to specify if you want to add
1839	quota information to existing entries or elsewhere.
1840	See sample configuration file for details.
1841
1842	- 1.14alpha9 :
1843
1844	- Documentation improved.
1845
1846	- pykotme now also prints the user's account balance value
1847	if the user is registered in the Quota Storage and his
1848	limiting factor is "balance".
1849
1850	- 1.14alpha8 :
1851
1852	- bin/waitprinter.sh is now included to wait for
1853	SNMP enabled printers to be idle again before
1854	asking for their internal page counter.
1855	See sample configuration file for details.
1856
1857	- 1.14alpha7 :
1858
1859	- edpykota now doesn't check if the user/group is above
1860	quota. The check is only done at print time. This
1861	prevents the sending of email messages when creating
1862	user quotas if quota is already reached at creation
1863	time.
1864
1865	- 1.14alpha6 :
1866
1867	- Configuration file split and moved to /etc/pykota/pykota.conf
1868	and /etc/pykota/pykotadmin.conf to prevent simple users to
1869	have Read/Write access to the Quota Database.
1870	Don't forget to :
1871
1872	$ chmod 640 /etc/pykota/pykotadmin.conf
1873
1874	- storageuser and storageuserpw configuration fields reintroduced
1875	for the same reason.
1876
1877	- Code cleaning for future implementation of email addresses
1878	support in the PostgreSQL and LDAP backends.
1879
1880	- 1.14alpha5 :
1881
1882	- Big bug fixed when changing the prices for a printer
1883
1884	- 1.14alpha4 :
1885
1886	- When adding an user, the user itself and its account balance
1887	are now added in the same LDAP entry. Before they were added
1888	as two different LDAP entries.
1889
1890	- 1.14alpha3 :
1891
1892	- Email field added to PostgreSQL database. An upgrade script
1893	is included in initscripts/postgresql.
1894
1895	- 1.14alpha2 :
1896
1897	- Typo fixed when using the --prototype option to edpykota
1898
1899	- 1.14alpha1 :
1900
1901	- Poor man's treshold included : users with a low account
1902	balance (below 1.0 by default, configurable) are sent
1903	a warning message.
1904
1905	- All warning messages to users are now configurable.
1906	NB : Warning messages to the administrator are not.
1907
1908	- 1.13 :
1909
1910	- Some small fixes wrt group handling.
1911
1912	- The whole module code was passed through PyChecker and
1913	several small code inconsistencies were fixed,
1914	as well as a bug in the groups code.
1915
1916	- 1.13alpha1 :
1917
1918	- Bug fix wrt LDAP.
1919
1920	- 1.12 :
1921
1922	- More complete test added in edpykota.
1923
1924	- 1.12alpha2 :
1925
1926	- The previous bug fix was incomplete. This is corrected.
1927
1928	- 1.12alpha1 :
1929
1930	- Small bug fix.
1931
1932	- 1.11 :
1933
1934	- Now includes the pykotme command line tool, to produce
1935	printing quotes for users.
1936
1937	- 1.10 :
1938
1939	- Bug fixed wrt quota reports when print limiting is by
1940	account balance.
1941
1942	- 1.09 :
1943
1944	- Translations finalized.
1945
1946	- Manpages updated.
1947
1948	- Installation documentation improved wrt LDAP support.
1949
1950	- 1.09beta2 :
1951
1952	- The CGI script for quota reports works again, and
1953	is much more powerful.
1954
1955	- 1.09beta :
1956
1957	- edpykota finalized
1958
1959	- 1.09alpha2 :
1960
1961	- LDAP schema modified a bit. Please upgrade.
1962
1963	- LDAP backend works !
1964
1965	- repykota and warnpykota allow the root user to pass
1966	users or groups names on the command line. Users
1967	and groups names may contain wildcards.
1968
1969	- repykota and warnpykota only reports or warns the
1970	current user when launched by non-root users.
1971
1972	- Minor bug fixes.
1973
1974	- 1.09alpha1 :
1975
1976	- More work on LDAP storage backend. Many options
1977	were added to /etc/pykota.conf to give some
1978	hints to the LDAP storage backend.
1979
1980	- Severe database access optimizations were done by
1981	rewriting most of the Quota Storage backends drivers.
1982
1983	- 1.08 :
1984
1985	- Major bug fix wrt LPRng support for remote jobs.
1986
1987	- Major bug fix wrt increase/decrease account balances.
1988
1989	- 1.08alpha8 :
1990
1991	- Code refactoring.
1992
1993	- A single user/password pair is used to connect
1994	to the database backend. The storageuser configuration
1995	field, and its associated passwords storageuserpw, are
1996	not used anymore.
1997
1998	- You can now set PyKota in debug mode, see sample configuration
1999	file for details.
2000	WARNING : only Quota Storage backend queries are logged in
2001	debug mode, for now.
2002
2003	- 1.08alpha7 :
2004
2005	- Very latest LDAP schema.
2006
2007	- Code enhancement wrt easy pluggability of PyKota attributes
2008	and object classes into an existing LDAP directory.
2009
2010	- 1.08alpha6 :
2011
2012	- Minor bug corrections
2013
2014	- More work on LDAP : new schema
2015
2016	- 1.08alpha5 :
2017
2018	- More good work on LDAP storage.
2019	repykota now works reasonably well with the sample LDAP directory.
2020
2021	- 1.08alpha4 :
2022
2023	- LDAP schema included.
2024	THIS IS JUST FOR PEOPLE TO DISCUSS ABOUT THIS.
2025	LDAP SUPPORT DOESN'T WORK YET, AND THE SCHEMA
2026	MAY CHANGE IN THE FUTURE. PLEASE TELL US
2027	WHAT YOU THINK ABOUT THIS SCHEMA ON THE
2028	MAILING LIST.
2029
2030	- 1.08alpha3 :
2031
2032	- External accounting methods were partly rewritten :
2033
2034	- No more "broken pipe" should happen.
2035
2036	- They now take care of the number of copies
2037	This may be unneeded though, if the postscript
2038	file already does this, because this would
2039	overcharge users (number of copies counted
2040	two times). NEEDS MORE TESTING.
2041
2042	- The sample configuration file now contains
2043	an external accounting method example which should
2044	work with all DSC compliant Postscript files.
2045
2046	- Some small bugs were fixed.
2047
2048	- 1.08alpha2 :
2049
2050	- Now works with net-snmp v5.0 and above.
2051	It already worked, but the sample configuration
2052	file didn't contain appropriate values...
2053
2054	- 1.07 : Release of the Shame !
2055
2056	- The external accounting methods driver was left out of
2057	the CVS tree. Nobody could use it since it wasn't included !
2058
2059	- 1.06 :
2060
2061	- Severe bug fixed : if you had a printer in
2062	power saving state which couldn't answer immediately,
2063	a bug was triggered.
2064	It was caused by a bad copy/paste which
2065	forgot to import a Python module at run time.
2066
2067	- 1.05 :
2068
2069	- External accounters are finally available !
2070	This means that you can plug any page accounting
2071	method you like by setting the appropriate
2072	'accounter' field in /etc/pykota.conf
2073	See the sample conf/pykota.conf.sample to
2074	learn how to do.
2075
2076	NB : Both 'external' and 'stupid' accounting methods
2077	account a job size just before this job is
2078	sent to the printer.
2079	The original 'querying' method accounts a job
2080	size just before the next job is sent to
2081	the printer.
2082
2083	- 1.05alpha3 :
2084
2085	- A 'stupid' and unreliable accounting method was
2086	implemented to serve as an example on how to
2087	do this sort of things. This method only counts
2088	the 'showpage' statements in the input data.
2089	See sample configuration file for details.
2090	Pluggable accounting methods work, but I advise
2091	you TO NOT USE THIS ONE WHICH IS JUST AN EXAMPLE.
2092	It is not reliable enough to be used.
2093	Use the 'querying' accounting method instead.
2094
2095	- 1.05alpha2 :
2096
2097	- Pluggable accounting methods.
2098
2099	- Better error handling.
2100
2101	- 1.05alpha1 :
2102
2103	- SECURITY file added to help improve PyKota's security.
2104
2105	- Extracting the printer's internal page counter is now
2106	tried several times, waiting several seconds between
2107	two tries. This lets the time to warm up for some printers
2108	which don't answer when they are sleeping (my Apple
2109	LaserWriter 16/600 PS is in this case, maybe others too)
2110
2111	- Small display bug fixed in repykota
2112
2113	- 1.04 :
2114
2115	- Default print policy for users/groups unknown from
2116	the print quota system is now DENY instead of ALLOW,
2117	since ALLOW can generate inaccurate results
2118	(incorrect job sizes charged to the wrong persons)
2119
2120	- LPRng support works !
2121
2122	- A bug was introduced some time ago wrt printers' default
2123	policy for unknown users. It is now corrected.
2124
2125	- repykota now displays prices per job and per page for each
2126	printer, if they are defined.
2127
2128	- Minor display bug fixed in repykota.
2129
2130	- Problem when running repykota with an empty database was fixed.
2131
2132	- 1.03 :
2133
2134	- Upgrade script included for earlier versions.
2135	Please look inside the initscripts subdirectory.
2136	THE DATABASE SCHEMA HAS CHANGED, PLEASE UPGRADE.
2137
2138	- repykota now reports account balances too.
2139
2140	- PyKota now has a nice logo, see the logos
2141	subdirectory.
2142
2143	- Manual pages were finally updated.
2144
2145	- Group quotas seem to work now !
2146
2147	- The new database schema allows to keep an history of all
2148	jobs as well as charge users per page and/or per job,
2149	and track users' account balance.
2150
2151	- edpykota now accepts much more command line options to
2152	use the new functionnalities. See edpykota --help for
2153	details.
2154
2155	- The installation script now allows to install the sample
2156	configuration file during first installation.
2157
2158	- More group quota code works, but still not finished.
2159
2160	- The CGI script displays a link to PyKota's website.
2161
2162	- The job history is now kept, this will allow per-period
2163	reports in the future.
2164
2165	- After having modified the quota for an user with edpykota,
2166	a quota check is done to eventually warn the user/admin about
2167	a quota which is too low to print.
2168
2169	- A workaround is provided for HP Printers : their internal
2170	page counter is only saved to NVRAM in a 10 increment, so
2171	if you switch them off and then on, the reported page counter
2172	may be lower than the real number of pages printed.
2173	See http://web.mit.edu/source/third/lprng/doc/LPRng-HOWTO-15.html
2174	We unconditionnally set the last job's page count to
2175	abs(int((10 - abs(lastcounter(snmp) - lastcounter(storage)) / 2))
2176	in this case.
2177	For a more accurate accounting, never switch your HP printers
2178	off.
2179
2180	- A fix is provided for printers which only have a volatile
2181	page counter (reset to 0 every time you switch the printer on)
2182	This should allow PyKota to work reasonably fine with HP Laserjet
2183	4L/5L/6L, not perfect, but better than nothing.
2184	See http://web.mit.edu/source/third/lprng/doc/LPRng-HOWTO-15.html
2185	For a more accurate accounting, never switch your HP printers
2186	off. This is untested, please report any problem.
2187
2188	- A bug was fixed when edpykota --add was used with users who already
2189	had a quota on the specified printer.
2190
2191	- A small display bug in repykota was introduced in preliminary
2192	1.03 versions, and fixed later on.
2193
2194	- Some minor bugs which happened in rare situations were fixed.
2195
2196	- Support for AppleTalk printers was added, see sample configuration
2197	file for details.
2198
2199	- Users and group printing can now be controlled (limited) either by
2200	print quota or by account balance.
2201
2202	- 1.02 :
2203
2204	- The installation script now checks for software availability
2205	and in case a software is missing asks the user if he
2206	wants to continue with the installation or abort it.
2207
2208	- The configuration file pykota.conf is now expected to be
2209	found in /etc instead of in /etc/cups
2210	The installation script prompts the user to see if he
2211	wants to move an old configuration file to the new location
2212	if needed.
2213
2214	- Improved documentation.
2215
2216	- You can now set the tcp/ip port on which the Quota Storage
2217	Server is listening, see sample configuration file for details.
2218
2219	- Better general error handling.
2220
2221	- Upgrade script for pre 1.01 PostgreSQL database schema is now
2222	included as well.
2223
2224	- 1.01 :
2225
2226	- The configuration file now accepts an option
2227	to choose the recipient(s) of the email messages :
2228
2229	- DevNull means no one will receive them.
2230	- User means only the user will receive them.
2231	- Admin means only the admin will receive them.
2232	- Both means the User and the Admin will receive them.
2233
2234	- The configuration file now uses hard-coded default values
2235	when an option is not set. See sample configuration file
2236	for details.
2237
2238	- Manual pages are included since 1.00, but I forgot to
2239	add this information to this file.
2240
2241	- Redistribution terms for the official package have
2242	softened and are now fully GPL compatible :
2243	unrestricted modification is now allowed even for
2244	the version number.
2245
2246	- 1.00 :
2247
2248	- edpykota now accepts a --noquota option. This
2249	disable quota checking while still doing page
2250	accounting. This is really useful for people
2251	who don't want to limit their users but want
2252	to know how much pages they print.
2253
2254	- Some untested scripts were added to retrieve
2255	the life time page counter of non-SNMP printers.
2256
2257	- Every directory now has a specific README file.
2258
2259	- 0.99 :
2260
2261	- Under some circumstances while the user wasn't allowed
2262	to print, he didn't receive any email message. It is
2263	now fixed.
2264
2265	- When an user wasn't allowed to print, the quota for
2266	the previous user wasn't updated. This is now fixed.
2267
2268	- 0.98 :
2269
2270	- Correctly handle the case where the printer is switched off.
2271
2272	- Small bug wrt syslog fixed.
2273
2274	- 0.97 :
2275
2276	- edpykota accepts wildcards on its command line for users/groups too
2277	if the --add option is not set, e.g. :
2278
2279	$ edpykota --printer lp --softlimit 50 --hardlimit 100 "jer*"
2280
2281	- If no user name is passed at all, then a default wildcard of "*"
2282	which means apply the command on ALL users for this printer is used.
2283
2284	- Small bug fixes.
2285
2286	- 0.96 :
2287
2288	- Options requester, policy, admin, adminmail and gracedelay can now
2289	be set either globally or per printer. The printer option has
2290	priority if both are defined.
2291
2292	- More powerful configuration parser.
2293
2294	- If all options are defined globally, there's no need to
2295	define a section for each printer in the configuration
2296	file anymore. Just define a [global] section and it's ok.
2297
2298	- 0.95 :
2299
2300	- External requesters for printers finally added.
2301
2302	- Full internationalization (english and french are supported)
2303
2304	- More complete quota usage report
2305
2306	- CGI script to access to the quota usage report
2307
2308	- Several bugs fixed.
2309
2310
2311	- 0.9 :
2312
2313	- First public version

Note: See TracBrowser for help on using the browser.

Download in other formats:

Original Format