...

hvor '$JBOSS_HOME' udpeger roden på JBoss Application Server. 

Optionelt er det muligt at placere komponentens routings-konfiguration i en (MySQL) database , hvor komponenten med konfigurerbart jævne mellemrum kan - Se Installationvejledningen. Så kan DCC indlæse nyeste konfiguration fra database. Det er ydermere muligt at konfigurere DCC, således at genindlæsning af routningskonfiguration kan tvinges til at køre. Dette gøres ved udfylde RoutingConfigurationRefreshParameters-elementet i dcc-config.xml. Det følgende er et eksempel på denne konfiguration:

<RoutingConfigurationRefreshParameters>
    <Location>/config</Location>
    <Filename>refresh</Filename>
</RoutingConfigurationRefreshParameters>

Konfigurationen betyder, at DCC kigger efter en fil ved navn refresh på stien /config. Hvis filen findes, genindlæses konfigurationen og filen slettes. Genindlæsning kan nu igangsættes med

touch /config/refresh

Indlæsningen sker ved genstart og periodisk, som angivet i DCCConfigReloadInterval - Se afsnittet Baggrundsjob til genindlæsning af DCC konfiguration.

Ændringer i den fil-baserede statiske konfiguration af komponenten træder først i kraft efter genstart af komponenten. Se vejledning nedenfor.

...

Udover at overvåge selve applikationsserveren for ressourceknaphed og generelle fejl kan man overvåge SOSI-DCC ved at:

1. Sikre, at endpointet svarer, ved at foretage simple HTTP GET kald mod komponents 'check' status sider:

...

på 2 måder:

• Status: på URL /decoupling/status (eller /decoupling/dcccheck

...

Viser en simple status side med IP-adressen og dato, øverste linje på siden viser 'OK'

...

• for bagudkompatibilitet)
• Alarm: på URL /decoupling/alarm (eller /decoupling/dcccheckall

...

Som 'dcccheck' men viser også konfigurationsparametre for komponenten.

...

• for bagudkompatibilitet)

9.1. Status

Status-siden viser en beskrivelse af tilstanden af flere parametre i DCC.

Siden vil returnere 500 i følgende tilfælde (ellers 200):

• DCC er ikke korrekt initialiseret

9.2. Alarm

Alarm-siden viser alarmer, hvis der er nogen. Ovenstående scenarier fra status-siden, samt følgende scenarier, vil forårsage en alarm:

• DCC er ikke korrekt initialiseret

Der returneres 500 ved alarm, ellers 200.

Anchor
_Toc175904309 _Toc175904309

Backup

...

Baggrundsjob til genindlæsning af DCC konfiguration

Det er i dag muligt at genindlæse DCC konfigurationen på 2 måder. Det er samme funktionalitet der bliver afviklet til genindlæsning, det er måden jobbet startes på der er forskellig.

Konfiguration af hvilken mappe DCC finder konfigurationsfilen i, indstilles ved at sætte en system property. Flere properties prøves af DCC, indtil den finder en som er sat.
Det gøres i følgende rækkefølge:
    dk.sosi.dcc.config.dir - det er typisk denne man selv vil sætte
    jboss.server.config.dir
    was.repository.root - hvis denne er sat søges der i stien defineret i property 'user.home' - dvs. at 'was.repository.root' blot bruges til at afgøre om programmet afvikles på en WAS
    catalina.home

...

Hvis der er fejl i den nye konfiguration logges dette og den tidligere korrekt indlæste bibeholdes.

ReloadConfiguration

ReloadConfiguration baggrundsjobbet for DCC gør det muligt at genindlæse den konfiguration som DCC er konfigureret til at bruge.

Baggrundsjobbet overholder husregler for baggrundsjobs (version v64 af husreglerne i seneste udgave af baggrundsjobbet). Den bryder dog reglen om at køre i egen container, da den skriver til konfiguration der ligger in-memory, som læses af DCC.

ReloadConfiguration-jobbet vil genlæse konfigurationsfilen in-memory når den kaldes, som medfører at DCC får den nye konfiguration, næste gang den tilgår in-memory konfigurationen.
Jobbet har følgende HTTP GET operationer, som kan tilgås med angivne URL path:

Start
decoupling/reloadConfiguration/start

Status
decoupling/reloadConfiguration/status

Succes og fejl skrives til loggen - "Configuration reloaded" skrives hvis udførslen går godt, ellers "Configuration reload failed" efterfulgt af fejlen, hvis udførslen fejler.

DCCConfigReloadService

DCCConfigReloadService

DCCConfigReloadService baggrundsjobbet DCCConfigReloadService beggrundsjobbet for DCC genindlæser konfigurationen periodisk.

...

DCCConfigReloadInterval skal angives som et positivt heltal, som angive angiver perioden indtil næste genindlæsning i sekunder. Denne værdi kan sættes meget højt, hvis man ikke ønsker at indlæse genindlæse konfigurationen automatisk, hvorefter det kun kan aktiveres igen ved genstart af DCC.

...