Fuse 6 is no longer supported
As of February 2025, Red Hat Fuse 6 is no longer supported. If you are using Fuse 6, please upgrade to Red Hat build of Apache Camel.Installation Guide
Installing Red Hat JBoss Fuse on a computer
Copyright © 2011-2015 Red Hat, Inc. and/or its affiliates.
Abstract
Chapter 1. Installation Prerequisites Copy linkLink copied to clipboard!
Abstract
Supported platforms Copy linkLink copied to clipboard!
Java Runtime Copy linkLink copied to clipboard!
C:\Program Files\Java\jde7 is not an acceptable install path and will lead to unpredictable errors in Red Hat JBoss Fuse at run time.
Supported Standards Copy linkLink copied to clipboard!
Hardware requirements Copy linkLink copied to clipboard!
- Full Installation
- 700 MB of free disk space
- 2 GB of RAM
Chapter 2. Installation Types Copy linkLink copied to clipboard!
2.1. Overview of Installation Types Copy linkLink copied to clipboard!
- Full install—the package that is available for download from the Red Hat Customer Portal installs Apache Karaf, Apache Camel, Apache ActiveMQ, Apache CXF, and the Fuse Management Console (Hawtio).
- Custom assembly—it is possible to create your own custom assembly of JBoss Fuse 6.2, containing a customized subset of the JBoss Fuse features and bundles. You can use this approach to replace the Minimal and the Medium install types, which were available for versions of JBoss Fuse prior to 6.2. To create a custom assembly of JBoss Fuse, proceed as follows:
- Download and install the standard Full Install from the Red Hat Customer Portal, as described in Chapter 3, Installing.
- Go to the
InstallDir/quickstarts/customproject and read the instructions inInstallDir/quickstarts/custom/README.mdfor creating a custom assembly. - After customizing the configuration of the
quickstarts/customproject, build the project by entering the command:mvn clean install
mvn clean installCopy to Clipboard Copied! Toggle word wrap Toggle overflow - The result of building this project is a custom assembly file, in the following location:
InstallDir/quickstarts/custom/target/custom-distro-ProjectVersion-bin.zip
InstallDir/quickstarts/custom/target/custom-distro-ProjectVersion-bin.zipCopy to Clipboard Copied! Toggle word wrap Toggle overflow - You can now install the custom assembly by unzipping the
custom-distro-ProjectVersion-bin.zipfile into a convenient location on the file system.
NoteThequickstarts/customproject is based mainly on the following Maven plug-ins:features-maven-pluginandmaven-assembly-plugin. For more details about thefeatures-maven-pluginplug-in, see section "Generating a Custom Offline Repository" in "Deploying into the Container".
Chapter 3. Installing Copy linkLink copied to clipboard!
Abstract
Getting the archive Copy linkLink copied to clipboard!
- Select Fuse, listed under Integrated Platforms, in the sidebar menu.
- Select
6.2.0from the Version drop-down list on the Software Downloads page. - Click the Download button next to the Red Hat JBoss Fuse 6.2.0 distribution file you want to download.
Unpacking the archive Copy linkLink copied to clipboard!
.zip file. Using a suitable archive tool, such as Zip, unpack Red Hat JBoss Fuse into a directory to which you have full access.
C:\Documents and Settings\Greco Roman\Desktop\fusesrc.
#, %, ^, ".
Chapter 4. Adding a Remote Console User Copy linkLink copied to clipboard!
Abstract
4.1. Add a User Copy linkLink copied to clipboard!
InstallDir/etc/users.properties.
- Open
InstallDir/etc/users.propertiesin your favorite text editor. - Locate the line
#admin=admin,admin,manager,viewer,Operator, Maintainer, Deployer, Auditor, Administrator, SuperUser.This line specifies a useradminwith the passwordadminand comma-separated list of roles. - Uncomment the line by removing the leading
#. - Change the first
adminto the desired user name. - Change the second
adminto the desired password. - Leave the role list,
admin,manager,viewer,Operator, Maintainer, Deployer, Auditor, Administrator, SuperUser, as is. - Save the changes.
Chapter 5. Offline Mode Copy linkLink copied to clipboard!
Abstract
5.1. Supported Functionality Copy linkLink copied to clipboard!
- Runtime dependencies—the dependencies required to run the JBoss Fuse container, in its default configuration.
- Build-time dependencies—the dependencies required to build a custom application (which might include third-party libraries).
- Running the JBoss Fuse container in its default configuration—is supported in offline mode. The default configuration of the JBoss Fuse container is specified by the
featuresBootproperty in theetc/org.apache.karaf.features.cfgfile. The requisite dependencies are all provided in thesystem/sub-directory of the installation. - Installing additional features—is, in general, not supported in offline mode. In principle, you can use the
features:installcommand to install any of the features from the standard feature repositories (as specified by thefeaturesRepositoriesproperty in theetc/org.apache.karaf.features.cfgfile), but the majority of these features must be downloaded from the Internet and are thus not supported in offline mode. - Deploying custom applications—is, in general, not supported in offline mode. There may be some cases where an application with a minimal set of build-time dependencies is deployable offline, but in general, custom applications would have third-party dependencies that require an Internet connection (so that JAR files can be downloaded by Apache Maven).
Chapter 6. Monitoring Fuse Resources Copy linkLink copied to clipboard!
Abstract
6.1. Installation Procedure Copy linkLink copied to clipboard!
Fuse Plugin Pack for JBoss ON 3.3:
- Navigate to the Red Hat Software Downloads page on the Red Hat Customer Portal.
- Select JBoss ON for Fuse under Management in the sidebar menu (or using the drop-down menu for the Products field).
- Make sure
3.3appears in the Version drop-down list on the Software Downloads page. - Click Download next to Fuse Plugin Pack for Red Hat JBoss Operations Network 3.3 .
- Unzip the plugin package (
jon-plugin-pack-fuse-3.3.0.GA.zip) into a temporary directory (for example,/installDir/server/). - Install the jar files in one of two ways:
- Hot DeployCopy the unpacked jar files into the JBoss Operations Network's
/installDir/server/plugins/directory. For details, see the JBoss Operations Network Installation Guide. - JON Server UIFor details, see the JBoss Operations Network Installation Guide, or watch the video Installing JBoss Operations Network - Part 4, Installing JON Agent Plugins.
Chapter 7. Getting Started with SwitchYard on JBoss Fuse Copy linkLink copied to clipboard!
7.1. SwitchYard Copy linkLink copied to clipboard!
Figure 7.1. SwitchYard Visual Editor
7.2. Installing SwitchYard on JBoss Fuse Copy linkLink copied to clipboard!
installDir/system/org/switchyard/karaf/switchyard/2.0.1.redhat-620117/switchyard-2.0.1.redhat-620117-core-features.xml.
Procedure 7.1. Install SwitchYard Manually
- Start JBoss Fuse:
./installDir/bin/fuse
./installDir/bin/fuseCopy to Clipboard Copied! Toggle word wrap Toggle overflow - List the available SwitchYard features by entering the following console command. If this is a fresh instance, they will all be uninstalled at this point.
JBossFuse:karaf@root> features:list | grep switchyard
JBossFuse:karaf@root> features:list | grep switchyardCopy to Clipboard Copied! Toggle word wrap Toggle overflow - Install the core SwitchYard components by entering the following console command:
JBossFuse:karaf@root> features:install switchyard
JBossFuse:karaf@root> features:install switchyardCopy to Clipboard Copied! Toggle word wrap Toggle overflow - List the SwitchYard features again. You will now see that SwitchYard (the switchyard feature) has been installed, along with its dependencies as defined by the SwitchYard features file.
7.3. SwitchYard Quickstart Applications Copy linkLink copied to clipboard!
installDir/quickstarts/switchyard.
- Start JBoss Fuse:
./installDir/bin/fuse
./installDir/bin/fuseCopy to Clipboard Copied! Toggle word wrap Toggle overflow - Install the application by entering the following console command:
JBossFuse:karaf@root> features:install switchyard-quickstart-APP_NAME
JBossFuse:karaf@root> features:install switchyard-quickstart-APP_NAMECopy to Clipboard Copied! Toggle word wrap Toggle overflow
Readme.md file for each.
Readme.md file. SwitchYard features are already defined in installDir/system/org/switchyard/karaf/switchyard/2.0.1.redhat-620117/switchyard-2.0.1.redhat-620117-core-features.xml.
7.4. Installing Your First Quickstart Application Copy linkLink copied to clipboard!
camel-quartz-binding quickstart application. This application makes use of the camel-quartz component which schedules a logging service to run every second.
- Start JBoss Fuse:
./installDir/bin/fuse
./installDir/bin/fuseCopy to Clipboard Copied! Toggle word wrap Toggle overflow - List the available SwitchYard features by entering the following console command. If this is a fresh instance, they will all be uninstalled at this point.
JBossFuse:karaf@root> features:list | grep switchyard
JBossFuse:karaf@root> features:list | grep switchyardCopy to Clipboard Copied! Toggle word wrap Toggle overflow Install thecamel-quartz-bindingapplication by entering the following console command:JBossFuse:karaf@root> features:install switchyard-quickstart-camel-quartz-binding
JBossFuse:karaf@root> features:install switchyard-quickstart-camel-quartz-bindingCopy to Clipboard Copied! Toggle word wrap Toggle overflow - List the SwitchYard features again. You will now see that the camel-quartz-binding application (the switchyard-quickstart-camel-quartz-binding feature) has been installed, along with its dependencies as defined by the SwitchYard features file.
- View the output from the installed (and running) application by entering the following console command:
JBossFuse:karaf@root> log:tail
JBossFuse:karaf@root> log:tailCopy to Clipboard Copied! Toggle word wrap Toggle overflow
installDir/quickstarts/switchyard/camel-quartz-binding/Readme.md.
7.5. What's Next? Copy linkLink copied to clipboard!
Chapter 8. Integrating JBoss BRMS and JBoss BPM Suite with JBoss Fuse Copy linkLink copied to clipboard!
features.xml files: one providing core JBoss BPM Suite and JBoss BRMS features, and the other providing additional support for integration with SwitchYard and Camel.
drools-karaf-features-6.2.0.Final-redhat-6-BZ1232486-features.xml:
- drools-common
- drools-module
- drools-templates
- drools-decisiontable
- drools-jpa
- kie
- kie-ci
- kie-spring
- kie-aries-blueprint
- jbpm-commons
- jbpm-human-task
- jbpm
- droolsjbpm-hibernate
- h2
Integration Pack contains references related to non-supported jars — that you can download from the Red Hat Customer Portal under JBoss BRMS or JBoss BPM Suite.
| Use Case | Feature(s) |
|---|---|
| I need to use Drools engine for rules evaluation. I do not need persistence, processes, nor decision tables. | Install drools-module. |
| I need to use Drools engine for rules evaluation with persistence and transactions. I do not need processes, nor decision tables. | Install drools-jpa (which includes drools-module). You might also want to install the droolsjbpm-hibernate feature, or ensure there is a compatible hibernate bundle installed. |
| I need to use Drools engine with decision tables. | Install drools-decisiontable (which includes drools-module). If you need persistence, install drools-jpa as well. |
| I need to use jBPM engine (or Drools engine with processes). | Install jbpm feature (which includes drools-module and drools-jpa). You might also want to install droolsjbpm-hibernate feature, or ensure there is a compatible hibernate bundle installed. |
| I need to use jBPM engine (or Drools engine with processes) with Human Task. | Install jbpm and jbpm-human-task. |
| I need to use Drools/jBPM with KieScanner (KIE-CI) to be able to download kJARs from a Maven repository. | Install required core engine jars (see row above) and kie-ci. |
| I need to use KIE-Spring integration. | Install kie-spring. |
| I need to use KIE-Aries-Blueprint integration. | Install kie-spring and kie-aries-blueprint. |
org/jboss/integration/fuse/karaf-features/1.0.0.redhat-620137/karaf-features-1.0.0.redhat-620137-features.xml:
- fuse-bxms-switchyard-common-knowledge
- fuse-bxms-switchyard-rules
- fuse-bxms-switchyard-bpm
- kie-camel
- jbpm-workitems-camel
installDir/etc/org.ops4j.pax.url.mvn.cfg.
8.1. Install Core JBoss BRMS and JBoss BPM Suite Features Copy linkLink copied to clipboard!
Procedure 8.1.
- The lastest supported version of these features are provided as a patch —
Integration Pack contains references related to non-supported jars— that you can download from the Red Hat Customer Portal under JBoss BRMS or JBoss BPM Suite. Download and install this patch.- Download the patch and unzip it.
- Navigate to the unzipped
BZ-1232486directory. - Run the following console command:
mvn org.apache.maven.plugins:maven-install-plugin:2.5.2:install-file -Dfile=drools-karaf-features-6.2.0.Final-redhat-6-BZ1232486-features.xml -DgroupId=org.drools -DartifactId=drools-karaf-features -Dversion=6.2.0.Final-redhat-6-BZ1232486 -Dpackaging=xml -Dclassifier=features
$ mvn org.apache.maven.plugins:maven-install-plugin:2.5.2:install-file -Dfile=drools-karaf-features-6.2.0.Final-redhat-6-BZ1232486-features.xml -DgroupId=org.drools -DartifactId=drools-karaf-features -Dversion=6.2.0.Final-redhat-6-BZ1232486 -Dpackaging=xml -Dclassifier=featuresCopy to Clipboard Copied! Toggle word wrap Toggle overflow
- Configure the required repositories.
- Edit the
installDir/etc/org.ops4j.pax.url.mvn.cfgfile in your JBoss Fuse installation and add the following entry to theorg.ops4j.pax.url.mvn.repositoriesvariable, noting that entries are separated by ‘, \’:- http://maven.repository.redhat.com/techpreview/all/@id=bxms-product-repo
- Start JBoss Fuse:
./installDir/bin/fuse
$ ./installDir/bin/fuseCopy to Clipboard Copied! Toggle word wrap Toggle overflow - Add a reference to the core features file by running the following console command:
JBossFuse:karaf@root> features:addurl mvn:org.drools/drools-karaf-features/6.2.0.Final-redhat-6-BZ1232486/xml/features
JBossFuse:karaf@root> features:addurl mvn:org.drools/drools-karaf-features/6.2.0.Final-redhat-6-BZ1232486/xml/featuresCopy to Clipboard Copied! Toggle word wrap Toggle overflow - You can now install the features provided by this file by running, for example, the following console command:
JBossFuse:karaf@root> features:install drools-module
JBossFuse:karaf@root> features:install drools-moduleCopy to Clipboard Copied! Toggle word wrap Toggle overflow
8.2. Install SwitchYard and Camel Integration Features Copy linkLink copied to clipboard!
Procedure 8.2.
- Add a reference to the features file by running the following console command:
JBossFuse:karaf@root> features:addurl mvn:org.jboss.integration.fuse/karaf-features/1.0.0.redhat-620137/xml/features
JBossFuse:karaf@root> features:addurl mvn:org.jboss.integration.fuse/karaf-features/1.0.0.redhat-620137/xml/featuresCopy to Clipboard Copied! Toggle word wrap Toggle overflow - You can now install the features provided for SwitchYard and Camel integration by running, for example, the following console command:
JBossFuse:karaf@root> features:install fuse-bxms-switchyard-rules
JBossFuse:karaf@root> features:install fuse-bxms-switchyard-rulesCopy to Clipboard Copied! Toggle word wrap Toggle overflow
8.3. Install JBoss Fuse Integration Quickstart Applications Copy linkLink copied to clipboard!
org/jboss/integration/fuse/quickstarts/karaf-features/1.0.0.redhat-620137/karaf-features-1.0.0.redhat-620137-features.xml:
- fuse-bxms-switchyard-quickstart-bpm-service
- fuse-bxms-switchyard-quickstart-remote-invoker
- fuse-bxms-switchyard-quickstart-rules-camel-cbr
- fuse-bxms-switchyard-quickstart-rules-interview
- fuse-bxms-switchyard-quickstart-rules-interview-container
- fuse-bxms-switchyard-quickstart-rules-interview-dtable
- fuse-bxms-switchyard-demo-library
- fuse-bxms-switchyard-demo-helpdesk
installDir/etc/org.ops4j.pax.url.mvn.cfg.
Procedure 8.3. Install JBoss Fuse Integration Quickstart Applications
- Add a reference to the features file by running the following console command:
JBossFuse:karaf@root> features:addurl mvn:org.jboss.integration.fuse.quickstarts/karaf-features/1.0.0.redhat-620137/xml/features
JBossFuse:karaf@root> features:addurl mvn:org.jboss.integration.fuse.quickstarts/karaf-features/1.0.0.redhat-620137/xml/featuresCopy to Clipboard Copied! Toggle word wrap Toggle overflow - You can now install the quickstart applications provided by this features file by running, for example, the following console command:
JBossFuse:karaf@root> features:install fuse-bxms-switchyard-quickstart-bpm-service
JBossFuse:karaf@root> features:install fuse-bxms-switchyard-quickstart-bpm-serviceCopy to Clipboard Copied! Toggle word wrap Toggle overflow
Procedure 8.4. Download and Install the Quickstart Application Source Files
- Download the quickstart application ZIP file.
- Unpack the contents of the quickstarts directory into your existing
installDir/quickstartsdirectory. - Unpack the contents of the system directory into your existing
installDir/systemdirectory. You can replace existing files if requested to do so.
8.4. Testing Your First Integration Quickstart Application Copy linkLink copied to clipboard!
Procedure 8.5.
- Start JBoss Fuse:
./installDir/bin/fuse
$ ./installDir/bin/fuseCopy to Clipboard Copied! Toggle word wrap Toggle overflow - Install and start the switchyard-bpm-service by running the following console command. Any dependent features specified by the application’s features file will be installed automatically.
JBossFuse:karaf@root> features:install fuse-bxms-switchyard-quickstart-bpm-service
JBossFuse:karaf@root> features:install fuse-bxms-switchyard-quickstart-bpm-serviceCopy to Clipboard Copied! Toggle word wrap Toggle overflow - Submit a webservice request to invoke the SOAP gateway.
- Open a terminal window and navigate to the associated quickstart directory that was unpacked from the quickstart application ZIP file (in this case, switchyard-bpm-service).
- Run the following command:
mvn clean install
$ mvn clean installCopy to Clipboard Copied! Toggle word wrap Toggle overflow NoteYou will need the following repositories configured in your Mavensettings.xmlfile:- http://maven.repository.redhat.com/techpreview/all/
- http://repository.jboss.org/nexus/content/repositories/public/
- https://repo.fusesource.com/nexus/content/groups/public/
- Run the following command:
mvn exec:java -Pkaraf
$ mvn exec:java -PkarafCopy to Clipboard Copied! Toggle word wrap Toggle overflow
- You will receive the following response:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow NoteIf you have not restarted the server since working through the configuration procedures up to this point, you might receive the following response. If so, restart the server and run the command again.SOAP Reply: <html><body>No service was found.</body></html>
SOAP Reply: <html><body>No service was found.</body></html>Copy to Clipboard Copied! Toggle word wrap Toggle overflow
Appendix A. Installing the Apache Components Copy linkLink copied to clipboard!
Abstract
extras directory.
A.1. Zip Archives for the Apache Components Copy linkLink copied to clipboard!
extras directory.
- apache-camel-2.15.1.redhat-620133.zip
- apache-cxf-3.0.4.redhat-620133.zip
C:\Documents and Settings\Greco Roman\Desktop\fusesrc.
Appendix B. Red Hat JBoss Fuse Maven Repositories Copy linkLink copied to clipboard!
Abstract
settings.xml file, where required artifacts are located.
B.1. Maven Repositories Copy linkLink copied to clipboard!
- JBoss Fuse repositoryProvides access to the artifacts in the Red Hat JBoss Fuse Maven repository. This repository is required.
https://repo.fusesource.com/nexus/content/groups/public/ - JBoss Fuse Snapshots repositoryProvides access to the artifacts in the Red Hat JBoss Fuse snapshot kit. This repository is not required, but it is useful if you want to experiment with building your project using different versions of the supplied archetypes.
https://repo.fusesource.com/nexus/content/groups/public-snapshots/ - Apache Public repositoryProvides access to the artifacts in the Apache Maven repository. This repository is not required, but it is useful to include as Red Hat JBoss Fuse depends on various Apache artifacts.
https://repository.apache.org/content/groups/public/
Legal Notice Copy linkLink copied to clipboard!
Trademark Disclaimer