.. _oper_systemd:

==================================
Instalace a spuštění
==================================

Komponenta se distribuuje jako balíček ``peva-connector-<verze>.zip``, který
obsahuje:

 - ``peva-connector.jar`` - spustitelná aplikace (Spring Boot),
 - ``config/peva-connector.yml.template`` - ukázková konfigurace,
 - ``peva-connector.service`` - ukázková jednotka pro systemd,
 - ``peva-connector-update`` - skript pro aktualizaci jaru,
 - ``doc/`` - tato dokumentace v HTML,
 - ``INSTALL.txt`` - stručný návod.

Instalace
=========

1. Rozbalte balíček do ``/opt/peva-connector``.
2. Zkopírujte ``config/peva-connector.yml.template`` na
   ``config/peva-connector.yml`` a doplňte přístupy k PEvA, Elze a databázi
   (viz :ref:`config`).
3. Připravte databázi - novou, nebo migrací z Imwhooseru
   (viz :ref:`config_migration`).

Spuštění z příkazové řádky
==========================

.. code-block:: bash

  java -jar peva-connector.jar

Konfigurace se hledá v adresáři ``config/`` vedle jaru
(``spring.config.name=peva-connector``).

Spuštění jako služba systemd
============================

Komponentu je možné spouštět jako systémovou službu. Ukázková jednotka
``peva-connector.service`` je součástí balíčku:

.. code-block:: ini

  [Unit]
  Description=PEVA Connector
  After=syslog.target postgresql-15.service
  Wants=postgresql-15.service

  [Service]
  User=elza
  ExecStart=/opt/peva-connector/peva-connector.jar
  SuccessExitStatus=143

  [Install]
  WantedBy=multi-user.target

Jednotku zkopírujte do ``/etc/systemd/system/`` a aktivujte:

.. code-block:: bash

  sudo systemctl daemon-reload
  sudo systemctl enable --now peva-connector

Aktualizace
===========

Pro aktualizaci na novou verzi lze použít přiložený skript
``peva-connector-update <verze>``, který stáhne odpovídající jar, přepne na něj
symbolický odkaz ``peva-connector.jar`` a restartuje službu.
