source: server/databases/postgresql.xml@ 5230b40

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 6.3 6.3-rc1 6.3-rc2 6.3-rc3 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts krejzi/svn lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 5230b40 was 5230b40, checked in by Randy McMurchy <randy@…>, 17 years ago

Downgraded OpenLDAP to the stable 2.3.32 version as the download page now properly reflects the versions; Updated to PostgreSQL-8.2.4

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@6837 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 19.9 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!-- <!ENTITY postgresql-download-http "http://gd.tuwien.ac.at/db/postgresql/source/v&postgresql-version;/postgresql-&postgresql-version;.tar.bz2"> -->
8 <!-- <!ENTITY postgresql-download-ftp "ftp://ftp.fr.postgresql.org/source/v&postgresql-version;/postgresql-&postgresql-version;.tar.bz2"> -->
9 <!ENTITY postgresql-download-http " ">
10 <!ENTITY postgresql-download-ftp "ftp://ftp5.us.postgresql.org/pub/PostgreSQL/source/v&postgresql-version;/postgresql-&postgresql-version;.tar.bz2">
11 <!ENTITY postgresql-md5sum "af7ec100a33c41bfb8d87b5e0ec2f44a">
12 <!ENTITY postgresql-size "12.5 MB">
13 <!ENTITY postgresql-buildsize "165 MB (additional 118 MB to run the testsuite)">
14 <!ENTITY postgresql-time "1.4 SBU">
15]>
16
17<sect1 id="postgresql" xreflabel="PostgreSQL-&postgresql-version;">
18 <?dbhtml filename="postgresql.html"?>
19
20 <sect1info>
21 <othername>$LastChangedBy$</othername>
22 <date>$Date$</date>
23 </sect1info>
24
25 <title>PostgreSQL-&postgresql-version;</title>
26
27 <indexterm zone="postgresql">
28 <primary sortas="a-PostgreSQL">PostgreSQL</primary>
29 </indexterm>
30
31 <sect2 role="package">
32 <title>Introduction to PostgreSQL</title>
33
34 <para><application>PostgreSQL</application> is an advanced
35 object-relational database management system (ORDBMS), derived
36 from the Berkeley Postgres database management system.</para>
37
38 <bridgehead renderas="sect3">Package Information</bridgehead>
39 <itemizedlist spacing="compact">
40 <listitem>
41 <para>Download (HTTP): <ulink url="&postgresql-download-http;"/></para>
42 </listitem>
43 <listitem>
44 <para>Download (FTP): <ulink url="&postgresql-download-ftp;"/></para>
45 </listitem>
46 <listitem>
47 <para>Download MD5 sum: &postgresql-md5sum;</para>
48 </listitem>
49 <listitem>
50 <para>Download size: &postgresql-size;</para>
51 </listitem>
52 <listitem>
53 <para>Estimated disk space required: &postgresql-buildsize;</para>
54 </listitem>
55 <listitem>
56 <para>Estimated build time: &postgresql-time;</para>
57 </listitem>
58 </itemizedlist>
59
60 <bridgehead renderas="sect3">PostgreSQL Dependencies</bridgehead>
61
62 <bridgehead renderas="sect4">Optional</bridgehead>
63 <para role="optional"><xref linkend="python"/>,
64 <xref linkend="tcl"/>,
65 <xref linkend="openssl"/>,
66 <xref linkend="openldap"/>,
67 <xref linkend="linux-pam"/>,
68 <ulink url="http://www.pdc.kth.se/kth-krb/">krb4</ulink>,
69 <xref linkend="mitkrb"/> or <xref linkend="heimdal"/>, and
70 <ulink url="http://developer.apple.com/networking/bonjour/">Bonjour</ulink></para>
71
72 <bridgehead renderas="sect4">Optional (To Regenerate Documentation)</bridgehead>
73 <para role="optional"><xref linkend="sgml-dtd"/>,
74 <xref linkend="docbook-dsssl"/>,
75 <xref linkend="openjade"/>, and
76 <xref linkend="perl-sgmlspm"/></para>
77
78 <para condition="html" role="usernotes">User Notes:
79 <ulink url="&blfs-wiki;/postgresql"/></para>
80
81 </sect2>
82
83 <sect2 role="installation">
84 <title>Installation of PostgreSQL</title>
85
86 <para>Install <application>PostgreSQL</application> with the
87 following commands: </para>
88
89<screen><userinput>sed -i "s|dsssl-stylesheets|&amp; \\\\\n sgml/docbook/&amp;-&docbook-dsssl-version;|" \
90 configure &amp;&amp;
91./configure --prefix=/usr --enable-thread-safety &amp;&amp;
92make</userinput></screen>
93
94 <para>To test the results, issue: <command>make check</command>.</para>
95
96 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
97
98<screen role="root"><userinput>make install &amp;&amp;
99chown -v root:root /usr/share/doc/postgresql/html/* &amp;&amp;
100install -v -m755 -d /usr/share/doc/postgresql/{FAQ/html,TODO.detail} &amp;&amp;
101install -v -m644 doc/TODO /usr/share/doc/postgresql &amp;&amp;
102install -v -m644 doc/FAQ* /usr/share/doc/postgresql/FAQ &amp;&amp;
103install -v -m644 doc/src/FAQ/* /usr/share/doc/postgresql/FAQ/html &amp;&amp;
104install -v -m644 doc/TODO.detail/* \
105 /usr/share/doc/postgresql/TODO.detail</userinput></screen>
106
107 <note>
108 <para>If you are upgrading an existing system and are going to install
109 the new files over the old ones, then you should back up your data, shut
110 down the old server and follow the instructions in <ulink
111 url="http://www.postgresql.org/docs/8.1/static/install-upgrading.html">the
112 official <application>PostgreSQL</application> documentation</ulink>.</para>
113 </note>
114
115 <para>Initialize a database cluster with the following commands issued by the
116 <systemitem class="username">root</systemitem> user:</para>
117
118<screen role="root"><userinput>install -v -m700 -d /srv/pgsql/data &amp;&amp;
119groupadd -g 41 postgres &amp;&amp;
120useradd -c "PostgreSQL Server" -g postgres -d /srv/pgsql/data \
121 -u 41 postgres &amp;&amp;
122chown -v postgres /srv/pgsql/data &amp;&amp;
123su - postgres -c '/usr/bin/initdb -D /srv/pgsql/data'</userinput></screen>
124
125 <para>As the <systemitem class="username">root</systemitem> user, start the
126 database server with the following command:</para>
127
128<screen role="root"><userinput>su - postgres -c '/usr/bin/postmaster -D /srv/pgsql/data > \
129 /srv/pgsql/data/logfile 2&gt;&amp;1 &amp;'</userinput></screen>
130
131 <para>Still as user <systemitem class="username">root</systemitem>, create
132 a database and verify the installation:</para>
133
134<screen role="root"><userinput>su - postgres -c '/usr/bin/createdb test' &amp;&amp;
135echo "create table t1 ( name varchar(20), state_province varchar(20) );" \
136 | (su - postgres -c '/usr/bin/psql test ') &amp;&amp;
137echo "insert into t1 values ('Billy', 'NewYork');" \
138 | (su - postgres -c '/usr/bin/psql test ') &amp;&amp;
139echo "insert into t1 values ('Evanidus', 'Quebec');" \
140 | (su - postgres -c '/usr/bin/psql test ') &amp;&amp;
141echo "insert into t1 values ('Jesse', 'Ontario');" \
142 | (su - postgres -c '/usr/bin/psql test ') &amp;&amp;
143echo "select * from t1;" | (su - postgres -c '/usr/bin/psql test')</userinput></screen>
144
145 </sect2>
146
147 <sect2 role="commands">
148 <title>Command Explanations</title>
149
150 <para><command>sed -i "s|dsssl-stylesheets|..."</command>: This command
151 puts an extra line in the <command>configure</command> script so that the
152 BLFS installed version of the DSSSL stylesheets are discovered.</para>
153
154 <para><parameter>--enable-thread-safety</parameter>: This switch makes the
155 client libraries thread-safe by allowing concurrent threads in
156 <filename class='libraryfile'>libpq</filename> and ECPG programs to safely
157 control their private connection handles.</para>
158
159 <para><command>chown -R root:root /usr/share/doc/postgresql/html/*</command>:
160 This command corrects the improper ownership of documentation files.</para>
161
162 <para><command>groupadd ...</command>; <command>useradd ...</command>:
163 These commands add an unprivileged user and group to run the database
164 server.</para>
165
166 <para><command>createdb test; create table t1; insert into t1 values...;
167 select * from t1</command>: Create a database, add a table to it, insert
168 some rows into the table and select them to verify that the installation
169 is working properly.</para>
170
171 </sect2>
172
173 <sect2 role="configuration">
174 <title>Configuring PostgreSQL</title>
175
176 <sect3 id="postgresql-config">
177 <title>Config Files</title>
178
179 <para><filename>$PGDATA/pg_ident.con</filename>,
180 <filename>$PGDATA/pg_hba.conf</filename> and
181 <filename>$PGDATA/postgresql.conf</filename></para>
182
183 <indexterm zone="postgresql postgresql-config">
184 <primary sortas="e-A.PGDATA-pg_ident.con">$PGDATA/pg_indent.con</primary>
185 </indexterm>
186
187 <indexterm zone="postgresql postgresql-config">
188 <primary sortas="e-A.PGDATA-pg_hba.conf">$PGDATA/pg_hba_conf</primary>
189 </indexterm>
190
191 <indexterm zone="postgresql postgresql-config">
192 <primary sortas="e-A.PGDATA-postgresql.conf">$PGDATA/postgresql.conf</primary>
193 </indexterm>
194
195 <para>The <envar>PGDATA</envar> environment variable is used to
196 distinguish database clusters from one another by setting it to
197 the value of the directory which contains the cluster desired.
198 The three configuration files exist in every <filename
199 class="directory">PGDATA/</filename> directory. Details on the
200 format of the files and the options that can be set in each can
201 be found in <ulink
202 url="file:///usr/share/doc/postgresql/html/index.html"/>.</para>
203
204 </sect3>
205
206 <sect3 id="postgresql-init">
207 <title>Boot Script</title>
208
209 <para>Install the <filename>/etc/rc.d/init.d/postgresql</filename>
210 init script included in the
211 <xref linkend="bootscripts"/> package.</para>
212
213 <indexterm zone="postgresql postgresql-init">
214 <primary sortas="f-postgresql">postgresql</primary>
215 </indexterm>
216
217<screen role="root"><userinput>make install-postgresql</userinput></screen>
218
219 </sect3>
220
221 </sect2>
222
223 <sect2 role="content">
224 <title>Contents</title>
225
226 <segmentedlist>
227 <segtitle>Installed Programs</segtitle>
228 <segtitle>Installed Libraries</segtitle>
229 <segtitle>Installed Directories</segtitle>
230
231 <seglistitem>
232 <seg>clusterdb, createdb, createlang, createuser, dropdb, droplang,
233 dropuser, ecpg, initdb, ipcclean, pg_config, pg_controldata, pg_ctl,
234 pg_dump, pg_dumpall, pg_resetxlog, pg_restore, pltcl_delmod,
235 pltcl_listmod, pltcl_loadmod, postgres, postmaster, psql,
236 reindexdb, and vacuumdb</seg>
237 <seg>libecpg.{so,a}, libecpg_compat.{so,a}, libpgport.a, libpgtypes.{so,a},
238 libpq.{so,a}, and various charset modules.</seg>
239 <seg>/srv/pgsql, /usr/include/libpq, /usr/include/postgresql,
240 /usr/lib/postgresql, /usr/share/doc/postgresql, and
241 /usr/share/postgresql</seg>
242 </seglistitem>
243 </segmentedlist>
244
245 <variablelist>
246 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
247 <?dbfo list-presentation="list"?>
248 <?dbhtml list-presentation="table"?>
249
250 <varlistentry id="clusterdb">
251 <term><command>clusterdb</command></term>
252 <listitem>
253 <para>is a utility for reclustering tables in a
254 <application>PostgreSQL</application> database.</para>
255 <indexterm zone="postgresql clusterdb">
256 <primary sortas="b-clusterdb">clusterdb</primary>
257 </indexterm>
258 </listitem>
259 </varlistentry>
260
261 <varlistentry id="createdb">
262 <term><command>createdb</command></term>
263 <listitem>
264 <para> creates a new <application>PostgreSQL</application>
265 database.</para>
266 <indexterm zone="postgresql createdb">
267 <primary sortas="b-createdb">createdb</primary>
268 </indexterm>
269 </listitem>
270 </varlistentry>
271
272 <varlistentry id="createlang">
273 <term><command>createlang</command></term>
274 <listitem>
275 <para>defines a new <application>PostgreSQL</application> procedural
276 language.</para>
277 <indexterm zone="postgresql createlang">
278 <primary sortas="b-createlang">createlang</primary>
279 </indexterm>
280 </listitem>
281 </varlistentry>
282
283 <varlistentry id="createuser">
284 <term><command>createuser</command></term>
285 <listitem>
286 <para>defines a new <application>PostgreSQL</application>
287 user account.</para>
288 <indexterm zone="postgresql createuser">
289 <primary sortas="b-createuser">createuser</primary>
290 </indexterm>
291 </listitem>
292 </varlistentry>
293
294 <varlistentry id="dropdb">
295 <term><command>dropdb</command></term>
296 <listitem>
297 <para>removes a <application>PostgreSQL</application> database.</para>
298 <indexterm zone="postgresql dropdb">
299 <primary sortas="b-dropdb">dropdb</primary>
300 </indexterm>
301 </listitem>
302 </varlistentry>
303
304 <varlistentry id="droplang">
305 <term><command>droplang</command></term>
306 <listitem>
307 <para>removes a <application>PostgreSQL</application> procedural
308 language.</para>
309 <indexterm zone="postgresql droplang">
310 <primary sortas="b-droplang">droplang</primary>
311 </indexterm>
312 </listitem>
313 </varlistentry>
314
315 <varlistentry id="dropuser">
316 <term><command>dropuser</command></term>
317 <listitem>
318 <para>removes a <application>PostgreSQL</application>
319 user account.</para>
320 <indexterm zone="postgresql dropuser">
321 <primary sortas="b-dropuser">dropuser</primary>
322 </indexterm>
323 </listitem>
324 </varlistentry>
325
326 <varlistentry id="ecpg">
327 <term><command>ecpg</command></term>
328 <listitem>
329 <para>is the embedded SQL preprocessor.</para>
330 <indexterm zone="postgresql ecpg">
331 <primary sortas="b-ecpg">ecpg</primary>
332 </indexterm>
333 </listitem>
334 </varlistentry>
335
336 <varlistentry id="initdb">
337 <term><command>initdb</command></term>
338 <listitem>
339 <para>creates a new database cluster.</para>
340 <indexterm zone="postgresql initdb">
341 <primary sortas="b-initdb">initdb</primary>
342 </indexterm>
343 </listitem>
344 </varlistentry>
345
346 <varlistentry id="ipcclean">
347 <term><command>ipcclean</command></term>
348 <listitem>
349 <para>removes shared memory and semaphores left over by an aborted
350 database server.</para>
351 <indexterm zone="postgresql ipcclean">
352 <primary sortas="b-ipcclean">ipcclean</primary>
353 </indexterm>
354 </listitem>
355 </varlistentry>
356
357 <varlistentry id="pg_config">
358 <term><command>pg_config</command></term>
359 <listitem>
360 <para>retrieves <application>PostgreSQL</application> version
361 information.</para>
362 <indexterm zone="postgresql pg_config">
363 <primary sortas="b-pg_config">pg_config</primary>
364 </indexterm>
365 </listitem>
366 </varlistentry>
367
368 <varlistentry id="pg_controldata">
369 <term><command>pg_controldata</command></term>
370 <listitem>
371 <para>returns information initialized during
372 <command>initdb</command>, such as the catalog version and server
373 locale.</para>
374 <indexterm zone="postgresql pg_controldata">
375 <primary sortas="b-pg_controldata">pg_controldata</primary>
376 </indexterm>
377 </listitem>
378 </varlistentry>
379
380 <varlistentry id="pg_ctl">
381 <term><command>pg_ctl</command></term>
382 <listitem>
383 <para>controls stopping and starting the database server.</para>
384 <indexterm zone="postgresql pg_ctl">
385 <primary sortas="b-pg_ctl">pg_ctl</primary>
386 </indexterm>
387 </listitem>
388 </varlistentry>
389
390 <varlistentry id="pg_dump">
391 <term><command>pg_dump</command></term>
392 <listitem>
393 <para>dumps database data and metadata into scripts which are used
394 to recreate the database.</para>
395 <indexterm zone="postgresql pg_dump">
396 <primary sortas="b-pg_dump">pg_dump</primary>
397 </indexterm>
398 </listitem>
399 </varlistentry>
400
401 <varlistentry id="pg_dumpall">
402 <term><command>pg_dumpall</command></term>
403 <listitem>
404 <para>recursively calls <command>pg_dump</command> for each
405 database in a cluster.</para>
406 <indexterm zone="postgresql pg_dumpall">
407 <primary sortas="b-pg_dumpall">pg_dumpall</primary>
408 </indexterm>
409 </listitem>
410 </varlistentry>
411
412 <varlistentry id="pg_resetxlog">
413 <term><command>pg_resetxlog</command></term>
414 <listitem>
415 <para>clears the write-ahead log and optionally resets some
416 fields in the <filename>pg_control</filename> file.</para>
417 <indexterm zone="postgresql pg_resetxlog">
418 <primary sortas="b-pg_resetxlog">pg_resetxlog</primary>
419 </indexterm>
420 </listitem>
421 </varlistentry>
422
423 <varlistentry id="pg_restore">
424 <term><command>pg_restore</command></term>
425 <listitem>
426 <para>creates databases from dump files created by
427 <command>pg_dump</command>.</para>
428 <indexterm zone="postgresql pg_restore">
429 <primary sortas="b-pg_restore">pg_restore</primary>
430 </indexterm>
431 </listitem>
432 </varlistentry>
433
434 <varlistentry id="pltcl_delmod">
435 <term><command>pltcl_delmod</command></term>
436 <listitem>
437 <para>is a support script used to delete a module from a
438 PL/<application>Tcl</application> table. The command
439 requires the <ulink
440 url="http://gborg.postgresql.org/project/pgtcl/">Pgtcl</ulink>
441 package to be installed also.</para>
442 <indexterm zone="postgresql pltcl_delmod">
443 <primary sortas="b-pltcl_delmod">pltcl_delmod</primary>
444 </indexterm>
445 </listitem>
446 </varlistentry>
447
448 <varlistentry id="pltcl_listmod">
449 <term><command>pltcl_listmod</command></term>
450 <listitem>
451 <para>is a support script used to list the modules in a
452 PL/<application>Tcl</application> table. The command
453 requires the <ulink
454 url="http://gborg.postgresql.org/project/pgtcl/">Pgtcl</ulink>
455 package to be installed also.</para>
456 <indexterm zone="postgresql pltcl_listmod">
457 <primary sortas="b-pltcl_listmod">pltcl_listmod</primary>
458 </indexterm>
459 </listitem>
460 </varlistentry>
461
462 <varlistentry id="pltcl_loadmod">
463 <term><command>pltcl_loadmod</command></term>
464 <listitem>
465 <para>is a support script used to load a module into a
466 PL/<application>Tcl</application> table. The command
467 requires the <ulink
468 url="http://gborg.postgresql.org/project/pgtcl/">Pgtcl</ulink>
469 package to be installed also.</para>
470 <indexterm zone="postgresql pltcl_loadmod">
471 <primary sortas="b-pltcl_loadmod">pltcl_loadmod</primary>
472 </indexterm>
473 </listitem>
474 </varlistentry>
475
476 <varlistentry id="postgres">
477 <term><command>postgres</command></term>
478 <listitem>
479 <para>is a single user database server, generally used for
480 debugging.</para>
481 <indexterm zone="postgresql postgres">
482 <primary sortas="b-postgres">postgres</primary>
483 </indexterm>
484 </listitem>
485 </varlistentry>
486
487 <varlistentry id="postmaster">
488 <term><command>postmaster</command></term>
489 <listitem>
490 <para>is a multi-user database daemon.</para>
491 <indexterm zone="postgresql postmaster">
492 <primary sortas="b-postmaster">postmaster</primary>
493 </indexterm>
494 </listitem>
495 </varlistentry>
496
497 <varlistentry id="psql">
498 <term><command>psql</command></term>
499 <listitem>
500 <para>is a console based database shell.</para>
501 <indexterm zone="postgresql psql">
502 <primary sortas="b-psql">psql</primary>
503 </indexterm>
504 </listitem>
505 </varlistentry>
506
507 <varlistentry id="reindexdb">
508 <term><command>reindexdb</command></term>
509 <listitem>
510 <para>is a utility for rebuilding indexes in a database.</para>
511 <indexterm zone="postgresql reindexdb">
512 <primary sortas="b-reindexdb">reindexdb</primary>
513 </indexterm>
514 </listitem>
515 </varlistentry>
516
517 <varlistentry id="vacuumdb">
518 <term><command>vacuumdb</command></term>
519 <listitem>
520 <para>compacts databases and generates statistics for the query
521 analyzer.</para>
522 <indexterm zone="postgresql vacuumdb">
523 <primary sortas="b-vacuumdb">vacuumdb</primary>
524 </indexterm>
525 </listitem>
526 </varlistentry>
527
528 </variablelist>
529
530 </sect2>
531
532</sect1>
Note: See TracBrowser for help on using the repository browser.