...

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 Lægemiddelstyrelsens bivirkningswebservice hos Den Engelske Lægemiddelstyrelse, MHRA, og transformerer dem til webservice protokollen SOAP.CRK. Komponenten er udviklet som en Java webapplikation og understøttes på Wildfly Application Server version 8.2.

Denne driftsvejledning er gældende for BIVWSP CRK version 1.0.Xx.

Eksterne afhængigheder

Komponenten skal kunne tilgå Lægemiddelstyrelsens bivirkningswebserviceDer kræves som udgangspunkt INGEN adgang til tjenester på internettet. De enkelte jobs, som indlæser endpoint definitioner kan dog være opsat til at hente denne fra en ekstern URL.

Placering af logfiler

Komponenten logger til sin egen rullende log som hedder bivwspcrk.log.

Logfiler er volume-mappet, så de er tilgængelig tilgængelige på docker-hosten, men af historiske hensyn kan det nævnes, at inde i containeren ligger logfilerne på Wildfly platformen i:

hvor '$JBOSS_HOME' udpeger roden på Wildfly Application Server installationen.

...

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

Bemærk, at disse også er volume-mappet ind.

...

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

1. Sikre, at endpointet svarer, ved at foretage simple HTTP GET kald mod komponents 'check' status side:
   1. http://<HOST>:<PORT>/bivwspcrk/check
      Viser en minimal status side som ender med 'End…'checkstatus
      

      Denne angiver pt blot antallet af aktive endpoints i konfigurationen og kan anvendes til at afgøre om komponenten er "I live".

2. Overvåge komponentens logfil for 'ERROR' indgange

Nyt password

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

...

Administration af endpoints

== Administrativ overskrivning af configuration.

Ved (genindlæsning) af endpoint definition fra ekstern kilde oprettes en ny
version af endpoint i databasen.  Tidligere versioner af samme endpoint
deaktiveres. Nye actions oprettes (som aktive) i databasen som peger på den nye
version af endpointet. Såfremt en tidligere aktiv action bortfalder for et
endpoint, vil den gamle værdi blive kopieret med angivelse af kilde.

Dette åbner et antal muligheder for administrativt at påvirke DCC konfigurationen.

=== Deaktivering af endpoint

Det er muligt helt at deaktivere et endpoint. Dette kan gøres ved at markere den
aktive version som `active=false`.

Bemærk at det kan være nyttigt at forhindre genindlæsning ved at _disable_ det
tilsvarende job i `crk-jobs.xml`.

=== Rollback til tidligere version af endpoint

Det er muligt at rulle et endpoint tilbage til en tidligere version.  Dette kan
gøres ved at markere den aktive version som `active=false`, og markere den
tidligere version med `active=true`.

Bemærk at det kan være nyttigt at forhindre genindlæsning ved at _disable_ det
tilsvarende job i `crk-jobs.xml`. Herved undgås utilsigtet "reaktivering" af den
nye version.

=== Deaktivering af action

En action kan deaktiveres ved at markere den med `active=false`. Den vil herefter
ikke længere være aktiv i DCC konfigurationen.

Ved opdatering fra ekstern kilde, vil denne action blive reaktiveret hvis og kun
hvis den er indeholdt i den nye end point definition.

[id="deactivate_action"]
=== Håndtering af nedlagte actions.

Såfremt en tidligere aktiv action bortfalder for et endpoint, vil den gamle
værdi blive kopieret med angivelse af kilde.  Tilstedeværelsen af kilde
angivelse (`inheritedEndpoint`) kan således fortolkes som et "deprekerings
flag".

Der kan herefter administrativt tages stilling til om denne action helt skal
bortfalde i DCC-konfigurationen, hvilket kan ske ved markering `active=false`
for pågældende action.

=== Overskrivning af gateway egenskab.

Såfremt den eksterne kilde angiver at en action kræver et niveau 4 id-kort
(MOCES), sættes useProxy til true.  Dvs det tillades DCC at køre foresprøgsler
til denne action igennem en SOSI-GW.

Det er muligt at overskrive denne værdi ved at definere `proxyOverride`. En
definition af `proxyOverride` har fortrinsret, og vil blive bevaret ved fremtidige
opdateringer af pågældende action (værdien kopieres fra tidligere versioner).

...

Backup
Der bør foretages backup af komponentens egne konfigurationsfiler hver gang konfigurationen ændres.
...