Вы находитесь на странице: 1из 24

Fuse ESB

Installation Guide
Version 4.4.1
Sept. 2011
The experts in open source integration and messaging
Installation Guide
Version 4.4.1
Updated: 30 Nov 2011
Copyright 2011 FuseSource Corporation, a Progress Software company. All rights reserved.
Legal Notices
These materials and all Progress

software products are copyrighted and all rights are reserved by Progress Software Corporation.
The information in these materials is subject to change without notice, and Progress Software Corporation assumes no responsibility
for any errors that may appear therein. The references in these materials to specific platforms supported are subject to change.
Actional, Apama, Apama (and Design), Artix, Business Empowerment, DataDirect (and design), DataDirect Connect, DataDirect
Connect64, DataDirect Technologies, DataDirect XML Converters, DataDirect XQuery, DataXtend, Dynamic Routing Architecture,
EdgeXtend, Empowerment Center, Fathom, FUSE Mediation Router, FUSE Message Broker, FUSE Services Framework,
IntelliStream, IONA, Making Software Work Together, Mindreef, ObjectStore, OpenEdge, Orbix, PeerDirect, POSSENET, Powered
by Progress, PowerTier, Progress, Progress DataXtend, Progress Dynamics, Progress Business Empowerment, Progress
Empowerment Center, Progress Empowerment Program, Progress OpenEdge, Progress Profiles, Progress Results, Progress
Software Developers Network, Progress Sonic, ProVision, PS Select, Savvion, SequeLink, Shadow, SOAPscope, SOAPStation,
Sonic, Sonic ESB, SonicMQ, Sonic Orchestration Server, SonicSynergy, SpeedScript, Stylus Studio, Technical Empowerment,
WebSpeed, Xcalia (and design), and Your Software, Our TechnologyExperience the Connection are registered trademarks of
Progress Software Corporation or one of its affiliates or subsidiaries in the U.S. and/or other countries. AccelEvent, Apama
Dashboard Studio, Apama Event Manager, Apama Event Modeler, Apama Event Store, Apama Risk Firewall, AppsAlive, AppServer,
ASPen, ASP-in-a-Box, BusinessEdge, Business Making Progress, Cache-Forward, DataDirect Spy, DataDirect SupportLink, FUSE,
FuseSource, Future Proof, GVAC, High Performance Integration, ObjectStore Inspector, ObjectStore Performance Expert, OpenAccess,
Orbacus, Pantero, POSSE, ProDataSet, Progress Control Tower, Progress ESP Event Manager, Progress ESP Event Modeler,
Progress Event Engine, Progress RFID, Progress RPM, Progress Software Business Making Progress, PSE Pro, SectorAlliance,
SeeThinkAct, Shadow z/Services, Shadow z/Direct, Shadow z/Events, Shadow z/Presentation, Shadow Studio, SmartBrowser,
SmartComponent, SmartDataBrowser, SmartDataObjects, SmartDataView, SmartDialog, SmartFolder, SmartFrame, SmartObjects,
SmartPanel, SmartQuery, SmartViewer, SmartWindow, Sonic Business Integration Suite, Sonic Process Manager, Sonic Collaboration
Server, Sonic Continuous Availability Architecture, Sonic Database Service, Sonic Workbench, Sonic XML Server, The Brains
Behind BAM, WebClient, and Who Makes Progress are trademarks or service marks of Progress Software Corporation and/or its
subsidiaries or affiliates in the U.S. and other countries. Java and all Java-based marks are trademarks or registered trademarks
of Sun Microsystems, Inc. in the U.S. and other countries. Any other trademarks contained herein are the property of their
respective owners.
Third Party Acknowledgments
Fuse ESB v4.3.1 incorporates ASM v3.1 from INRIA, France Telecom. Such technology is subject to the following terms and
conditions: ASM: a very small and fast Java bytecode manipulation framework Copyright (c) 2000-2005 INRIA, France Telecom
All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that
the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions
and the following disclaimer. 2. 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. 3. Neither the name of
the copyright holders 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.
Fuse ESB v4.3.1 incorporates HSQL Database Engine v1.7.3.3 from Hypersonic SQL Group. Such technology is subject to the
following terms and conditions: Hypersonic SQL License Copyright Copyright (c) 1995-2000 by the Hypersonic SQL Group. 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. All advertising materials mentioning
features or use of this software must display the following acknowledgment: "This product includes Hypersonic SQL." Products
derived from this software may not be called "Hypersonic SQL" nor may "Hypersonic SQL" appear in their names without prior
written permission of the Hypersonic SQL Group. Redistributions of any form whatsoever must retain the following acknowledgment:
"This product includes Hypersonic SQL." This software is provided "as is" and any expressed 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
Hypersonic SQL Group or its 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 any 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. This software consists of
voluntary contributions made by many individuals on behalf of the Hypersonic SQL Group.
Fuse ESB v4.3.1 incorporates JBoss.org Javassist v3.9.0.GA, The contents of these files are subject to the Mozilla Public
License Version 1.1 (the "License") provided below; you may not use this file except in compliance with the License. You may
also obtain a copy of the License at http://www.mozilla.org/MPL/. Software distributed under the License is distributed on an
"AS IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License for the specific language governing
rights and limitations under the License. For Javassist v3.9.0.GA, The Original Code is Javassist. The Initial Developer of the
Original Code is Shigeru Chiba. Portions created by the Initial Developer are Copyright (C) 1999-2008 Shigeru Chiba. All Rights
Reserved.
Fuse ESB v4.3.1 incorporates ANTLR, Another Tool for Language Recognition v2.7.7 from Terrence Parr. Such technology is
subject to the following terms and conditions: SOFTWARE RIGHTS ANTLR 1989-2006 Developed by Terence Parr Partially
supported by University of San Francisco & jGuru.com. We reserve no legal rights to the ANTLR--it is fully in the public domain.
An individual or company may do whatever they wish with source code distributed with ANTLR or the code generated by ANTLR,
including the incorporation of ANTLR, or its output, into commercial software. We encourage users to develop software with
ANTLR. However, we do ask that credit is given to us for developing ANTLR. By "credit", we mean that if you use ANTLR or
incorporate any source code into one of your programs (commercial product, research project, or otherwise) that you acknowledge
this fact somewhere in the documentation, research report, etc... If you like ANTLR and have developed a nice tool with the
output, please mention that you developed it using ANTLR. In addition, we ask that the headers remain intact in our source code.
As long as these guidelines are kept, we expect to continue enhancing this system and expect to make other tools available as
they are completed. The primary ANTLR guy: Terence Parr <parrt@cs.usfca.edu> <parrt@antlr.org>.
Table of Contents
1. Installation Prerequisites ....................................................................................................... 9
Supported Platforms ....................................................................................................... 10
Java and Compiler Requirements ....................................................................................... 11
Other Suggested Prerequisites ........................................................................................... 12
Disk Space Requirements ................................................................................................ 13
2. Installing Fuse ESB ............................................................................................................ 15
3. Installing from Source Code ................................................................................................. 17
Source Installation Requirements ....................................................................................... 18
Unpacking the Distribution ............................................................................................... 20
Building the Source ........................................................................................................ 21
Distribution Files Built ..................................................................................................... 22
4. Uninstalling Fuse ESB ........................................................................................................ 23
5 Fuse ESB Installation Guide Version 4.4.1
List of Tables
1.1. Disk Space Requirements ................................................................................................... 13
2.1. Installer Files ................................................................................................................... 15
Fuse ESB Installation Guide Version 4.4.1 6
List of Examples
1.1. Windows Environment Script ............................................................................................... 12
1.2. UNIX and Linux Environment Script ...................................................................................... 12
3.1. Windows Environment Script ............................................................................................... 19
3.2. UNIX and Linux Environment Script ...................................................................................... 19
7 Fuse ESB Installation Guide Version 4.4.1
Fuse ESB Installation Guide Version 4.4.1 8
Chapter 1. Installation Prerequisites
Before attempting to install and use Fuse ESB, make sure your system meets the minimum requirements.
Supported Platforms ............................................................................................................... 10
Java and Compiler Requirements ............................................................................................... 11
Other Suggested Prerequisites ................................................................................................... 12
Disk Space Requirements ........................................................................................................ 13
9 Fuse ESB Installation Guide Version 4.4.1
Supported Platforms
Progress tests and supports ESB products on the platforms listed at http://
fusesource.com/downloads/platforms-supported/.
Support for additional operating systems and versions is considered on a
case-by-case basis.
Fuse ESB Installation Guide Version 4.4.1 10
Chapter 1. Installation Prerequisites
Java and Compiler Requirements
Java Runtime To run applications developed with Fuse ESB, we require Java 6
1
, JRE
1.6.0_18 or later.
Important
Java 5 is not supported.
Java Development To develop applications for Fuse ESB, we require Java 6, JDK 1.6.0_18 or
later.
Important
Java 5 is not supported.
Note
Only JREs and JDKs distributed or OEMed from Oracle Microsystems
are supported. (That is, Fuse ESB is not guaranteed to run with gcj.)
On Red Hat-derived Linux systems, gcj is the default Java
distribution. In these cases, you must download and install a Oracle
JRE/JDK and set the JAVA_HOME environment variable. You can also
integrate the Oracle JRE/JDK into the alternatives(1) system.
See the alternatives(1) man page for details.
1
http://www.oracle.com/technetwork/java/javase/downloads/index.html
11 Fuse ESB Installation Guide Version 4.4.1
Java and Compiler Requirements
Other Suggested Prerequisites
These programs are not required to work with Fuse Message Broker. However,
they are useful for a variety of build tasks.
Apache Maven Apache Maven is a popular build management tool. To build the source
distribution of Fuse ESB, you need Apache Maven 3; you can download
Apache Maven from http://maven.apache.org/download.html.
Once you have installed Apache Maven, you must:
1. Set the M2_HOME environment variable to point to the top-level directory
that contains your Maven installation.
2. Add Maven's bin directory to the PATH.
3. Set the MAVEN_OPTS environment variable to -Xmx512M to give the Maven
build more memory in which to run.
Environment Scripts You can create scripts like the one shown here to make all settings for the
required programs. You must adjust the paths in these examples to reflect
your actual installed locations of Ant, Maven, and the JDK.
Example 1.1. Windows Environment Script
set JAVA_HOME=C:\Progra~1\Java\jdk1.6.0_18
set M2_HOME=C:\maven
set PATH=%JAVA_HOME%\bin;%PATH%
set PATH=%M2_HOME%\bin;%PATH%
set MAVEN_OPTS=-Xmx512M
Example 1.2. UNIX and Linux Environment Script
export JAVA_HOME=/usr/lib/jvm/java-1.6.0-oracle
export M2_HOME=/opt/maven
export PATH=$JAVA_HOME/bin:$PATH
export PATH=$M2_HOME/bin:$PATH
export MAVEN_OPTS=-Xmx512M
Fuse ESB Installation Guide Version 4.4.1 12
Chapter 1. Installation Prerequisites
Disk Space Requirements
Table 1.1 on page 13 shows the amount of disk space you will need to install
Fuse ESB.
Table 1.1. Disk Space Requirements
Linux Windows Installation Type
90 MB 89 MB Binary installation
3.6 MB 3 MB Source installation, as installed
329 MB
a
328 MB
a
Source installation, after building
a
plus up to 600 MB placed in the Maven $HOME/.m2 and .maven directories.
13 Fuse ESB Installation Guide Version 4.4.1
Disk Space Requirements
Fuse ESB Installation Guide Version 4.4.1 14
Chapter 2. Installing Fuse ESB
Installer Files Table 2.1 on page 15 lists the available installation files for Fuse ESB.
Table 2.1. Installer Files
Description File
Binary installation package for Windows platforms. apache-servicemix-4.4.1-fuse-00-08.zip
Binary installation package for Linux, OS X, and all UNIX
platforms.
apache-servicemix-4.4.1-fuse-00-08.tar.gz
Source code installation package for all platforms. If you
prefer to build Fuse ESB from source, see "Installing from
Source Code" on page 17.
apache-servicemix-4.4.1-fuse-00-08-src.zip
Unpacking the Distribution The binary distribution is packaged either as a .zip file (Windows) or a
.tar.gz file (*NIX). Using a suitable archive tool, such as Zip or Gunzip,
unpack the distribution 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.
After unpacking the distribution and checking the prerequisites, you are now
ready to use the product. See Product Introduction for more details.
(Optional) Remove the JBI
container
The JBI container is installed as a sub-container of the OSGi container in Fuse
ESB. If you do not intend to use the JBI container, however, you might prefer
to remove it from the OSGi container altogether. To remove the JBI container,
perform the following steps:
1. You need to perform a cold start of the OSGi container. That is, you must
completely wipe the data stored by the current instance of the container.
While the container is shut down, delete the entire EsbInstallDir/data
directory (the data directory might not exist, if you have not yet run the
OSGi container).
15 Fuse ESB Installation Guide Version 4.4.1
2. Edit the etc/org.apache.karaf.features.cfg file to customize the
list of features installed during a cold start. In the featuresBoot setting,
delete all of the entries in the comma-separated list that match the
patterns jbi-* or servicemix-*. For example, after deleting the relevant
entries from the default list, the featuresBoot setting would look as
follows:
#
# Comma separated list of features to install at startup
#
featuresBoot=config,activemq-broker,camel,war
3. The next time you start up the OSGi container, it initializes itself without
the JBI features.
Fuse ESB Installation Guide Version 4.4.1 16
Chapter 2. Installing Fuse ESB
Chapter 3. Installing from Source Code
The Fuse ESB source distribution includes the source code and tools for building a number of the components
included in Fuse ESB. Once built, you can use them to create an installation of Fuse ESB.
Source Installation Requirements ............................................................................................... 18
Unpacking the Distribution ....................................................................................................... 20
Building the Source ................................................................................................................ 21
Distribution Files Built ............................................................................................................. 22
17 Fuse ESB Installation Guide Version 4.4.1
Source Installation Requirements
You must have the following in order to build a Fuse ESB product from its
source distribution:
An active connection to the Internet.
The build system uses the Maven build engine, which connects to one or
more Maven repositories on the Internet to download JAR files that are
determined to be dependencies of the current build.
A Java 6 JDK
Apache Maven 3
Java JDK You need the Java Development Kit (JDK), version 6 Update 18 or later.
You can download the JDK from http://www.oracle.com/technetwork/java/
javase/downloads/index.html.
Once you have installed the JDK you must:
1. Set the JAVA_HOME environment variable to point to the top-level directory
containing your JDK.
2. Add the JDK's bin directory to the PATH.
Tip
On Windows, the Oracle JDK installs by default into C:\Program
Files\Java\jdk1.6.0_version. When specifying this path in your
JAVA_HOME environment variable, you can use Progra~1 instead of
Program Files, as shown in the example scripts below.
Apache Maven Apache Maven is a popular build management tool. ESB source builds require
Apache Maven 3; you can download Apache Maven from http://
maven.apache.org/download.html.
Once you have installed Apache Maven, you must:
Fuse ESB Installation Guide Version 4.4.1 18
Chapter 3. Installing from Source Code
1. Set the M2_HOME environment variable to point to the top-level directory
containing your Maven installation.
2. Add Maven's bin directory to the PATH.
3. Set the MAVEN_OPTS environment variable to -Xmx512M to give the Maven
build more memory in which to run.
Example Scripts You can make all settings for the required programs with a script like the
following examples. Adjust the paths in these examples to reflect your actual
installed locations of Ant, Maven, and the JDK.
Example 3.1. Windows Environment Script
set JAVA_HOME=C:\Progra~1\Java\jdk1.6.0_18
set ANT_HOME=C:\Ant
set M2_HOME=C:\Maven
set PATH=%JAVA_HOME%\bin;%PATH%
set PATH=%ANT_HOME%\bin;%PATH%
set PATH=%M2_HOME%\bin;%PATH%
set MAVEN_OPTS=-Xmx512M
Example 3.2. UNIX and Linux Environment Script
export JAVA_HOME=/usr/lib/jvm/java-1.6.0-oracle
export ANT_HOME=/opt/ant
export M2_HOME=/opt/maven
export PATH=$JAVA_HOME/bin:$PATH
export PATH=$ANT_HOME/bin:$PATH
export PATH=$M2_HOME/bin:$PATH
export MAVEN_OPTS=-Xmx512M
19 Fuse ESB Installation Guide Version 4.4.1
Source Installation Requirements
Unpacking the Distribution
The source distribution is packaged as a .zip file that must be unpacked
before you can build the Fuse ESB installation. Unpack the distribution 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.
Fuse ESB Installation Guide Version 4.4.1 20
Chapter 3. Installing from Source Code
Building the Source
Build the Fuse ESB distribution using the instructions in this section.
Build Commands Follow these steps to build the entire distribution.
1. Change to the src subdirectory of the folder into which you unpacked
the source distribution.
2. Run the following command:
mvn -Pfastinstall
Tip
If you want to run the tests, omit the -Pfastinstall option.
Tip
If you have errors building the source distribution, try removing your
private Maven repository ($HOME/.m2/repository/*), then running
mvn -U install.
21 Fuse ESB Installation Guide Version 4.4.1
Building the Source
Distribution Files Built
When the build runs successfully, Fuse ESB distribution .zip and .tar.gz
files are found in the src/assembly/target folder of the source installation
directory.
To install Fuse ESB from the newly built distribution file, unzip its contents
into the directory of your choice.
Fuse ESB Installation Guide Version 4.4.1 22
Chapter 3. Installing from Source Code
Chapter 4. Uninstalling Fuse ESB
This chapter describes how to uninstall Fuse ESB.
To remove Fuse ESB from a system:
1. Locate the folder into which Fuse ESB was expanded.
2. Delete that folder.
23 Fuse ESB Installation Guide Version 4.4.1
Fuse ESB Installation Guide Version 4.4.1 24

Вам также может понравиться