Troubleshooting

Troubleshooting

Tato stránka shrnuje nejčastější problémy při instalaci a provozu MetacheckAPI.

Aplikace po nasazení nenaběhne

Typické příčiny

• Tomcat nepoužívá Java 21.
• WAR je nasazený do Tomcatu 9 nebo staršího kontejneru bez Jakarta Servlet 6.
• Chybí PostgreSQL JDBC driver v Tomcatu.
• Není dostupný JNDI datasource jdbc/proarc.
• Není nastavený METACHECK_HOME ani -Dmetacheck.home.

Kontrola

java -version
curl http://localhost:8080/metacheck/rest/v1/application

Zkontrolujte také log Tomcatu, typicky catalina.out nebo logy služby tomcat.

Chyba JNDI datasource

Příznaky

• aplikace startuje, ale endpointy vrací chybu,
• v logu je zmíněn jdbc/proarc, NameNotFoundException nebo chyba připojení do PostgreSQL.

Řešení

1. Ověřte, že je datasource definovaný jako jdbc/proarc.
2. Ověřte, že aplikace hledá java:comp/env/jdbc/proarc.
3. Zkontrolujte přihlašovací údaje a dostupnost databáze.
4. Ověřte, že je v Tomcatu dostupný PostgreSQL JDBC driver.

Chyba připojení na Metakat

Příznaky

• dávka zůstává ve zpracování,
• založení dávky selže,
• v logu je chyba HTTP komunikace nebo autentizace.

Řešení

1. Zkontrolujte metakat.baseUrl.
2. Zkontrolujte metakat.apiKey.
3. Ověřte dostupnost Metakat API ze serveru, na kterém běží Tomcat.
4. U delších zpracování zvyšte metakat.pollTimeoutMs.

Aplikace nenajde obrazová data nebo ALTO XML

Typické příčiny

• Chybná hodnota proarc.connected.
• Chybná cesta proarc.importFolder.
• Nesedí přípony file.imageExtension, file.previewExtension, file.thumbnailExtension, file.altoExtension nebo file.ocrExtension.
• Uživatel, pod kterým běží Tomcat, nemá práva ke čtení dávkové složky.

Řešení

Ověřte strukturu dávkové složky a práva souborového systému. Pokud je proarc.importFolder relativní, vyhodnocuje se vůči složce konkrétní dávky.

Swagger není dostupný

Očekávaná adresa při standardním kontextu:

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

Pokud je WAR nasazený pod jiným názvem, změňte část /metacheck podle názvu kontextu.

Endpoint /application neodpovídá

Očekávaná adresa:

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

Pokud server vrací 404, ověřte název kontextu aplikace a dokončení deploye WAR balíčku. Pokud server vrací 500, pokračujte podle chyb v aplikačním nebo Tomcat logu.

Dávka nejde editovat

Metadata lze editovat jen u dávek ve stavech:

• GENERATED
• EDITING

Po potvrzení editace endpointem POST /object se dávka nastaví na EDITED a další editace nemusí být povolená.