4.4. Aktualizace

Aktualizace na novou verzi vyžaduje několik kroků z pohledu administrátora systému.

Postup aktualizace se liší v závislosti na používané verzi aplikace, způsobu jejího nasazení a případných provedených lokálních úpravách. Tento návod je doporučeným postupem pro typové instalace z binární distribuce.

Před aktualizací je vždy vhodné zálohovat původní data tj. databázi aplikace a pracovní adresář work.

4.4.1. Aktualizace z verze 3.x

Stažení nové verze a konfigurace

Stáhněte si novou verzi aplikace a proveďte její konfiguraci shodně s původní konfigurací dle bodu Konfigurace a spuštění Elza.

Postup aktualizace

Provedení zálohy databáze
Zastavte aplikaci Elza
Proveďte aktualizaci aplikace a jejích balíčků
Spusťte aplikaci Elza

4.4.2. Aktualizace z verzí 2.x

Před provedením aktualizace na řadu 3 je zapotřebí provést kontrolu softwarového prostředí a splnění minimálních požadavků. Zejména se jedná o kontrolu verze databáze a dostupnost Java verze 17 a vyšší.

Předpokladem pro provedení aktualizace je nainstalovaná verze 2.x a vyšší.

Změna aktualizace balíčků

Do verze 3.0 bylo možné provést samostatně aktualizaci aplikace a následně v samostatném kroku realizovat aktualizaci balíčků. Nicméně již od verze 2.5.0 je možné balíčky s pravidly nahrávat přímo do pracovní složky Elza a tyto balíčky jsou v průběhu spouštění aplikace rovnou nahrány.

Od verze 3.0 dochází k aktualizaci balíčků výhradně při startu aplikace a definiční balíčky je nutné aktualizovat společně s binárními soubory.

Změna konfigurace

Pro práci se souřadnicemi v databázi je obvykle využíváno rozšíření PostGIS. V rámci konfigurace bylo nutné ve verzi 2.x definovat dialekt, který ho určoval. Tato volba již není nově k dispozici a detekce dialektu probíhá automaticky. Z konfigurace je nutné odstranit nastavení: spring.jpa.properties.hibernate.dialect.

První spuštění po aktualizaci

Po dokončení aktualizace na verzi 3 z verze 2.x je nutné:

Provedení kontroly verze pravidel nahraných balíčků. Verze ZP musí být větší než 300.
Spuštění reindexace dat. Provede se volbou v rozhraní pro administraci: Přepočítat indexy.

4.4.3. Aktualizace z verze 1.x

Do verze 2.0 byla aplikace Elza obvykle instalována formou WAR balíčku do aplikačního serveru Tomcat. Od verze 2.0 je aplikační server přímo součástí Elza.

Odstranění samostatného Tomcat

Pro přechod ze samostatného aplikačního na vložený proveďte tyto kroky:

Proveďte novou instalaci Elza dle: Instalace pomocí binární distribuce

Zkopírujte původní konfigurační soubor elza-ui.yaml do složky config a změňte jeho pojmenování na elza.yaml

Spusťte a zkontrolujte novou instalaci

Odstraňte původní instalaci v aplikačním serveru

Po převedení na novou verzi bude aplikace naslouchat na portu 8080. Port, kde je aplikace dostupná, je možné opravit pomocí nastavení server.port, viz: Nastavení webového serveru.

4.4.4. Aktualizace z verzí 0.x

Aktualizace ze starších verzí než-li 0.17.1 není podporována. V takovém případě je nutné provést nejprve aktualizaci na verzi 0.17.1 a následně aktualizaci na verzi 2.x.