4.10. Odstraňování problémů

4.10.1. Logy

Soubory logů se nastavují v elza.yaml (viz Konfigurace aplikace); obvykle jsou v adresáři log pracovního adresáře:

  • elza.log - aplikační log (elza.logFile),

  • siem.log - bezpečnostní auditní log (elza.siemLogFile, viz Autentizace a zabezpečení),

  • access_log.<datum>.log - HTTP požadavky, je-li zapnut přístupový log (viz Konfigurace aplikace).

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

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

DELETE FROM db_databasechangeloglock;

4.10.3. Balíček je starší než nahraný

Start selže s hlášením Package is an older version than the one already imported. Adresář 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.

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

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

4.10.5. 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 Provoz za reverzní proxy.

4.10.6. Opravy dat starších verzí

Chyby při aktualizaci starých instalací řady 2.x popisuje kapitola Příloha: aktualizace starších verzí.