...
VP Camel fungerar som en distributör av meddelanden från en konsument av information till en eller flera producenter av information, samt levererar svar från dessa. För att detta ska fungera ska VP installeras, samt ha tillgång till data via en installerad TAK-databas. För underhåll finns en applikation StatusProbe som kontrollerar att VP fungerar som den ska, men användningen är optional.
Äldre versioner
SKLTP VP - Installation av äldre versioner
Förutsättningar
Följande förutsätts vara installerat innan VP installeras:
...
Det finns en applikation StatusProbe som kan användas för att kontrollera status för VP Camel (och andra applikationer). Hur man installerar och använder den kan läsas på sidan Status-probe.
Ny installation av VP
1. Ladda ner applikationen
Hämta senaste version, t.ex. denna från IneraNexus (ersätt 1.0.0 med senaste version) :
https://nexus.inera.se/#browse/browse:maven-public:se%2Fskltp%2Fvp%2Fvp-services-camel%2F1.0.0-RC1%2Fvp-services-camel-1.0.0-RC1.jar
...
Pomfil för projektet finns intill, på adress:
https://nexus.inera.se/#browse/browse:maven-public:se%2Fskltp%2Fvp%2Fvp-parent-camel%2F1.0.0-RC1%2Fvp-parent-camel-1.0.0-RC1.pom
2. Konfigurera VP applikation
Notera att om det finns en redan installerad version av VP så är detta steget redan genomfört och endast ev förändringar kring nya eller borttagna properties behövs hanteras. Se release notes för VP på Release Note - Virtualiseringsplatformen för att hämta information om eventuella förändringar mellan releaser. |
...
Säkerställ att application-custom.properties och application-security-custom.properties finns under <vp-camel-intall-dir>/conf/ (annars behöver de skapas/kopieras) för att kunna överlagra default parametrar.
Med ledning av konfigurations-anvisningarna, sätt de parametrar som eventuellt behöver ändras.
För att “Trädklättring” ska fungera (se förklaring här: UppdateraHSACache - Bakgrund, arkitektur och implementation) så ska en fil med hsa information finnas i den mapp som pekas ut i application-custom.properties. Observera att denna funktionalitet kommer att försvinna i framtida versioner av VP Camel.
Ladda ner en HSA fil med endast SE nod som kompletterar den riktiga HSA filen. Placera till exempel i config-katalogen.
Kodblock wget http://skl-tp.atlassian.net/wiki/download/attachments/5308496/hsacachecomplementary.xml mv hsacachecomplementary.xml /usr/local/<vp-camel-intall-dir>/conf/hsacachecomplementary.xml
Uppdatera värdet i parametern hsa.files i application-custom.properties, så att den pekar på katalogen där du lagt filen hsacachecomplementary.xml för att läsa in SE noden
Kodblock vi /usr/local/<vp-camel-intall-dir>/conf/vp-config-override.properties hsa.files=/usr/local/<vp-camel-intall-dir>/conf/hsacachecomplementary.xml
Finns det behov av att hämta en fil från HSA med ett komplett organisationsträd, läs följande instruktion.
Säkerställ att korrekta certifikatsfiler finns i den mapp som pekas ut i application-security-custom.properties eller default-mappen /certs/ i <vp-camel-intall-dir>. Se också till att application-security-custom.properties listar rätt namn på certifikatsfilerna samt deras password.
Saknas mappen <vp-camel-intall-dir>/certs/, skapa den och lägg era certifikatsfiler i katalogen.
Kodblock mkdir /usr/local/<vp-camel-intall-dir>/certs/ cp my-cert.p12 <vp-camel-intall-dir>/certs/ cp my-trustsore.jks <vp-camel-intall-dir>/certs/ cp my-client.jks <vp-camel-intall-dir>/certs/
Se SKLTP VP - Konfiguration, hur konfiguration i application-security-custom.properties skall göras för att peka ut certifikatsfiler.
Vid behov , se Installationsmanual Certifikat för hur en truststore hanteras.
3. Starta, stoppa och kontrollera status på VP Camel
|
4. Verifiera installationen av VP Camel
Notera att virtuella tjänster, teststubbar och schemas läggs på efter en deploy, se rubriken Driftsätta Virtualiseringar |
Med integrerad statustjänst:
VP Camel exponerar en statustjänst vars port kan konfigureras i application-custom.properties.
Man kan anropa den med t.ex. Curl:Kodblock curl --data "username=uname&password=pw" http://<serveradress>:8080/status
och få ett svar:
Kodblock { "Name": "vp-services-camel", "Version": "1.0.0-RC1", "BuildTime": "2019-09-11T09:15:30.887Z", "ServiceStatus": "Started", "Uptime": "20 minutes", "ManagementName": "vp-services", "JavaVersion": "1.8.0_161", "CamelVersion": "2.24.0", "TakCacheInitialized": "true", "TakCacheResetInfo": "Date:2019-09-12T15:41 Status:REFRESH_OK vagval:566 behorigheter:1034", "HsaCacheInitialized": "true", "HsaCacheResetInfo": "Date:2019-09-12T15:41 Status:true oldNum:0 newNum:31465", "JvmTotalMemory": "885 mB", "JvmFreeMemory": "817 mB", "JvmUsedMemory": "67 mB", "JvmMaxMemory": "1365 mB", "Endpoints": [ "https://0.0.0.0:20000/vp", "http://0.0.0.0:8080/vp", "http://0.0.0.0:8080/status", "http://0.0.0.0:24000/resethsacache", "http://0.0.0.0:23000/resetcache" ] }
Med SoapUI:
a. Installera först SoapUI ( https://www.soapui.org/downloads/soapui/source-forge.html )
b. Skapa ett SoapUI-projekt som kör request’s mot VP Camel. Tutorials finns på denna adress:
https://www.soapui.org/learn/tutorials/web-service-example-projects.html
c. För att kunna köra webtjänsten så måste man installera ett SITHS certifikat. Finns inget kan det beställas från SITHS förvaltningen. I SoapUI väljer du sedan File > Preferences och sedan fliken SSL Settings. Som KeyStore väljer du det SITHS certifikat du har beställt och anger lösenordet som du fått i samband med beställningen. Notera att det är certifikatet för autentisering som skall användas, inte signering.
e. Se till att adress till applikationen är korrekt, annars editera.
f. Exekvera anrop genom att först dubbelklicka på önskat test och sedan klicka på den gröna pilen.
g. Ett resultat kommer nu att dyka upp i fönstret till höger i SoapUI (th på bilden nedan). Se exempel-svar nedan och dess betydelse.
...