Red Hat Training

A Red Hat training course is available for Red Hat Fuse

Installation Guide

Red Hat JBoss Fuse

Installing Red Hat JBoss Fuse on a computer

Red Hat

Version 6.0

Copyright © 2013 Red Hat, Inc. and/or its affiliates.

13 Oct 2017

Abstract

It is easy to install Red Hat JBoss Fuse and tailor the installation to a particular environment.

Chapter 1. Installation Prerequisites

Abstract

Before attempting to install and use Red Hat JBoss Fuse, make sure your system meets the minimum requirements.

Supported platforms

Red Hat tests and supports Fuse products on the platforms listed at Red Hat JBoss Fuse Supported Configurations.

Java Runtime

Fuse runtime platforms need Java 6, JRE 1.6.0_18 or later.
To develop applications for Fuse runtime platforms, you need Java 6, JDK 1.6.0_18 or later.
Note
Fuse products are only guaranteed to run with Java runtimes distributed by, or OEMed from, Red Hat (OpenJDK), Oracle and IBM.
Note
On Red Hat-derived Linux systems, gcj is the default Java distribution. In these cases, you must download and install an Oracle Java runtime and set the JAVA_HOME environment variable. You can also integrate the Oracle Java runtime into the alternatives(1) system. See the alternatives(1) man page for details.
Warning
Do not install the Java runtime under a directory path that includes whitespace. For example, the path, 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.

Hardware requirements

The minimum hardware specifications for installing and starting up Red Hat JBoss Fuse are:
  • Minimum Installation
    • 90 MB free disk space
    • 2 GB RAM
  • Medium Installation
    • 355 MB free disk space
    • 2 GB RAM
  • Full Installation
    • 720 MB free disk space
    • 2 GB RAM
In addition to the disk space required for installing and starting up the base installation the first time, a running system will require space for caching, persistent message stores, and other functions.

Chapter 2. Installation Types

Red Hat JBoss Fuse allows you to choose between installations that contain different feature sets:
  • Minimal—installs Apache Karaf, Apache Camel core, and selected Apache Camel components
  • Medium—installs Apache Karaf, Apache Camel;, and Apache ActiveMQ
  • Full—installs Apache Karaf, Apache Camel, Apache ActiveMQ Apache CXF, and the JBI components

Chapter 3. Installing

Abstract

Red Hat JBoss Fuse is installed by unpacking an archive system on a system. This provides an easy way for a developer to get up and running.

Getting the archive

You can download the Red Hat JBoss Fuse archive from the Customer Portal>Downloads>JBoss Enterprise Middleware>Downloads page. After logging in, go to the sidebar menu under JBoss Enterprise Platforms and select Fuse. Click the Download button next to the product that you want to download.
Note
Trial kits are also available from the developer Web site, at http://jboss.org/products/fuse. These kits are not supported by Red Hat.

Unpacking the archive

Red Hat JBoss Fuse is packaged as a .zip file. Using a suitable archive tool, such as Zip, unpack Red Hat JBoss Fuse into a directory to which you have full access.
Warning
Do not unpack the archive file into a folder that has spaces in its path name. For example, do not unpack into C:\Documents and Settings\Greco Roman\Desktop\fusesrc.

Chapter 4. Adding a Remote Console User

Abstract

The server's remote command console is not configured with a default user. Before you can connect to the server's console remotely, you must add a user to the configuration.
Important
The information in this file is unencrypted so it is not suitable for environments that require strict security.
To add a user:
  1. Open InstallDir/etc/users.properties in your favorite text editor.
  2. Locate the line #admin=admin,admin.
    This line specifies a user admin with the password admin and the role admin.
  3. Remove the leading # to uncomment the line.
  4. Replace the first admin with a name for the user.
  5. Replace admin with the password for the user.
  6. Leave the last admin as is, and save the changes.
  7. To access the container's JMX port and to use the ActiveMQ Web console, you must specify the credentials for them. To do so, open InstallDir/etc/system.properties in your favorite text editor and search for the following lines: 
    #
# Authentication - must match an entry in users.properties with the admin privilege
#
#activemq.jmx.user=admin
#activemq.jmx.password=admin
    Uncomment the activemq.jmx.user=admin and activemq.jmx.password=admin settings (by removing the leading #) and change the username and password values to the same username and password values you just defined in the etc/users.properties file.

Chapter 5. Monitoring Fuse Resources

Abstract

Using Red Hat JBoss Operations Network (JON), you can discover, import, and monitor Red Hat JBoss Fuse.
Important
The Fuse Plugin Pack for JBoss ON 3.1.2 is not installed with the JON base distribution. You must download and install it separately after you have installed the JON base distribution.
To install the Fuse Plugin Pack for JBoss ON 3.1.2:
  1. Navigate to the Red Hat Customer Portal>Downloads>JBoss Enterprise Middleware>Downloads page.
  2. In the sidebar menu, under JBoss Enterprise Platforms, select Fuse.
  3. Click Download next to JON 3.1.2 Plugin Pack for JBoss Fuse 6.0.0 .
  4. Unzip the plugin package (JON-3.1.2-Fuse/jon-plugin-pack-fuse-3.1.2.GA.zip) into the /installDir/server/ directory.
  5. Install the jar files in one of two ways:

Appendix A. Installing the Apache Components

Abstract

Red Hat JBoss Fuse includes standard distribution of Apache Camel and Apache CXF in the installation's extras directory.
If you simply want to use a standard distribution of Apache Camel or Apache CXF without the OSGi container or Fuse Fabric you can use the archived versions in the installation's extras directory.
The following archive files are provided:
Apache Camel
apache-camel-2.10.0.redhat-60024.zip
Apache CXF
apache-cxf-2.6.0.redhat-60024.zip
You can copy the file to the desired location and decompress it using the appropriate utility for your platform.
Warning
Do not unpack the archive file into a folder that has spaces in its path name. For example, do not unpack into C:\Documents and Settings\Greco Roman\Desktop\fusesrc.

Legal Notice

Trademark Disclaimer

The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, MetaMatrix, Fedora, the Infinity Logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Apache, ServiceMix, Camel, CXF, and ActiveMQ are trademarks of Apache Software Foundation. Any other names contained herein may be trademarks of their respective owners.

Legal Notice

Third Party Acknowledgements

One or more products in the Red Hat JBoss Fuse release includes third party components covered by licenses that require that the following documentation notices be provided:
  • JLine (http://jline.sourceforge.net) jline:jline:jar:1.0
    License: BSD (LICENSE.txt) - Copyright (c) 2002-2006, Marc Prud'hommeaux
    All rights reserved.
    Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
    • Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
    • Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
    • Neither the name of JLine nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
    THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  • Stax2 API (http://woodstox.codehaus.org/StAX2) org.codehaus.woodstox:stax2-api:jar:3.1.1
    License: The BSD License (http://www.opensource.org/licenses/bsd-license.php)
    Copyright (c) <YEAR>, <OWNER> All rights reserved.
    Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
    • Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
    • Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
    THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  • jibx-run - JiBX runtime (http://www.jibx.org/main-reactor/jibx-run) org.jibx:jibx-run:bundle:1.2.3
    License: BSD (http://jibx.sourceforge.net/jibx-license.html) Copyright (c) 2003-2010, Dennis M. Sosnoski.
    All rights reserved.
    Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
    • Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
    • Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
    • Neither the name of JiBX nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
    THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  • JavaAssist (http://www.jboss.org/javassist) org.jboss.javassist:com.springsource.javassist:jar:3.9.0.GA:compile
    License: MPL (http://www.mozilla.org/MPL/MPL-1.1.html)
  • HAPI-OSGI-Base Module (http://hl7api.sourceforge.net/hapi-osgi-base/) ca.uhn.hapi:hapi-osgi-base:bundle:1.2
    License: Mozilla Public License 1.1 (http://www.mozilla.org/MPL/MPL-1.1.txt)