.. Zdroj: elza/docs/admin-guide/source/03-upgrade.rst, elza e87a93d6d1

.. _Admin_update:

===========
Aktualizace
===========

Před každou aktualizací si přečtěte :ref:`změny <news_changelog>` 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í.

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ář :file:`dms` (viz
:doc:`09-zalohovani`).

Ručně
-----

#. Zazálohujte databázi a adresář :file:`dms` pracovního adresáře ze
   stejného okamžiku, nejlépe při zastavené aplikaci. Viz
   :doc:`09-zalohovani`.
#. Zastavte aplikaci.
#. Nahraďte soubor JAR (v Linuxu přesměrujte symbolický link na nový
   soubor).
#. Nahraďte balíčky v adresáři :file:`dpkg/` pracovního adresáře balíčky
   z nové distribuce (viz :ref:`admin_install_dpkg`). Nová verze Elzy může
   vyžadovat nové verze balíčků, proto je aktualizujte společně.
#. Proveďte změny konfigurace uvedené v přehledu změn.
#. 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.

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 :ref:`požadavky <admin_about_sw>`.

Změny konfigurace:

- Odstraňte z :file:`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 :file:`dpkg/`
  a aktualizují se společně s aplikací.

Po prvním spuštění:

#. V modulu *Administrace* > *Správa balíčků* ověřte, že balíček pravidel
   ZP2015 má verzi vyšší než 300.
#. 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 :doc:`11-starsi-aktualizace`.

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 :doc:`02-instalace`,
použijte stávající databázi a pracovní adresář a přesuňte původní
konfigurační soubor :file:`elza-ui.yaml` do :file:`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.
