Provozni prirucka

Provozní příručka

Tato stránka je určená pro správce provozní instance MetacheckAPI.

Denní kontrola

Kontrola	Co ověřit
Aplikace	/rest/v1/application vrací odpověď.
Swagger	/swagger/ je dostupný.
Databáze	Tomcat log neobsahuje chyby připojení k jdbc/proarc.
Metakat	Nové dávky se dostávají ze stavu zpracování do výsledného stavu.
Disk	Importní a pracovní adresáře mají dost volného místa.
Logy	Neopakují se chyby dávkového zpracování.

Logy

Sledujte minimálně:

• log servlet kontejneru,
• aplikační log Log4j 2,
• log služby nebo prostředí, které spouští Tomcat,
• logy databáze při problémech s připojením nebo výkonem.

Při incidentu si uložte:

• čas problému,
• URL endpointu nebo ID dávky,
• stav dávky,
• relevantní část aplikačního logu,
• relevantní část logu Tomcatu.

Zálohy

Zálohovat je vhodné:

Oblast	Doporučení
Databáze	Pravidelná záloha PostgreSQL podle pravidel provozu ProArc.
METACHECK_HOME	Před každou změnou konfigurace a před upgradem.
WAR balíček	Uložit aktuálně nasazenou verzi kvůli rollbacku.
Importní data	Podle pravidel digitalizačního workflow a kapacity úložiště.
Uživatelská data	Zálohovat podle skutečného umístění nalinkovaných adresářů.

Monitoring

Minimální monitoring by měl hlídat:

• dostupnost /rest/v1/application,
• HTTP 5xx chyby,
• dostupnost databáze,
• dostupnost Metakat API ze serveru aplikace,
• zaplnění disku,
• velikost a rotaci logů,
• dlouho běžící nebo zaseknuté dávky.

Restart aplikace

Restart je vhodný po:

• změně metacheck.cfg,
• změně JNDI datasource,
• výměně WAR balíčku,
• změně JVM parametrů nebo proměnných prostředí.

Po restartu vždy ověřte:

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

Práce s konfigurací

Konfiguraci měňte mimo WAR balíček v adresáři METACHECK_HOME. Před úpravou si uložte kopii aktuálního souboru:

cp /opt/metacheck/metacheck.cfg /opt/metacheck/metacheck.cfg.$(date +%Y%m%d-%H%M%S)

Po změně konfigurace restartujte aplikaci a zkontrolujte logy.

Provozní checklist po nasazení

1. WAR je nasazený pod očekávaným kontextem.
2. METACHECK_HOME ukazuje na správný adresář.
3. V METACHECK_HOME jsou nalinkované uživatelské adresáře s daty.
4. metacheck.cfg obsahuje hodnoty pro dané prostředí.
5. JNDI datasource jdbc/proarc je dostupný.
6. Databázové schéma se inicializovalo nebo aktualizovalo bez chyby.
7. Metakat API je dostupné ze serveru aplikace.
8. Importní složky jsou čitelné uživatelem Tomcatu.
9. /rest/v1/application vrací odpověď.
10. /swagger/ je dostupný.
11. Testovací dávka projde očekávaným workflow.