TODO: Uppdatera
Äldre versioner
SKLTP VP - Installation av äldre versioner
Förutsättningar
Följande förutsätts vara installerat innan VP installeras:
SKLTP TAK 2.4.0 eller senare installerad, se installationsanvisning. Konfiguration enligt installationsanvisning förutsätts
Certifikat installerat, se installationsmanual
Ny installation av VP
1. Ladda ner applikationen
wget http://repo1.maven.org/maven2/se/skltp/vp/vp-services/x.y.z/vp-services-x.y.z.zip där x.y.z är en vaersion av vp, exempelvis wget http://repo1.maven.org/maven2/se/skltp/vp/vp-services/3.1.3/vp-services-3.1.3.zip |
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. |
VP har konfigurationsfiler för att konfigurera olika parametrar som styr applikationens funktioner. Hur dessa parametrar konfigureras och dess betydelse beskrivs i detalj på SKLTP VP Camel - Konfiguration.
Säkerställ att vp-config-override.properties och vp-security-override.properties finns under /usr/local/mule-standalone-3.7.0/conf/ för att kunna överlagra default parametrar
Skapa en vp-config-override.properties och en vp-security-override.properties, konfigurera enligt SKLTP VP - Konfiguration
sudo vi /usr/local/mule-standalone-3.7.0/conf/vp-config-override.properties
eller (med hjälp av WinSCP) logga in på aktuell server och hämta konfigurationen under ….
sudo vi /usr/local/mule-standalone-3.7.0/conf/vp-security-override.properties
Säkerställ att fil med hsa information finns under /usr/local/mule-standalone-3.7.0/conf/
Ladda ner HSA fil med endast SE nod som kompletterar den riktiga HSA filen.
wget http://skl-tp.atlassian.net/wiki/download/attachments/5308496/hsacachecomplementary.xml mv hsacachecomplementary.xml /usr/local/mule-standalone-3.7.0/conf/hsacachecomplementary.xml
Uppdatera i parametern HSA_FILES vp-config-override.properties för att lägga till hsacachecomplementary.xml och läsa in SE noden
vi /usr/local/mule-standalone-3.7.0/conf/vp-config-override.properties HSA_FILES=/usr/local/mule-standalone-3.7.0/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 under /usr/local/mule-standalone-3.7.0/certs/ och att vp-security-override.properties pekar på certifikatsfilerna.
Saknas /usr/local/mule-standalone-3.7.0/certs/, skapa den och lägg era certifikatsfiler i katalogen.
mkdir /usr/local/mule-standalone-3.7.0/certs/ cp my-cert.p12 /usr/local/mule-standalone-3.7.0/certs/ cp my-trustsore.jks /usr/local/mule-standalone-3.7.0/certs/
Se SKLTP VP - Konfiguration, hur konfiguration i vp-security-override.properties skall göras för att peka ut certifikatsfiler.
Vid behov , se Installationsmanual Certifikat för hur en truststore hanteras.
3. Installation
Se gemensam installationsanvisning längre ner på sidan.
Installationsanvisning (delade delar)
Genomför en en release med MMC
Genomför en en release manuellt när inte MMC finns tillgängligt
Monitorera mule.log för att se loggar
tail -f /usr/local/mule-standalone-3.7.0/logs/mule.log $
Ta bort tidigare version av samma applikation om det finns en sådan, tex olika releasekandidater (RC).
I /usr/local/mule-standalone-3.7.0/apps, radera vp-services-[version]-anchor.txt för att trigga så att Mule tar bort applikationen under kontrollerade former.
rm /usr/local/mule-standalone-3.7.0/apps/vp-services-3.1.3-anchor.txt
Säkerställ att applikationen tagits av Mule genom katalogen vp-services-[version] inte längre finns kvar.
ll -a /usr/local/mule-standalone-3.7.0/apps
Driftsätt applikation (zip)
Kopiera den nedladdade zip-filen, vp-services-[version].zip, till /usr/local/mule-standalone-3.7.0/apps. Mule packar upp applikationen till en katalog vp-services-[version].
cp vp-services-3.1.3.zip /usr/local/mule-standalone-3.7.0/apps
En fil med namn vp-services-[version]-anchor.txt (vp-services-3.1.3.zip) skapas vid en lyckad driftsättning.
ll -a /usr/local/mule-standalone-3.7.0/apps -rw-r--r-- 1 mule mule 75 26 okt 21.59 vp-services-3.1.3-anchor.txt drwxr-xr-x 5 mule mule 4096 15 okt 13.17 vp-services-3.1.3
Verifiera i loggar hur releasen gick, /usr/local/mule-standalone-3.7.0/logs/mule-app-vp.log och /usr/local/mule-standalone-3.7.0/logs/mule.log
I /usr/local/mule-standalone-3.7.0/logs/mule.log ser man status på driftsättningen.
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + New app 'vp-services-3.1.3' + ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ INFO 2013-08-28 08:50:27,837 [WrapperListener_start_runner] org.mule.module.launcher.MuleApplicationClassLoader: [vp-services-3.1.3] Loading the following jars: ============================= - - - ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + Started app 'vp-services-3.1.3' + ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
********************************************************************** * - - + APPLICATION + - - * - - + STATUS + - - * ********************************************************************** * vp-services-3.1.3 * DEPLOYED * **********************************************************************
I /usr/local/mule-standalone-3.7.0/logs/mule-app-vp.log ser man följande vid en lyckad start.
********************************************************************** * Application: vp-services-3.1.3 * * OS encoding: UTF-8, Mule encoding: UTF-8 * * * * Agents Running: * * JMX Agent * * Wrapper Manager: Mule PID #20712, Wrapper PID #20705 * ********************************************************************** 2013-08-28 08:51:31,182 INFO org.mule.module.logging.DispatchingLogger - Start force a reset of VagvalAgent... 2013-08-28 08:51:31,186 INFO org.mule.module.logging.DispatchingLogger - Initialize VagvalAgent TAK resources... 2013-08-28 08:51:31,187 INFO org.mule.module.logging.DispatchingLogger - Fetch all virtualizations from TAK... 2013-08-28 08:51:31,503 INFO org.mule.module.logging.DispatchingLogger - Fetch all permissions from TAK... 2013-08-28 08:51:31,801 INFO org.mule.module.logging.DispatchingLogger - Save virtualizations and permissions to local TAK copy: /home/mule/.tk.devtest.localCache 2013-08-28 08:51:31,932 INFO org.mule.module.logging.DispatchingLogger - Init VagvalAgent loaded number of permissions: 161 2013-08-28 08:51:31,934 INFO org.mule.module.logging.DispatchingLogger - Init VagvalAgent loaded number of virtualizations: 116 2013-08-28 08:51:31,935 INFO org.mule.module.logging.DispatchingLogger - Init VagvalAgent done 2013-08-28 08:51:31,936 INFO org.mule.module.logging.DispatchingLogger - Successfully force reset VagvalAgent
Om driftsättningen misslyckas skapas inte en vp-services-[version]-anchor.txt, applikationen startar inte och följande ses i /usr/local/mule-standalone-3.7.0/logs/mule.log
********************************************************************** * - - + APPLICATION + - - * - - + STATUS + - - * ********************************************************************** * vp-services-3.1.3 * FAILED * **********************************************************************
Notera att virtuella tjänster, teststubbar och schemas läggs på efter en deploy, se rubriken Driftsätta Virtualiseringar |
Verifiera installationen av Virtualiseringsplattformen med anrop till Ping tjänst
Med hjälp av ett verktyg som SoapUI går det att göra anrop till tjänster som exponeras av Virtualiseringsplattformen. För att verifiera att installationen gått bra kan man använda bifogat SoapUI projekt genom att följa följande instruktion.
Installera först SoapUI (http://sourceforge.net/projects/soapui/files/soapui/)
Ladda sedan hem SoapUI projektet från länken "soapUI projekt" och spara det i lämplig katalog.
Importera projektet till SoapUI, välj meny File/Import Project.
För att kunna köra webtjänsten så måste vi installera ett SITHS certifikat. Har vi inget SITHS certifikat, beställ ett hos 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.Exekvera anrop genom att först dubbelklicka på PingRequest och sedan klicka på den gröna pilen, i bilden märkt med Exekvera anrop.
Om adressen (förvald till localhost:20000) inte är korrekt, klicka på adressen och välj valet "edit current", ändra adressen till korrekt adress.
Ett resultat kommer nu att dyka upp i fönstret till höger, märkt Response i bilden nedan. Se exempelsvar nedan och dess betydelse.
klicka för större bild
1: VP004, ingen logisk adress (verksamhet/system) upplagd som matchar angiven logisk adress i anropet. Orsak, en logisk adress (Test) saknas i Tjänstekatalogen. Åtgärd, registrera logisk adress i Tjänstekatalogen.
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <soap:Fault> <faultcode>soap:Server</faultcode> <faultstring>VP004 No Logical Adress found for serviceNamespace:urn:riv:itinfra:tp:Ping:1:rivtabp20, receiverId:Test (se.skl.tp.vp.exceptions.VpSemanticException). Message payload is of type: ReversibleXMLStreamReader</faultstring> </soap:Fault> </soap:Body> </soap:Envelope> |
2: VP007, ingen behörighet finns för konsumenten (HSA ID från certifikatet) att anropa angiven logisk adress (verksamhet/system). Orsak, behörighet saknas i Tjänstekatalogen. Åtgärd, registrera behörighet för konsumenten i Tjänstekatalogen.
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <soap:Fault> <faultcode>soap:Server</faultcode> <faultstring>VP007 Authorization missing for serviceNamespace: urn:riv:itinfra:tp:Ping:1:rivtabp20, receiverId: Test, senderId: HSAID-XYZ (se.skl.tp.vp.exceptions.VpSemanticException). Message payload is of type: ReversibleXMLStreamReader</faultstring> </soap:Fault> </soap:Body> </soap:Envelope> |
3: OK, ett lyckat anrop där konsumenten har behörighet att anropa logisk adress för tjänsten Ping.
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Header> <mule:header xmlns:mule="http://www.muleumo.org/providers/soap/1.0"> <mule:MULE_CORRELATION_ID>ca082f56-13b1-11e3-941a-8114c8049c15</mule:MULE_CORRELATION_ID> <mule:MULE_CORRELATION_GROUP_SIZE>1</mule:MULE_CORRELATION_GROUP_SIZE> <mule:MULE_CORRELATION_SEQUENCE>-1</mule:MULE_CORRELATION_SEQUENCE> </mule:header> </soap:Header> <soap:Body> <pingResponse xmlns="urn:riv:itinfra:tp:PingResponder:1" xmlns:ns2="http://www.w3.org/2005/08/addressing"> <pingUt>Ping response from:Ping test</pingUt> </pingResponse> </soap:Body> </soap:Envelope> |
Verifiera att följande loggar dyker upp i <mule_home>/logs/mule-app-vp.log
** logEvent-debug.start *********************************************************** IntegrationScenarioId= ContractId= LogMessage=xreq-in ServiceImpl=vagval-dynamic-routing-flow Host=tp-test01 (192.168.19.10) ComponentId=vp-services-2.2.4 Endpoint=https://localhost:20000/vp/Ping/1/rivtabp20 MessageId=12a01c5a-5908-11e3-906c-2d7f5d7f27be BusinessCorrelationId=12a06a86-5908-11e3-906c-2d7f5d7f27be BusinessContextId= ExtraInfo= -senderid=HSASERVICES-100M -source=se.skl.tp.vp.util.LogTransformer -cxf_service=urn:riv:itinfra:tp:Ping:1:rivtabp20 -rivversion=RIVTABP20 -receiverid=Ping Payload=<?xml version='1.0' encoding='UTF-8'?><soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:add="http://www.w3.org/2005/08/addressing" xmlns:urn="urn:riv:itinfra:tp:PingResponder:1"> <soapenv:Header> <add:To>Ping</add:To> </soapenv:Header> <soapenv:Body> <urn:ping> <urn:pingIn/> </urn:ping> </soapenv:Body> </soapenv:Envelope> ** logEvent-debug.end ************************************************************* 2013-11-29 16:08:15,865 DEBUG org.mule.module.logging.DispatchingLogger - MULE_ENCODING = UTF-8 (java.lang.String) 2013-11-29 16:08:15,866 DEBUG org.mule.module.logging.DispatchingLogger - http.method = POST (java.lang.String) 2013-11-29 16:08:15,867 DEBUG org.mule.module.logging.DispatchingLogger - MULE_CORRELATION_ID = 12a01c5a-5908-11e3-906c-2d7f5d7f27be (java.lang.String) 2013-11-29 16:08:15,868 DEBUG org.mule.module.logging.DispatchingLogger - x-skltp-prt = 9 (java.lang.String) 2013-11-29 16:08:15,869 DEBUG org.mule.module.logging.DispatchingLogger - Content-Type = text/plain;charset=UTF-8 (java.lang.String) 2013-11-29 16:08:15,870 DEBUG org.mule.module.logging.DispatchingLogger - MULE_CORRELATION_GROUP_SIZE = 1 (java.lang.String) 2013-11-29 16:08:15,871 DEBUG org.mule.module.logging.DispatchingLogger - SOAPAction = "" (java.lang.String) 2013-11-29 16:08:15,888 DEBUG org.mule.module.logging.DispatchingLogger - soi-toolkit.log ** logEvent-debug.start *********************************************************** IntegrationScenarioId= ContractId= LogMessage=xresp-out ServiceImpl=vagval-dynamic-routing-flow Host=tp-test01 (localhost) ComponentId=vp-services-2.2.4 Endpoint=https://localhost:20000/vp/Ping/1/rivtabp20 MessageId=12a4b04f-5908-11e3-906c-2d7f5d7f27be BusinessCorrelationId=12a06a86-5908-11e3-906c-2d7f5d7f27be BusinessContextId= ExtraInfo= -senderid=HSASERVICES-100M -source=se.skl.tp.vp.util.LogTransformer -cxf_service=urn:riv:itinfra:tp:Ping:1:rivtabp20 -rivversion=RIVTABP20 -time.producer=9 -endpoint_url=http://localhost:20001/teststubservice/Ping_Service/1 -receiverid=Ping Payload=<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"><soap:Header><mule:header xmlns:mule="http://www.muleumo.org/providers/soap/1.0"><mule:MULE_CORRELATION_ID>12a01c5a-5908-11e3-906c-2d7f5d7f27be</mule:MULE_CORRELATION_ID><mule:MULE_CORRELATION_GROUP_SIZE>1</mule:MULE_CORRELATION_GROUP_SIZE><mule:MULE_CORRELATION_SEQUENCE>-1</mule:MULE_CORRELATION_SEQUENCE></mule:header></soap:Header><soap:Body><pingResponse xmlns="urn:riv:itinfra:tp:PingResponder:1" xmlns:ns2="http://www.w3.org/2005/08/addressing"><pingUt>Ping response from: </pingUt></pingResponse></soap:Body></soap:Envelope> ** logEvent-debug.end ************************************************************* |