Svareksponeringsservice XDS-adaptere
Driftsvejledning

Anchor
_Toc327544068 _Toc327544068

Anchor
_Toc462261533 _Toc462261533

Introduktion

Anchor
_Toc316542421 _Toc316542421

Anchor
_Ref317083052 _Ref317083052

Anchor
_Toc327544069 _Toc327544069

Anchor
_Toc462261534 _Toc462261534

Formål

Anchor
_Toc327544071 _Toc327544071

Anchor
_Toc462261535 _Toc462261535

Læsevejledning

Læseren forventes at have kendskab til National Sundheds-IT's platform NSP, samt generelt kendskab til WildFly applikationsserver samt Ubuntu Linux operativ system.

Anchor
_Toc317831244 _Toc317831244

Anchor
_Toc317839917 _Toc317839917

Anchor
_Toc327544072 _Toc327544072

Anchor
_Toc462261536 _Toc462261536

Dokumenthistorik

Anchor
_Toc327544073 _Toc327544073

Anchor
_Toc462261537 _Toc462261537

Definitioner og referencer

Anchor
_Toc305606359 _Toc305606359

Anchor
_Ref327533610 _Ref327533610

Anchor
_Toc327544074 _Toc327544074

Anchor
_Toc462261538 _Toc462261538

Komponenter

Svareksponeringsservice XDS-adaptere er implementeret gennem følgende komponenter:

• Svareksponeringsservice XDS Registry Adapter
• Type: Webservice
• Filnavn: sxa-documentmetadataprovider.war
• Url: <serverurl>/sxa-documentmetadataprovider
• Statusurl: <serverurl>/service-check/service?servicename=sxa-documentmetadataprovider
• Svareksponeringsservice XDS Repository Adapter
• Type: Webservice
• Filnavn: sxa-documentprovider.war
• Url: <serverurl>/sxa-documentprovider
• Statusurl: <serverurl>/service-check/service?servicename=sxa-documentprovider

Brug af service-check forudsætter følgende komponent på NSP:

• Service-check
• Type: Webservice
• Filnavn: service-check.war
• Url: <serverurl>/service-check/service

Anchor
_Toc305606360 _Toc305606360

Anchor
_Toc327544075 _Toc327544075

Anchor
_Toc462261539 _Toc462261539

Daglig drift

Dette afsnit beskriver den daglige drift af systemet.

Anchor
_Toc327544076 _Toc327544076

Anchor
_Toc462261540 _Toc462261540

Relaterede services

Svareksponeringsservice XDS Repository Adapter afhænger af den eksterne service:

• Svareksponeringsservice hos Laboratoriedatabanken

Ved fejl i denne vil Svareksponeringsservice XDS Repository Adapter returnere svar til anvendere, hvoraf det fremgår, at der er fejl.

Anchor
_Toc305606363 _Toc305606363

Anchor
_Toc327544078 _Toc327544078

Anchor
_Ref449958486 _Ref449958486

Anchor
_Toc462261541 _Toc462261541

Konfiguration

Anchor
_Toc404868518 _Toc404868518

Anchor
_Toc462261542 _Toc462261542

Konfiguration af Svareksponeringsservice XDS Registry Adapter

Anchor
_Ref404947195 _Ref404947195

Anchor
_Toc462261543 _Toc462261543

Konfiguration af dokument-metadata

Dokument-metadata anvendt af Svareksponeringsservice XDS Registry Adapter, når der laves opslag på en patient, er defineret i følgende fil:

• sxametadataconfiguration.xml

Denne indlæses fra WildFly modulet:
/pack/wildfly8/modules/nsi/ddsprojects/sxa/documentmetadataprovider/config/main/
Et eksempel på indhold i sxametadataconfiguration.xml:
<metadata>
<classCode class="codedValue">
<code>001</code>
<codeSystem>2.16.840.1.113883.3.4208.100.9</codeSystem>
<description>Klinisk rapport</description>
</classCode>
<confidentialityCode class="codedValue">
<code>N</code>
<codeSystem>2.16.840.1.113883.5.25</codeSystem>
<description>Normal</description>
</confidentialityCode>
<formatCode class="codedValue">
<code>urn:ad:dk:medcom:labreports:svareksponeringsservice</code>
<codeSystem>1.2.208.184.100.10</codeSystem>
<description>Laboratoriesvar (samling af svar)</description>
</formatCode>
<languageCode>da-DK</languageCode>
<mimeType>text/xml</mimeType>
<practiceSettingCode class="codedValue">
<code></code>
<codeSystem></codeSystem>
<description></description>
</practiceSettingCode>
<typeCode class="codedValue">
<code>11502-2</code>
<codeSystem>2.16.840.1.113883.6.1</codeSystem>
<description>LABORATORY REPORT.TOTAL</description>
</typeCode>
<homeCommunityId>1.2.3.5.6</homeCommunityId>
<repositoryUniqueId>1.2.3.4.55.66</repositoryUniqueId>
<uniqueIdRoot>1.2.3.4.55.66</uniqueIdRoot>
<healthcareFacilityTypeCode class="codedValue">
<code></code>
<codeSystem>2.16.840.1.113883.6.96</codeSystem>
<description></description>
</healthcareFacilityTypeCode>
<authorInstitution
class="dk.nsi.documentsharing.core.metadata.model.OrganisationImpl">
<name>Region Test</name>
<id class="valueWithAssigningAuthority">
<value>291000016008</value>
<assigningAuthority>1.2.208.176.1.1</assigningAuthority>
</id>
</authorInstitution>
</metadata>

Anchor
_Toc462261544 _Toc462261544

Konfiguration af filter på dokument-metadata-forespørgsel

Ved opslag på en patient kan der anføres en række søge-parametre. Svareksponeringsservice XDS Registry Adapter har logik, der er afhængig af konkrete søge-parametre og konfigureret filter (beskrevet her), fastlægger hvilket svar, der skal returneres.
Filteret konfigureres i følgende fil:

• sxafilterconfiguration.xml

Denne indlæses fra WildFly modulet:
/pack/wildfly8/modules/nsi/ddsprojects/sxa/documentmetadataprovider/config/main/
I konfiguration specificeres 0, 1 eller flere kode-sæt i hhv. classCodes, typeCodes, eventCodes, confidentialityCodes, formatCodes og practiceSettingCodes?
<filter>
<classCodes>
</classCodes>
<typeCodes>
</typeCodes>
<eventCodes>
</eventCodes>
<confidentialityCodes>
</confidentialityCodes>
<formatCodes>
</formatCodes>
<practiceSettingCodes>
</practiceSettingCodes>
</filter>
Hver kode-sæt, består af:
<codedValue>
<code>kode-værdi</code>
<codeSystem>kode-system</codeSystem>
<description>menneskelæselig beskrivelse af kode-værdi</description>
</codedValue>
Filterets classCodes, typeCodes, eventCodes, confidentialityCodes, formatCodes og practiceSettingCodes modsvarer lignende navne i søge-parametre, der kan være anført ved kald af Svareksponeringsservice XDS Registry Adapter opslag. Er et kodesæt anført i søge-parametre for fx eventCodes, da bevirker filteret et tomt svar, når:

1. Filterets eventCodes ikke er tomt, og
2. Ingen af evt. flere eventCodes fra søge-parametre findes i filterets eventCodes-liste

Tilsvarende logik er gældende de øvrige koder i filteret.
Følgende er et eksempel på konfiguration af filteret:
<filter>
<classCodes/>
<typeCodes>
<codedValue>
<code>11502-2</code>
<codeSystem>2.16.840.1.113883.6.1</codeSystem>
<description>LABORATORY REPORT.TOTAL</description>
</codedValue>
</typeCodes>
<eventCodes/>
<confidentialityCodes>
<codedValue>
<code>N</code>
<codeSystem>2.16.840.1.113883.5.25</codeSystem>
<description>Normal</description>
</codedValue>
</confidentialityCodes>
<formatCodes>
<codedValue>
<code>urn:ad:dk:medcom:labreports:svareksponeringsservice</code>
<codeSystem>1.2.208.184.100.10</codeSystem>
<description>Laboratoriesvar (samling af svar)</description>
</codedValue>
</formatCodes>
<practiceSettingCodes>
<codedValue>
<code>408454008</code>
<codeSystem>2.16.840.1.113883.6.96</codeSystem>
<description>klinisk mikrobiologi</description>
</codedValue>
<codedValue>
<code>394596001</code>
<codeSystem>2.16.840.1.113883.6.96</codeSystem>
<description>klinisk biokemi</description>
</codedValue>
<codedValue>
<code>394915009</code>
<codeSystem>2.16.840.1.113883.6.96</codeSystem>
<description>patologi anatomi og cytologi</description>
</codedValue>
</practiceSettingCodes>
</filter>

Anchor
_Toc462261545 _Toc462261545

Konfiguration af mapning til specialer

Ved opslag på en patient kan der anføres en række søge-parametre. Svareksponeringsservice XDS Registry Adapter har logik, der er afhængig af konkrete søge-parametre foretager encoding i dokumentid, der er del af returnerede metadata.
Mapning til specialer konfigureres i følgende fil:

• sxapracticesettingcodes.xml

Denne indlæses fra WildFly modulet:
/pack/wildfly8/modules/nsi/ddsprojects/sxa/documentmetadataprovider/config/main/
I konfiguration specificeres specialer således:
<filter>
<practiceSettingCodes>
<mappedCodedValue>
<code>408454008</code>
<codeSystem>2.16.840.1.113883.6.96</codeSystem>
<description>klinisk mikrobiologi</description>
<mappedValue>Mikrobiologi</mappedValue>
</mappedCodedValue>
<mappedCodedValue>
<code>394596001</code>
<codeSystem>2.16.840.1.113883.6.96</codeSystem>
<description>klinisk biokemi</description>
<mappedValue>KliniskBiokemi</mappedValue>
</mappedCodedValue>
<mappedCodedValue>
<code>394915009</code>
<codeSystem>2.16.840.1.113883.6.96</codeSystem>
<description>patologisk anatomi og cytologi</description>
<mappedValue>Patologi</mappedValue>
</mappedCodedValue>
</practiceSettingCodes>
</filter>
Det er vigtigt, at den tilsvarende fil for documentprovider er konfigureret fuldstændigt identisk.

Anchor
_Toc462261546 _Toc462261546

Udpegning af log4j-konfigurationfil

Følgende fil, der findes under roden i war-filen sxa-documentmetadataprovider.war, udpeger den fil, der anvendes til konfiguration af log4j:

• documentsharing.log4j.properties

Bemærk, at denne fil (om nødvendigt) skal tilpasses direkte i war-filen og ikke findes i WildFly modulet.

Anchor
_Toc462261547 _Toc462261547

Konfiguration af log4j

Log4j konfiguration findes i følgende fil:

• log4j-sxa-documentmetadataprovider-ws.xml

Denne indlæses fra WildFly modulet:
/pack/wildfly8/modules/nsi/ddsprojects/sxa/documentmetadataprovider/config/main/
I konfigurationen er det muligt at aktivere performanceloggeren, der udvalgte steder i adapteren, vil skrive tidsvarighed af kald igennem systemet. Performanceloggeren aktiveres ved at ændre level værdien fra "OFF" til "DEBUG". Eftersom konfigurationen kun indlæses ved opstart af servicen, er det nødvendigt at genstarte servicen efter endt redigering af log4j-sxa-documentmetadataprovider-ws.xml filen.
Eksempel på konfiguration af performanceloggeren, hvor level værdien er sat til "OFF":
<logger name="performancelogger" additivity="false">
<level value="OFF" />
<appender-ref ref="PerformanceFile" />
</logger>
Som standard skriver performanceloggeren til sxa-documentmetadataprovider-ws-performance.log i WildFly' log-folder.
Se yderligere opsætning i installationsvejledningen.

Anchor
_Toc462261548 _Toc462261548

Udpegning af SLA-log konfiguration

Følgende fil udpeger hvilken fil, der indeholder konfigurationen af SLA-logning:

• nspslalog-sxa-documentmetadataprovider.properties

Denne indlæses fra WildFly modulet:
/pack/wildfly8/modules/nsi/ddsprojects/sxa/documentmetadataprovider/config/main/
Per default udpeges konfigurationsfilen beskrevet i næste afsnit.

Anchor
_Toc462261549 _Toc462261549

Konfiguration af SLA-log

Per default indlæses konfigurationen af Svareksponeringsservice XDS Registry Adapters SLA-logning fra følgende fil:

• log4j-nspslalog-sxa-documentmetadataprovider.properties

Denne indlæses fra WildFly modulet:
/pack/wildfly8/modules/nsi/ddsprojects/sxa/documentmetadataprovider/config/main/

Anchor
_Toc327544080 _Toc327544080

Anchor
_Toc462261550 _Toc462261550

Konfiguration af Svareksponeringsservice XDS Repository Adapter

Anchor
_Toc462261551 _Toc462261551

Konfiguration af Svareksponeringsservice kalder

Opsætningen for kalderen af Svareksponeringsservice konfigureres i SXADocumentProvider.properties.
Denne indlæses fra WildFly modulet:
/pack/wildfly8/modules/nsi/ddsprojects/sxa/documentprovider/config/main/
Et eksempel på sådan konfiguration er:
sxa.labservice.request.timeout.seconds = 120
sxa.labservice.request.username = username
sxa.labservice.request.password = password
sxa.labservice.endpoint = http://localhost:9090/sxa-labreportservicestub/SvarEksponering
sxa.document.unique.root.id = 1.2.3.4.55.66
sxa.labservice.request.samtykkekode = _ sxa.labservice.request.samtykketekst = _ sxa.labservice.request.slutbruger.identifikation = _ sxa.labservice.request.slutbruger.organisation = _ sxa.labservice.request.slutbruger.cpr = _ sxa.labservice.request.slutbruger.fornavn = _ sxa.labservice.request.slutbruger.efternavn = _ sxa.labservice.request.slutbruger.stilling = _ sxa.labservice.request.slutbruger.email = _ sxa.labservice.request.slutbruger.rolle = _ sxa.labservice.request.slutbruger.autorisationskode = _
Properties beskrives ifølge tabel.

Anchor
_Toc462261552 _Toc462261552

Konfiguration af dokumentdelings-id

Konfiguration af hvilket homeCommunityId og repositoryUniqueId, Svareksponeringsservice XDS Repository Adapter'en skal reagere på ved request for indhentning af dokument, er konfigureret i følgende fil:

• sxaproviderconfiguration.xml

Denne indlæses fra WildFly modulet:
/pack/wildfly8/modules/nsi/ddsprojects/sxa/documentprovider/config/main/
Et eksempel på sådan konfiguration er:
<ProviderConfiguration>
<homeCommunityId>1.2.3.5.6</homeCommunityId>
<repositoryUniqueId>1.2.3.4.55.66</repositoryUniqueId>
<uniqueIdRoot>1.2.3.4.55.66</uniqueIdRoot>
</ProviderConfiguration>
Bemærk, at de konkrete værdier skal være afstemt med homeCommunityId og repositoryUniqueId i de dokumentmetadata, der er konfigureret som beskrevet i afsnit 4.1.1. Er der ikke overensstemmelse, vil kald til Svareksponeringsservice XDS Repository give anledning til svar, der påpeger uoverenstemmelsen.

Anchor
_Toc327544081 _Toc327544081

Anchor
_Toc462261553 _Toc462261553

Konfiguration af mapning til specialer

Ved opslag på en patient kan der anføres en række søge-parametre. Svareksponeringsservice XDS Registry Adapter har logik, der er afhængig af konkrete søge-parametre foretager encoding i dokumentid, der er del af returnerede metadata. Ved indhentning af dokument foretages decoding og mapning til speciale-parametre anvendt i kaldet til Svareksponeringsservicen.
Mapning til specialer konfigureres i følgende fil:

• sxapracticesettingcodes.xml

Denne indlæses fra WildFly modulet:
/pack/wildfly8/modules/nsi/ddsprojects/sxa/documentprovider/config/main/
I konfiguration specificeres specialer således:
<filter>
<practiceSettingCodes>
<mappedCodedValue>
<code>408454008</code>
<codeSystem>2.16.840.1.113883.6.96</codeSystem>
<description>klinisk mikrobiologi</description>
<mappedValue>Mikrobiologi</mappedValue>
</mappedCodedValue>
<mappedCodedValue>
<code>394596001</code>
<codeSystem>2.16.840.1.113883.6.96</codeSystem>
<description>klinisk biokemi</description>
<mappedValue>KliniskBiokemi</mappedValue>
</mappedCodedValue>
<mappedCodedValue>
<code>394915009</code>
<codeSystem>2.16.840.1.113883.6.96</codeSystem>
<description>patologisk anatomi og cytologi</description>
<mappedValue>Patologi</mappedValue>
</mappedCodedValue>
</practiceSettingCodes>
</filter>
Det er vigtigt, at den tilsvarende fil for documentmetadataprovider er konfigureret fuldstændigt identisk.

Anchor
_Toc462261554 _Toc462261554

Udpegning af log4j-konfigurationfil

Følgende fil, der findes under roden i war-filen sxa-documentprovider.war, udpeger den fil, der anvendes til konfiguration af log4j:

• documentsharing.log4j.properties

Bemærk, at denne fil (om nødvendigt) skal tilpasses direkte i war-filen og ikke findes i WildFly modulet.

Anchor
_Toc462261555 _Toc462261555

Konfiguration af log4j

Log4j konfiguration findes i følgende fil:

• log4j-sxa-documentprovider-ws.xml

Denne indlæses fra WildFly modulet:
/pack/wildfly8/modules/nsi/ddsprojects/sxa/documentprovider/config/main/
I konfigurationen er det muligt at aktivere performanceloggeren, der udvalgte steder i adapteren, vil skrive tidsvarighed af kald igennem systemet. Performanceloggeren aktiveres ved at ændre level værdien fra "OFF" til "DEBUG". Eftersom konfigurationen kun indlæses ved opstart af servicen, er det nødvendigt at genstarte servicen efter endt redigering af log4j-sxa-documentprovider-ws.xml filen.
Eksempel på konfiguration af performanceloggeren, hvor level værdien er sat til "OFF":
<logger name="performancelogger" additivity="false">
<level value="OFF" />
<appender-ref ref="PerformanceFile" />
</logger>

Anchor
_Toc462261556 _Toc462261556

Udpegning af SLA-log konfiguration

Følgende fil udpeger hvilken fil, der indeholder konfigurationen af SLA-logning:

• nspslalog-sxa-documentprovider.properties

Denne indlæses fra WildFly modulet:
/pack/wildfly8/modules/nsi/ddsprojects/sxa/documentprovider/config/main/
Per default udpeges konfigurationsfilen beskrevet i næste afsnit.

Anchor
_Toc462261557 _Toc462261557

Konfiguration af SLA-log

Per default indlæses konfigurationen af Svareksponeringsservice XDS Repository Adapters SLA-logning fra følgende fil:

• log4j-nspslalog-sxa-documentprovider.properties

Denne indlæses fra WildFly modulet:
/pack/wildfly8/modules/nsi/ddsprojects/sxa/documentprovider/config/main/

Anchor
_Toc462261558 _Toc462261558

HTTP Statuscheck på komponenter i Svareksponeringsservice XDS-adaptere

Det er muligt at lave servicetjek på Svareksponeringsservice XDS-adaptere ved brug af den generelle service servicecheck. For at understøtte servicetjek kræves konfiguration af servicecheck servicen, der er både generel og specifikt for svareksponeringsservice XDS-adaptere. Følgende underafsnit beskriver den nødvendige konfiguration.

Anchor
_Toc327544084 _Toc327544084

Anchor
_Toc414948990 _Toc414948990

Anchor
_Ref448237841 _Ref448237841

Anchor
_Toc462261559 _Toc462261559

ServiceCheck.properties

Grundlæggende konfiguration af service-check sker ved tilretning af properties i ServiceCheck.properties filen. 
Eksempel på ServiceCheck.properties
jmx.url = service:jmx:rmi://localhost/jndi/rmi://localhost:1090/jmxconnector
jmx.username = nisse
jmx.password = ngyffe
service.config.path = service-check.xml
log4j.path = servicecheck.log4j.properties
\\
Konfiguration af log4j sker ved tilretning af properties i filen servicecheck.log4j.properties:
log4j.logger.service-check=INFO, sclog
\\
log4j.appender.sclog=org.apache.log4j.RollingFileAppender
log4j.appender.sclog.File=$\{jboss.server.log.dir\}/service-check.log
log4j.appender.sclog.layout=org.apache.log4j.PatternLayout
log4j.appender.sclog.layout.ConversionPattern=%d \[%t\] %-5p %c - %m%n

Anchor
_Toc434410445 _Toc434410445

Anchor
_Ref327260436 _Ref327260436

Anchor
_Toc327544085 _Toc327544085

Anchor
_Toc414948991 _Toc414948991

Anchor
_Toc462261560 _Toc462261560

JMX-Console sikkerhedsopsætning

WildFly

Følgende script afvikles for at tilføje en ny JMX bruger på wildfly:
wildfly\bin\add-user.sh
Under opsætning af brugeren vælges typen 'Management User' og muligheden for kommunikation på tværs af applikationsservere kræves ikke rettigheder til.
Når brugeren er oprettet med navn og kodeord ændres ServicesCheck.properties, så properties stemmer overens med det indtastede i add-user.sh scriptet.
Se afsnit 4.3.1 for et eksempel på konfiguration af jmx.username og jmx.password.

Anchor
_Toc462261561 _Toc462261561

service-check.xml

Konfiguration af de enkelte checks for en service foretages ved tilretning af settings i service-check.xml filen. Nedenfor ses eksempel på konfiguration af Svareksponeringsservice XDS Adapteres service check, der omfatter:

• Check i WildFly at servicen er registreret og aktiv

<service name="sxa-documentmetadataprovider">
<assertions resultCode="200">
<mBeanCheck>
<ObjectName>jboss.as:deployment=sxa-documentmetadataprovider.war,subsystem=undertow,servlet=MetadataProviderWS</ObjectName>
</mBeanCheck>
</assertions>
<assertions resultCode="404">
<mBeanCheck>
<ObjectName>jboss.as:deployment=sxa-documentmetadataprovider.war,subsystem=undertow,servlet=MetadataProviderWS</ObjectName>
<isRegistered>false</isRegistered>
</mBeanCheck>
</assertions>
</service>
<service name="sxa-documentprovider">
<assertions resultCode="200">
<mBeanCheck>
<ObjectName>jboss.as:deployment=sxa-documentprovider.war,subsystem=undertow,servlet=DocumentProviderWS</ObjectName>
</mBeanCheck>
</assertions>
<assertions resultCode="404">
<mBeanCheck>
<ObjectName>jboss.as:deployment=sxa-documentprovider.war,subsystem=undertow,servlet=DocumentProviderWS</ObjectName>
<isRegistered>false</isRegistered>
</mBeanCheck>
</assertions>
</service>

Anchor
_Toc462261562 _Toc462261562

Test af Service-check konfiguration

Efter konfiguration og deploy af ServiceCheck servicen, kan Svareksponeringsservice XDS Adaptere servicecheck testes med følgende kommandoer:
curl –i localhost:9090/service-check/service?servicename=sxa-documentmetadataprovider
curl –i localhost:9090/service-check/service?servicename=sxa-documentprovider
Servicen returnerer følgende http koder:

• 200 ved normal situation.
• 404 hvis servicen ikke er deployed
• 405 ved fejlkonfiguration af url til check af service-check funktionen (for at lette fejlsøgning)
• 500 ved anden intern fejl ved forespørgsel i WildFly på den overvågede service

Anchor
_Toc462261563 _Toc462261563

HTTP Versionsnummer-information på Svareksponeringsservice XDS-adaptere

Der kan hentes versionsnummer fra kørende Svareksponeringsservice XDS adaptere som givet i nedenstående tabel.

Tabel 1 Versionsnummer for kørende service
Versionsnummeret hentes fra Mavens pom.properties indlejret i jar-filen for fællesartefaktet sxa-provider-common.

Anchor
_Toc462261564 _Toc462261564

Test af versionsnummer

Efter konfiguration og deploy af Svareksponeringsservice XDS-adaptere kan versionsnummeret for fx Svareksponeringsservice XDS Registry Adapter hentes med:
curl localhost:9090/sxa-documentmetadataprovider/version
hvilket giver output i stil med:
Version: 1.0.0
Tilsvarende hentes versionsnummeret for Svareksponeringsservice XDS Repository Adapter blot ved at anvende det andet endpoint i tabellen.

Anchor
_Toc305606364 _Toc305606364

Anchor
_Toc327544087 _Toc327544087

Anchor
_Ref404947522 _Ref404947522

Anchor
_Toc462261565 _Toc462261565

Overvågning

Svareksponeringsservice XDS-adaptere overvåges af service-check overvågningsside, hvis url kan aflæses i afsnit 2.

Anchor
_Toc462261566 _Toc462261566

Placering af HTML overvågningsside

Under listen af komponenter først i dette dokument, er der henvisninger til overvågningssiderne.

Anchor
_Toc305606366 _Toc305606366

Anchor
_Toc327544089 _Toc327544089

Anchor
_Toc414948996 _Toc414948996

Anchor
_Toc462261567 _Toc462261567

Fortolkning af HTML overvågningsside

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

Anchor
_Toc305606367 _Toc305606367

Anchor
_Toc327544090 _Toc327544090

Anchor
_Toc414948997 _Toc414948997

Anchor
_Toc462261568 _Toc462261568

Overvågningstype

Simpel WEB side der anvender JMX til at indhente oplysninger om Web services deployed på serveren. Som udgangspunkt overvåges følgende:

• Verificer service er registreret og aktiveret i WildFly

Det muligt at udvide overvågning med yderligere checks ved at tilføje nye objekter i service-check.xml, se eksempler i afsnit 4.3.2.

Anchor
_Toc305606368 _Toc305606368

Anchor
_Toc327544091 _Toc327544091

Anchor
_Toc462261569 _Toc462261569

Logfiler og fortolkning af disse

Alle logfiler er at finde i log/ under WildFly. Herunder findes en liste over alle logfiler med en beskrivelse af hvilke komponenter der skriver til dem.

For alle webservices er der en tilhørende SLA-log, der sørger for at logge udvalgte elementer fra requests til webservicen.
Performance logs forekommer kun ved aktivering af performanceloggeren i komponenternes log4j konfiguration.

Anchor
_Toc305606369 _Toc305606369

Anchor
_Toc327544092 _Toc327544092

Anchor
_Toc462261570 _Toc462261570

Standard fejlsøgning

Fejlsøgning kan ske ved at undersøge de logfiler, der er beskrevet i forudgående afsnit.

Anchor
_Toc305606370 _Toc305606370

Anchor
_Toc327544093 _Toc327544093

Anchor
_Toc462261571 _Toc462261571

Krav til backup m.m.

Det anbefales, at aktuelle konfigurationsfiler til Svareksponeringsservice XDS-adaptere holdes under versionskontrol og back-up.