= 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 dla Windows {{{C:\Program Files\BetaSoft\eDokumenty}}} , dla Linux {{{/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 (gdy instalacja Ready_™ jest na serwerze z systemem z rodziny WINDOWS) === #pobranie_windows Pobieramy przez przeglądarkę paczkę aktualizacji (ZIP) z [http://support.edokumenty.eu/download/application/ready/] 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'' , ''bin'', ''etc'', ''vendor'' . 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 (gdy instalacja Ready_™ wykonana jest na serwerach z rodziny 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 PHP7.2 należy pobrać paczkę zakończoną sufiksem php7.2 np. Ready_v6.xx.x-php72.zip . Gdzie xx-x to najnowsza dostępna wersją w katalogu stable. Należy pamiętać aby pobrać i rozpakować kod z pliku zip w folderze gdzie zainstalowane są eDokumenty/Ready_™. Domyślnie rozpakowujemy w {{{/home/edokumenty}}}, tak aby nadpisał się katalog ''public_html'', ''bin'', ''etc'', ''vendor''. Pobieramy przez przeglądarkę paczkę aktualizacji (ZIP) z [http://support.edokumenty.eu/download/application/ready/] z gałęzi stable (w szczególnych przypadkach można pobrać z gałęzi latest). {{{ #zmiana użytkownika su - edokumenty #pobranie pakietu instalacyjnego wget --user= --password= http://support.edokumenty.eu/download/application/ready/stable/Ready_v6.xx.x-php72.zip UWAGA! Należy zwrócić uwagę na kod aplikacji czy mamy wersję dla PHP 5.6 czy dla PHP 7.2 #rozpakowanie archiwum. Uwaga!!! należy uważać na pytania zadawane w konsoli przez program unzip. unzip Ready_v6.xx.x-php72.zip # Odpowiadamy [A- All] }}} Zastępujemy ''public_html'' , ''bin'', ''etc'', ''vendor'' katalogami 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 ''O programiwa >> Aktualizacja systemu'' [[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'' gdzie będzie prezentował adres naszego serwera, którym zainstalowany jest system eDokumenty/Ready_™ [[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'' , ''bin'', ''etc'', ''vendor''. Jeżeli nie zrobiliśmy tego wcześniej, to jest to ostatni moment, aby wykonać kopię tego katalogu. Tę czynność możemy wykonać poleceniem zip {{{ zip -r backup_edokumenty.zip public_html/ vendor/ }}} 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. {{{ svnadmin dump repos > repos.dump }}} Krok 5. To czynności opisane wcześniej w niniejszej instrukcji, czyli pobranie pakietu i rozpakowanie katalogu ''public_html'' , ''bin'', ''etc'', ''vendor'' 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 6.x należy sprawdzić, czy nie ma najpierw patchy do wersji 5.4, a następnie do wersji 6.x. 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]''