| 584 | | The easiest way to configure PyKota to be used for a particular <application>CUPS</application> print queue, |
| 585 | | is to modify the <literal>PPD</literal> file associated with this print queue. |
| 586 | | Say you want to set quotas on the <literal>HPLaser</literal> print queue. You |
| 587 | | then just have to modify the file <filename>/etc/cups/ppd/HPLaser.ppd</filename>. |
| 588 | | You will have to add the following lines somewhere near the beginning of this file : |
| 589 | | <screen> |
| 590 | | *% Print Quota System |
| 591 | | *cupsFilter: "application/vnd.cups-postscript 0 /usr/bin/pykota" |
| 592 | | </screen> |
| 593 | | </para> |
| 594 | | |
| 595 | | <para> |
| 596 | | The first line is a comment. The second one tells <application>CUPS</application> |
| 597 | | to launch PyKota's accounting filter just before sending the print job to |
| 598 | | the printer's hardware. |
| | 584 | From version 1.16alpha7 on, configuring PyKota to integrate |
| | 585 | within CUPS is more than easy. |
| | 586 | </para> |
| | 587 | |
| | 588 | <para> |
| | 589 | You just have to create a symbolic link to the <filename>cupspykota</filename> |
| | 590 | command in CUPS' backend directory : |
| | 591 | <screen> |
| | 592 | $ cd /usr/lib/cups/backend |
| | 593 | $ ln -s /usr/bin/cupspykota cupspykota |
| | 594 | </screen> |
| 610 | | Repeat the above procedure for each print queue on which you want to use |
| 611 | | PyKota. That's all ! |
| 612 | | </para> |
| 613 | | |
| 614 | | <sect3> |
| 615 | | <title>Troubleshooting</title> |
| 616 | | <para> |
| 617 | | NB : the above procedure only works with <literal>PPD</literal> files which |
| 618 | | don't already contain an <literal>*cupsFilter</literal> line. PostScript |
| 619 | | printers usually don't need this line, but other types of printers may need |
| 620 | | it. A different procedure exists for such printers, but it is not actually |
| 621 | | documented. Search the mailing list archives at |
| 622 | | <ulink url="http://cgi.librelogiciel.com/mailman/listinfo/pykota"> |
| 623 | | http://cgi.librelogiciel.com/mailman/listinfo/pykota |
| 624 | | </ulink> to learn how to do. |
| 625 | | </para> |
| 626 | | |
| 627 | | <para> |
| 628 | | In case of problem, the simplest way to solve it is currently |
| 629 | | to ask on PyKota's mailing list, describing the symptoms, as |
| 630 | | well as the hardware and software you use. |
| 631 | | In a future release of this document, a section dedicated to |
| 632 | | Frequently Asked Questions will be included. |
| 633 | | </para> |
| 634 | | </sect3> |
| 635 | | |
| 636 | | </sect2> |
| 637 | | |
| 638 | | <sect2> |
| 639 | | <title>With LPRng</title> |
| 640 | | <para> |
| 641 | | To plug PyKota into your <application>LPRng</application> setup, |
| 642 | | you have to modify the <filename>/etc/printcap</filename>. |
| 643 | | You just have to add the following lines to each queue on |
| 644 | | which you want to use PyKota : |
| 645 | | <screen> |
| 646 | | :achk=true |
| 647 | | :as=|/usr/bin/pykota |
| 648 | | </screen> |
| 649 | | </para> |
| 650 | | |
| 651 | | <para> |
| 652 | | You have to restart <application>LPRng</application> for this modification to |
| 653 | | take effect : |
| 654 | | <screen> |
| 655 | | $ /etc/init.d/lprng restart |
| 656 | | </screen> |
| | 606 | Now point your web browser to CUPS configuration page, usually at |
| | 607 | <ulink url="http://localhost:631">http://localhost:631</ulink> on |
| | 608 | your print server. |
| | 609 | </para> |
| | 610 | |
| | 611 | <para> |
| | 612 | Then when creating new printers or reconfiguring existing ones, just |
| | 613 | choose devices which are <literal>PyKota managed</literal> instead of |
| | 614 | normal devices. You've got one <literal>PyKota managed</literal> device |
| | 615 | for each regular device available from CUPS, so just choose the appropriate |
| | 616 | one. |
| | 633 | |
| | 634 | <para> |
| | 635 | You can now also ask us questions on IRC : |
| | 636 | <screen> |
| | 637 | /server irc.freenode.net |
| | 638 | /join #pykota |
| | 639 | </screen> |
| | 640 | </para> |
| | 641 | </sect3> |
| | 642 | |
| | 643 | </sect2> |
| | 644 | |
| | 645 | <sect2> |
| | 646 | <title>With LPRng</title> |
| | 647 | <para> |
| | 648 | To plug PyKota into your <application>LPRng</application> setup, |
| | 649 | you have to modify the <filename>/etc/printcap</filename>. |
| | 650 | You just have to add the following lines to each queue on |
| | 651 | which you want to use PyKota : |
| | 652 | <screen> |
| | 653 | :achk=true |
| | 654 | :as=|/usr/bin/pykota |
| | 655 | </screen> |
| | 656 | </para> |
| | 657 | |
| | 658 | <para> |
| | 659 | You have to restart <application>LPRng</application> for this modification to |
| | 660 | take effect : |
| | 661 | <screen> |
| | 662 | $ /etc/init.d/lprng restart |
| | 663 | </screen> |
| | 664 | </para> |
| | 665 | |
| | 666 | <para> |
| | 667 | Repeat the above procedure for each print queue on which you want to use |
| | 668 | PyKota. That's all ! |
| | 669 | </para> |
| | 670 | |
| | 671 | <sect3> |
| | 672 | <title>Troubleshooting</title> |
| | 673 | <para> |
| | 674 | In case of problem, the simplest way to solve it is currently |
| | 675 | to ask on PyKota's mailing list, describing the symptoms, as |
| | 676 | well as the hardware and software you use. |
| | 677 | In a future release of this document, a section dedicated to |
| | 678 | Frequently Asked Questions will be included. |
| | 679 | </para> |
| | 680 | |
| | 681 | <para> |
| | 682 | You can now also ask us questions on IRC : |
| | 683 | <screen> |
| | 684 | /server irc.freenode.net |
| | 685 | /join #pykota |
| | 686 | </screen> |
| | 687 | </para> |
