Changeset 2714

Show
Ignore:
Timestamp:
02/20/06 21:34:57 (18 years ago)
Author:
jerome
Message:

Updated installation doc.

Files:
1 modified

Legend:

Unmodified
Added
Removed
  • pykota/trunk/README

    r2700 r2714  
    320320==== 
    321321 
    322   PyKota's documentation is now at : 
     322  PyKota's documentation is available as DocBook SGML sources 
     323  files in the pykota/docs directory. If you obtained an 
     324  Official package, in the same directory you'll also find 
     325  the documentation in HTML and PDF formats. 
     326   
     327  PyKota's collaborative documentation is available from : 
    323328   
    324329    http://www.librelogiciel.com/software/PyKota/WiKota/ 
     
    342347  Finally, SuSe users may find the following document to best describe 
    343348  how to install PyKota on their favorite distribution. It's a Spanish 
    344   document written by Dennis Romero : 
     349  document written by Dennis Romero, and is mostly outdated now : 
    345350   
    346351    http://www.cvr.espol.edu.ec/people/dennis/Pykota1.19-SuSE9.1.pdf 
     
    350355-------------- 
    351356    
     357  See : 
     358   
     359    http://www.librelogiciel.com/software/PyKota/WiKota/Dependencies 
     360     
     361  for an up-to-date list, or see below (maybe not up-to-date) : 
     362   
    352363  You need to have the following tools installed on the CUPS Server : 
    353364   
     
    389400      PySQLite module v2.0.5 or higher (http://www.pysqlite.org) 
    390401 or 
    391     - MySQL 4.0 or higher and the MySQL-python bindings.  
     402    - The MySQL-python bindings.  
    392403      IMPORTANT: If you are using MySQL 4.1, then MySQL-python must be  
    393404      version 1.2 or greater. Version 1.0 does not work correctly with 4.1. 
     
    436447      Beware : with SQLite the database server and the print 
    437448      servers MUST be the very same machine. 
    438      
    439 NB :     
    440  
    441   PygreSQL must be linked with the PostgreSQL client libraries on  
    442   the Print Server. The PostgreSQL client libraries' version must  
    443   match the PostgreSQL version used on the database server.  
    444    
    445 or   
    446  
    447   python-ldap must be linked with the OpenLDAP client libraries on the  
    448   Print Server. The OpenLDAP client libraries' version should match the  
    449   OpenLDAP version used on the database server, if applicable. 
    450    
     449       
     450  or      
     451   
     452    - MySQL 4.0 or higher. 
     453     
    451454  This list of prerequisite software may change in the future, when 
    452455  PyKota will support more functionnalities you will be given  
     
    595598    For existing printers : 
    596599     
    597         If you had already installed a version of PyKota earlier  
    598         than 1.16alpha7, then remove the *cupsFilter lines in your  
    599         PPD files for each already managed printer. Each  
    600         line to remove is of the form : 
    601          
    602           *cupsFilter: "application/vnd.cups-postscript 0 /usr/share/pykota/pykota" 
    603          
    604         This means that each time the pstops filter will be executed, it will 
    605         pass the job's data through the pykota filter which is present in  
    606         /usr/share/pykota 
    607          
    608         Don't touch anything else, especially any other *cupsFilter line. 
    609         Then save each of these files. 
    610          
    611         Then, the easiest is to directly modify the DeviceURI lines  
     600        The easiest is to directly modify the DeviceURI lines  
    612601        in /etc/cups/printers.conf, you just have to put  
    613602        'cupspykota:' in front of what is already on these lines.  
     
    643632 
    644633You can either use pkturnkey, or do the same things manually by 
    645 using the pkprinters and edpykota command line tools : 
     634using the pkprinters, pkusers and edpykota command line tools : 
     635 
     636Create printers : 
    646637 
    647638    $ pkprinters --help 
     
    655646    of 0.05 unit. 
    656647 
    657 Now set quotas for users on this printer :      
    658  
    659     $ edpykota --add -P hp2100 -S 40 -H 50 user1 ... userN 
    660          
    661     launching edpykota without any argument or with the --help 
    662     command line option will show you all the possibilities. 
    663      
    664     by default, each user is limited by "quota", this means that on 
    665     each printer he can have a different soft and hard limit. 
    666     You may want to limit the user by his account balance value,  
    667     in which case, the print quota is shared between all printers 
    668     instead of being different. To do this, use the following : 
    669      
    670     $ edpykota --add -P hp2100 --limitby balance --balance 10 user1 ... userN 
    671      
    672     This will put 10 $ (or Euros, PyKota doesn't care) on each user's account 
    673     balance, and tell PyKota to limit them by their account balance value. 
    674     Whenever they print on any printer, their account balance value is 
    675     decreased by an amount which depends on the particular price per page 
    676     and per job that you may have defined on the printer with edpykota's 
    677     --charge command line option. 
    678     Soft and Hard limits are not used if "--limitby balance" is used, 
    679     but you can define a "poorman"'s threshold in /etc/pykota/pykota.conf 
    680     to obtain a similar result (warning message when quota is low). 
    681  
     648Create users : 
     649 
     650    $ pkusers --add --limitby balance --balane 10.0 jerome 
     651     
     652    would create user jerome and give him ten credits to spend 
     653    on any printer. 
     654     
     655Finally create print quota entries : 
     656 
     657    $ edpykota --add -P hp2100 jerome 
     658         
     659    This will create a print quota entry for user jerome on     
     660    printer hp2100. The print quota entry holds the number of 
     661    pages printed on a particular printer for a particular 
     662    user, as well as optional page limits to be used instead 
     663    of balance limits. See pkusers and edpykota's manual 
     664    pages for details. 
     665     
    682666Restart CUPS, for example under Debian GNU/Linux systems :           
    683667