[svn/pld-doc]: rev 218 - in pld-doc: book book/pl_book__uslugi howto
shufla w svn.pld-dc.org
shufla w svn.pld-dc.org
Pon, 12 Sty 2004, 11:23:45 CET
Author: shufla
Date: 2004-01-12 11:23:45 +0100 (Mon, 12 Jan 2004)
New Revision: 218
Added:
pld-doc/book/pl_book__uslugi/pl_uslugi_bazydanych__postgresql.sec
Removed:
pld-doc/howto/pl_howto__postgresql.docb
Modified:
pld-doc/book/pl_book__master.docb
pld-doc/book/pl_book__uslugi/pl_uslugi.chp
Log:
- moved PostgreSQL howto to proper section in book
Modified: pld-doc/book/pl_book__master.docb
===================================================================
--- pld-doc/book/pl_book__master.docb 2004-01-12 10:07:47 UTC (rev 217)
+++ pld-doc/book/pl_book__master.docb 2004-01-12 10:23:45 UTC (rev 218)
@@ -14,6 +14,7 @@
<!ENTITY uslugi SYSTEM "pl_book__uslugi/pl_uslugi.chp">
<!ENTITY uslugi_exim SYSTEM "pl_book__uslugi/pl_uslugi_poczta__exim.sec">
<!ENTITY uslugi_postfix SYSTEM "pl_book__uslugi/pl_uslugi_poczta__postfix.sec">
+<!ENTITY uslugi_postgresql SYSTEM "pl_book__uslugi/pl_uslugi_bazydanych__postgresql.sec">
]>
<!-- $LastChangedDate$ $LastChangedBy$ $Rev$ -->
<book lang="pl"><title>PLD Linux Distribution</title>
Modified: pld-doc/book/pl_book__uslugi/pl_uslugi.chp
===================================================================
--- pld-doc/book/pl_book__uslugi/pl_uslugi.chp 2004-01-12 10:07:47 UTC (rev 217)
+++ pld-doc/book/pl_book__uslugi/pl_uslugi.chp 2004-01-12 10:23:45 UTC (rev 218)
@@ -4,4 +4,5 @@
<para>W rozdziale tym przedstawimy opis instalacji i konfiguracji ważniejszych usług dostępnych w PLD</para>
&uslugi_exim;
&uslugi_postfix;
+ &uslugi_postgresql;
</chapter>
Added: pld-doc/book/pl_book__uslugi/pl_uslugi_bazydanych__postgresql.sec
===================================================================
--- pld-doc/book/pl_book__uslugi/pl_uslugi_bazydanych__postgresql.sec 2004-01-12 10:07:47 UTC (rev 217)
+++ pld-doc/book/pl_book__uslugi/pl_uslugi_bazydanych__postgresql.sec 2004-01-12 10:23:45 UTC (rev 218)
@@ -0,0 +1,190 @@
+<?xml version="1.0" encoding="iso-8859-2"?>
+<section>
+ <title>Prosta instalacja PostgreSQL na PLD</title>
+ <section>
+ <title>Co to jest PostgreSQL</title>
+ <section>
+ <title>PostgreSQL : The most advanced Open Source database system in the world</title>
+ <para>
+ PostgreSQL: Najbadziej zaawansowny system zarządzania bazą danych na świecie typu OpenSource - w taki oto sposób grupa rozwijająca SZDB PostgreSQL reklamuje swój produkt. SZDB PostgreSQL jest implementacją języka SQL, która zawiera w sobie bardzo wiele jego elementów, a na dodatek wprowadza wiele własnych rozszerzeń. Porównywany z mySQL oddaje mu pola przy małych instalacjach, które w prosty, a szybki sposób mają obsługiwać bazę danych - typu małe portale internetowe, proste bazy, i tym podobne. Jednakże SZDB PostgreSQL dostaje skrzydeł w większych projektach, jest często porównywany do bardzo robudowanego SZDB Oracle. Cechy SZDB PostgreSQL to między innymi:
+ <itemizedlist>
+ <listitem><para>osadzane języki proceduralne wykonywane przez bazę danych (plperl, pl/perlu, plpgsql, plpython, pltcl, pl/tclu)</para></listitem>
+ <listitem><para>możliwość tworzenia funkcji w PostgreSQLu w języku C, kompilowanych do bibliotek dynamicznych</para></listitem>
+ <listitem><para>sterowniki dostępu do bazy z języków C, C++, python, perl, czy Java (poprzez JDBC), ODBC</para></listitem>
+ <listitem><para>wysoce zaawansowana implementacja standardu SQL, obejmująca SQL/92</para></listitem>
+ <listitem><para>obsługa BLOB (Binary Large OBjects) -- dużych obiektów binarnych, takich jak pliki graficzne, itp.</para></listitem>
+ <listitem><para>obsługa pól typu AUTOINCREMENT jako SERIAL lub SEQUENCE</para></listitem>
+ <listitem><para>licencje BSD, która umożliwia zamykanie kodu SZDB PostgreSQL przy dokonywaniu modyfikacji, co jest istotne w rozwiązaniach biznesowych</para></listitem>
+ </itemizedlist>
+ </para>
+ </section>
+ </section>
+ <section>
+ <title>Instalacja pakietów</title>
+ <para>
+ Uruchamiamy program poldek:
+ <screen># 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>
+# 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># poldek -i postgresql-module-plpgsql</screen> oraz <screen>root# poldek -i postgresql-module-plpython</screen>
+ </para>
+ </section>
+ <section>
+ <title>Konfiguracja PostgreSQLa w PLD</title>
+ <section><title>Wstępna konfiguracja</title>
+ <para>
+ Edytujemy plik <filename>/etc/sysconfig/postgresql</filename>:
+
+<screen># vim /etc/sysconfig/postgresql</screen>
+
+I wybieramy odopowiednie podejście do bazy danych. Polecam standard setting.
+Po edycji wykonanie komendy
+
+<screen># 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>
+ </section>
+ <section>
+ <title>Inicjalizacja</title>
+ <para>
+Wykonujemy polecenie:
+
+<screen># /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>
+ </section>
+ <section>
+ <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># 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>
+ </section>
+ <section>
+ <title>Uruchomienie PostgreSQLa</title>
+ <para><screen># /etc/rc.d/init.d/postgresql start</screen></para>
+ </section>
+ <section>
+ <title>Dodanie użytkownika</title>
+ <para>
+ <screen>
+# 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>
+ </section>
+ <section>
+ <title>Ostatni test</title>
+ <para>
+ <screen>
+$ psql -h 127.0.0.1 template1
+template-1=# SELECT count(*) FROM pg_database;
+ count
+-------
+ 2
+(1 row)
+
+ </screen>
+ </para>
+ </section>
+ <section>
+ <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># poldek -i php-pgsql</screen>
+<screen># poldek -i perl-DBD-Pg</screen>
+<screen># poldek -i perl-Pg</screen>
+<screen># poldek -i python-postgresql</screen>
+<screen># poldek -i postgresql-devel</screen>
+<screen># poldek -i postgresql-doc</screen>
+
+ </para>
+ </section>
+ <section>
+ <title>Odnośniki</title>
+ <para>
+ <itemizedlist>
+ <listitem><para>
+ <ulink url="http://www.postgresql.org/"><citetitle>strona główna projektu PostgreSQL</citetitle></ulink>
+ </para></listitem>
+ <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>
+ <listitem><para>
+ <ulink url=""><citetitle>lokalna wersja FAQ, instalowana z
+ pakietem postgresql</citetitle></ulink>
+ </para></listitem>
+ </itemizedlist>
+ </para>
+ </section>
+</section>
Deleted: pld-doc/howto/pl_howto__postgresql.docb
===================================================================
--- pld-doc/howto/pl_howto__postgresql.docb 2004-01-12 10:07:47 UTC (rev 217)
+++ pld-doc/howto/pl_howto__postgresql.docb 2004-01-12 10:23:45 UTC (rev 218)
@@ -1,191 +0,0 @@
-<?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