Changeset 1600 for pykota/trunk/README

Timestamp:

07/16/04 14:22:47 (20 years ago)

Author:

jalet

Message:

LPRng support early version

Files:

• pykota/trunk/README (modified) (14 diffs)

pykota/trunk/README

@@ -25 +25 @@
      FROM THIS FILE, PYKOTA CAN'T BE USED ANYMORE WITH LPRNG.
      
-     SUPPORT FOR LPRNG SHOULD BE RE-ADDED SOON WHEN A HUGE REWRITE
-     OF SOME PARTS OF PYKOTA WILL HAVE TAKEN PLACE
+     LPRNG SUPPORT IS CURRENTLY BEING REWRITTEN, AND YOU CAN
+     ALREADY PLAY WITH IT, BUT DON'T USE IT IN PRODUCTION UNTIL
+     THIS NOTE IS REMOVED.
 
 ====================================================================
@@ -47 +48 @@
         - Supports both CUPS and LPRng as the printing system.
         
-          NB : LPRng support is currently being rewritten, so
-          LPRng is actually not supported in latest CVS versions.
-            
     Databases :
     
@@ -174 +172 @@
     counter.
     
-    With CUPS, this is done both at the beginning and at the end of a
+    This is done both at the beginning and at the end of a
     print job. The counters difference is then immediately used to 
     decrease the user's account balance or increase his quota usage.
-    
-    With LPRng, this is done just before the beginning of a job, and used 
-    this to modify the *preceding* user's quota. So you're always late 
-    of one print job, but this is generally ok.
     
   - The 'software' method consists in delegating the computation of the
@@ -186 +180 @@
     The command can read the job's data from its standard input and MUST
     output the job's size on its standard output. Changes to the user
-    account are reported immediately, both with CUPS and LPRng.
-    
-PyKota is known to work fine with HP Laserjet 2100 and 2200, and 
-Apple LaserWriter 16/600 PS, both with CUPS and LPRng, under 
-Debian GNU/Linux (Sarge and Sid) operating systems. It should work
-fine with most network printers.
+    account are reported immediately.
+    
+PyKota is known to work fine with most laser printers, either with
+software accounting, or with hardware accounting if the printer
+supports this.
 
 ============================================================
@@ -237 +230 @@
       
   Other architectures may be supported as well in the future, check    
-  on Psyco's website.
+  this on Psyco's website.
   
   Installing Psyco is not mandatory, but it will speedup PCL5 parsing
@@ -244 +237 @@
   is already optimal. For PCL5 this is a completely different matter,
   and if you install Psyco you will never regret it !
-  Same remark applies for PCL6 (aka PCLXL) but performance improvement
-  is yet to be fully tested (it is very high anyway).
+  Same remark applies for PCL6 (aka PCLXL) : the parser is completely
+  different, but the performance gain with Psyco is impressive.
   
   You may also benefit from having the following tools installed to
@@ -268 +261 @@
   the Print Server. The PostgreSQL client libraries' version must 
   match the PostgreSQL version used on the Quota Storage Server. 
-  BEWARE : under Debian Sarge, as of March 15th 2004, there's a
-  problem with python2.2-pygresql and python-2.3-pygresql, so please
-  install python2.1-pygresql and use Python 2.1 to install and run
-  PyKota. This is not a bug in PyKota, and this should be fixed
-  by Debian in a few days I hope.
   
 or  
@@ -307 +295 @@
 
 Go to the initscripts subdirectory of PyKota's sources, and choose
-the appropriate storage backend for your configuration. Read
+the appropriate storage backend for your configuration. Read carefully
 the associated README file and execute the initialization script
 to create an empty PyKota Storage. Upgrade scripts may be 
@@ -314 +302 @@
 Copy the conf/pykota.conf.sample and  conf/pykotadmin.conf.sample 
 sample configuration files to /etc/pykota/pykota.conf and 
-/etc/pykota/pykotadmin.conf. The installation script tries to do 
-this for you if needed and you agreed to this action. You need to 
-adapt these files to your own needs. Especially you have to create 
+/etc/pykota/pykotadmin.conf (the installation script tries to do 
+this for you if needed and you agreed to this action). You need to 
+adapt these files to your own needs. Especially you may have to create 
 sections named after your own printers, and change the 
 administrator's email address which by default is root@localhost.
@@ -342 +330 @@
           $ /etc/init.d/cupsys restart
           
+        or :    
+      
+          $ /etc/rc.d/init.d/cupsysrestart
+          
+        or any similar command depending on your operating system.  
+          
     For new printers :
     
@@ -358 +352 @@
         
         Now double check /etc/pykota/pykota.conf 
-        This file should contain a section named after the
+        
+        You should manually create a section named after the
         printer you've just added, unless you have set
         all options globally.
+        
         The new pkhint command can help you with correct settings 
         for your printers, but don't rely on it because it is still
-        incomplete.
+        experimental work. To use pkhint, you have to feed it with
+        CUPS' printers.conf file this way :
+        
+          $ pkhint </etc/cups/printers.conf
+        
+        pkhint will try to tell you what is the best accounting
+        method for each printer and will print some lines you'll
+        just have to copy&paste in the appropriate sections in
+        /etc/pykota/pykota.conf
         
         That's all.
@@ -399 +403 @@
         
         Save the file and restart CUPS.
+        
+        Here too, you may find it interesting to use the pkhint command as
+        described above to help with manual configuration of the file
+        /etc/pykota/pykota.conf
 
   - LPRng Printing System :
   
-      For now LPRng support in PyKota is deactivated. Please be patient.
+    For each printer on which you want to use PyKota :
+    
+        Modify the printer's entry in /etc/printcap : you have to add
+        the three following lines :
+        
+          :ac=true:\
+          :as=/usr/share/pykota/lprngpykota:\
+          :ae=/usr/share/pykota/lprngpykota:\
+          
+        This will tell LPRng to activate accounting, and use the lprngpykota 
+        accounting filter both at the start and at the end of printing. 
+        
+    When all modifications are done, just save the /etc/printcap file and    
+    restart LPRng :
+    
+          $ /etc/init.d/lprng restart
+          
+        or :    
+      
+          $ /etc/rc.d/init.d/lprng restart
+          
+        or any similar command depending on your operating system.  
+        
+    NB : the pkhint command can't be used with LPRng for now, so you    
+         have to modify /etc/pykota/pykota.conf carefully. The comments
+         in this file will help you.
       
 Now you can begin to populate the PyKota's database with printers,
@@ -489 +522 @@
     http://cgi.librelogiciel.com/mailman/listinfo/pykota
     
+  The mailing list is the preferred way to obtain support, because  
+  all members can help and can also benefit from the solutions
+  proposed by other members. 
+  
+  Posts by non-members are usually rejected.
+  
+  The mailing list language is english and only english.
+    
 IRC :    
 -----
@@ -496 +537 @@
         /server irc.freenode.net
         /join #pykota
+        
+  Preferred language on this channel is english, but french      
+  is also accepted. Try to avoid exposing complex problems
+  in french because english speaking people on the channel
+  wouldn't benefit from the solutions.
+  
+  PyKota's main author is known as 'tamere' on IRC.
     
 ============================================================