=================================== 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 Předpoklady =========== Nainstalována databáze Postgresql. Vhodné znalosti =============== Způsob administrace Apache Tomcat. 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. .. code-block:: SQL 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. .. code-block:: SQL 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: .. code-block:: SQL 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. .. code-block:: SQL 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`` .. _Admin_InstallBinConf: 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 webapps #. Spusť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`` 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ář