.. _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í <admin_about_sw>` 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.
