.. _imwhooser_install:

=====================
Instalace Imwhooser
=====================

Komponenta je Java aplikace vyžadující 
pro provoz Java 1.8 a vyšší. Data jsou uložena
v databázi PostrgreSQL.

Aplikace je nainstalována standardně v cestě: :file:`/opt/ais/imwhooser`.

Struktura souborů a adresářů:

 - :file:`imwhooser-x.y.jar` - binární soubor s aplikací
 - :file:`imwhooser.jar` - symbolický link na :file:`imwhooser-x.y.jar`
 - :file:`config/imwhooser.yaml` - konfigurační soubor
 - :file:`log` - adresář pro zápis logu


Vytvoření databáze
====================

::

  createdb -T template0 --locale=cs_CZ.UTF-8 -O imwhooser imwhooser


Spuštění aplikace a nastavení služby
=======================================

.. _`Installing Spring Boot Application`: https://docs.spring.io/spring-boot/docs/2.1.0.RELEASE/reference/html/deployment-install.html

Komponentu je možné spustit přímo z příkazové řádky nebo 
provozovat jako službu (ať již v Linuxu nebo ve Windows). 

Podrobný popis metod spouštění aplikace je součástí dokumentace `Installing Spring Boot Application`_.

Spuštění jako služba v Linuxu
-----------------------------

Binární soubor je možné spustit jako službu a to v systému :token:`init.d` i 
:token:`systemd`. Podrobný popis metod spouštění aplikace jako služby 
je součástí dokumentace `Installing Spring Boot Application`_.

Příklad konfigurace pro :token:`systemd`
----------------------------------------

.. code-block:: ini

    [Unit]
    Description=AIS Imwhooser
    After=syslog.target

    [Service]
    User=ais
    ExecStart=/opt/ais/imwhooser/imwhooser.jar
    WorkingDirectory=/opt/ais/imwhooser
    SuccessExitStatus=143

    [Install]
    WantedBy=multi-user.target