Quick Start

Quick Start

Tento postup popisuje nejkratší cestu od prázdného serveru k ověřené instanci MetacheckAPI v Tomcatu.

Předpoklady

Komponenta	Doporučení
Java	21
Maven	3.9 nebo kompatibilní verze
Servlet kontejner	Tomcat 10.1+
Databáze	PostgreSQL databáze ProArc s tabulkami Metacheck
Externí služba	dostupné Metakat API

1. Připravte adresáře

sudo mkdir -p /opt/metacheck
sudo chown tomcat:tomcat /opt/metacheck

Adresář /opt/metacheck bude obsahovat metacheck.cfg a případnou klientskou konfiguraci.

2. Sestavte WAR

V kořeni zdrojového projektu spusťte:

mvn clean package

Výsledný artefakt:

target/metacheck.war

3. Nastavte Tomcat

Do Tomcatu doplňte:

• PostgreSQL JDBC driver do lib,
• JNDI datasource jdbc/proarc,
• proměnnou METACHECK_HOME nebo JVM parametr -Dmetacheck.home=/opt/metacheck.

Minimální příklady jsou na stránce Instalace.

4. Vytvořte konfiguraci

Soubor /opt/metacheck/metacheck.cfg:

metacheck.application.name=Metacheck
metacheck.application.status=running

proarc.connected=true
proarc.importFolder=proarc_import

metakat.baseUrl=https://metakat.example.org
metakat.apiKey=CHANGE_ME
metakat.pollIntervalMs=10000
metakat.pollTimeoutMs=3600000

file.imageExtension=.full.jpg
file.previewExtension=.preview.jpg
file.thumbnailExtension=.thumb.jpg
file.altoExtension=.xml
file.ocrExtension=.txt

metacheck.client.configPath=./metacheckClient.json

Hodnoty metakat.baseUrl, metakat.apiKey, databázové připojení a cestu k importní složce upravte podle prostředí.

5. Nasaďte aplikaci

sudo cp target/metacheck.war /var/lib/tomcat/webapps/metacheck.war
sudo systemctl restart tomcat

Názvy služby a adresářů se mohou lišit podle distribuce a způsobu instalace Tomcatu.

6. Ověřte běh

curl http://localhost:8080/metacheck/rest/v1/application

Swagger UI:

http://localhost:8080/metacheck/swagger/

Pokud ověření selže, pokračujte stránkou Troubleshooting.

Hotovo

Po úspěšném ověření má správce funkční backend, konfigurační adresář mimo WAR a připojení na databázi a Metakat.