= Instalacja przez przeglądarkę = #menu === Menu === 1. [#pkt1. Wymagania minimalne] 2. [#pkt2. Pobieranie pakietu instalacyjnego i przygotowanie do instalacji] 3. [#pkt3 Proces instalacji przez przeglądarkę] 4. [#pkt4 Czynności po instalacji i uruchomienie systemu] Aby zapewnić możliwość instalacji systemu eDokumenty w różnych środowiskach, udostępniono instalator webowy wykonujący instalację '''przez przeglądarkę'''. Jedynym wymaganiem do jego uruchomienia jest posiadanie systemu z zainstalowanym serwerem stron www - Apache 2.2 z obsługą języka skryptowego PHP w wersji min. 5.2.6 oraz serwerem baz danych PostgreSQL (w wersji min. 8.3). Na potrzeby tej instrukcji wykorzystano środowisko Ubuntu 12.04 LTS (wersja dekstop, analogicznie będzie w wersji server, tylko bez ładnych okienek) z PHP 5.3, Apache 2.2 i PostgreSQL 9.1. == Wymagania minimalne == #pkt1 Wymaganiem minimalnym takiej instalacji jest posiadanie zainstalowanego i skonfigurowanego serwera stron www. Instalację odpowiedniego oprogramowania i konfigurację opisuje artykuł: [wiki:AdminGuide/RequiredPackages Instalacja na dowolnym systemie Linux]. ''Przejdź do [#menu menu]'' == Pobranie pakietu instalacyjnego i przygotowanie do instalacji == #pkt2 Niniejsze operacje należy wykonywać jako użytkownik edokumenty {{{ #!sh # Przejście z użytkownika root na uedokumenty root@edokumenty:/$ su - edokumenty edokumenty@edokumenty:~# # Pobranie pakietu przy pomocy polecenia wget: edokumenty@edokumenty:~#wget --user= --password= http://support.edokumenty.eu/download/application/latest/eDokumenty-4.0.x-php53.zip # (dla zainstalowanej wersji php 5.3) # Wersję php można sprawdzić poleceniem php -v # Po pobraniu rozpakowujemy archiwum edokumenty@edokumenty:~# unzip eDokumenty-4.0.x-php53.zip }}} Skoro posiadamy już gotowe środowisko, pobieramy odpowiedni dla wersji php pakiet instalacyjny (pik z rozszerzeniem '''.zip''') ze strony: [http://support.edokumenty.eu/download/application/stable/] lub [http://support.edokumenty.eu/download/application/latest/] (Rys.1). [[BR]][[Image(ipp_000.png)]][[BR]] (''Rys.1 - Pobranie pakietu instalacyjnego'')[[BR]] Następnie pobrany pik rozpakowujemy do katalogu głównego serwera (w tym przypadku do katalogu {{{~/public_html}}}) (Rys.2). [[BR]][[Image(ipp_001.png)]][[BR]] (''Rys.2 - Katalog główny serwera'')[[BR]] W tym momencie w katalogu tym posiadamy szereg katalogów i plików, które tworzą strukturę aplikacji eDokumenty (Rys.3). [[BR]][[Image(ipp_002.png)]][[BR]] (''Rys.3 - Struktura nadrzędna plików i katalogów systemu eDokumenty'')[[BR]] Następnie należy przejść do katalogu {{{~/public_html/apps/edokumenty}}} i zmienić nazwę katalogu '''install-''' na '''install''' (Rys.4 i 5). [[BR]][[Image(ipp_003.png)]][[BR]] (''Rys.4 - katalog instalacyjny przed zmianą nazwy'')[[BR]] [[BR]][[Image(ipp_004.png)]][[BR]] (''Rys.5 - Właściwa nazwa katalogu instalacyjnego'')[[BR]] ''Przejdź do [#menu menu]'' == Proces instalacji przez przeglądarkę == #pkt3 Kolejnym krokiem w tym procesie jest uruchomienie do wybranej przeglądarki internetowej i wpisanie w pasku adresu {{{http://localhost/}}}. Powinna pojawić się strona instalatora systemu eDokumenty. Jeżeli wyświetli się strona ''403 Forbidden'' i zobaczymy komunikat ''Forbidden. You don't have permission to access /apps/edokumenty/install on this server'' należy zmienić uprawnienia do plików (Rys.6). [[BR]][[Image(ipp_005.png)]][[BR]] (''Rys.6 - Złe uprawnienia powodem braku możliwości instalacji'')[[BR]] W przypadku wyświetlenia komunikatu: ''"PHP Fatal error: Incompatible file format: The encoded file has format major ID 4, whereas the Loader expects 5" '' oznacza to, że wykorzystano złą wersję systemu dla wersji php w systemie. Dla wersji: * PHP 5.2 należy pobrać źródła z systemu z opisem eDokumenty-....zip * PHP 5.3 eDokumenty-...-php53.zip * PHP 5.4 eDokumenty-...-php54.zip Informacje odnośnie uprawnień do plików i katalogów w systemie eDokumenty są opisane w artykule [wiki:AdminGuide/FilePermissions Uprawnienia do plików systemu eDokumenty] oraz częściowo w [wiki:AdminGuide/DebianInstaller Instalator dla Debiana] Prawidłowo załadowana strona powinna wyglądać następująco (Rys.7): [[BR]][[Image(ipp_006.png)]][[BR]] (''Rys.7 - Strona instalatora systemu eDokumenty'')[[BR]] Kolejne kroki będą realizowane poprzez klikanie przycisku ''Dalej''. Druga strona jest konfiguracją połączenia z bazą danych, gdzie wprowadzamy dane serwera oraz użytkowników, dzięki którym system eDokumenty będzie się komunikował z bazą danych ''edokumenty'' na serwerze PostgreSQL (Rys.8). [[BR]][[Image(ipp_007.png)]][[BR]] (''Rys.8 - Konfiguracja połączenia z bazą danych'')[[BR]] Idąc dalej musimy wprowadzić dane jednostki administracyjnej, dla której system jest instalowany (Rys.9): [[BR]][[Image(ipp_008.png)]][[BR]] (''Rys.9 - Wprowadzanie danych jednostki administracyjnej'')[[BR]] Kolejno wprowadzamy ilość licencji oraz numer licencji (Rys.10) [[BR]][[Image(ipp_009.png)]][[BR]] (''Rys.10 - Wprowadzanie klucza licencyjnego'')[[BR]] Ostatnim panelem konfiguracyjnym jest ustawienie użytkownika administracyjnego (wraz z jego hasłem), który będzie posiadał pełne prawa do systemu (Rys.11) [[BR]][[Image(ipp_010.png)]][[BR]] (''Rys.11 - Wprowadzanie klucza licencyjnego'')[[BR]] Następny ekran to przygotowanie do instalacji. Wystarczy tutaj kliknąć przycisk ''Instaluj'' i uruchomi się instalacja (Rys.12): [[BR]][[Image(ipp_011.png)]][[BR]] (''Rys.12 - Uruchamianie instalacji systemu'')[[BR]] O zakończeniu instalacji zostaniemy poinformowani szeregiem komunikatów (Rys.13): [[BR]][[Image(ipp_012.png)]][[BR]] (''Rys.13 - zakończona instalacja'')[[BR]] ''Przejdź do [#menu menu]'' == Czynności po instalacji i uruchomienie systemu == #pkt4 Po zakończeniu procesu instalacji należy przejść do katalogu {{{~/public_html/apps/edokumenty}}} i zmienić nazwę katalogu '''install''' na starą '''install-''' (Rys.14) (W przypadku, gdy na jednej instancji edokumentów nie będzie uruchamianych więcej niż jedna firma, wtedy można usunąć ten katalog). [[BR]][[Image(ipp_013.png)]][[BR]] (''Rys.14 - Usuwanie katalogu install'')[[BR]] Wreszcie w tym momencie możemy uruchomić system. W pasku adresu przeglądarki wpisujemy {{{http://localhost/}}}. Jeżeli uruchomi się strona logowania systemu eDokumenty, to znaczy, że instalacja przeszła poprawnie (Rys.15): [[BR]][[Image(ipp_014.png)]][[BR]] (''Rys.15 - Uruchomienie zainstalowanego systemu eDokumenty'')[[BR]] ''Przejdź do [#menu menu]'' == Podsumowanie == #pkt5 Jak widać proces instalacji przez przeglądarkę jest nieskomplikowany i intuicyjny. taki sposób instalacji pozwala dostosować i kontrolować instalację do środowiska pracy (serwera), gdyż analogicznie będzie się odbywać instalacja na systemach Windows. Kluczem tutaj jest prawidłowe przygotowanie środowiska tj. serwera Apache, interpretera PHP oraz serwera bazy danych PostgreSQL. ''Przejdź do [#menu menu]''