Fuse ESB 4.2 quick start guide

Here are some notes of getting started using Fuse ESB 4.2 (aka ServiceMix 4).

For full documentation, click here

install/config

• prerequisites
• required software - JDK 1.5+
• recommended software - Maven 2.1+, Eclipse 3.4+
• see this guide for more details
• download Fuse ESB 4.2 here and follow the installation instructions

basic structure

• /bin - executable files
• /etc - configuration files
• /deploy - used to deploy bundles
• /data - runtime files

basic configuration

• edit the "org.apache.felix.karaf.features.cfg" file to set necessary startup features (camel, activemq, etc)

start server

• cd /[fuse]/bin
• run 'servicemix' (starts server and karaf shell)

start shell against a running server

• ssh -p 8101 karaf@localhost (default password:karaf)

frequently used commands (for a full list click here)

• managing features
• features:list
• features:listUrl
• features:uninstall [name]
• features:install [name]
• managing bundles
• osgi:uninstall [id]
• osgi:install -s file:/bundles/example-1.0.jar
• osgi:install -s mvn:com.company/example/1.0
• osgi:update [id] (refresh from install location)
• osgi:refresh [id] (reinitialize the bundle)
• monitoring
• osgi:list (list all bundles)
• osgi:list | grep test
• osgi:headers (view bundle header info)
• osgi:headers | grep test
• log:display
• log:set [level] [log package] (log:set DEBUG com.foo.bar)
• shutdown (stop servicemix)

other tips

• monitor log file
• tail -f /[fuse]/data/log/karaf.log
• deploy bundles
• osgi:install or move bundle to the [fuse]/deploy directory