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 GM-Facade 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 GM-Facade og deres forventede placering med hensyn til platform.

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

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

I afsnit 6.4 er GM-Facade-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:

• Graviditetsmappens App Facade (GM-Facade)
  • Type: Webservice
  • Filnavn: gmaf.war
  • Statusurl: <serverurl>/gmaf/health/status
  • Alarmurl: <serverurl>/gmaf/health/alarm
  • Endpoints for GM-Facade:
    • Opslag i journal url:  <serverurl>/gmaf/api/2025/06/25/journal

Daglig drift

Dette afsnit beskriver den daglige drift af systemet.

Relaterede services

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

• Mobile Access to Health Documents (MHD)
• Certificate Revocation Authority  (CRA)

Konfiguration

Komponenterne afvikles i et docker compose setup, som ligger under https://git.nspop.dk/scm/com/graviditetsmappens-app-facade.git. Konfigurationsproperties er beskrevet GM-Facade - Installationsvejledning#Konfiguration

Log-konfiguration

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

SLA-log konfiguration

Komponenten benytter ikke SLA-logger, dog logges hvor længe kald tager i applikationsloggen.

Whitelist konfiguration

Komponenten kræver ikke whitelisting. Sikkerhed er udelukkende styret af medsendt JTP-H.

Monitorering

Til statuscheck af GM-Facade udstilles <serverurl>/gmaf/health/status som returnerer HTTP 200 når komponenten er oppe. Status returnerer ikke yderligere status'er, da servicen er en simpel viderestillingsservice uden egen datakilde. 

Overvågning

GM-Facade overvåges på <serverurl>/gmaf/health/alarm. Endpointet returnerer HTTP 200, med mindre en eller flere kald til komponenten er fejlet med HTTP 500, i så fald returnes HTTP 500:

Eksempel på kald der returnerer HTTP 200:

Monitor: Total number of requests: 5, failed: 0

Audit log

Auditlogning foretages med ...

Standard fejlsøgning

• Ved problemer med indlæsning af servicens konfigurationsfiler bør man verificere at alle påkrævede properties er sat og alle tilhørende filer er indlæst korrekt.
• En service eller et job kan stoppes og startes gennem docker.

Krav til backup m.m.

Det anbefales at aktuelle konfigurationsfiler til GM-Facade er under versionskontrol og back up.

Dokument Historik