# 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

1. Provedení zálohy databáze

2. Zastavte aplikaci Elza

3. Proveďte aktualizaci aplikace a jejích balíčků

4. 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é:

1. Provedení kontroly verze pravidel nahraných balíčků. Verze ZP musí být větší než 300.

2. 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:

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

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

> 3. Spusťte a zkontrolujte novou instalaci

> 4. 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.