= Aktualizacja systemu eDokumenty = #tytul === Menu === 1. [#kopia_zapasowa Tworzenie kopii zapasowej systemu] 2. [#pobranie Pobranie nowej wersji systemu i rozpakowanie archiwum][[BR]] 2.1 [#pobranie_windows Pobranie pakietu dla systemu Windows][[BR]] 2.2 [#pobranie_linux Pobranie pakietu dla systemu Linux] 3. [#aktualizacja Aktualizacja systemu przez przeglądarkę] == Tworzenie kopii zapasowej systemu == #kopia_zapasowa Wykonujemy kopię ''public_html'' - standardowo znajduje się w katalogu {{{C:\Program Files\BetaSoft\eDokumenty}}} albo {{{/home/edokumenty}}}. Dodatkowo zaleca się wykonanie kopii bezpieczeństwa repozytorium oraz bazy danych Opis procesu tworzenia backupów jest opisany w artykule [wiki:AdminGuide/Procedures/BackupAndRestore Kopia zapasowa i odtworzenie systemu eDokumenty] ''Przejdź do [#tytul menu]'' == Pobranie nowej wersji systemu i rozpakowanie archiwum == #pobranie Aby dokonać aktualizacji systemu należy po pierwsze pobrać na serwer nową wersję systemu w formacie zip, po drugie rozpakować ją we właściwym miejscu i po trzecie postępować zgodnie z kreatorem aktualizacji. === Windows === #pobranie_windows Pobieramy przez przeglądarkę paczkę aktualizacji (ZIP) z [http://support.edokumenty.eu/download/] z gałęzi stable (w szczególnych przypadkach można pobrać z gałęzi latest). Rozpakowujemy do {{{C:\Program files\Betasoft\eDokumenty\}}}. Tak aby nadpisał się katalog ''public_html''. Uwaga!!! Należy sprawdzić uprawnienia użytkownika ''www-data'' do pliku ''config.inc''. Podczas próby instalacji opisanej w następnej sekcji może wyskoczyć błąd braku uprawnień. Opis rozwiązania tego problemu jest zawarty w artykule: [wiki:AdminGuide/FilePermissions Uprawnienia do plików systemu eDokumenty] ''Przejdź do [#tytul menu]'' === Linux === #pobranie_linux Jeżeli pracujemy w systemie Linux i mamy do dyspozycji konsolę można pobrać paczkę za pomocą komendy ''wget''. (Logowanie wg danych do Forum, wiki itp). Uwaga! Pliki rozpakowujemy z użytkownika '''edokumenty'''. Dla PHP5.6 należy pobrać paczkę zakończoną sufiksem php56 np. eDokumenty-5.0.37-php56.zip. {{{ #zmiana użytkownika su - edokumenty #pobranie pakietu instalacyjnego wget --user= --password= http://support.edokumenty.eu/download/application/latest/eDokumenty-5.0.37-php56.zip #rozpakowanie archiwum. Uwaga!!! należy uważać na pytania zadawane w konsoli przez program unzip. unzip eDokumenty-5.0.37-php56.zip # Odpowiadamy [A- All] }}} Zastępujemy public_html katalogiem wypakowanym z paczki aktualizacyjnej. Zwracamy uwagę na ustawienie odpowiednich uprawnień do plików (linki do odpowiednich artykułów powyżej). ''Przejdź do [#tytul menu]'' == Aktualizacja systemu przez przeglądarkę == #aktualizacja Aktualizację systemu można uruchomić z dwóch poziomów. Z poziomu uruchomionego systemu Administrator wybiera menu ''Narzędzia >> Aktualizacja'' [[BR]][[Image(aktualizacja001.jpg)]][[BR]] (''Rys.1'')[[BR]] Otwiera się okienko przejścia do panelu aktualizacji [[BR]][[Image(aktualizacja002.jpg)]][[BR]] (''Rys.2'')[[BR]] Kliknięcie przycisku ''Przejdź'' przenosi nas do strony logowania aktualizacji systemu. [[BR]][[Image(aktualizacja003.jpg)]][[BR]] (''Rys.3'')[[BR]] Innym sposobem na osiągnięcie tego samego celu jest wpisanie w oknie przeglądarki adresu {{{http://localhost/apps/upgrade/}}}, gdzie ''localhost'' zastąpić należy adresem serwera. [[BR]][[Image(aktualizacja004.jpg)]][[BR]] (''Rys.4'')[[BR]] Logujemy się do systemu jako administrator. Pierwszy ekran kreatora informuje nas o krokach, jakie będą realizowane podczas aktualizacji. Przez kolejne etapy należy przechodzić naciskając przycisk ''Dalej''. [[BR]][[Image(aktualizacja005.jpg)]][[BR]] (''Rys.5'')[[BR]] Pierwszym krokiem w procesie jest wyłączenie systemu. Krok ten powoduje wylogowanie użytkowników, którym pojawi się monit ''trwa aktualizacja systemu''. [[BR]][[Image(aktualizacja006.jpg)]][[BR]] (''Rys.6'')[[BR]] Opis ''Stan systemu - Załączony'' zmienia się na ''Stan systemu - Wyłączony''. Na tym etapie może wystąpić błąd braku uprawnień do pliku ''config.inc'', co zostało już wspomniane wcześniej [wiki:AdminGuide/FilePermissions Uprawnienia do plików systemu eDokumenty] [[BR]][[Image(aktualizacja007.jpg)]][[BR]] (''Rys.7'')[[BR]] Kiedy system jest wyłączony można przejść do utworzenia kopii zapasowych. Podstawowy opis przedstawiony jest w kreatorze, natomiast dokładny opis ręcznego tworzenia kopii bazy danych jest przedstawiony w artykule: [wiki:AdminGuide/Procedures/BackupAndRestore Kopia zapasowa i odtworzenie systemu eDokumenty] [[BR]][[Image(aktualizacja008.jpg)]][[BR]] (''Rys.8'')[[BR]] Następnie przechodzimy do robienia kopii katalogu ''public_html''. Jeżeli nie zrobiliśmy tego wcześniej, to jest to ostatni moment, aby wykonać kopię tego katalogu. [[BR]][[Image(aktualizacja009.jpg)]][[BR]] (''Rys.9'')[[BR]] Ostatnią czynnością w zakresie tworzenia kopii zapasowych systemu jest zrzut repozytorium. Informacje, jak wykonać taka kopię zapasową, są przedstawione w kroku 4. kreatora aktualizacji. [[BR]][[Image(aktualizacja010.jpg)]][[BR]] (''Rys.10'')[[BR]] Krok 5. To czynności opisane wcześniej w niniejszej instrukcji, czyli pobranie pakietu i rozpakowanie katalogu ''public_html'' w taki sposób, aby nadpisać już istniejący. [[BR]][[Image(aktualizacja011.jpg)]][[BR]] (''Rys.11'')[[BR]] Następny krok jest kluczowym etapem w procesie aktualizacji systemu. Na tym etapie wykonywane są poprawki i modyfikacje (patche). System wyszukuje, czy są nowe poprawki. [[BR]][[Image(aktualizacja012.jpg)]][[BR]] (''Rys.12'')[[BR]] Jeżeli nie, to wyskakuje monit ''brak nowych patchy'' [[BR]][[Image(aktualizacja013.jpg)]][[BR]] (''Rys.13'')[[BR]] W przeciwnym przypadku wyświetli się lista patchy do wykonania. Warto również korzystając z górnej listy wersji sprawdzić, czy nie ma poprawek do starszych wersji systemu. Sugeruje się sprawdzać do dwóch wersji wstecz - czyli aktualizując system do wersji 3.8 należy sprawdzić, czy nie ma najpierw patchy do wersji 3.4, a następnie do wersji 3.6. Należy kliknąć przycisk ''Wykonaj'', aby wykonać wszystkie patche. [[BR]][[Image(aktualizacja014.jpg)]][[BR]] (''Rys.14'')[[BR]] Wyskakuje monit, czy na pewno wykonać niewykonane poprawki [[BR]][[Image(aktualizacja015.jpg)]][[BR]] (''Rys.15'')[[BR]] Jeżeli nie chcemy wykonywać naraz wszystkich poprawek, bądź wystąpiły błędy bądź ostrzeżenia podczas realizacji procesu aktualizacji, wtedy klikając dwa razy na wybranej aktualizacji możemy wykonać tylko ją: [[BR]][[Image(aktualizacja016.jpg)]][[BR]] (''Rys.16'')[[BR]] Efektem operacji jest wyświetlenie monitu z przebiegiem aktualizacji: [[BR]][[Image(aktualizacja019.jpg)]][[BR]] (''Rys.17'')[[BR]] ''Uwaga!!! Nie należy powtórnie wykonywać patchy, które przeszły z błędami. Taka operacja może spowodować uszkodzenie bazy danych!!! '' Po wykonaniu patchy przechodzimy ''Dalej'', gdzie nastąpi załączenie systemu [[BR]][[Image(aktualizacja017.jpg)]][[BR]] (''Rys.18'')[[BR]] Załączenie systemu umożliwi użytkownikom logowanie do systemu [[BR]][[Image(aktualizacja018.jpg)]][[BR]] (''Rys.19'')[[BR]] Klikamy ''Zakończ'', aby przejść do panelu logowania systemu. [[BR]][[Image(aktualizacja020.jpg)]][[BR]] (''Rys.20'')[[BR]] GOTOWE! ''Przejdź do [#tytul menu]''