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
kafka.producer.bootstrap.servers	Kommasepareret liste af Kafka servere som NAS2 skal anvende. Denne liste bør indeholde alle noderne i Kafka clusteret
kafka.producer.client.id	Navnet som NAS2 vil fremgå med i listen af Producers på et Kafka Cluster.
nsp.kafka.producer.component.name	Navnet på NAS2 komponenten
nsp.kafka.producer.component.abbreviation	Kort navn på NAS2 komponenten
nsp.kafka.producer.component.version	Versionen af NAS2 komponenten
nsp.kafka.producer.service.name	Navnet på den service i NAS2 der anvender Kafka
datasource.jndi	JNDI navnet på den datasource der giver adgang til NAS2 databasen.
app.endpoint	Service endpoint (anvendes i DKS servlet)

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.