Instalace

Požadavky

• Java 21
• Maven 3.9 nebo kompatibilní verze
• servlet kontejner s podporou Jakarta Servlet 6, např. Tomcat 10.1+
• PostgreSQL databáze dostupná přes JNDI datasource
• dostupná služba Metakat API

Sestavení aplikace

V kořeni projektu spusťte:

mvn clean package

Výstupem je WAR balíček:

target/metacheck.war

Projekt při buildu vytváří také rozbalenou webovou aplikaci:

target/metacheck/

Nasazení do Tomcatu

1. Zkopírujte target/metacheck.war do adresáře webapps servlet kontejneru.
2. Nastavte JNDI datasource jdbc/proarc.
3. Nastavte konfigurační adresář pomocí METACHECK_HOME nebo JVM parametru -Dmetacheck.home.
4. Do adresáře METACHECK_HOME nalinkujte uživatelské adresáře s daty.
5. Spusťte nebo restartujte servlet kontejner.
6. Ověřte dostupnost aplikace:

http://localhost:8080/metacheck/
https://metacheck.inovatika.dev/api/swagger

JNDI datasource

Aplikace očekává datasource:

java:comp/env/jdbc/proarc

PostgreSQL JDBC driver musí být dostupný v Tomcatu, typicky v adresáři lib.

Příklad globálního datasource v conf/server.xml. Hodnotu Resource vložte do existující sekce GlobalNamingResources:

<GlobalNamingResources>
    <Resource
        name="jdbc/proarc"
        auth="Container"
        type="javax.sql.DataSource"
        driverClassName="org.postgresql.Driver"
        url="jdbc:postgresql://localhost:5432/proarc"
        username="proarc"
        password="changeit"
        maxTotal="20"
        maxIdle="10"
        maxWaitMillis="10000" />
</GlobalNamingResources>

Příklad napojení aplikace v conf/Catalina/localhost/metacheck.xml:

<Context>
    <ResourceLink
        name="jdbc/proarc"
        global="jdbc/proarc"
        type="javax.sql.DataSource" />
</Context>

Alternativně lze datasource definovat přímo v kontextu aplikace:

<Context>
    <Resource
        name="jdbc/proarc"
        auth="Container"
        type="javax.sql.DataSource"
        driverClassName="org.postgresql.Driver"
        url="jdbc:postgresql://localhost:5432/proarc"
        username="proarc"
        password="changeit"
        maxTotal="20"
        maxIdle="10"
        maxWaitMillis="10000" />
</Context>

Hodnoty url, username a password upravte podle provozní databáze.

Nastavení konfiguračního adresáře v Tomcatu

Doporučené nastavení přes JVM parametr v bin/setenv.sh:

CATALINA_OPTS="$CATALINA_OPTS -Dmetacheck.home=/opt/metacheck"

Na Windows v bin/setenv.bat:

set "CATALINA_OPTS=%CATALINA_OPTS% -Dmetacheck.home=C:\metacheck"

Alternativně lze použít proměnnou prostředí METACHECK_HOME.

První spuštění

Při startu aplikace se podle konfigurace inicializuje adresář Metacheck a připraví se šablona konfiguračního souboru. Databázové schéma MetacheckAPI se inicializuje automaticky. Pokud je při nasazení novější verze potřeba databázové schéma povýšit, provede aplikace upgrade schématu také automaticky.

Doporučený postup:

1. Vytvořte konfigurační adresář, např. /opt/metacheck.
2. Nastavte METACHECK_HOME=/opt/metacheck.
3. Nalinkujte do něj uživatelské adresáře s daty.
4. Spusťte aplikaci.
5. Zkontrolujte soubor metacheck.cfg.
6. Doplňte hodnoty pro Metakat, ProArc a klientskou konfiguraci.
7. Restartujte aplikaci.

Ověření instalace

Základní informace o aplikaci:

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

Swagger UI:

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

Testy

Lokální testy spustíte příkazem:

mvn test