= Instalacja i konfiguracja serwera PostgreSQL w systemie Windows = #postgresql

=== Menu ===
 * [#wstep Wstęp]
 * [#instalacja Instalacja i konfiguracja serwera baz danych]
 * [#konfiguracja Konfiguracja końcowa pod kątem systemu eDokumenty]


== Wstęp == #wstep

System eDokumenty korzysta z serwera baz danych PostgreSQL. Instalację i konfigurację należy rozpocząć od pobrania instalatora ze strony firmy EnterpriseDB: 
[http://www.enterprisedb.com/products-services-training/pgdownload#windows http://www.enterprisedb.com/products-services-training/pgdownload#windows]

[[Image(PostgreSQL_001.png)]] 
''Strona pobierania serwera baz danych PostgreSQL''[[BR]]

Sugeruje się instalację na systemie Windows w wersji 32-bitowej.

Dodatkowo zaleca sie utworzenie przed procesem instalacji docelowej ścieżki katalogów dla przechowywania baz danych. Dla celów bezpieczeństwa i wydajności nie powinien byc to dysk systemowy tylko wydzielony dysk/partycja. Dla przykładu ścieżka może wyglądać w sposób nastepujący:
{{{D:\SQL\PostgreSQL\9.3\data}}}. Tworzenie katalogów podczas instalacji powoduje niewyjaśniony błąd skutkujący tym, że usługa serwera postgresql nie chce się uruchomić.
 
[#postgresql Powrót do menu]

== Instalacja i konfiguracja serwera baz danych == #instalacja

Po pobraniu instalatora należy z poziomu użytkownika z uprawnieniami administratora uruchomić instalację.

[[Image(PostgreSQL_002.png)]] 
''Instalator serwera PostgreSQL''[[BR]]

Pierwszym krokiem instalacji jest wybranie katalogu instalacji PostgreSQL - tutaj można zostawić lokalizacje domyślną:

[[Image(PostgreSQL_003.png)]] 
''Określenie katalogu instalacji PostgreSQL''[[BR]]

Następnie nalezy wskazać ścieżkę przechowywania danych. Jak już wspomniano sugeruje się, aby nie była to ścieżka na dysku C:

[[Image(PostgreSQL_004.png)]] [[BR]]
[[Image(PostgreSQL_005.png)]] 
''Określenie katalogu danych PostgreSQL''[[BR]]

Kolejny krok to ustawienie hasła dla użytkownika postgres (użytkownik o najwyższych prawach administratora):

[[Image(PostgreSQL_006.png)]] 
''Ustawienie hasła dla uzytkownika postgres PostgreSQL''[[BR]]

Określenie portu działania usługi PostgreSQL - port 5432 jest domyślnym portem instalacji:

[[Image(PostgreSQL_007.png)]] 
''Port działania usługi PostgreSQL''[[BR]]

Ustawienie wykorzystywanego języka dla klastra PostgreSQL. Zaleca sie ustawienie {{{Polish, Poland}}}

[[Image(PostgreSQL_008.png)]] [[BR]]

Zasadniczo proces instalacji kończy się wraz przejściem dalej Next i zainstalowaniem serwera. Po zainstalowaniu zaleca się restart serwera w celu uaktywnienia wpisów w zmiennej systemowej PATH. Winien tam pojawić się wpis typu: {{{C:\Program Files (x86)\PostgreSQL\[WERSJA_POSTGRESA]\bin}}}.

Na ostatnim etapie instalacji system domyślnie chce instalować pakiet Stack Builder nie jest on wymagany.

[#postgresql Powrót do menu]

== Konfiguracja końcowa pod kątem systemu eDokumenty == #konfiguracja

W niniejszej sekcji opisano konfigurację, którą należy przeprowadzić w systemie PostgreSQL dla celów instalacji samego systemu eDokumenty.
Do tego celu najlepiej wykorzystać narzędzie zwane PgAdmin3, które instaluje się wraz z serwerem PostgreSQL.
Konfiguracja obejmowac będzie:
 * Utworzenie ról/użytkowników na serwerze PostgreSQL
 * Utworzenie bazy eDokumenty
 
=== Utworzenie kont uzytkowników ===
Pierwszym krokiem po zalogowaniu się w narzędziu PgAdmin3 jest dodanie kont uzytkowników.
Należy dodać dwie role:
 * edokumenty - konto właściciela bazy
 * http - konto na którym operacje wykonuje serwer www
 
Konfigurację kont można przeprowadzić z poziomu interfejsu użytkownika:
 * Tworzymy nowy login roli:
[[Image(PostgreSQL_009.png)]] [[BR]]
 * Podajemy nazwę użytkownika
[[Image(PostgreSQL_010.png)]] [[BR]]
 * Ustawiamy hasło dostępu
[[Image(PostgreSQL_011.png)]] [[BR]]
 * Ustawiamy uprawnienia
[[Image(PostgreSQL_012.png)]] [[BR]] 

Opcjonalnie można skorzystać z gotowego skryptu SQL:

{{{
#!sql
CREATE ROLE edokumenty LOGIN ENCRYPTED PASSWORD md5('<hasło dla użytkownika http, np. 123234345>')
CREATEDB SUPERUSER REPLICATION
   VALID UNTIL 'infinity';
COMMENT ON ROLE edokumenty
  IS 'Uzytkownik/właściciel bazy eDokumenty';
}}}

Dla uzytkownika http


{{{
#!sql
CREATE ROLE http LOGIN ENCRYPTED PASSWORD md5('<hasło dla użytkownika http, np. 12345>')
   VALID UNTIL 'infinity';

}}}

 Wynikiem operacji będą utworzone role:
 
[[Image(PostgreSQL_013.png)]] [[BR]] 

=== Tworzenie bazy eDokumenty ===
Utworzenie bazy eDokumenty jest niezbędne do zainstalowania systemu eDokumenty (przez przeglądarkę internetową).

Pustą bazę pod instalację systemu eDokumenty tworzymy z poziomu uzytkownika postgres
{{{
psql -U postres
}}}


W celu złąożenia bazy należy w narzędziu zapytania wykonać następujący skrypt:

{{{
#!sql
-- DROP DATABASE IF EXISTS edokumenty;

CREATE DATABASE edokumenty
  WITH OWNER = edokumenty
       ENCODING = 'UTF8'
       TABLESPACE = pg_default
       LC_COLLATE = 'Polish_Poland.1250'
       LC_CTYPE = 'Polish_Poland.1250'
       CONNECTION LIMIT = -1;

COMMENT ON DATABASE edokumenty
  IS 'Baza danych systemu eDokumenty';

}}}


[#postgresql Powrót do menu]