Changeset 860

Show
Ignore:
Timestamp:
03/22/03 15:06:02 (22 years ago)
Author:
jalet
Message:

Quota Storage Server installation is OK for PostgreSQL.

Files:
1 modified

Legend:

Unmodified
Added
Removed
  • pykota/trunk/docs/installation.sgml

    r859 r860  
    33<chapter> 
    44  <title>Installation</title> 
     5   
     6  <para>Last modified on $Date$</para> 
     7   
    58  <para> 
    69    Before being able to use <application>PyKota</application>, you have of course to 
     
    1013  <para> 
    1114    First you have to determine which machine will be the <application>PyKota</application> 
    12     <glossaryterm>Storage Server</glossaryterm>. The Storage Server is the host responsible 
     15    <firstterm>Storage Server</firstterm>. The Storage Server is the host responsible 
    1316    for keeping a centralized database of print usage for all your printers, users and groups. 
    1417  </para> 
    1518   
    1619  <para> 
    17     Then you have to list all the <glossaryterm>Print Servers</glossaryterm> for which 
    18     you plan to use <glossaryterm>print quota</glossaryterm> facilities. 
     20    Then you have to list all the <firstterm>Print Servers</firstterm> for which 
     21    you plan to use <firstterm>print quota</firstterm> facilities. 
    1922  </para> 
    2023   
     
    4447       
    4548      <para> 
    46         <application>PostgreSQL</application> is an <glossaryterm>Object Relationnal DataBase 
    47         Management System</glossaryterm> distributed under a <glossaryterm>Free Software</glossaryterm> 
     49        <application>PostgreSQL</application> is an <firstterm>Object Relationnal DataBase 
     50        Management System</firstterm> distributed under a <firstterm>Free Software</firstterm> 
    4851        license from the  
    4952        <ulink url="http://www.postgresql.org">http://www.postgresql.org</ulink> 
     
    8588        server even if the configuration is correct. Sometimes your connections may be blocked by 
    8689        one or more network firewalls along the route from one machine to the other. If this 
    87         is the case, then the best thing you can do is to ask your <glossaryterm>Network Administrator</glossaryterm> 
     90        is the case, then the best thing you can do is to ask your <firstterm>Network Administrator</firstterm> 
    8891        to not filter the IP port used by <application>PostgreSQL</application>, which is 
    8992        usually port 5432/tcp. 
     93        <note> 
     94          <title>Note</title> 
     95          <para> 
     96            The TCP/IP network port used by PostgreSQL may be different. When in doubt, ask your  
     97            <firstterm>System Administrator</firstterm> for the correct value.  
     98          </para> 
     99        </note>   
     100      </para> 
     101       
     102      <para> 
     103        Now that your <application>PostgreSQL</application> server is up and running, and 
     104        is waiting for your connections, you have to create the Quota Storage DataBase. 
     105        To do so, you'll have to feed <application>PostgreSQL</application> with the 
     106        <filename>pykota-x.xx/initscripts/pykota-postgresql.sql</filename> file. 
     107        This file will create a Quota DataBase administrator and a Quota DataBase user 
     108        in the <application>PostgreSQL</application> system, then create an empty 
     109        Quota DataBase and set some permissions on it. 
     110      </para> 
     111       
     112      <para> 
     113        To run this script, you can use the <application>psql</application> frontend to 
     114        <application>PostgreSQL</application>, but your priviledges must be sufficient 
     115        to be allowed to create users and databases. You can launch <application>psql</application> 
     116        as the <literal>postgres</literal> user which is <application>PostgreSQL</application>'s 
     117        default administrator, and connect to the default database named <literal>template1</literal>. 
     118        From a command line interpreter (i.e. shell), type the following commands : 
     119        <screen> 
     120jerome@nordine:~$ cd pykota-1.02-official/initscripts/ 
     121jerome@nordine:~/pykota-1.02-official/initscripts$ psql -h localhost -U postgres template1 
     122Welcome to psql, the PostgreSQL interactive terminal. 
     123 
     124Type:  \copyright for distribution terms 
     125       \h for help with SQL commands 
     126       \? for help on internal slash commands 
     127       \g or terminate with semicolon to execute query 
     128       \q to quit 
     129 
     130template1=# \i pykota-postgresql.sql  
     131            ... a lot of output lines 
     132template1=# \q       
     133        </screen> 
     134      </para> 
     135       
     136      <para> 
     137        If no error occured, then your Quota DataBase is ready to be used. 
     138        Now you can let the Quota Storage Server alone, the remaining work 
     139        will have to be done on each one of the print servers which will 
     140        use this particular Quota Storage Server. 
    90141        <tip> 
    91142          <title>Tip</title> 
    92143          <para> 
    93             The TCP/IP network port used by PostgreSQL may be different. When in doubt, ask your  
    94             <glossaryterm>System Administrator</glossaryterm> for the correct value.  
     144            If an error occured, maybe your PostgreSQL version is too old, or 
     145            an unexpected problem (like a bug) happened. Please send me an email so that I 
     146            can try to solve the problem. Thanks in advance. 
    95147          </para> 
    96148        </tip>   
    97       </para> 
    98        
    99       <para> 
    100         TODO. 
    101149      </para> 
    102150    </sect2>   
     
    152200 
    153201$Log$ 
     202Revision 1.6  2003/03/22 14:06:02  jalet 
     203Quota Storage Server installation is OK for PostgreSQL. 
     204 
    154205Revision 1.5  2003/03/22 13:11:33  jalet 
    155206The port on which the Quota Storage Sever is listening can now