Anvisning Tjänsteplattformen Driftsättning av Virtualiseringsplattformen Revisionshistorik Version Beskrivning Ändrad av PA1 Upprättande av dokumentet Jan Västernäs A Första versionen Jan Västernäs PB1 Uppdaterad för version 1.1 Mats Ekhammar B Godkänd för acceptanstest hos SVR Johan Eltes C Uppdaterad för version 1.1.1 Björn Beskow Innehållsförteckning 1Inledning...2 2Installation...2 2.1Förutsättningar...2 2.2Installation av Mule ESB...2 2.3Konfigurering...2 3Verifiering...4 3.1Förutsättningar...4 3.2Verifiera med ping tjänst...4 3.3Verifiera med referensapplikation...4 Sidan 1(5)
1 Inledning Virtualiseringsplattformen driftsätts på Mule, som är en Enterprise Service Bus. Anvsiningen är uppdelad i avsnitten Installation och Verifiering. 2 Installation 2.1 Förutsättningar Java SE 5.0 eller senare är installerat. Se http://java.sun.com för ned laddning- och installations- instruktioner. Dock har teknisk verifiering av leverantören enbart skett mot Java 1.5.0_19. Mule version 2.2.1 är installerad. Se http://www.mulesource.org för nedladdning och http://www.mulesource.org/display/mule2intro/installing+mule för installationsanvisningar. Note: Use forward slashes when specifying the MULE_HOME environment variable, e.g. set MULE_HOME=C:/Mule/mule-standalone-2.2. Zip fil med virtualiseringsplattforms distributionen är upp packad på filsystemet. 2.2 Installation av Mule ESB Den uppackade distributionens placering anges nedan som $DIST och Mules installations katalog benämns $MULE_HOME. Certifikaten som anges nedan är de testcertifikat som används under verifieringen. Dessa skall bytas ut mot riktiga certifikat vid en produktionssättning. 1. Byt ut filen $MULE_HOME/lib/mule/mule-transport-cxf-2.2.1.jar mot $DIST/lib/muletransport-cxf-2.2.1-CALLISTA.jar: a) Radera eller byt namn på filen mule-transport-cxf-2.2.1.jar i $MULE_HOME/lib/mule/ till t.ex. mule-transport-cxf-2.2.1.jar.orig. b) Kopiera filen $DIST/lib/mule-transport-cxf-2.2.1-CALLISTA.jar till $MULE_HOME/lib/mule/. 2. Byt ut filen $MULE_HOME/lib/mule/mule-transport-http-2.2.1.jar mot $DIST/lib/muletransport-http-2.2.1-CALLISTA.jar: a) Radera eller byt namn på filen mule-transport-http-2.2.1.jar i $MULE_HOME/lib/mule/ till t.ex. mule-transport-http-2.2.1.jar.orig. b) Kopiera filen $DIST/lib/mule-transport-http-2.2.1-CALLISTA.jar till $MULE_HOME/lib/mule/. 3. Skapa en katalog som heter certs under $MULE_HOME. 4. Lägg filerna tp.jks och truststore.jks ($DIST/certs) i katalogen $MULE_HOME/certs. 5. Lägg filerna tp-virtualisering-1.1.1.jar, tp-util-1.1.1jar och tp-schemas-1.1.1.jar ($DIST/lib) i Sidan 2(5)
katalogen $MULE_HOME/lib/user. 2.3 Konfigurering Konfiguration för virtualiseringsplattformen finns i property fil. 1. Lägg filen $DIST/config/tp-virtualisering-override.props i katalogen $MULE_HOME/lib/user. Nedan korta förklaringar till properties i denna fil: tp.sokvagvalsinfo.url: URL där Tjänstekatalogens web service (SokVagvalsInfo) kan nås. tp.tls.store.password: Lösenord till certifikats filerna tp.tls.store.location: Katalog där certifikats filerna finns. tp.host: Servernamnet för den instans där Virtualiseringsplattformen driftas. tp.port: Port numret där de virtuella tjänsterna nås. tp.baseuri: Bas URL som anger var de virtuella tjänsterna nås. tp.ping.port: Port numret där ping tjänsten nås. tp.ping.uri: URL som anger var ping tjänsten nås. tp.ping.response: Svar man vill få från ping tjänsten. tp.dashboard.port: Port numret där dashboarden nås. tp.dashboard.uri: URL som anger var dashboarden nås. tp.senderidpropertyname: Anger den OID i certifikat subjektet som anger avsändarens id. Loggnings konfiguration för virtualiseringsplattformen återfinns som log4j properties. 2. Lägg $DIST/config/log4j.properties i katalogen $MULE_HOME/conf. Sidan 3(5)
3 Verifiering 3.1 Förutsättningar Tjänstekatalogen är installerad, konfigurerad och startad enligt separat anvisning (Anvisning Tjänsteplattformen Driftsättning av Tjänstekatalogen). Verifieringen med referensapplikation skall göras med Java 1.5.0. I Java 1.6.0_10 finns det en bugg med CXF version 2.1.2 som virtualiseringsplattformen använder. 3.2 Verifiera med ping tjänst URL:en till ping tjänsten samt svaret från denna konfigurerades i kapitlet Konfigurering ovan. 1. Starta ett kommandofönster i katalogen $MULE_HOME/bin. 2. Starta virtualiseringsplattformen: mule -config tp-virtualisering-prod.xml. 3. Öppna följande länk i en webläsare: http://localhost:20000/monitor/ping 4. Verifiera att ping tjänsten svarar med konfigurerat svar. Default är TP is alive! När detta är klart har du verifierat att Mule är korrekt installerat. att Virtualiseringsplattformen är startad och kan svara på anrop. 3.3 Verifiera med referensapplikation Verifieringen antas ske på samma server som virtualiseringsplattformen är installerad. 1. Säkerställ att virtualiseringsplattformen ej är startad. 2. Flytta $DIST/lib/tp-journalinfo-apoteket-virtualisering-1.1.1.jar till katalogen $MULE_HOME/lib/user. 3. Ändra i filen $MULE_HOME/lib/user/tp-virtualisering-override.props och sätt propertyn tp.senderidpropertyname=ou (se stycke 3.3.1 nedan). 4. Starta ett kommandofönster i katalogen $MULE_HOME/bin. 5. Starta virtualiseringsplattformen: mule -config tp-virtualisering-prod.xml. 6. Starta ett kommadofönster i katalogen $DIST/verify 7. Starta producenten med kommandot: producer.bat Avvakta meddelandet producer ready 8. Starta ett kommadofönster i katalogen $DIST/verify 9. Kör att anrop med konsumenten med kommandot: consumer.bat Sidan 4(5)
localhost:23000/virtuell (host:port/baseuri är de värden som angavs under konfigureringen i kapitlet Konfigurering ovan) 10. Verifiera att du får ett svar: Virtualiseringsplattformen OK När detta är klart har du verifierat att Mule är korrekt installerat att Virtualiseringplattformen är korrekt installerad att Virtualiseringplattformen hittar sina testcertifikat att Virtualiseringplattformen hittar Tjänstekatalogen att det går att driftsätta en virtuell tjänt i Virtualiseringsplattformen att det går att anropa en virtuell tjänst i Virtualiseringsplattformen När denna verifiering är klar kan man ta bort tp-journalinfo-apoteket-virtualisering-1.1.1.jar från MULE_HOME/lib/user. 3.3.1 Certifikat Medskickade testcertifikat bygger på localhost, dvs anropande tjänstekonsumenter får svar från localhost. Används mjuka certifikat för konsumenten, så hämtas hsaid från egenskapen OU i certifikatets subject, medan hårda certifikat (SITHS-kort) använder egenskapen serialnumber. Virtualiseringsplattformen konfigureras för detta genom propertyn tp.senderidpropertyname i filen $MULE_HOME/lib/user/tp-virtualisering-override.props. Sidan 5(5)