Versions Compared

Old Version 2

changes.mady.by.user Unknown User (jpe@kvalitetsit.dk)

Saved on

compared with

New Version Current

changes.mady.by.user Unknown User (ihpe@sundhedsdata.dk)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Table of Contents
maxLevel2

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

DatoAnsvarligBeskrivelse
2019-11-18Jonas PedersenFørste udgave af driftvejledningen

Definitioner og referencer

ReferenceBeskrivelse
NAS2National Adviseringsservice 2
NAS1National Adviseringsservice 1
NAS MultiplexerNational Adviseringsservice Multiplexer
NSPDen nationale service platform
DriftenNSP Leverandøren og NSP Driftleverandøren
SDSSundhedsdatastyrelsen
Installationsvejledning6. 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

PropertyBeskrivelse
kafka.producer.bootstrap.serversKommasepareret liste af Kafka servere som NAS2 skal anvende. Denne liste bør indeholde alle noderne i Kafka clusteretkafka.producer.client.idNavnet som NAS2 vil fremgå med i listen af Producers på et Kafka Cluster.nsp.kafka.producer.component.nameNavnet på NAS2 komponentennsp.kafka.producer.component.abbreviationKort navn på NAS2 komponentennsp.kafka.producer.component.versionVersionen af NAS2 komponentennsp.kafka.producer.service.nameNavnet på den service i NAS2 der anvender Kafkadatasource.jndiJNDI navnet på den datasource der giver adgang til NAS2 databasen.
firstNas.endpointEndpoint 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.endpointEndpoint på det NAS system der skal kaldes sidst.
app.endpointService 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. 

...

Code Block
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. 

...

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. 

...