...

1. Sikre, at endpointet svarer, ved at foretage simple HTTP GET kald mod komponents 'check' status side:
   1. http://<HOST>:<PORT>/crk/checkstatus
      

      Denne angiver pt blot antallet af aktive endpoints i konfigurationen og kan anvendes til at afgøre om komponenten er "I live".

2. Overvåge komponentens logfil for 'ERROR' indgange

Administration af endpoints

...

Versionsudstilling

CRK udstiller sit versionsnummer på følgende endpoint: http://<HOST>:<PORT>/crk/version. Endpointet svarer på GET-requests, og versionsnummeret kommer i body'en af svaret. Eksempel på kald af endpoint:

curl -i localhost:8060/crk/version

Eksempel på response:

HTTP/1.1 200 OK
Connection: keep-alive
X-Powered-By: Undertow/1
Server: WildFly/8
Transfer-Encoding: chunked
Date: Thu, 16 Sep 2021 07:33:16 GMT

Version: 1.0.8-SNAPSHOT

Administrativ overskrivning af konfiguration

Ved (genindlæsning) af endpoint definition fra ekstern kilde oprettes en ny version af endpoint i databasen. Tidligere versioner af samme endpoint deaktiveres. Nye actions oprettes (som aktive) i databasen som peger på den nye version af endpointet. Såfremt en tidligere aktiv action bortfalder for et endpoint, vil den gamle værdi blive kopieret med angivelse af kilde.

Dette åbner et antal muligheder for administrativt at påvirke DCC konfigurationen (se installationsvejledningen for en oversigt over de nedenfor anvendte konfigurationsfiler).

Deaktivering af endpoint

Det er muligt helt at deaktivere et endpoint. Dette kan gøres ved at markere den aktive version som active=false.

Bemærk at det kan være nyttigt at forhindre genindlæsning ved at disable det tilsvarende job i crk-jobs.xml.

Rollback til tidligere version af endpoint

Det er muligt at rulle et endpoint tilbage til en tidligere version. Dette kan gøres ved at markere den aktive version som active=false, og markere den tidligere version med active=true.

Bemærk at det kan være nyttigt at forhindre genindlæsning ved at disable det tilsvarende job i crk-jobs.xml. Herved undgås utilsigtet "reaktivering" af den nye version.

Deaktivering af action

En action kan deaktiveres ved at markere den med active=false. Den vil herefter ikke længere være aktiv i DCC konfigurationen.

Ved opdatering fra ekstern kilde, vil denne action blive reaktiveret hvis og kun hvis den er indeholdt i den nye end point definition.

Håndtering af nedlagte actions

Såfremt en tidligere aktiv action bortfalder for et endpoint, vil den gamle værdi blive kopieret med angivelse af kilde. Tilstedeværelsen af kilde angivelse ("inheritedEndpoint") kan således fortolkes som et "deprekeringsflag".

Der kan herefter administrativt tages stilling til om denne action helt skal bortfalde i DCC-konfigurationen, hvilket kan ske ved markering active=false for pågældende action.

Overskrivning af gateway egenskab

Såfremt den eksterne kilde angiver at en action kræver et niveau 4 id-kort (MOCES), sættes useProxy til true. Dvs det tillades DCC at køre forespørgsler til denne action igennem en SOSI-GW.

Det er muligt at overskrive denne værdi ved at definere proxyOverride. En definition af proxyOverride har fortrinsret, og vil blive bevaret ved fremtidige opdateringer af pågældende action (værdien kopieres fra tidligere versioner).

Backup

Der bør foretages backup af komponentens egne konfigurationsfiler hver gang konfigurationen ændres.

...