Ce contenu n'est pas disponible dans la langue sélectionnée.
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 Copier lienLien copié sur presse-papiers!
Abstract
Supported platforms Copier lienLien copié sur presse-papiers!
Java Runtime Copier lienLien copié sur presse-papiers!
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 Copier lienLien copié sur presse-papiers!
Hardware requirements Copier lienLien copié sur presse-papiers!
- Full Installation
- 700 MB of free disk space
- 2 GB of RAM
Chapter 2. Installation Types Copier lienLien copié sur presse-papiers!
2.1. Overview of Installation Types Copier lienLien copié sur presse-papiers!
- 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 Copier lienLien copié sur presse-papiers!
Abstract
Getting the archive Copier lienLien copié sur presse-papiers!
- 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 Copier lienLien copié sur presse-papiers!
.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 Copier lienLien copié sur presse-papiers!
Abstract
4.1. Add a User Copier lienLien copié sur presse-papiers!
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 Copier lienLien copié sur presse-papiers!
Abstract
5.1. Supported Functionality Copier lienLien copié sur presse-papiers!
- 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 Copier lienLien copié sur presse-papiers!
Abstract
6.1. Installation Procedure Copier lienLien copié sur presse-papiers!
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 Copier lienLien copié sur presse-papiers!
7.1. SwitchYard Copier lienLien copié sur presse-papiers!
Figure 7.1. SwitchYard Visual Editor
7.2. Installing SwitchYard on JBoss Fuse Copier lienLien copié sur presse-papiers!
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 Copier lienLien copié sur presse-papiers!
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 Copier lienLien copié sur presse-papiers!
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? Copier lienLien copié sur presse-papiers!
Chapter 8. Integrating JBoss BRMS and JBoss BPM Suite with JBoss Fuse Copier lienLien copié sur presse-papiers!
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 Copier lienLien copié sur presse-papiers!
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 Copier lienLien copié sur presse-papiers!
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 Copier lienLien copié sur presse-papiers!
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 Copier lienLien copié sur presse-papiers!
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 Copier lienLien copié sur presse-papiers!
Abstract
extras directory.
A.1. Zip Archives for the Apache Components Copier lienLien copié sur presse-papiers!
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 Copier lienLien copié sur presse-papiers!
Abstract
settings.xml file, where required artifacts are located.
B.1. Maven Repositories Copier lienLien copié sur presse-papiers!
- 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 Copier lienLien copié sur presse-papiers!
Trademark Disclaimer