.. _abm_administration_installation:

Instalace
=========

Instalace jednotlivých prostředí se může mírně lišit.
Například může být jiný uživatel, pod kterým služby běží, služby mohou být rozmístěny na různých aplikačních serverech, může být jiná adresa databáze a podobně..

Příprava aplikačního serveru
----------------------------

* Připravte aplikační server nejlépe RockyLinux 9.2

* Pomocí správce balíčků na něj nainstalujte javu 17

* Pomocí správce balíčků na něj nainstalujte PostgreSQL databázi 11.3

* Zpřístupněte port databáze ve firewallu, abyste ji mohli spravovat externě::

    sudo firewall-cmd --zone=public --permanent --add-port=5432/tcp

* Založte uživatele pod kterým poběží služby::

    sudo useradd ais

* Vytvořte instalační adresář::

    /opt/ais/abm
    /opt/ais/abm/install

Příprava databáze
-----------------

* Pomocí pgAdmin (verze 4.7) se připojte na databázový server.

* Založte databázi příkazem::

    create database abm locale 'cs_CZ.utf8';

  Databázi není možné založit pomocí dialogu pgAdmin, protože se zde nenabízí správná colation cs-CZ.utf8!

* Vytvořte databázového uživatele ais.

* Uživateli ais nastavte všechna práva ke schématu public databáze abm.

Instalace modulu pro offline média
----------------------------------

* Připravte obsah instalačního adresáře /opt/ais/abm:

  * Obsah instalačního souboru abm-1.x.y.rev.zip.
    Například pomocí příkazů::

      curl -o abm.zip "https://repo.aipsafe.cz/repository/shared/cz.aipsafe.uk.ais/1.x.y.rev/extension/abm-1.x.y.rev.zip"
      unzip abm.zip
      mv abm.zip install

  * Konfigurační soubor abm.yml.

..
    Viz :ref:`Konfigurace<abm_administration_configuration>`.

  * Spouštěcí scripty abm-gui.sh, abmm-api.sh, abm-proc.sh s obsahem::

      #!/bin/sh
      java -jar abm-gui.jar "$@"

    Namísto abm-gui.jar je u dalších scriptů abm-api.jar, abm-proc.jar.

    Spouštěcím scriptům sh nastavte právo execute::

      chmod a+x /opt/ais/abm/*.sh

  * Adresář var jehož vlastníkem je ais::

      mkdir var
      chown ais:ais var

* Pomocí příkazu::

    ./abm-cmd.sh validate

  zkontrolujte připojení k databázi a potřebu provést migrace.

* Pomocí příkazu::

    ./abm-cmd.sh migrate

  proveďte instalaci struktury databáze.

* Pokud se jedná pouze o testovací databázi můžete pomocí příkazu::

    sudo -u ais ./abm-cmd.sh demonstration

  naplnit databázi testovacími daty.

  Příkaz je třeba spustit pod uživatelem ais, protože pracuje se stejnými soubory v adreáři var jako služba svc-gui.

* V adresáři /etc/systemd/system vytvořte soubor abm-gui.service s následujícím obsahem::

    [Unit]
    Description=ABM GUI
    After=multi-user.target

    [Service]
    User=ais
    WorkingDirectory=/opt/ais/abm
    ExecStart=/opt/ais/abm/abm-gui.sh

    [Install]
    WantedBy=multi-user.target

* Obdobně vytvořte i soubory abm-api.service a abm-proc.service spouštějící abm-api.sh a abm-proc.sh s popisem ABM API a ABM Processes.

* Enablujte služby::

    sudo systemctl enable abm-gui
    sudo systemctl enable abm-api
    sudo systemctl enable abm-proc

* Nastartujte služby::

    sudo systemctl start abm-gui
    sudo systemctl start abm-api
    sudo systemctl start abm-proc

* Ověřte, že služby běží::

    sudo systemctl status abm-gui
    sudo systemctl status abm-api
    sudo systemctl status abm-proc

* Povolte porty služeb ve firewallu::

    sudo firewall-cmd --zone=public --permanent --add-port=8080/tcp
    sudo firewall-cmd --zone=public --permanent --add-port=8081/tcp

* Oveřte, že jsou služby přístupné v browseru.

..
  Viz :ref:`Přístupové body<abm_administration_basic_access>`.

* Proveďte reboot aplikačního serveru::

    sudo reboot

  a znovu zkontrolujte, že jsou služby po chvíli přístupné v browseru.