Indholdsfortegnelse

Indledning

Formål

Dette dokument er rettet mod systemadministratorer og driftspersoner, som skal kunne håndtere de driftsmæssige aspekter af komponenten.
Driftsvejledningen indeholder information om hensyn til eksterne afhængigheder, placering af logfiler og konfigurationsfiler.

Sammenhæng med øvrigt dokumenter

Dette dokument er en del af den samlede dokumentation for NADM web facade.

Dokumentet er udformet, så det i videst muligt omfang opfylder sit formål uafhængigt af de øvrige dokumenter.

Service Snitflade

Web facaden har context root /nadm.

Rest ressourcer

Web facade består af række rest ressourcer som er specificeret med open-api 3.0. Samtlige rest ressourcer deployeres under stien (/NADM)/api

TODO: links til yaml filer?

Overvågning (servlet)

Endpoints

Funktionalitet

/isAlive

Bruges af loadbalanceren for at tjekke at servicen er deployet. Returnerer en html side med deployment info.

Da denne service ikke er afhængige af database eller andre interne services, returnere den altid 200, hvis applikationen kører.

Login / logout

Endpoints	Funktionalitet
/nadm/login	Start login flow, der ender når bruger med ønsket rolle er valgt.
/nadm/logout	Invalider session og rediriger til logout side

Konfiguration

Konfiguration af web facade sker i filerne "compose/configuration" mappen som er beskrevet i NADM - NAF (web facade) - Installationsvejledning I det følgende gennemgåes konfigurationsfilernes detaljer.

Konfigurationsfiler

I det følgende gennemgåes en oversigt over komponentens konfigurationsfiler.

Konfigurationsfiler for web facade
log4j-maternity.xml	Log4j opsætninger der følger gængs standard på NSP.
log4j-nspslalog.properties	Log4j slalog opsætninger der følger gængs standard på NSP.

Logning

Alle logfiler er at finde i Wildfly Server log directory (/pack/wildfly/standalone/log/). Herunder findes en liste over alle logfiler med en beskrivelse af hvilke komponenter der skriver til dem.

Logfilnavn	Komponenter der skriver til denne
access.log	- NSP Accesshandler skippes. Acces handling sker i oiosaml
accesshandler.log	- NSP Accesshandler skippes. Acces handling sker i oiosaml
audit.log	- NSP Accesshandler skippes. Acces handling sker i oiosaml
maternity-web-facade.log	Applikation
maternity-web-facade-sla.log	Applikation (se nedenfor for specifikation af slalog punkter)
nsp-kafka.log	-
oiosaml-sp.log	OIOSAML
oiosaml-sp-audit.log	OIOSAML Audit
server.log	Wildfly Applikationsserver

SLA log punkter

LogPointUniqueId	LogPointUniqueId	Beskrivelse

Eksempel:

Fejlhåndtering

Applikationsfejl bliver logget ved hjælp af log4j, med type ERROR, INFO, DEBUG alt efter hvor alvorlig fejlen er samt et errorId som kommunikeres til klienten.