[svn/pld-doc]: rev 186 - pld-doc/howto
shufla w svn.pld-dc.org
shufla w svn.pld-dc.org
Wto, 6 Sty 2004, 18:34:35 CET
Author: shufla
Date: 2004-01-06 18:34:34 +0100 (Tue, 06 Jan 2004)
New Revision: 186
Added:
pld-doc/howto/pl_howto__postgresql.docb
Log:
- wersja poczatkowa;
- struktura dokumentu jest chyba do zmiany;
- wciecia do poprawy;
- zostawcie na razie, musze to i tak przemyslec;
Added: pld-doc/howto/pl_howto__postgresql.docb
===================================================================
--- pld-doc/howto/pl_howto__postgresql.docb 2004-01-06 17:02:44 UTC (rev 185)
+++ pld-doc/howto/pl_howto__postgresql.docb 2004-01-06 17:34:34 UTC (rev 186)
@@ -0,0 +1,191 @@
+<?xml version="1.0" encoding="iso-8859-2"?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
+]>
+<book lang="pl"><title></title>
+ <bookinfo>
+ <title>Prosta instalacja PostgreSQL na PLD</title>
+ <author>
+ <firstname>Łukasz</firstname>
+ <surname>Nowak</surname>
+ </author>
+ </bookinfo>
+ <chapter>
+ <title>Instalacja pakietów</title>
+ <para>
+ Uruchamiamy program poldek:
+ <screen>root# poldek</screen>
+ Wykonujemy:
+ <screen>poldek>ls -l postgresql-*</screen>
+ Przykładowy wynik to:
+ <screen>
+poldek> ls -l postgresql-*
+package build date size
+postgresql-7.4-0.8 2003/12/16 20:45 8.8 MB
+postgresql-backend-devel-7.4-0.8 2003/12/16 20:45 1.4 MB
+postgresql-clients-7.4-0.8 2003/12/16 20:45 1.5 MB
+postgresql-devel-7.4-0.8 2003/12/16 20:45 93.0 KB
+postgresql-doc-7.4-0.8 2003/12/16 20:45 5.3 MB
+postgresql-ecpg-7.4-0.8 2003/12/16 20:45 479.0 KB
+postgresql-ecpg-devel-7.4-0.8 2003/12/16 20:45 17.0 KB
+postgresql-libs-7.4-0.8 2003/12/16 20:45 252.0 KB
+postgresql-module-pgcrypto-7.4-0.8 2003/12/16 20:45 91.0 KB
+postgresql-module-plperl-7.4-0.8 2003/12/16 20:45 30.0 KB
+postgresql-module-plpgsql-7.4-0.8 2003/12/16 20:45 100.0 KB
+postgresql-module-plpython-7.4-0.8 2003/12/16 20:45 35.0 KB
+postgresql-module-pltcl-7.4-0.8 2003/12/16 20:45 44.0 KB
+postgresql-static-7.4-0.8 2003/12/16 20:45 303.0 KB
+postgresql-tcl-7.4-0.8 2003/12/16 20:45 38.0 KB
+postgresql-tcl-devel-7.4-0.8 2003/12/16 20:45 0.0 KB
+postgresql-tcl-static-7.4-0.8 2003/12/16 20:45 36.0 KB
+17 packages, 18.6 MB
+poldek>
+
+ </screen>
+ Do poprawnego działania SZDB PostgreSQL konieczne są następujące pakiety:
+ <itemizedlist>
+ <listitem><para>postgresql</para></listitem>
+ <listitem><para>postgresql-clients</para></listitem>
+ <listitem><para>postgresql-libs</para></listitem>
+ </itemizedlist>
+ Zatem można przystąpić do ich instalacji, wpisując następujące polecenie:
+ <screen>
+root# poldek -i postgresql postgresql-clients postgresql-libs
+ </screen>
+ Aby SZDB PostgreSQL skorzystał z wewnętrznych języków plpgsql czy też plphpython należy doinstalować pakiety postgresql-module-plpgsql <screen>root# poldek -i postgresql-module-plpgsql</screen> oraz <screen>root# poldek -i postgresql-module-plpython</screen>
+ </para>
+ </chapter>
+ <chapter>
+ <title>Konfiguracja PostgreSQLa w PLD</title>
+ <section><title>Wstępna konfiguracja</title>
+ <para>
+ Edytujemy plik <filename>/etc/sysconfig/postgresql</filename>:
+
+<screen>root# vim /etc/sysconfig/postgresql</screen>
+
+I wybieramy odopowiednie podejście do bazy danych. Polecam standard setting.
+Po edycji wykonanie komendy
+
+<screen>root# grep PG_DB_CLUSTERS /etc/sysconfig/postgresql | egrep -v ^#</screen>
+
+powinno dać wynik:
+
+<screen>PG_DB_CLUSTERS="/var/lib/pgsql"</screen>
+ </para>
+ </section>
+ <section><title>Sortowanie po polsku</title>
+ <para>
+Metoda nadesłana przez Marcina Dolińskiego:
+
+<screen>poldek -i localedb-src && localedb-gen -l pl_PL && echo LANG=pl_PL >>/etc/sysconfig/i18n</screen>
+TODO: locale tylko dla PostgreSQLa.
+ </para>
+</section>
+ </chapter>
+ <chapter>
+ <title>Inicjalizacja</title>
+ <para>
+Wykonujemy polecenie:
+
+<screen>root# /etc/rc.d/init.d/postgresql init</screen>
+Podczas inizjalizacji SZDB PostgreSQL stworzy pliki potrzebne mu do przechowywania tabel, tabele systemowe jak i bazy danych template0 i template1 konieczne do jego dalszego działania. Inicjalizacja PostgreSQLa nie jest równoznaczna z jego uruchomieniem, o czym dalej.
+ </para>
+ </chapter>
+ <chapter>
+ <title>Konfiguracja PostgreSQLa</title>
+ <para>
+W punkcie (3) (<- TODO, shufla docbook lame) został zainicjalizowany cluster, w którym to można dodawać bazy
+danych. Trzeba teraz odpowiednio skonfigurować tenże cluster. Przyda się
+edycja plików ${PG_DB_CLUSTERS}/{postgresql.conf,pg_hba.conf}:
+
+<screen>root# vim /var/lib/pgsql/{postgresql.conf,pg_hba.conf}</screen>
+
+Przydatna opcja to tcpip_socket = true w <filename>/var/lib/pgsql/postgresql.conf</filename>.
+
+ </para>
+ </chapter>
+ <chapter>
+ <title>Uruchomienie PostgreSQLa</title>
+ <para><screen>root# /etc/rc.d/init.d/postgresql start</screen></para>
+ </chapter>
+ <chapter>
+ <title>Dodanie użytkownika</title>
+ <para>
+ <screen>
+root# su - postgres -c 'psql template1'
+
+template1=# CREATE USER uzytkownik WITH ENCRYPTED PASSWORD 'hasło' CREATEUSER CREATEDB;
+CREATE USER
+ </screen>
+Użytkownik `uzytkownik' będzie miał możliwość tworzenia baz danych (za pomocą
+createdb lub CREATE DATABASE z poziomu psql) jak i dodawania użytkowników (createuser lub
+CREATE USER z poziomu psql).
+ </para>
+ </chapter>
+ <chapter>
+ <title>Ostatni test</title>
+ <para>
+ <screen>
+uzytkownik$ psql -h 127.0.0.1 template1
+template-1=# SELECT count(*) FROM pg_database;
+ count
+-------
+ 2
+(1 row)
+
+ </screen>
+ </para>
+ </chapter>
+ <chapter>
+ <title>Dodatki</title>
+ <para>
+Warto włączyć obsługę PostgreSQLa w PHP, instalując pakiet `php-pgsql',
+również w perlu `perl-DBD-Pg' lub `perl-Pg', oraz w pythonie
+`python-postgresql'. Pakiet `postgresql-devel' jest przydatny przy pisaniu
+aplikacji w C/C++ korzystających z PostgreSQLa. Dokumentacja do PostgreSQLa
+znajduje się, a jakże, w pakiecie `postgresql-doc'.
+
+<screen>root# poldek -i php-pgsql</screen>
+<screen>root# poldek -i perl-DBD-Pg</screen>
+<screen>root# poldek -i perl-Pg</screen>
+<screen>root# poldek -i python-postgresql</screen>
+<screen>root# poldek -i postgresql-devel</screen>
+<screen>root# poldek -i postgresql-doc</screen>
+
+ </para>
+ </chapter>
+ <chapter>
+ <title>Odnośniki</title>
+ <para>
+
+ </para>
+ </chapter>
+ <chapter>
+ <title>Odnośniki</title>
+ <para>
+ <itemizedlist>
+ <listitem><para>
+ <ulink url="http://pgsql.spsk1.pl/"><citetitle>bardzo dobry zestaw isotnych informacji po polsku
+ dotyczących PostgreSQLa</citetitle></ulink>
+ </para></listitem>
+ <listitem><para>
+ <ulink url="http://pgsql.spsk1.pl/postgresql-faq.html"><citetitle>FAQ PostgreSQLa po Polsku</citetitle></ulink>
+ </para></listitem>
+ <listitem><para>
+ <ulink url="/usr/share/doc/postgresql-*/FAQ_polish.gz"><citetitle>lokalna wersja FAQ, instalowana z
+ pakietem postgresql</citetitle></ulink>
+ </para></listitem>
+ </itemizedlist>
+ </para>
+ </chapter>
+ <chapter>
+ <title>Podziękowania</title>
+ <para>
+ Serdeczne dzięki dla:
+ <itemizedlist>
+ <listitem><para>Averne</para></listitem>
+ <listitem><para>y0shi</para></listitem>
+ <listitem><para>[pawelb]</para></listitem>
+ </itemizedlist>
+</para>
+ </chapter>
+</book>
Więcej informacji o liście dyskusyjnej pld-doc