Nærværende dokument udgør driftsvejledningen for FIBS (Fødselsindberetnings-servicen).
FIBS fungerer som webservice gateway som modtager indberetninger som følger DenGodeWebservice (DGWS) til Kirkeministeriets jordemoder-service og transformerer dem til webservice protokollen OWSA Model T som jordemoder-service benytter.
Komponenten er udviklet som en standard NSP forretningsservice og afvikles i Docker i et image baseret på det på nsp udbudte standard image.
Komponenten skal kunne tilgå Kirkeministeriets jordemoder-service (KJS). I den forbindelse skal det nævnes, at FIBS er udstyret med et certifikat (x509), som benyttes til signering af beskeder sendt mod KJS.
Ved udskiftning af dette certifikat er det vigtigt at huske på, at foretage en opdatering af KJS med de relevante certifikatoplysninger. Kontakt til driftsansvarlig kan skaffes gennem NSP operatøren.
Grundlæggende konfiguration foregår ved redigering i filen application.properties, der placeres på følgende placering:
/pack/wildfly8/modules/dk/rsd/fibs/newborns/main/resources/application.properties
Moduldefinitionen er at finde i sourcekoden til SFSK under:
/service/etc/wildfly/modules/dk/rsd/fibs/newborns/main/module.xml
I application.properties skal følgende properties være definerede:
Property | Beskrivelse |
Komponenten logger til sin egen rullende log som hedder 'fibs.log'.
Komponents SLA logninger havner i 'nsputil-sla.log', medmindre der konfigureres til andet.
På JBoss 8 platformen ligger logfilerne i:
$JBOSS_HOME/standalone/log/ |
hvor '$JBOSS_HOME' udpeger roden på JBoss Application Server installationen.
Indgange i loggen indeholder en kort beskrivelse af hændelsen, tidspunktet samt hændelsens alvorlighedsgrad ('Severity').
Ved drift bør der ikke være indgange af alvorlighedsgrad 'ERROR' i loggen. Se overvågningsvejledning nedenfor.
Komponentens konfiguration er placeret i komponentens Wildfly modul under
$JBOSS_HOME/modules/dk/rsd/fibs/newborns/main/resources/ |
hvor '$JBOSS_HOME' udpeger roden på JBoss Application Server installationen.
Ændringer i konfigurationen af komponenten træder først i kraft efter genstart af komponenten. Se vejledning nedenfor.
Komponentens wsdl er udstillet på følgende url:
<host>/fibs/wsdl/fibs.wsdl
De tilhørende artefakter som refereres fra wsdl-filen er også udstillet.
Skal komponenten genstartes gøres det ved at genstarte den docker container som komponenten kører i.
Efter genstart bør der verificeres at der ikke er nogen indgange med alvorlighedsgrad 'ERROR' i komponentens log.
Udover at overvåge selve applikationsserveren for ressourceknaphed og generelle fejl kan man overvåge FIBS ved at:
Configuration OkDer svares med en HTTP status 200 hvis alt er OK. Hvis der er fejl, som f.eks. databasen ikke kan kontaktes, så returneres der en HTTP status 500.
FIBS version: 2.0.14-SNAPSHOT
FIBS database Ok.
Der bør foretages backup af komponentens egne konfigurationsfiler hver gang konfigurationen ændres.
For at gøre eventuelt fejlfinding nemmere anbefales det, at der ligeledes tages backup af komponentens logfiler.
Der pt. ingen kendte fejl.