4.3. Aktualizace

Před každou aktualizací si přečtěte změny všech sestavení mezi nainstalovanou a novou verzí. Záznamy, které uvádějí konfigurační klíč nebo krok při aktualizaci, mohou vyžadovat zásah před aktualizací nebo po ní.

Databázové schéma a data se automaticky migrují při prvním spuštění nové verze. Migraci nelze vrátit: návrat k předchozí verzi vyžaduje obnovu zálohy pořízené před aktualizací.

4.3.1. Aktualizace v rámci řady 3.x

Pomocí instalačních skriptů

elza-deploy provede všechny níže uvedené kroky včetně zálohy databáze před aktualizací. elza-deploy --auto nainstaluje nejnovější verzi nastaveného kanálu a časovač elza-update umí aktualizace provádět bezobslužně mimo pracovní dobu. Viz https://get.lightcomp.com/elza/.

Skript zálohuje pouze databázi; zálohujte také adresář dms (viz Zálohování a obnova).

Ručně

  1. Zazálohujte databázi a adresář dms pracovního adresáře ze stejného okamžiku, nejlépe při zastavené aplikaci. Viz Zálohování a obnova.

  2. Zastavte aplikaci.

  3. Nahraďte soubor JAR (v Linuxu přesměrujte symbolický link na nový soubor).

  4. Nahraďte balíčky v adresáři dpkg/ pracovního adresáře balíčky z nové distribuce (viz Nahrání balíčků). Nová verze Elzy může vyžadovat nové verze balíčků, proto je aktualizujte společně.

  5. Proveďte změny konfigurace uvedené v přehledu změn.

  6. Spusťte aplikaci a sledujte log až do jejího spuštění. První start po aktualizaci může kvůli migracím dat trvat výrazně déle.

4.3.2. Aktualizace z řady 2.x

Instalaci verze 2.x lze aktualizovat přímo na aktuální verzi. Před aktualizací ověřte, že:

  • je nainstalována Java 17,

  • databázový server splňuje požadavky.

Změny konfigurace:

  • Odstraňte z elza.yaml nastavení spring.jpa.properties.hibernate.dialect; dialekt se určuje automaticky.

  • Od verze 3.0 se balíčky nahrávají při startu z adresáře dpkg/ a aktualizují se společně s aplikací.

Po prvním spuštění:

  1. V modulu Administrace > Správa balíčků ověřte, že balíček pravidel ZP2015 má verzi vyšší než 300.

  2. Přestavte vyhledávací index volbou Přepočítat indexy v administraci.

Starší instalace řady 2.x mohou před aktualizací vyžadovat opravy dat, viz Příloha: aktualizace starších verzí.

4.3.3. Aktualizace z řad 1.x a 0.x

Verze 1.x běžely jako soubor WAR v samostatném serveru Tomcat. Nainstalujte aktuální verzi podle kapitoly Instalace, použijte stávající databázi a pracovní adresář a přesuňte původní konfigurační soubor elza-ui.yaml do config/elza.yaml, přičemž odstraňte nastavení uvedená výše pro řadu 2.x. Aktualizace z verzí starších než 0.17.1 není podporována; nejprve je nutné aktualizovat na verzi 0.17.1.