Fuse ESB : l’installation

Apache ServiceMix sert de conteneur pour l’ESB Fuse. Cet ESB se base sur JBI, Camel et ActiveMQ notamment. Voici quelques billes pour l’installer simplement avec ses composants de base.

Tout d’abord, il faudra le télécharger. Cette installation est pour Linux, mais c’est assez similaire pour Windows. Je préconise de le dé-tar-géziper dans /opt puis de créer un lien symbolique de /opt/apache-servicemix-4.3.0-fuse-03-00 sur /opt/apache-servicemix. Par défaut, la version 4.3.0-fuses-03-00 n’a pas tout d’installer.

Allons dans /opt/apache-servicemix/etc :

Modification de users.properties :

smx=smx,admin  
karaf=karaf, admin  
fuseesb=fuseesb, admin

Puis org.ops4j.pax.web.cfg :

org.apache.felix.karaf.features.configKey =  org.ops4j.pax.web  
org.osgi.service.http.port =  8080  
felix.fileinstall.filename =  org.ops4j.pax.web.cfg

Puis org.apache.karaf.features.cfg :

#  
# Comma separated list of features to install at startup  
#  
featuresBoot=config,activemq-broker,camel,jbi-cluster,war,servicemix-cxf-bc,servicemix-file,servicemix-ftp,servicemix-http,servicemix-jms,servicemix-mail,servicemix-bean,servicemix-camel,servicemix-cxf-se,servicemix-drools,servicemix-eip,servicemix-osworkflow,servicemix-quartz,servicemix-scripting,servicemix-validation,servicemix-saxon,servicemix-wsn2005,war,webconsole,cxf,cxf-jaxrs,cxf-osgi,camel-jms,camel-cxf

Puis system.properties :

#  
# Default port for the OSGI HTTP Service  
#  
org.osgi.service.http.port=8080

Enfin, vous pouvez le lancer avec /opt/apache-servicemix/bin/karaf et fous aurez accès à la WebConsole avec cette url : http://localhost:8080/system/console/bundles

Premières commandes Karaf

Une fois dans la console Karaf, voici les commandes essentielles :

# Lister les bundles installés
karaf@root> list

# Installer une feature
karaf@root> features:install camel-http

# Voir les logs en temps réel
karaf@root> log:tail

# Vérifier les ports HTTP
karaf@root> http:list

Points d’attention

Problème	Solution
Port déjà utilisé	Modifier `org.osgi.service.http.port` dans `system.properties`
Feature introuvable	Vérifier le nom exact avec `features:list \| grep camel`
Bundle en `Failure`	Voir la cause avec `dev:stacktrace` ou dans les logs

Alternative moderne : Camel Karaf

Si vous utilisez encore Karaf aujourd’hui, la stack recommandée est :

features:addurl mvn:org.apache.camel.karaf/apache-camel/LATEST/xml/features
features:install camel-core camel-http camel-jms

Au lieu de charger toutes les features dans featuresBoot, il est préférable de n’installer que celles nécessaires au démarrage et d’ajouter les autres à la demande via la console.