4.2. Instalace pomocí binární distribuce¶
Binární distribuce aplikace Elza je určena pro její instalaci do aplikačního serveru s podporou technologií Java Servlet a WebSocket.
- Podporované systémy:
Java 1.8 a vyšší
Microsoft Windows nebo Linux
Apache Tomcat 8.0 a vyšší
Databáze:
Postgresql
Microsoft SQL Server
4.2.1. Předpoklady¶
Nainstalována databáze Postgresql.
4.2.2. Vhodné znalosti¶
Způsob administrace Apache Tomcat.
4.2.3. Postup instalace Elza¶
Instalace Apache Tomcat¶
Nainstalujte Apache Tomcat. Ke stažení zde: https://tomcat.apache.org/
Elza v tuto chvíli musí být nainstalována jako kořenová aplikace v Tomcat.
Příprava databáze¶
Pro přístup k databází vytvořte v Postgres samostatného uživatele. Například: ‚elza‘.
Nepoužívejte účet administrátora pro přístup k databázi.
Vytvořte prázdnou databázi, jejíž vlastníkem je uživatel z předchozího bodu.
CREATE DATABASE elza OWNER = 'elza';
Pro další krok je potřeba povolit uživateli (uživatel ‚elza‘) oprávnění pro nastavení rozšíření. Nejjednoduší způsob je dočasně nastavit uživateli právo superuživatel.
ALTER USER elza WITH SUPERUSER;
Připojte se k databázi jako vlastník (uživatel ‚elza‘) a přidejte do databáze možnost používat rozšíření PostGIS:
psql -U elza -W -d elza CREATE EXTENSION postgis;
Po úspěšném vytvoření rozšíření PostGIS lze uživateli opět odebrat práva superuživatele.
ALTER USER elza WITH NOSUPERUSER;
Pracovní adresář¶
Připravte pracovní adresář pro Elzu. Do adresáře se budou ukládat pravidla popisu, tiskové šablony, vygenerované tisky a další.
Například: D:\Elza\work
Konfigurace a spuštění Elza¶
V adresáři server je vzorový soubor :file:elza-ui.yaml. Ten otevřete a upravte dle nastavení v předchozích bodech. Minimálně je nutné nastavit: - připojení k databázi (sekce elza: data:) - cestu k pracovnímu adresáři (workingDir:)
Upravený soubor elza-ui.yaml nahrajte do souboru
ROOT.war
do adresáře WEB-INF/classes Soubor ROOT.war je standardní ZIP souboru a je možné s ním pracovat pomocí běžných nástrojů pro práci se ZIP soubory. Ve Windows je nutné mu před úpravou změnit koncovku na .zip.V připravené instalaci Tomcat smažte adresář
webapps/ROOT
a upravenýROOT.war
nahrajte do adresáře webappsSpusťte Tomcat V případě správné konfigurace dojde k vytvoření tabulek v databázi a nastartování aplikace.
Nastavení po prvním spuštění¶
Po úspěšném startu aplikace je nutné v ní nastavit číselníkové hodnoty a pravidla pro zpracování archiválií.
Ve správě balíčků do aplikace nahrajte balíček
packages/package-cz-base.zip
ve správě balíčků do aplikace nahrajte balíček
packages/rules-cz-zp2015.zip
proveďte import paměťových institucí volbou Osoby / Import osob ze souboru
data/all-institutions-import.xml
4.2.4. Zálohování dat¶
Je doporučeno data uložená v aplikaci pravidelně zálohovat. Záloha by měla být provedena vždy před aktualizací aplikace.
- Předmět zálohy:
databáze
pracovní adresář