Indholdsfortegnelse

Introduktion

Formål

Dette dokument er rettet mod systemadministratorer og driftspersoner, som skal kunne håndtere driftsmæssige aspekter af komponenten.

Driftsvejledningen indeholder information om GM-Facade med hensyn til eksterne afhængigheder, standard placering af logfiler og konfigurationsfiler, og evt. krav til genstart af applikationer hvis komponenten ikke er responsiv.

I afsnit 3 (Komponenter) er beskrevet hvilke komponenter, der indgår i GM-Facade og deres forventede placering med hensyn til platform.

Afsnit 5 (Konfiguration) beskriver aktuelle konfigurationsparametre for GM-Facade henholdsvis Repository, samt eksempler på konfigurationsparameter-filer.

Afsnit 6.1, 6.2 og 6.3 (Overvågning) beskriver hvorledes GM-Facade komponenterne overvåges.

I afsnit 6.4 er GM-Facade-relaterede logfiler beskrevet, så disse evt. kan overvåges, og tillige danne baggrund for fejlsøgning.

Beskrivelse af standard fejlsøgning og start/stop vejledning for komponenterne er beskrevet i afsnit 7 (Standard fejlsøgning).

Specielle krav til backup er beskrevet i afsnit 8 (Krav til backup m.m.), ligesom procedure ved reetablering af komponenten ud fra backup beskrives.

Læsevejledning

Læseren forventes at have kendskab til NSP miljøet.

Definitioner og referencer

Komponenter

Dette dokument dækker følgende komponenter:

• Graviditetsmappens App Facade (GM-Facade)
  • Type: Webservice
  • Filnavn: gmaf.war
  • Statusurl: <serverurl>/gmaf/health/status
  • Alarmurl: <serverurl>/gmaf/health/alarm
  • Endpoints for GM-Facade:
    • Opslag i journal url:  <serverurl>/gmaf/api/2025/06/25/journal

Daglig drift

Dette afsnit beskriver den daglige drift af systemet.

Relaterede services

GM-Facade afhænger af tilstedeværelsen af en række andre services, og ved fejl i nogle af disse vil komponenten fejle tilsvarende. Disse services er:

• Mobile Access to Health Documents (MHD)
• Certificate Revocation Authority  (CRA)

Konfiguration

Komponenterne afvikles i et docker compose setup, som ligger under https://git.nspop.dk/scm/com/graviditetsmappens-app-facade.git

log4j konfiguration

Komponenten benytter standard den logger der er indbagt i docker nsp-image og kræver ikke særskilt konfiguration. 

SLA-log konfiguration

Komponenten benytter ikke SLA-logger, dog logges hvor længe kald tager i applikationsloggen.

Whitelist konfiguration

Der foretages whitelisting ...

Monitorering

Til statuscheck af GM-Facade

Overvågning

GM-Facade overvåges ...

Placering af HTML overvågningsside

...

Fortolkning af HTML overvågningsside

Alle overvågningssider returnerer enten status 200 hvis de i øjeblikket kører fint, status 404 hvis servicen ikke er deployeret, .... og status 500, hvis der er opstået en fejl, og komponenten derfor ikke virker korrekt.

Overvågningstype

Som udgangspunkt overvåges følgende:

Audit log

Auditlogning foretages med ...

De forskellige ITI-håndtag logges på følgende måde:

Standard fejlsøgning

• Ved problemer med indlæsning af servicens konfigurationsfiler (...) bør man verificere at ...
• Ved manglende logning hvor der forventes fejlbeskeder bør konfigurationsfilen (...) checkes, da logindstillingerne sættes herigennem.
• En service eller et job kan stoppes og startes gennem docker.

Krav til backup m.m.

Det anbefales at aktuelle konfigurationsfiler til GM-Facade er under versionskontrol og back up.

Dokument Historik