JBoss Fuse 6.0 Installation And Configuration

Trouble Shooting

Why does the URL http://localhost;8181 not work?

This could be many reasons. One of the most frequent case is the web console not install properly. To correct the issue run the following command on the command line console:

profile-edit --features fabric-webui fabric

JBoss Fuse has a good reference page at: https://access.redhat.com/site/documentation/en-US/JBoss_Fuse/6.0/html/Using_the_Management_Console/files/FMCUGAccess.html

Introduction

JBoss Fuse 6.0 and RedHat A-MQ 6.0 were introduced at March 2013. Now both JBoss Fuse and RedHat A-MQ 6.1 is on the horizon. I am little bit disappointed by the slow pace of the release, as Apache Camel 2.12.1 is already released, but JBoss Fuse 6.0 is still based on 2.10.0. Regardless this sluggishness of the update, I still believe, JBoss Fuse is the best ESB framework available in the market comparing with Mule ESB and Talend ESB.

This blog is an simple introduction of JBoss Fuse. I will focus on basic installation and basic karaf commands on Linux/MacOS. Later on, I will introduce examples on how to develop routes for the enterprise integration purposes.

Installation

The JBoss Fuse installation is very straight forward. First we need to download the binary distribution from http://www.jboss.org/products/fuse. You can choose download link based on your os. For me, I am installing on macbook pro [5.9]. I also downloaded the FuseIDE 6.0. Today, I will only introduction the runtime environment.

Once you download the zip for, you can use the following command to unzip the download file [I download the zip file to $HOME/Downloads]:

jar -vxf jboss-fuse-full-6.0.0.redhat-024.zip
mv jboss-fuse-full-6.0.0.redhat-024 ~/.
cd ~/jboss-fuse-full-6.0.0.redhat-024

The above commands unzip the downloaded zip file and put the installation dir under $HOME/jboss-fuse-full-6.0.0.redhat-024. Let's name this dir as JBOSS_FUSE_HOME. Basically, all the required installation is done. In order to start JBoss Fuse as a service, we need to create a wrapper.

Create Serice Wrapper

To create service wrapper, we can execute the following commands:

cd $JBOSS_FUSE_HOME/bin
chmod 755 *
./fuse

The above command will bring up the karaf cmmand line console. On the console, issue the following commands:

features:install wrapper
wrapper:install -n JBossFuseSerivce -d JBossFuseService -d JBoss-Fuse

Now if you list the bin dir, two new files are created:

JBossFuseSerivce-service 
JBossFuseSerivce-wrapper

You can run the service by executing the following command:

./JBossFuseSerivce-service start|stop|restart  

Where start, stop, and restart means to start, stop, and restart the JBoss Fuse service.

Create Fabric

We would like to use management console to monitor the JBoss Fuse container. In order to do this, we need to create fabric through karaf command line console by issue the following commands:

JBossFuse:karaf@root> fabric:create

Here is the output. Enter gary as user name and gary as password

No user found in etc/users.properties or specified as an option. Please specify one ...
New user name: gary
Password for gary: 
Verify password for gary:
Using specified zookeeper password:gary
JBossFuse:karaf@root> 

profile-edit --features fabric-webui fabric

The last command will ask user name and password. I just use gary/gary as user name and password, respectively.

Now you can login to the management console using the URL: localhost:8181. Note that 8181 is the default port. The default port is defined at etc/jetty.xml file. You can modify the file to change the port you wish to use