Wtyczka 

Wtyczka do systemu PlusWorkflow odpowiedzialna za przeprowadzanie aktualizacji automatycznych sytemu oraz innych komponentów.

Konfiguracja

Po zainstalowaniu wtyczki, będzie ona dostępna z poziomu menu w Administracja -> Konfiguracja Systemu -> Centrum aktualizacji.

...

Aktualizacja systemy PlusWorkflow

Konfiguracja początkowej wersji kompilacji systemu

Podczas pierwszej konfiguracji automatycznych aktualizacji niezbędne jest podanie wersji kompilacji aktualnie zainstalowanego systemu. Indykatorem braku tej wersji będzie czerwony baner. Wersję kompilacji (w przypadku systemów klienckich będzie to rewizja SVN) należy wpisać w pole i kliknąć Zapisz.

Image Modified

Wyszukiwanie aktualizacji

Aktualizacje wyszukiwane są automatycznie - sprawdzanie czy istnieje nowa wersja odbywa się kilka razy w ciągu godziny. Możemy również wymusić sprawdzanie aktualizacji poprzez przycisk  w prawym dolnym rogu.

...

•  Przeprowadzi aktualizację do najnowszej wersji
•  Pozwala na podanie wersji do której chcemy przeprowadzić aktualizację

Image Modified

Pobieranie aktualizacji

Po kliknięciu na przycisk Przygotuj aktualizację... zostanie ona pobrana w tle (może to zająć nawet kilka minut w zależności od rozmiaru i prędkości łącza).

Aktualizacja kompatybilna z aktualną wersją

Aktualizacja która pozytywnie przeszła walidacje wyświetlana jest z zielonym banerem.

...

•  Akceptacja aktualizacji (nie jest to jeszcze jednoznaczne z instalacją – nadal będzie można taką aktualizację anulować)
• Anuluje wybraną aktualizację
• Wyświetla szczegóły walidacji (np. ostrzeżenia)

Aktualizacja niekompatybilna z aktualną wersją

Jeżeli pobrana aktualizacja nie jest kompatybilna z aktualnym stanem systemu, zostanie wyświetlony następujący ekran:

...

•  Wymusza instalację aktualizacji bez względu na błędy walidacji ( przed wymuszeniem aktualizacji należy sprawdzić Szczegóły i upewnić się że taka aktualizacja jest bezpieczna)
•  Anuluje wybraną aktualizację
•  Wyświetla szczegóły błędów walidacji 

Zatwierdzanie aktualizacji

Po zatwierdzeniu aktualizacji wybieramy moment w którym dana aktualizacja ma zostać zainstalowana:

...

Po ponownym uruchomieniu system powinien być już aktualny:

Przywracanie wersji systemu z kopii zapasowej

Jeżeli dostępne są jakiekolwiek kopie zapasowe (tworzone podczas aktualizacji systemu) to na pasku narzędzi pojawi się ikona ustawień .

...

Po przygotowaniu kopii zapasowej zostanie ona zaplanowana do wykonania przy kolejnym uruchomieniu systemu:

Ręczne przywracanie kopii zapasowych

W przypadku gdy zmiany wprowadzone w aktualizacji uniemożliwiają uruchomienie systemu w celu przywrócenia kopii zapasowej, możemy dokonać przywrócenia kopii zapasowej ręcznie.

Patcher aktualizuje system przy uruchomieniu na podstawie plików zapisanych w katalogu .patcher w głównym katalogu web aplikacji (np. <tomcat>/webapps/PlusWorkflow/.patcher). Pliki kopii zapasowych zapisywane są w katalogu .patcher/backups.

W celu przywrócenia tych kopii zapasowych musimy stworzyć plik .patcher/patcher.plan z opisem planowanych działań:

{
  "serverURI" : "http://www.aktualizacje.plusworkflow.pl",
  "version" : "<wersja systemu>",
  "patches" : [ ],
  "rollbacks" : [ "<nazwy plików kopii zapasowych - tablica>" ],
  "client" : {
    "token" : {
      "token" : "<token>"
    },
    "environment" : {
      "env" : "<env>"
    }
  },
  "applyAfter" : null
}

• serverURI - adres serwera z aktualizacjami
• version - aktualna wersja projektu
• rollbacks - nazwy plików kopii zapasowych z katalogu backups które chcemy przywrócić (w kolejności przywracania – najmłodsze kopie na początku)
• client - konfiguracja klienta (token klienta i środowisko)

Gotowa struktura plików w katalogu .patcher musi wyglądać następująco:

Image Added
Po wprowadzeniu tych zmiany należy uruchomić system PlusWorkflow. Kopie zapasowe zostaną przywrócone dokładnie tak jak w przypadku przywracania ich z poziomu wtyczki.

Aktualizacja wtyczek

Aktualizacja wtyczek przebiega w uproszczonej formie w stosunku do aktualizacji systemu :

...

- instalowana jest natychmiast

...

Wszystkie wtyczki wyświetlane są w panelu Aktualizacje komponentów:

Image Removedi nie wymaga restartu systemu.

Aktualizacja do najnowszej kompatybilnej wersji (od wersji 1.0.0):

Przycisk aktualizacji wtyczki wyświetla najnowszą kompatybilną wersję wtyczki. Dodatkowo możliwy jest wybór innych kompatybilnych wersji do aktualizacji.

Image Added

Aktualizacja do nowszych niekompatybilnych wersji (od wersji 1.0.0):

W przypadku gdy wtyczka jest w najnowszej kompatybilnej wersji, ale istnieje nowsza wersja wtyczki - będzie ona widoczna na liście.

Image Added

Wybranie takiej wersji spowoduje wyświetlenie okna z opisem problemów:

Image Added

Downgrade wtyczek do starszych wersji (od wersji 1.0.0):

Podczas cofania wersji również sprawdzane są wymagania. Użytkownik zostanie poinformowany jeżeli cofnięcie wersji spowoduje problemy z działaniem innych wtyczek.

Image Added

Wybranie takiej wersji spowoduje wyświetlenie okna z opisem problemów:

Image Added

Logi aktualizacji

Zasoby

Wtyczka do pobrania w wersji 0.3.2

...