Friday, August 13, 2010

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

No comments:

Post a Comment

Post a Comment