Aktualizacja systemu eDokumenty

  1. Tworzenie kopii zapasowej systemu
  2. Pobranie nowej wersji systemu i rozpakowanie archiwum
    2.1 Pobranie pakietu dla systemu Windows
    2.2 Pobranie pakietu dla systemu Linux
  3. Aktualizacja systemu przez przeglądarkę

Tworzenie kopii zapasowej systemu

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 Kopia zapasowa i odtworzenie systemu eDokumenty

Przejdź do menu

Pobranie nowej wersji systemu i rozpakowanie archiwum

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)

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: Uprawnienia do plików systemu eDokumenty

Przejdź do menu

Linux (gdy instalacja Ready_™ wykonana jest na serwerach z rodziny 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=<USER> --password=<PASSWD> 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 menu

Aktualizacja systemu przez przeglądarkę

Aktualizację systemu można uruchomić z dwóch poziomów. Z poziomu uruchomionego systemu Administrator wybiera MENU O programiwa >> Aktualizacja systemu



(Rys.1)

Otwiera się okienko przejścia do panelu aktualizacji



(Rys.2)

Kliknięcie przycisku Przejdź przenosi nas do strony logowania aktualizacji systemu.



(Rys.3)

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_™



(Rys.4)

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.



(Rys.5)

Pierwszym krokiem w procesie jest wyłączenie systemu. Krok ten powoduje wylogowanie użytkowników, którym pojawi się monit trwa aktualizacja systemu.



(Rys.6)

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 Uprawnienia do plików systemu eDokumenty



(Rys.7)

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: Kopia zapasowa i odtworzenie systemu eDokumenty



(Rys.8)

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.



(Rys.11)

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.



(Rys.12)

Jeżeli nie, to wyskakuje monit brak nowych patchy



(Rys.13)

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.



(Rys.14)

Wyskakuje monit, czy na pewno wykonać niewykonane poprawki



(Rys.15)

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ą:



(Rys.16)

Efektem operacji jest wyświetlenie monitu z przebiegiem aktualizacji:



(Rys.17)

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



(Rys.18)

Załączenie systemu umożliwi użytkownikom logowanie do systemu



(Rys.19)

Klikamy Zakończ, aby przejść do panelu logowania systemu.



(Rys.20)

GOTOWE!

Przejdź do menu

Załączniki