Upgrade Guide

Upgrade Guide

Upgrade MetacheckAPI je primárně výměna WAR balíčku a ověření kompatibility konfigurace, databáze a externích služeb. Databázové schéma MetacheckAPI si aplikace spravuje sama; při nasazení novější verze provede případný upgrade schématu automaticky.

Před upgradem

1. Přečtěte si release notes cílové verze.
2. Ověřte kompatibilitu Java, Tomcatu a databáze.
3. Zazálohujte aktuální WAR balíček.
4. Zazálohujte adresář METACHECK_HOME.
5. Zazálohujte databázi nebo ověřte dostupnost poslední provozní zálohy.
6. Poznamenejte si aktuální hodnoty metacheck.cfg, datasource a nastavení Tomcatu.

Doporučený postup

1. Sestavte nebo stáhněte nový metacheck.war.
2. Zastavte Tomcat nebo konkrétní aplikaci.
3. Nahraďte původní WAR balíček novou verzí.
4. Pokud Tomcat ponechává rozbalený adresář aplikace, odstraňte jen rozbalenou kopii stejného kontextu podle interního provozního postupu.
5. Spusťte Tomcat.
6. Sledujte aplikační log a log Tomcatu, včetně případné automatické inicializace nebo aktualizace databázového schématu.
7. Ověřte endpoint /rest/v1/application.
8. Ověřte Swagger UI.
9. Ověřte práci s testovací dávkou.

Ověření po upgradu

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

Swagger UI:

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

Pro funkční kontrolu ověřte:

• načtení seznamu dávek,
• založení testovací dávky,
• načtení objektů dávky,
• načtení a uložení metadat,
• dostupnost obrazových náhledů a ALTO XML.

Rollback

Pokud se upgrade nepodaří:

1. Zastavte Tomcat nebo konkrétní aplikaci.
2. Vraťte předchozí WAR balíček.
3. Vraťte konfiguraci z poslední známé funkční kopie, pokud byla změněna.
4. Spusťte Tomcat.
5. Ověřte /rest/v1/application a základní práci s dávkami.

Rollback databáze provádějte jen podle provozních pravidel daného prostředí. Pokud nová verze automaticky povýšila databázové schéma, musí být rollback databáze součástí připraveného plánu.

Upgrade z 1.0.2 na 1.0.3

Verze 1.0.3 přidává práci se souborem packageInfo.json při zpracování dávky a aktualizuje Swagger/OpenAPI specifikaci.

Při upgradu ověřte:

• zda dávkové složky mohou obsahovat packageInfo.json,
• zda je soubor dostupný ve složce s obrazovými daty nebo ve složce dávky,
• zda klienti používají query parametr folder místo dřívějšího path ve filtru dávek.