4.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.

4.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).

4.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).

4.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

4.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.