.. Zdroj: elza/docs/admin-guide/source/10-troubleshooting.rst, elza e87a93d6d1

.. _admin_fixes:

=====================
Odstraňování problémů
=====================

Logy
====

Soubory logů se nastavují v :file:`elza.yaml` (viz :doc:`04-konfigurace`);
obvykle jsou v adresáři :file:`log` pracovního adresáře:

- :file:`elza.log` - aplikační log (``elza.logFile``),
- :file:`siem.log` - bezpečnostní auditní log (``elza.siemLogFile``, viz
  :doc:`05-zabezpeceni`),
- :file:`access_log.<datum>.log` - HTTP požadavky, je-li zapnut
  přístupový log (viz :doc:`04-konfigurace`).

Pokud aplikace nenastartuje, hledejte v :file:`elza.log` první ``ERROR``;
při provozu pod systemd zkontrolujte také ``journalctl -u elza``.

Uzamčená databáze
=================

Start se zastaví u hlášení::

   Waiting for changelog lock....

Předchozí start nedokončil migraci databáze a ponechal zámek. Ujistěte
se, že nad stejnou databází neběží jiná instance Elzy. Poté zámek
uvolněte a aplikaci spusťte znovu:

.. code-block:: sql

   DELETE FROM db_databasechangeloglock;

Balíček je starší než nahraný
=============================

Start selže s hlášením ``Package is an older version than the one already
imported``. Adresář :file:`dpkg` pracovního adresáře obsahuje starší verzi
balíčku, než je v databázi. Nahraďte jej balíčkem z aktuální distribuce
nebo jej odstraňte.

Chybné znaky v textech
======================

České nebo jiné znaky mimo ASCII se ukládají nebo zobrazují chybně. JVM
běží s jiným výchozím kódováním než UTF-8. Spusťte Javu s parametry:

.. code-block:: bash

   java -Dfile.encoding=UTF-8 -Dsun.jnu.encoding=UTF-8 -jar elza-tomcat.jar

Nefunguje WebSocket
===================

Aplikace se načte, ale změny provedené jinými uživateli nebo průběh úloh
na pozadí se zobrazí až po obnovení stránky. Reverzní proxy nepředává
spojení WebSocket na ``/stomp``. Viz :doc:`06-reverzni-proxy`.

Opravy dat starších verzí
=========================

Chyby při aktualizaci starých instalací řady 2.x popisuje kapitola
:doc:`11-starsi-aktualizace`.