Innehållsförteckning
maxLevel 3

Introduktion

Anslutningstjänster driftsätts på Anslutningsplattformen. 

För närvarande pågår en migrering från en Mule 2 plattform till Mule 3 plattform. Den här anvisningen är därför uppdelad i två delar innehållande installation och verifiering för Mule 2 respektive Mule 3.

Information om vilka tjänster som finns utvecklade för Anpassningsplattformen listas nedan, Mule 2 respektive Mule3.

Installation, konfiguration och verifiering av Anpassningsplattformen för Mule 3 (AnP)

Under uppbyggnad!

Mule ESB installation och konfiguration

För installation samt konfiguration av Mule ESB se Installationsmanual Mule

Anpassninsgtjänster i AnP

Releaseprocess

Här finns information om de olika stegen i releaseprocessen för nya och uppdaterade tjänster.

Genomför en en release med MMC

Se Mule Management Console

Genomför en en release manuellt när inte MMC finns tillgängligt

...

Ladda ner den paketerade Mule applikationen för den anpassninsgstjänst som skall installeras. Alla anpassningstjänster finns tillgängliga från det centrala Maven repot för SKLTP projekt med gruppid se.skltp, Anpassningstjänster. Nedan ett exempel för DominoHttp10Adapter.

wget http://central.maven.org/maven2/se/skltp/adapterservices/ehr/accesscontrol/DominoHttp10Adapter/2.0.0-RC1/DominoHttp10Adapter-2.0.0-RC1.zip

...

Ta bort tidigare version av samma applikation om det finns en sådan, tex DominoHttp10Adapter-1.2.0 som i exemplet nedan.

rm /usr/local/mule-standalone-3.3.1/apps/DominoHttp10Adapter-1.2.0-anchor.txt

...

Kopiera applikationen /usr/local/mule-standalone-3.3.1/apps

cp DominoHttp10Adapter-2.0.0-RC1.zip /usr/local/mule-standalone-3.3.1/apps/

...

Verifiera i samtliga loggar att releasen gick bra. OBS! Viktigt att alla loggar kontrolleras, bland annat Mule och den nya/uppdaterade appens log, tex DominoHttp10Adapter

tail -f /usr/local/mule-standalone-3.3.1/mule.log
tail -f /usr/local/mule-standalone-3.3.1/mule-app-DominoHttp10Adapter.log

**********************************************************************
*            - - + APPLICATION + - -            * - - + STATUS + - - *
**********************************************************************
* ExampleAdapter-Y.Y.Y-RC1           			* DEPLOYED           *
* DominoHttp10Adapter-2.0.0-RC1           		* DEPLOYED           *
* ExampleAdapter-Y.Y.Y-RC1 			           	* DEPLOYED           *
**********************************************************************

...

Vid problem tas releasen bort genom att ta bort anchor-filen för motsvarande applikation och den gamla releasen deployas om. Exempel för tjänsten DominoHttp10Adapter.

rm /usr/local/mule-standalone-3.3.1/apps/DominoHttp10Adapter-2.0.0-RC1-anchor.txt
 
cp DominoHttp10Adapter-1.2.0.zip /usr/local/mule-standalone-3.3.1/apps/

Anpassningstjänster för Mule 3

...

Installation, konfiguration och verifiering av Anpassningsplattformen för Mule 2 (AnP)

Struktur

Anslutningsplattformens katalogstruktur skall skapas enligt följande:

home

• bin
• filetransfer
• anslutningsplattform
• jdk1.6.0_37
• mule-standalone-2.2.8
• conf
• certs
• services
• apache-activemq-5.6.0

bin: Start, stop script
filetransfer: yta att ladda upp filer vid tex releaser av nya versioner
anslutningsplattform: roten i applikationen tjänstebryggan
jdk1.6.0_37: Java installationen som tjänstebryggan kör på
mule-standalone-2.2.8: Mule installationen som tjänstebryggan kör på
conf: Tjänstebryggans konfiguration, och Mule
cert: Katalog där certifikat skall installeras services: Tjänster deployade i anslutningsplattformen
apache-activemq-5.6.0: ActiveMQ installation 

Förutsättningar

• Java 1.6 eller senare är installerat. Se http://www.oracle.com/technetwork/java/javase/index-137561.html för nedladdning- och installationsanvisningar. Teknisk verifiering har dock endast gjorts med Java SE 6 Update 37.

• Mule ESB 2.2.8 är installerad. Den här versionen är ej nedladdningsbar från Mulesoft men kan byggas från källkod med hjälp av Maven. Källkoden för version 2.2.8 finns tillgänglig på http://svn.codehaus.org/mule/tags/mule-2.2.8/

• Anslutningsplattformens distributionsfil är nedladdad och uppackad på filsystemet. Distributionen finns att ladda ner på följande adress: TBD
• Ladda ner AMQ-jar från följande länk och tillför den på MULE-HOME/lib/user

Konfigurera driftsmiljö

Innan själva installationen av anslutningsplattformen kan påbörjas, behöver man konfigurera miljön som skall köra plattformen. Filen ${<user home>}/TJANSTEBRYGGAN_ENVIRONMENT innehåller de miljövariabler som behöver vara på plats för att kunna installera och starta anslutningsplattformen. Se till att miljövariablerna läses in, tex genom att sätta dem i .bashrc.

...

Installation av Anslutningsplattformen

Det här avsnittet beskriver hur man installerar Anslutningsplattformen på en befintlig Mule ESB 2.2.8 installation.

Kopiera bibliotek

Anslutningsplattformen utgörs av en mängd bibliotek (jar-filer) som Mule ESB måste läsa in för att kunna start upp tjänsten. Detta avsnittet visar hur man kopierar in dessa biliotek till rätt ställe.

• Börja med att radera de exempelapplikationer som följer med Mule ESB. Det här görs genom att exekvera följande kommando:

rm –rf  ${MULE_HOME}/lib/user/*

• Installera nu Anslutningsplattformens bibliotek genom att kopiera dem till Mule ESBs bibliotektskatalog. Exekvera följande kommando:

cp –rf ${DIST}/lib/*.jar ${MULE_HOME}/lib/user/

Konfigurera Mule ESB för uppstart

Innan Mule kan skapas krävs det att man gör viss konfiguration. Bland annat för att Mule ESB ska veta var Anslutningsplattformens konfiguration finns. Men även JMX och loggning behöver vara på plats.

• Konfigurera Anslutningsplattformen, ${MULE_HOME}/conf/tb-config.properties, ${MULE_HOME}/conf/tb-security.properties
• Konfigurera Mule, ${MULE_HOME}/conf/wrapper.conf

...

För att Mule ESB skall kunna starta upp korrekt med JMX-stöd behöver rättigheter ändras på jmx.password filen. Ändra rättigheter genom:

chmod 400 ${MULE_HOME}/conf/jmx.password

Nu är Mule ESB konfigurerad för uppstart. Anslutningsplattformens bibliotek finns på plats samt förinställd konfiguration. Det ska nu gå att starta Mule ESB.

Starta Mule genom att exekvera följande kommando:

sh ${MULE_HOME}/bin/mule –config tb-config.xml && tail –f ${MULE_HOME}/logs/anslutningsplattform.log

När Mule ESB är startad så visas: Mule Started!!!

Konfigurera Anslutningsplattformen

För att Anslutningsplattformen skall operera optimalt krävs en del konfiguration. För fullständig referens över de systemparametrar. Se

• systemparametrar

Verifiering

Det här avsnittet förutsätter att man har gjort all nödvändig konfiguration för den miljön där Anslutningsplattformen har installerats.

För att förenkla uppstart och nedstängning av anslutningsplattformen medkommer script för dessa aktioner. Dessa finns tillgängligs i${DIST}/bin.

cp ${DIST}/bin/*.sh vp/bin

När scripten är på plats med rätt sökvägar är det dags att starta upp Mule ESB och Anslutningsplattformen. Det här görs genom att använda de nyss modifierade start-scriptet start.sh.

sh start.sh && tail –f ${MULE_HOME}/logs/anslutningsplattform.log

Mule ESB kommer nu starta upp och när den är klar ska man ha följande output i loggen:

...

Innehållsförteckning
maxLevel 3

Introduktion

Anslutningstjänster driftsätts på Anslutningsplattformen. 

För närvarande pågår en migrering från en Mule 2 plattform till Mule 3 plattform. Den här anvisningen är därför uppdelad i två delar innehållande installation och verifiering för Mule 2 respektive Mule 3.

Information om vilka tjänster som finns utvecklade för Anpassningsplattformen listas nedan, Mule 2 respektive Mule3.

...

Installation, konfiguration och verifiering av Anpassningsplattformen för Mule 3 (AnP)

Under uppbyggnad!

Mule ESB installation och konfiguration

För installation samt konfiguration av Mule ESB se Installationsmanual Mule

Anpassninsgtjänster i AnP

Releaseprocess

Här finns information om de olika stegen i releaseprocessen för nya och uppdaterade tjänster.

Genomför en en release med MMC

Se Mule Management Console

Genomför en en release manuellt när inte MMC finns tillgängligt

1. Ladda ner den paketerade Mule applikationen för den anpassninsgstjänst som skall installeras. Alla anpassningstjänster finns tillgängliga från det centrala Maven repot för SKLTP projekt med gruppid se.skltp, Anpassningstjänster. Nedan ett exempel för DominoHttp10Adapter.

   Kodblock
   wget http://central.maven.org/maven2/se/skltp/adapterservices/ehr/accesscontrol/DominoHttp10Adapter/2.0.0-RC1/DominoHttp10Adapter-2.0.0-RC1.zip

2. Ta bort tidigare version av samma applikation om det finns en sådan, tex DominoHttp10Adapter-1.2.0 som i exemplet nedan.

   Kodblock
   rm /usr/local/mule-standalone-3.3.1/apps/DominoHttp10Adapter-1.2.0-anchor.txt

3. Om det är några konfigurationsförändringar eller om tjänsten är helt ny (se information för respektive tjänst), uppdatera alternativt lägg till properties-filen i /usr/local/mule-standalone-3.3.1/conf/<tjänst>-config-override.properties. För tex tjänsten DominoHttp10Adapter är det  /usr/local/mule-standalone-3.3.1/conf/DominoHttp10Adapter-config-override.properties.
   
   

4. Kopiera applikationen /usr/local/mule-standalone-3.3.1/apps

   Kodblock
   cp DominoHttp10Adapter-2.0.0-RC1.zip /usr/local/mule-standalone-3.3.1/apps/

5. Verifiera i samtliga loggar att releasen gick bra. OBS! Viktigt att alla loggar kontrolleras, bland annat Mule och den nya/uppdaterade appens log, tex DominoHttp10Adapter

   Kodblock
   tail -f /usr/local/mule-standalone-3.3.1/mule.log tail -f /usr/local/mule-standalone-3.3.1/mule-app-DominoHttp10Adapter.log

   Kodblock
   title Exempel på lyckad deploy i mule.log
   ********************************************************************** * - - + APPLICATION + - - * - - + STATUS + - - * ********************************************************************** * ExampleAdapter-Y.Y.Y-RC1 * DEPLOYED * * DominoHttp10Adapter-2.0.0-RC1 * DEPLOYED * * ExampleAdapter-Y.Y.Y-RC1 * DEPLOYED * **********************************************************************

...

Denna verifiering visar nu att anslutningsplattformen är installerad och startad.

...

2. Vid problem tas releasen bort genom att ta bort anchor-filen för motsvarande applikation och den gamla releasen deployas om. Exempel för tjänsten DominoHttp10Adapter.

   Kodblock
   rm /usr/local/mule-standalone-3.3.1/apps/DominoHttp10Adapter-2.0.0-RC1-anchor.txt   cp DominoHttp10Adapter-1.2.0.zip /usr/local/mule-standalone-3.3.1/apps/

Anpassningstjänster för Mule 3