Changeset 2126

Timestamp:

03/05/05 19:54:54 (20 years ago)

Author:

jalet

Message:

Improved the installation documentation.
Now checkdeps also checks for the presence of GhostScript?, which
may be needed if PyKota's bannering facility is used or if some
printer driver produces non-DSC compliant PostScript?.

Location:

pykota/trunk

Files:

• checkdeps.py (modified) (2 diffs)
• docs/installation.sgml (modified) (13 diffs)
• README (modified) (2 diffs)

pykota/trunk/checkdeps.py

@@ -24 +24 @@
 #
 # $Log$
+# Revision 1.6  2005/03/05 18:54:54  jalet
+# Improved the installation documentation.
+# Now checkdeps also checks for the presence of GhostScript, which
+# may be needed if PyKota's bannering facility is used or if some
+# printer driver produces non-DSC compliant PostScript.
+#
 # Revision 1.5  2005/02/14 23:37:58  jalet
 # Added a check for the presence of pythn-psyco
@@ -98 +104 @@
                        ("Python-Psyco", "psyco", "Python-Psyco speedups parsing of print files, you should use it.\nSee http://psyco.sourceforge.net/"),
                      ]
-    commandstocheck = [ ("SNMP Tools", "snmpget", "SNMP Tools are needed if you want to use SNMP enabled printers."), 
+    commandstocheck = [ ("GhostScript", "gs", "Depending on your configuration, GhostScript may be needed in different parts of PyKota."),
+                        ("SNMP Tools", "snmpget", "SNMP Tools are needed if you want to use SNMP enabled printers."), 
                         ("Netatalk", "pap", "Netatalk is needed if you want to use AppleTalk enabled printers.")
                       ]

pykota/trunk/docs/installation.sgml

@@ -122 +122 @@
         Of course if your print server and your database servers have different <acronym>IP</acronym>
         addresses, you have to replace the <literal>127.0.0.1</literal> address above with your print
-        server's <acronym>IP</acronym> address.
+        server's <acronym>IP</acronym> address. As an alternative, you could still keep these
+        lines and add similar lines with other <acronym>IP</acronym> addresses if have several
+        print servers for which you want a single centralized database.
         <tip>
           <title>Tip</title>
@@ -297 +299 @@
           <title>Note</title>
           <para>
-            If you use RPM or DEB packages, usually the
-            <filename>pykota.schema</filename> file gets installed into the
-            <filename>/usr/share/pykota/ldap</filename> directory, along 
-            with a README file.
+            If you use RPM or DEB packages, the
+            <filename>pykota.schema</filename> file is usually installed into the
+            <filename>/usr/share/pykota/ldap</filename> directory, along
+            with a README file, and may also be installed automatically in
+            your <acronym>LDAP</acronym> server's schemas directory.
           </para>
         </note>  
@@ -379 +382 @@
         <command>ldapadd</command> command, or with some specialized tool
         like <command>gq</command>. You can look at the <filename>initscripts/ldap/pykota-sample.ldif</filename>
-        file to see what minimal branches are necessary.
+        file to see which minimal branches are necessary.
         <note>
           <title>Note</title>
           <para>
             If you use RPM or DEB packages, usually the
-            <filename>pykota-sample.ldif</filename> file gets installed into the
+            <filename>pykota-sample.ldif</filename> file is installed into the
             <filename>/usr/share/pykota/ldap</filename> directory, along 
             with a README file.
@@ -447 +450 @@
         <listitem>
           <para>
-            <application>CUPS</application> version 1.1 or above, or <application>LPRng</application>
+            <application>CUPS</application> version 1.1.14 or above, or <application>LPRng</application>
             version 3.8.27 or above (it probably works with older versions but this is untested).
             You can download them from <ulink url="http://www.cups.org">http://www.cups.org</ulink>
@@ -455 +458 @@
         <listitem>
           <para>
-            Python version 2.1 or above.
+            <application>Python</application> version 2.1 or above.
             You can download it from <ulink url="http://www.python.org">http://www.python.org</ulink>.
+            While <application>PyKota</application> itself will try to preserve compatibility
+            with <application>Python</application> version 2.1 for the near future, some <application>Python</application>
+            modules which are needed by <application>PyKota</application> may mandate the use of a more recent version
+            of this language.
           </para>
         </listitem>  
@@ -570 +577 @@
         <listitem>
           <para>
+            The <application>Python Imaging Library - PIL</application> module. 
+            You can download it from <ulink url="http://www.pythonware.com">http://www.pythonware.com</ulink>.
+          </para>
+        </listitem>  
+        <listitem>
+          <para>
             The <application>PyOSD</application> Python module. 
             You can download it from <ulink url="http://repose.cx/pyosd/">http://repose.cx/pyosd/</ulink>.
@@ -635 +648 @@
       In a future release, this documentation will include the complete
       reference for all configuration fields available. Keep in mind that
-      PyKota can be really heavily customized, and can delegate some work
+      <application>PyKota</application> can be really heavily customized, and can delegate some work
       to any external command of your choice.
     </para>
@@ -648 +661 @@
       define options either globally so that they apply to all printers,
       or on a per printer basis. Please see the sample configuration files
-      to see what I mean. In the simplest form, only a global section is
+      to see what I mean. In the simplest form, only a <literal>[global]</literal> section is
       needed. In more complex configurations, you will have to create 
       one section per printer. Each section in the configuration files
@@ -657 +670 @@
     
     <para>
-      After you have modified PyKota's configuration files, you have to
+      After you have modified <application>PyKota</application>'s configuration files, you have to
       double check their permissions, otherwise your installation may be
       insecure or may not work at all.
@@ -664 +677 @@
       readable by anyone. If normal users read this file, at best they
       will learn the username and optional password of the read-only
-      database user, so they won't be allowed to do any harm.
+      database user. This means that beside being allowed to read all the contents of
+      the quota database, they won't be allowed to modify or delete it.
       On the other hand, the <filename>~pykota/pykotadmin.conf</filename>
       file contains the read-write user's identity and password. You must then
@@ -692 +706 @@
     </para>
     
+    <para>
+      Don't forget to restart your print server sofware if you changed group membership for the user it runs
+      as, otherwise your change wouldn't be taken into account.
+    </para>
     
     <para>
@@ -702 +720 @@
       
       <para>
-        From version 1.16alpha7 on, configuring PyKota to integrate
-        within CUPS is more than easy.
+        From version 1.16alpha7 on, configuring <application>PyKota</application> to integrate
+        within <application>CUPS</application> is more than easy.
       </para>
       
       <para>
         You just have to create a symbolic link to the <filename>cupspykota</filename>
-        command in CUPS' backend directory :
+        command in <application>CUPS</application>' backend directory :
         <screen>        
 $ cd /usr/lib/cups/backend        
@@ -831 +849 @@
 
 $Log$
+Revision 1.33  2005/03/05 18:54:54  jalet
+Improved the installation documentation.
+Now checkdeps also checks for the presence of GhostScript, which
+may be needed if PyKota's bannering facility is used or if some
+printer driver produces non-DSC compliant PostScript.
+
 Revision 1.32  2005/02/28 23:17:40  jalet
 Improved documentation

pykota/trunk/README

@@ -241 +241 @@
 
   You can now purchase 8x5x365@NextBusinessDay Technical
-Support Contracts from us. The yearly fee is computed with  
-the following formula :
+  Support Contracts from us. The yearly fee is computed with  
+  the following formula :
 
   (100.0 * NbPrintServers) + (2.5 * NbPrinters) + (0.04 * NbUsers) EUROS.
   
   This fee includes the VAT, and a free subscription to official  
-PyKota packages.  
+  PyKota packages.  
 
   Please send an email to alet@librelogiciel.com if you're
-interested in purchasing such a contract.   
+  interested in purchasing such a contract.   
+
+  Remember that purchasing a support contract for Free Software like PyKota
+  is a great way to show your appreciation for the work already being done 
+  on this project, and will help to improve this software in the future.
 
 ============================================================
@@ -643 +647 @@
 
   - Kanakorn Horsiritham developped phpPykotaAdmin which is 
-    a web based database independant administrative GUI :
+    a web based database independant administrative GUI,
+    written in PHP.
   
       http://opensource.psu.ac.th/~kanakorn/mambo/
+      
+    He was also kind enough to write an installation guide  
+    in english for CUPS and PyKota with phpPykotaAdmin on Fedora
+    Core 3. You'll find this document on the same website.
+    
+    This great software currently at version 0.3 is a wonderful
+    basis for an administrative GUI since it only depends on 
+    PyKota commands to be present to successfully manage
+    PyKota's database. 
   
 Additionnal software will be listed here when they will be