Page History
Navitabs | ||||
---|---|---|---|---|
| ||||
Anchor | ||||
---|---|---|---|---|
|
SOSI-DCC driftsvejledning
Indledning
Eksterne afhængigheder
Placering af logfiler
Placering af konfigurationsfiler
Start/stop vejledning
Overvågning
Backup
Kendte fejl
Anchor | ||||
---|---|---|---|---|
|
Nærværende dokument udgør driftsvejledningen for SOSI-DCC komponenten, som også er kendt som Afkoblingskomponenten. SOSI-DCC fungerer som webservice gateway og dens hovedfunktioner er routning af requests, håndhævelse af timeout-grænser på webservice kald samt asynkron afkobling af webservice kald med tilhørende retry-mekanisme. (Den asynkrone afkobling er pt. slået fra i NSP)
Komponenten er udviklet som en Java 8 webapplikation og understøttes på JBoss Application Server version 8 (Wildfly)
Denne driftsvejledning er gældende for SOSI-DCC version 2.4.X.
Anchor | ||||
---|---|---|---|---|
|
På NSP er der pt. ingen eksterne afhængigheder.
Anchor | ||||
---|---|---|---|---|
|
Komponenten logger til sin egen rullende log som hedder 'decoupling.log'.
Komponents SLA logninger havner i 'nsputil-sla.log'.
På JBoss 8 platformen ligger logfilerne i:
$JBOSS_HOME/standalone/log/
hvor '$JBOSS_HOME' udpeger roden på JBoss Application Server.
Indgange i loggen indeholder en kort beskrivelse af hændelsen, tidspunktet samt hændelsens alvorlighedsgrad ('Severity').
Ved drift bør der ikke være indgange af alvorlighedsgrad 'ERROR' i loggen. Se overvågningsvejledning nedenfor.
Anchor | ||||
---|---|---|---|---|
|
Komponentens konfiguration udgøres af filerne 'dcc-config.xml' og 'log4j-dcc.properties'.
Afvikles komponenten på en NSP er det der ydermere to konfigurationsfiler til SLA-loggen: 'nspslalog-sosidcc.properties' og 'log4j-nspslalog.properties'.
På JBoss platformen er konfigurationen placeret i
$JBOSS_HOME/standalone/configuration/
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 indlæse nyeste konfiguration fra database.
Ændringer i den fil-baserede statiske konfiguration af komponenten træder først i kraft efter genstart af komponenten. Se vejledning nedenfor.
Anchor | ||||
---|---|---|---|---|
|
Wiki Markup |
---|
Komponenten stoppes og startes gennem den respektive applikationsservers administrations konsol eller ved genstart af hele applikationsserveren. \\ Efter genstart bør der verificeres at der ikke er nogen indgange med alvorlighedsgrad 'ERROR' i komponentens log. \\ Under stop eller undeploy af komponenten ses følgende typer warnings i loggen, som kan ignoreres: \\ _WARN \[org.jboss.msc.inject\] (MSC service thread 1-5) MSC000100: Unexpected failure to uninject public void net.sf.jbosscommonj.timermanager.TimerManagerService.setMinThreads(int): java.lang.IllegalArgumentException_ |
Anchor | ||||
---|---|---|---|---|
|
Udover at overvåge selve applikationsserveren for ressourceknaphed og generelle fejl kan man overvåge SOSI-DCC ved at:
- Sikre, at endpointet svarer, ved at foretage simple HTTP GET kald mod komponents 'check' status sider:
Viser en simple status side med IP-adressen og dato, øverste linje på siden viser 'OK'
Som 'dcccheck' men viser også konfigurationsparametre for komponenten.
- Overvåge komponentens logfil for 'ERROR' indgange
Anchor | ||||
---|---|---|---|---|
|
Der bør foretages backup af komponentens egne konfigurationsfiler hver gang konfigurationen ændres.
For at gøre eventuelt fejlfinding nemmere anbefales det, at der ligeledes tages backup af komponentens logfiler.
Anchor | ||||
---|---|---|---|---|
|
Der pt. ingen kendte fejl.