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
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
- 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.
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
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 * **********************************************************************
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
DEPRECATED
Nya uppsättningen av Anpassningsplattformen följer driftinstruktioner 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.
# .bashrc
# Source global definitions
if [ -f /etc/bashrc ]; then
. /etc/bashrc
fi
source ~/TJANSTEBRYGGAN_ENVIRONMENT
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
# enable JMX
wrapper.java.additional.<N+1>=-Dcom.sun.management.jmxremote.port=1111
wrapper.java.additional.<N+2>=Dcom.sun.management.jmxremote.password.file=/home/mule/vp/vp-home/tjanstebryggan/config/jmx.password
wrapper.java.additional.<N+3>=-Dcom.sun.management.jmxremote.ssl=false
# add classpath for services
wrapper.java.classpath.<N>=/home/mule/anslutningsplattformen/services/*.jar
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
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:
**********************************************************************
* Mule ESB and Integration Platform *
* Version: 2.2.8 Build: 22648 *
* MuleSoft, Inc. *
* For more information go to http://www.mulesoft.org *
* *
* Server started: 10/14/11 12:15 PM *
* Server ID: vp *
* JDK: 1.6.0_26 (mixed mode) *
* OS encoding: MacRoman, Mule encoding: UTF-8 *
* OS: Mac OS X (10.7.1, x86_64) *
* Host: Marcus-Krantzs-MacBook-Pro.local (192.168.0.109) *
* Agents Running: *
* JMX Agent *
**********************************************************************
Denna verifiering visar nu att anslutningsplattformen är installerad och startad.
Anpassningstjänster för Mule 2