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ě. Balíček, který nová distribuce přidává, se naimportuje, jen pokud jej uvádí elza.packages.enabled.

  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.