Page History
| Navitabs | ||||
|---|---|---|---|---|
| ||||
| Table of Contents | ||
|---|---|---|
|
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.
| 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.
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.