.. _Admin_update: =========================== 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ář :file:`work`. ------------------------- 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 :ref:`Admin_InstallBinConf`. Postup aktualizace ------------------ #. Provedení zálohy databáze #. Zastavte aplikaci Elza #. Proveďte aktualizaci aplikace a jejích balíčků #. Spusťte aplikaci Elza ------------------------- Aktualizace z verzí 2.x ------------------------- Před provedením aktualizace na řadu 3 je zapotřebí provést kontrolu :ref:`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: :menuselection:`Přepočítat indexy`. -------------------------- Aktualizace z verze 1.x -------------------------- Do verze 2.0 byla aplikace Elza obvykle instalována formou :token:`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: :ref:`admin_install` #. Zkopírujte původní konfigurační soubor :file:`elza-ui.yaml` do složky :file:`config` a změňte jeho pojmenování na :file:`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í :token:`server.port`, viz: :ref:`Admin_config_web`. ------------------------- 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.