# 3.1. 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.

## 3.1.1. 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 Konfigurace).

3. Připravte databázi - novou, nebo migrací z Imwhooseru (viz Migrace z Imwhooseru).

## 3.1.2. Spuštění z příkazové řádky

    java -jar peva-connector.jar

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

## 3.1.3. 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:

    [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:

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

## 3.1.4. 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.