Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Applikationen forudsætter desuden, at audit API biblioteket er installeret og tilgængeligt i Wildfly.

Applikationen selv leveres som en .war fil, og skal lægges ind under deployments/ mappen. Dernæst vil Wildfly starte applikationen op. Sørg for at alle konfigurations filerne er de forventede steder, samt at de er korrekt udfyldt, på forhåndbliver leveret efter retningslinierne sat i NSP Continuous Integration & Delivery.

Konfigurering af leverence

SORUS bruger tre konfigurations filer, som alle findes i configuration/resource/ mappen i roden af servicens mappe på SVN. Nedenstående tabel indeholder konfigurations filerne, samt deres forventede installations mappe i Wildfly's enten domain/ eller standalone/ mapper.

FilInstallations lokation
log4j-sorus.propertiesconfiguration/
sorus-ds.xmldeployments/
sorus.propertiesconfiguration/


log4j-sorus.properties

Leverancen benytter Apache Log4J til applikations logning, og denne fil er konfigurering af denne.

...

NavnStandard værdiKommentar
app.nameSOR Opdatering ServiceNavnet for applikationen
app.name.shortsorusApplikationens forkortelse
app.url
URL på applikationen, bruges i forbindelse med DKS og udstilling af WSDL
app.security.seal.federation.testfalseAngiver om SEAL modulet skal benytte test federation ved validering af de certifikater, som er brugt til signering af en request
sor.db.jndijava:jboss/datasources/SORROJNDI navn på den datasource applikationen skal benytte for database opslag
sor.db.retry.max5Antallet af gange applikationen skal forsøge at udføre et database opslag, før at den giver op
sor.db.retry.wait1000Tiden i millisekunder applikationen venter mellem hvert forsøg på opslag i databasen
sor.backend.security.certificate.validationtrueAngiver om klienten for backend applikationen skal validere SSL certifikater, eller om den skal godkende alle. Denne burde ikke skulle slås fra, med mindre at backenden benytter et self-signed certifikat.
sor.backend.security.username
Brugernavn til brug ved Basic Authentication mod backenden
sor.backend.security.password
Password til brug ved Basic Authentication mod backenden
sor.backend.url.restbase
Base URL for REST endpoints for backenden, benyttes i forbindelse af checks om backenden er oppe og tilgængeligsom stub som alle andre URLs bliver genereret ud fra
sor.backend.url.soapservice
Restende af URL for SOAP endpoints for backenden
status.score.max100Bruges til udregning om applikationen er oppe og tilgængelig, eller om DCC skal betragte den som værende nede. Der vil internt blive holdt en score for at vurdere, om servicen er oppe eller ej. Denne vil blive påvirket af resultatet af kald mod backenden. Dette er den maksimale værdi denne score kan komme op på.
status.score.down60Bruges til udregning om applikationen er oppe og tilgængelig, eller om DCC skal betragte den som værende nede. Hvis den interne score overstiger denne værdi, så vil servicen blive betragtet som værende nede.
status.score.success40Bruges til udregning om applikationen er oppe og tilgængelig, eller om DCC skal betragte den som værende nede. Når et kald går succefuldt igennem til backend servicen, så vil denne værdi blive trukket fra den interne score. Den interne værdi kan ikke blive lavere end 0. Et kald som indeholder forkerte værdier vil stadig blive betragtet som værende en succes. Det er kun i de tilfælde, at backend servicen ikke kan nås, eller svarer tilbage med andet end HTTP 200, at det ikke bliver betragtet som værende en succes.
status.score.error20Bruges til udregning om applikationen er oppe og tilgængelig, eller om DCC skal betragte den som værende nede. Når et kald ikke går succefuldt igennem til backend servicen, så vil denne værdi blive lagt til den interne score.

...

Når servicen er blevet startet op, og igen fejl er sket i loggen under opstart, så kan applikationen hurtigt afprøves ved at gå ind på:

https://localhost/status?verbose

Dette burde give et XML output der ligner følgende:

...

Dernæst kan det testes at hente WSDL filen for applikationen:

https://localhost/v3/SOROpdateringService?wsdl

...