...

...

BIVWSP driftsvejledning

Indledning
Eksterne afhængigheder
Placering af logfiler
Placering af konfigurationsfiler
Start/stop vejledning
Overvågning
Backup
Kendte fejl

...

Indledning

Nærværende dokument udgør driftsvejledningen for BIVWSP (BivirkningsWebServiceProxy). BIVWSP fungerer som webservice proxy, der modtager indberetninger som følger Den Gode Webservice (DGWS) til Sundhedsstyrelsens bivirkningswebservice hos Den Engelske Lægemiddelstyrelse, MHRA, og transformerer dem til webservice protokollen SOAP.
Komponenten er udviklet som en Java webapplikation og understøttes på JBoss Application Server version 6.0.
Denne driftsvejledning er gældende for BIVWSP version 1.0.X.

...

Eksterne afhængigheder

Komponenten skal kunne tilgå Sundhedsstyrelsens bivirkningswebservice.

...

...

Placering af logfiler

Komponenten logger til sin egen rullende log som hedder bivwsp.log.
På JBoss platformen ligger logfilerne i:

$JBOSS_HOME/server/default/log/ 

hvor '$JBOSS_HOME' udpeger roden på JBoss Application Server installationen.
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.

...

...

Placering af konfigurationsfiler

Komponentens konfiguration udgøres af filerne i folderen 'BIVWSP' som er placeret under

$JBOSS_HOME/server/default/conf/ 

hvor '$JBOSS_HOME' udpeger roden på JBoss Application Server installationen.
Ændringer i konfigurationen af komponenten træder først i kraft efter genstart af komponenten. Se vejledning nedenfor.

...

Start/stop vejledning

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.

...

...

Overvågning

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

1. Sikre, at endpointet svarer, ved at foretage simple HTTP GET kald mod komponents 'check' status side:
   1. http://<HOST>:<PORT>/bivwsp/check
      Viser en minimal status side som ender med 'End…'
2. Overvåge komponentens logfil for 'ERROR' indgange

...

Når der modtages et nyt password, som skal rettes i property-filen. Skal det først krypteres. Det gøres ved at kalde:

mvn exec:java -DmainClass=dk.silverbullet.EncryptPass -Dexec.args="password" 

Hvor password ændres til rigtig password. Krypteret password kan derefter aflæses i output fra programmet. F.eks.

Encryptet password...:SLiL3+RVjjO1Mn2qSB3ex4vxxYkZq585

...

...

Backup

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.

...

Kendte fejl

Der pt. ingen kendte fejl.