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 | 6. 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.
|
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.