Introduktion
Anslutningstjänster driftsätt på Anslutningsplattformen.
Den här anvisningen är uppdelad i två delar; installation och verifiering.
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
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
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
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.