1 | <!-- $Id$ --> |
---|
2 | |
---|
3 | <chapter> |
---|
4 | <title>Installation</title> |
---|
5 | <para> |
---|
6 | Before being able to use <application>PyKota</application>, you have of course to |
---|
7 | install it first. But before installing, you must carefully plan your installation. |
---|
8 | </para> |
---|
9 | |
---|
10 | <para> |
---|
11 | 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 |
---|
13 | for keeping a centralized database of print usage for all your printers, users and groups. |
---|
14 | </para> |
---|
15 | |
---|
16 | <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. |
---|
19 | </para> |
---|
20 | |
---|
21 | <para> |
---|
22 | Now we will see what has to be done on all those servers. |
---|
23 | <note> |
---|
24 | <title>Note</title> |
---|
25 | <para> |
---|
26 | Of course, depending on the size of your network, you may very well |
---|
27 | use the same machine as both a Print Server and a Storage Server. |
---|
28 | This is especially the case if you've got only one server. |
---|
29 | </para> |
---|
30 | </note> |
---|
31 | </para> |
---|
32 | |
---|
33 | <sect1> |
---|
34 | <title>Storage Server Installation</title> |
---|
35 | |
---|
36 | <para> |
---|
37 | Depending on <application>PyKota</application>'s version number, different |
---|
38 | types of storage backends may be supported, so we will see for each one of |
---|
39 | them how to configure it. |
---|
40 | </para> |
---|
41 | |
---|
42 | <sect2> |
---|
43 | <title>PostgreSQL</title> |
---|
44 | |
---|
45 | <para> |
---|
46 | <application>PostgreSQL</application> is an <glossaryterm>Object Relationnal DataBase |
---|
47 | Management System</glossaryterm> distributed under a <glossaryterm>Free Software</glossaryterm> |
---|
48 | license from the |
---|
49 | <ulink url="http://www.postgresql.org">http://www.postgresql.org</ulink> |
---|
50 | web site. It certainely is the free <acronym>RDBMS</acronym> which has the most advanced |
---|
51 | features, and is widely used all over the world. |
---|
52 | </para> |
---|
53 | |
---|
54 | <para> |
---|
55 | To configure your Storage Server, you must have PostgreSQL already working. |
---|
56 | The complete installation of <application>PostgreSQL</application> is not covered by |
---|
57 | the present manual, please refer to your system's documentation or to |
---|
58 | <ulink url="http://www.postgresql.org">http://www.postgresql.org</ulink> for |
---|
59 | details. |
---|
60 | </para> |
---|
61 | |
---|
62 | <para> |
---|
63 | One thing you have to check, though, is that every Print Server on which you |
---|
64 | want to install the print quota mechanism must be able to connect to the |
---|
65 | <application>PostgreSQL</application> server. In the default installation of |
---|
66 | <application>PostgreSQL</application> this may not be the case for security reasons, except if both |
---|
67 | servers are in fact the same machine. In any case, it is recommended that you |
---|
68 | check the <filename>/etc/postgresql/pg_hba.conf</filename> and modify it if |
---|
69 | needed. This file is self documented and its modification is straightforward. |
---|
70 | <tip> |
---|
71 | <title>Tip</title> |
---|
72 | <para> |
---|
73 | Don't forget to restart <application>PostgreSQL</application> if you modify |
---|
74 | any of its configuration files, in order for the changes to take effect. |
---|
75 | </para> |
---|
76 | </tip> |
---|
77 | </para> |
---|
78 | |
---|
79 | <para> |
---|
80 | Be careful, you may be unable to connect from a Print Server to the <application>PostgreSQL</application> |
---|
81 | server even if the configuration is correct. Sometimes your connections may be blocked by |
---|
82 | one or more network firewalls along the route from one machine to the other. If this |
---|
83 | is the case, then the best thing you can do is to ask your <glossaryterm>Network Administrator</glossaryterm> |
---|
84 | to not filter the IP port used by <application>PostgreSQL</application>, which is |
---|
85 | usually port 5432/tcp. |
---|
86 | <tip> |
---|
87 | <title>Tip</title> |
---|
88 | <para> |
---|
89 | The TCP/IP network port used by PostgreSQL may be different. When in doubt, ask your |
---|
90 | <glossaryterm>System Administrator</glossaryterm> for the correct value. |
---|
91 | </para> |
---|
92 | </tip> |
---|
93 | </para> |
---|
94 | |
---|
95 | <para> |
---|
96 | TODO. |
---|
97 | </para> |
---|
98 | </sect2> |
---|
99 | |
---|
100 | <sect2> |
---|
101 | <title>MySQL</title> |
---|
102 | |
---|
103 | <para> |
---|
104 | TODO. |
---|
105 | </para> |
---|
106 | </sect2> |
---|
107 | |
---|
108 | <sect2> |
---|
109 | <title>LDAP</title> |
---|
110 | |
---|
111 | <para> |
---|
112 | TODO. |
---|
113 | </para> |
---|
114 | </sect2> |
---|
115 | |
---|
116 | <sect2> |
---|
117 | <title>Berkeley DB</title> |
---|
118 | |
---|
119 | <para> |
---|
120 | TODO. |
---|
121 | </para> |
---|
122 | </sect2> |
---|
123 | </sect1> |
---|
124 | |
---|
125 | <sect1> |
---|
126 | <title>Print Server Installation</title> |
---|
127 | |
---|
128 | <para> |
---|
129 | For each Print Server on which you plan to implement the print quota |
---|
130 | mechanism, you have, of course, to have an already working printing environment. |
---|
131 | Currently <application>PyKota</application> only works with the |
---|
132 | <ulink url="http://www.cups.org"><application>CUPS</application></ulink> environment, |
---|
133 | but more may be added in the future. |
---|
134 | </para> |
---|
135 | |
---|
136 | <para> |
---|
137 | TODO |
---|
138 | </para> |
---|
139 | </sect1> |
---|
140 | </chapter> |
---|
141 | |
---|
142 | <!-- |
---|
143 | |
---|
144 | $Log$ |
---|
145 | Revision 1.2 2003/03/18 22:10:54 jalet |
---|
146 | Documentation improvements. |
---|
147 | |
---|
148 | Revision 1.1 2003/02/08 00:03:35 jalet |
---|
149 | Documentation skeleton added |
---|
150 | |
---|
151 | |
---|
152 | --> |
---|