Introduktion

Formål

Dette dokument indeholder en beskrivelse af hvordan National Adviseringsservice Multiplexer (herefter NAS Multiplexer) driftes på et NSP Backend miljø.

Læsevejledning

Læseren forventes at have kendskab til Sundhedsdatastyrelsens platform NSP, samt generelt kendskab til WildFly applikation server, Docker, Docker Compose samt Ubuntu Linux operativ system.

Dokument Historik

Dato	Ansvarlig	Beskrivelse
2019-11-18	Jonas Pedersen	Første udgave af driftvejledningen

Definitioner og referencer

Reference	Beskrivelse
NAS2	National Adviseringsservice 2
NAS1	National Adviseringsservice 1
NAS Multiplexer	National Adviseringsservice Multiplexer
NSP	Den nationale service platform
Driften	NSP Leverandøren og NSP Driftleverandøren
SDS	Sundhedsdatastyrelsen
Installationsvejledning	Multiplexer - installationsvejledning

Konfiguration

Konfiguration af NAS Multiplexer sker i filerne i "compose/configuration" mappen som beskrevet i installationsvejledningen. I det følgende gennemgåes hver enkelt services konfigurationsfiler i detaljer.

Multiplexer service

Denne service konfigureres i filerne "multiplexer.properties" og "log4j-multiplexer.xml".

multiplexer.properties

Property	Beskrivelse
firstNas.endpoint	Endpoint på det NAS system der skal kaldes først. Det er også dette system svaret anvendes fra i de tilfælde hvor begge systemer svarer OK (http status 200)
secondNas.endpoint	Endpoint på det NAS system der skal kaldes sidst.

log4j-multiplexer.xml

Denne fil indeholder en Log4J opsætning der følger gængs standard på NSP.

Overvågning

NAS Multiplexer udstiller en status side. På denne side fremgår servicens versionsnummer samt servicens status. Status siden kan tilgås via http://NAS_MULTIPLEXER/multiplexer/health.

Eksempel på svar på fra status-siden.

HTTP/1.1 200 OK
Connection: keep-alive
X-Powered-By: Undertow/1
Server: WildFly/8
Content-Type: application/json
Content-Length: 49
Date: Mon, 18 Nov 2019 10:42:16 GMT

{ "healthy": true, "version": "1.0.0-SNAPSHOT" }

HTTP statuskode

Status-siden returnerer følgende status koder afhængig af servicens status.

200: Applikationen er sund

500: Der er opstået en fejl i applikationen.

Fejlfinding

Såfremt der er problemer med servicen, så returneres der en HTTP status kode 500.

HTTP/1.1 500 Internal Server Error
Connection: keep-alive
X-Powered-By: Undertow/1
Server: WildFly/8
Content-Type: application/json
Content-Length: 103
Date: Wed, 20 Feb 2019 13:30:11 GMT

{ "healthy": false, "version": "1.0.0-SNAPSHOT" }

Følgende årsager kan resultere i en statuskode 500.

Alvorlig intern fejl i servicen.

Hvis status-siden returnerer HTTP status 500 bør man tjekke applikationsloggen, da fejl logges her til.

Servicen kan genstartes ved at genstarte den docker container, som servicen den kører i.