Indholdsfortegnelse

Introduktion

Formål

Dette dokument er rettet mod systemadministratorer og driftspersoner, som skal kunne håndtere driftsmæssige aspekter af komponenten.

Driftsvejledningen indeholder information om MHD med hensyn til eksterne afhængigheder, standard placering af logfiler og konfigurationsfiler, og evt. krav til genstart af applikationer hvis komponenten ikke er responsiv.

I afsnit 3 (Komponenter) er beskrevet hvilke komponenter, der indgår i MHD og deres forventede placering med hensyn til platform.

Afsnit 5 (Konfiguration) beskriver aktuelle konfigurationsparametre for MHD henholdsvis Repository, samt eksempler på konfigurationsparameter-filer.

Afsnit 6.1, 6.2 og 6.3 (Overvågning) beskriver hvorledes MHD komponenterne overvåges.

I afsnit 6.4 er MHD-relaterede logfiler beskrevet, så disse evt. kan overvåges, og tillige danne baggrund for fejlsøgning.

Beskrivelse af standard fejlsøgning og start/stop vejledning for komponenterne er beskrevet i afsnit 7 (Standard fejlsøgning).

Specielle krav til backup er beskrevet i afsnit 8 (Krav til backup m.m.), ligesom procedure ved reetablering af komponenten ud fra backup beskrives.

Læsevejledning

Læseren forventes at have kendskab til NSP miljøet.

Definitioner og referencer

Komponenter

Dette dokument dækker følgende komponenter:

• Generisk udstilling (MHD)
  • Type: Webservice
  • Filnavn: mhd.war
  • Statusurl: <serverurl>/mhd/status
  • Alarmurl: <serverurl>/mhd/alarm
  • Endpoints for GM Facade:
    • Opslag i DDS registry (ITI-18) url:  <serverurl>/mhd/api/2025/05/06/DocumentReference?patient.identifier=0101010101
    • Opslag i DDS repository (ITI-43) url: <serverurl>/mhd/api/2025/05/06/Binary/DOCUMENT_ID?repositoryID=REPOSITORY_ID&homeCommunityID=CUMMUNITY_ID

Daglig drift

Dette afsnit beskriver den daglige drift af systemet.

Relaterede services

MHD afhænger af tilstedeværelsen af en række andre services, og ved fejl i nogle af disse vil MHD fejle tilsvarende. Disse services er:

• STS - Til veksling af JTPH til IDWS
• Dokumentdelingservice (DDS) - til fremsøgning af dokumenter med ITI-18 og ITI-43

Konfiguration

Komponenterne afvikles i et docker compose setup, som ligger under https://git.nspop.dk/scm/com/mobile-access-to-health-documents.git

log konfiguration

Komponenten benytter den standard logger der er indbagt i docker nsp-image og kræver ikke særskilt konfiguration. 

SLA-log konfiguration

MHD er en viderestillingsservice og der er ikke separat sla logning. I stedet logges udvalgte tider i standard loggen. 

Whitelist konfiguration

MHD er en rest service, som ikke kræver whitelisting.

Monitorering

Til statuscheck af MHD udstilles <serverurl>/mhd/status som returnerer HTTP 200 hvis servicen i øjeblikket kører. 

Overvågning

MHD overvåges på <serverurl>/mhd/alarm.

Fortolkning af HTML overvågningsside

Alle overvågningssider returnerer enten status 200 hvis de i øjeblikket kører fint, status 404 hvis servicen ikke er deployeret og status 500, hvis der er opstået en fejl, og komponenten derfor ikke virker korrekt.

Audit log

Hvert kald til '/mhd/api/2025/05/06/DocumentReference' medfører en ny indgang i auditloggen, som kan være udfyldt med følgende komponenter:

Hvert kald til '/mhd/api/2025/05/06/Binary' medfører en ny indgang i auditloggen, som kan være udfyldt med følgende komponenter:

Standard fejlsøgning

• Ved problemer med indlæsning af servicens konfigurationsfiler (...) bør man verificere at ...
• Ved manglende logning hvor der forventes fejlbeskeder bør konfigurationsfilen (...) checkes, da logindstillingerne sættes herigennem.
• En service eller et job kan stoppes og startes gennem docker.

Krav til backup m.m.

Det anbefales at aktuelle konfigurationsfiler til MHD er under versionskontrol og back up.

Dokument Historik