You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@servicemix.apache.org by ch...@apache.org on 2006/11/05 14:39:58 UTC
svn commit: r471422 [2/5] - in /incubator/servicemix/site/main: ./
5-jbi.data/ importing-servicemix-into-eclipse.data/
Added: incubator/servicemix/site/main/3-installation.html
URL: http://svn.apache.org/viewvc/incubator/servicemix/site/main/3-installation.html?view=auto&rev=471422
==============================================================================
--- incubator/servicemix/site/main/3-installation.html (added)
+++ incubator/servicemix/site/main/3-installation.html Sun Nov 5 05:39:56 2006
@@ -0,0 +1,532 @@
+
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<HTML>
+ <HEAD>
+<!--
+ Pier's plugin always overwrites the stylesheet so lets explicitly use another one
+ <link type="text/css" rel="stylesheet" href="autoexport:///SM/resources/space.css">
+-->
+ <LINK type="text/css" rel="stylesheet" href="resources/site.css">
+ <SCRIPT src="resources/space.js" type="text/javascript"></SCRIPT>
+ <TITLE>
+3. Installation
+ </TITLE>
+ <META http-equiv="Content-Type" content="text/html;charset=UTF-8"></HEAD>
+ <BODY onload="init()">
+
+ <!-- Banner -->
+ <DIV id="site-banner">
+
+ <TABLE border="0" cellpadding="0" cellspacing="0" width="100%">
+ <TR>
+ <TD align="left" class="topbardiv" nowrap="">
+ <IMG border="0" src="http://incubator.apache.org/servicemix/main/images/logo.jpg">
+ </TD>
+ <TD align="right" nowrap="">
+ <IMG border="0" src="http://incubator.apache.org/images/apache-incubator-logo.png">
+ </TD>
+ </TR>
+ </TABLE>
+
+ </DIV>
+
+ <!-- Bread crumbs and Quick Links -->
+ <DIV id="site-navbar">
+ <TABLE border="0" cellpadding="0" cellspacing="0" width="100%">
+ <TR>
+ <TD align="left" valign="middle" nowrap="">
+ <DIV id="site-breadcrumbs">
+<A href="home.html" title="ServiceMix">ServiceMix</A> > <A href="home.html" title="Home">Home</A> > <A href="users-guide.html" title="User's Guide">User's Guide</A> > <A href="" title="3. Installation">3. Installation</A>
+ </DIV>
+ </TD>
+ <TD align="right" valign="middle" nowrap="">
+ <DIV id="site-quicklinks">
+<P><A href="download.html" title="Download">Download</A> | <A href="documentation.html" title="Documentation">Documentation</A> | <A href="javadocs.html" title="JavaDocs">JavaDocs</A> | <A href="source.html" title="Source">Source</A> | <SPAN class="nobr"><A href="home.html" title="Visit page outside Confluence" rel="nofollow">Wiki<SUP><IMG class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif" height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN> | <A href="discussion-forums.html" title="Discussion Forums">Discussion Forums</A> | <A href="support.html" title="Support">Support</A></P>
+ </DIV>
+ </TD>
+ </TR>
+ </TABLE>
+ </DIV>
+
+<!-- Integrate google search later.
+ <form name="search" action="http://www.google.com/search" method="get">
+ <input type="hidden" name="ie" value="UTF- 8" />
+ <input type="hidden" name="oe" value="UTF- 8" />
+ <input type="hidden" name="domains" value="" />
+ <input type="hidden" name="sitesearch" value="" />
+ <input type="text" name="q" maxlength="255" value="" />
+ <input type="submit" name="btnG" value="Google Search" />
+ </form>
+-->
+
+ <DIV id="site-content">
+ <TABLE>
+ <TR>
+ <TD valign="top">
+ <DIV id="site-navigation">
+<H3><A name="Navigation-Overview"></A>Overview</H3>
+
+<UL class="alternate" type="square">
+ <LI><A href="home.html" title="Home">Home</A></LI>
+ <LI><SPAN class="nobr"><A href="http://www.apache.org/" title="Visit page outside Confluence" rel="nofollow">ASF<SUP><IMG class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif" height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN></LI>
+ <LI><A href="license.html" title="License">License</A></LI>
+ <LI><A href="faq.html" title="FAQ">FAQ</A></LI>
+ <LI><A href="download.html" title="Download">Download</A></LI>
+ <LI><A href="sitemap.html" title="SiteMap">SiteMap</A></LI>
+</UL>
+
+
+<H3><A name="Navigation-Community"></A>Community</H3>
+
+<UL class="alternate" type="square">
+ <LI><A href="users-guide.html" title="User's Guide">User's Guide</A></LI>
+ <LI><A href="documentation.html" title="Documentation">Documentation</A></LI>
+ <LI><A href="support.html" title="Support">Support</A></LI>
+ <LI><A href="discussion-forums.html" title="Discussion Forums">Discussion Forums</A></LI>
+ <LI><A href="mailing-lists.html" title="Mailing Lists">Mailing Lists</A></LI>
+ <LI><SPAN class="nobr"><A href="http://issues.apache.org/activemq/browse/SM" title="Visit page outside Confluence" rel="nofollow">Issues<SUP><IMG class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif" height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN></LI>
+ <LI><A href="contributing.html" title="Contributing">Contributing</A></LI>
+ <LI><SPAN class="nobr"><A href="http://goopen.org/confluence/pages/listpages-dirview.action?key=SM" title="Visit page outside Confluence" rel="nofollow">Wiki<SUP><IMG class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif" height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN></LI>
+ <LI><A href="team.html" title="Team">Team</A></LI>
+ <LI><A href="users.html" title="Users">Users</A></LI>
+</UL>
+
+
+<H3><A name="Navigation-Developers"></A>Developers</H3>
+
+<UL class="alternate" type="square">
+ <LI><A href="source.html" title="Source">Source</A></LI>
+ <LI><A href="building.html" title="Building">Building</A></LI>
+ <LI><A href="ideas.html" title="Ideas">Ideas</A></LI>
+ <LI><A href="becoming-a-committer.html" title="Becoming a committer">Becoming a committer</A></LI>
+ <LI><A href="release-guide.html" title="Release Guide">Release Guide</A></LI>
+ <LI><A href="related-projects.html" title="Related Projects">Related Projects</A></LI>
+ <LI><A href="tools.html" title="Tools">Tools</A></LI>
+ <LI><A href="resources.html" title="Resources">Resources</A></LI>
+</UL>
+
+ </DIV>
+ </TD>
+ <TD valign="top">
+ <DIV id="site-page">
+
+<!--
+ <div class="pagetitle">3. Installation</div>
+-->
+ <DIV class="wiki-content"><STYLE type="text/css">/*<![CDATA[*/
+table.ScrollbarTable {border: none;padding: 3px;width: 100%;padding: 3px;margin: 0px;background-color: #f0f0f0}
+table.ScrollbarTable td.ScrollbarPrevIcon {text-align: center;width: 16px;border: none;}
+table.ScrollbarTable td.ScrollbarPrevName {text-align: left;border: none;}
+table.ScrollbarTable td.ScrollbarParent {text-align: center;border: none;}
+table.ScrollbarTable td.ScrollbarNextName {text-align: right;border: none;}
+table.ScrollbarTable td.ScrollbarNextIcon {text-align: center;width: 16px;border: none;}
+
+/*]]>*/</STYLE><DIV class="Scrollbar"><TABLE class="ScrollbarTable"><TR><TD class="ScrollbarPrevIcon"><A href="../SM30UG/2-introduction.html"><IMG border="0" align="middle" src="http://goopen.org/confluence/images/icons/back_16.gif" width="16" height="16"></A></TD><TD width="33%" class="ScrollbarPrevName"><A href="../SM30UG/2-introduction.html">2. Introduction</A> </TD><TD width="33%" class="ScrollbarParent"><SUP><A href="users-guide.html"><IMG border="0" align="middle" src="http://goopen.org/confluence/images/icons/up_16.gif" width="8" height="8"></A></SUP><A href="users-guide.html">User's Guide</A></TD><TD width="33%" class="ScrollbarNextName"> <A href="../SM30UG/4-examples.html">4. Examples</A></TD><TD class="ScrollbarNextIcon"><A href="../SM30UG/4-examples.html"><IMG border="0" align="middle" src="http://goopen.org/confluence/images/icons/forwd_16.gif" width="16" height="16"></A></TD></TR></TABLE></DIV>
+<P><A name="3.Installation-top"></A></P>
+
+<H1><A name="3.Installation-3.Installation"></A>3. Installation</H1>
+
+<P>This document describes how to install and configure ServiceMix 3.x for both Unix and Windows' platforms.<BR>
+Here you will find information about what are pre requisite software, where to download Geronimo from and how to customize the installation to use custom ports other than the defaults.</P>
+
+<P>This article contains the following sections:</P>
+<DIV>
+<UL>
+ <LI><A href="#3.Installation-PreInstallationRequirements">Pre-Installation Requirements</A></LI>
+ <LI><A href="#3.Installation-InstallationProcedureforWindows">Installation Procedure for Windows</A>
+<UL>
+ <LI><A href="#3.Installation-WindowsBinaryInstallation">Windows Binary Installation</A></LI>
+ <LI><A href="#3.Installation-WindowsSourceInstallation">Windows Source Installation</A></LI>
+ <LI><A href="#3.Installation-WindowsDevelopers%2527Release">Windows Developers' Release</A></LI>
+</UL></LI>
+ <LI><A href="#3.Installation-InstallationProcedureForUnix">Installation Procedure For Unix</A>
+<UL>
+ <LI><A href="#3.Installation-UnixBinaryInstallation">Unix Binary Installation</A></LI>
+ <LI><A href="#3.Installation-UnixSourceInstallation">Unix Source Installation</A></LI>
+ <LI><A href="#3.Installation-UnixDevelopers%2527Release">Unix Developers' Release</A></LI>
+</UL></LI>
+ <LI><A href="#3.Installation-StartingServiceMix">Starting ServiceMix</A>
+<UL>
+ <LI><A href="#3.Installation-OnWindows">On Windows</A></LI>
+ <LI><A href="#3.Installation-OnUnix">On Unix</A>
+<UL>
+ <LI><A href="#3.Installation-TroubleshootingforUnix">Troubleshooting for Unix</A></LI>
+</UL></LI>
+</UL></LI>
+ <LI><A href="#3.Installation-Troubleshooting">Troubleshooting</A>
+<UL>
+ <LI><A href="#3.Installation-Pathname">Path name</A></LI>
+ <LI><A href="#3.Installation-Missinglibraries">Missing libraries</A></LI>
+</UL></LI>
+ <LI><A href="#3.Installation-TestingtheInstallation">Testing the Installation</A></LI>
+ <LI><A href="#3.Installation-StoppingServiceMix">Stopping ServiceMix</A></LI>
+ <LI><A href="#3.Installation-ConfiguringServiceMix">Configuring ServiceMix</A></LI>
+</UL></DIV>
+
+<H2><A name="3.Installation-PreInstallationRequirements"></A>Pre-Installation Requirements</H2>
+
+<P><B>Hardware:</B></P>
+<UL>
+ <LI>31 MB of free disk space for the ServiceMix 3.0.x binary distribution.</LI>
+ <LI>8 MB of free disk space for the ServiceMix 3.0.x source or developer's distributions respectively around 25 MB for SVN checkout. The Maven build requires roughly 250 MB disk space and for the dependencies Maven downloads during building further 200 MB are required. As a lot of small files are produced, the exact space demands depend greatly on your cluster utilisation ratio.</LI>
+</UL>
+
+
+<P><B>Operating Systems:</B></P>
+<UL>
+ <LI>Windows: Windows XP SP2, Windows 2000.</LI>
+ <LI>Unix: Ubuntu Linux, Powerdog Linux, MacOS, AIX, HP-UX, Solaris, any Unix platform that supports Java.</LI>
+</UL>
+
+
+<P><B>Environment:</B></P>
+<UL>
+ <LI>Java Developer Kit (JDK) 1.5.x or greater (<SPAN class="nobr"><A href="http://java.sun.com/" title="Visit page outside Confluence" rel="nofollow">http://java.sun.com/<SUP><IMG class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif" height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN>).</LI>
+ <LI>The JAVA_HOME environment variable must be set to the directory where the JDK is installed, e.g., <TT>c:\Program Files\jdk.1.5.0_06</TT>. To accomplish that, press Windows key and Break key together, switch to "Advanced" tab and click on "Environment Variables". Here, check for the variable and, if necessary, add it.</LI>
+ <LI>Apache Maven 2.0.4 (<SPAN class="nobr"><A href="http://maven.apache.org/download.html" title="Visit page outside Confluence" rel="nofollow">http://maven.apache.org/download.html<SUP><IMG class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif" height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN>).</LI>
+</UL>
+
+
+<TABLE cellpadding="5" width="85%" cellspacing="8px" class="infoMacro" border="0" align="center"><COLGROUP><COL width="24"><COL></COLGROUP><TR><TD valign="top"><IMG src="http://goopen.org/confluence/images/icons/emoticons/information.gif" width="16" height="16" align="absmiddle" alt="" border="0"></TD><TD><B class="strong">JDK 1.4</B><BR>
+<P>While the core JBI container can be used with JDK 1.4 without any problems, the build system requires JDK 5 and some components are dependant on JDK 5 features.</P></TD></TR></TABLE>
+
+<H2><A name="3.Installation-InstallationProcedureforWindows"></A>Installation Procedure for Windows</H2>
+
+<P>This section of the Getting Started guide explains how to install binary and source distributions of ServiceMix on a Windows system.</P>
+<TABLE cellpadding="5" width="85%" cellspacing="8px" class="tipMacro" border="0" align="center"><COLGROUP><COL width="24"><COL></COLGROUP><TR><TD valign="top"><IMG src="http://goopen.org/confluence/images/icons/emoticons/check.gif" width="16" height="16" align="absmiddle" alt="" border="0"></TD><TD><B class="strong">Handy Hint</B><BR>
+<P>In case you have to install ServiceMix into a very deep path or a path containing illegal characters for Java paths, e.g. !, % etc., you may add a bat file to <EM>start -> startup</EM> that executes</P>
+<DIV class="preformatted"><DIV class="preformattedContent">
+<PRE>subst S: "C:\your very % problematic path!\SM"
+</PRE>
+</DIV></DIV>
+<P>so your ServiceMix root directory is S: — which works for sure and is short to type.</P></TD></TR></TABLE>
+
+<H3><A name="3.Installation-WindowsBinaryInstallation"></A>Windows Binary Installation</H3>
+
+<P>This procedure explains how to download and install the binary distribution on a Windows system.</P>
+<OL>
+ <LI>From a browser, navigate to <SPAN class="nobr"><A href="http://incubator.apache.org/servicemix/download.html" title="Visit page outside Confluence" rel="nofollow">http://incubator.apache.org/servicemix/download.html<SUP><IMG class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif" height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN>.</LI>
+ <LI>Click the "ServiceMix 3.0.x Release" link under the "Latest Releases" section. This brings up a new page.</LI>
+ <LI>Under the "Download Here" section, select the desired distribution (you may have to scroll down to see the "Download Here" section).<BR>
+For a binary distribution, the filename will be similar to: <TT>apache-servicemix-3.0.x.zip</TT>.</LI>
+ <LI>Extract the files from the ZIP file into a directory of your choice. Please remember the restrictions concerning illegal characters in Java paths, e.g. !, % etc.</LI>
+ <LI>Proceed to the <A href="/confluence/display/SM30UG" title="View ServiceMix 3.0 User Guide space">SM30UG:#Starting ServiceMix</A> section of this document.</LI>
+ <LI>Following start-up, go to the <A href="/confluence/display/SM30UG" title="View ServiceMix 3.0 User Guide space">SM30UG:#Testing the Installation</A> section of this document.</LI>
+</OL>
+
+
+<H3><A name="3.Installation-WindowsSourceInstallation"></A>Windows Source Installation</H3>
+
+<P>This procedure explains how to download and install the source distribution on a Windows system. <B>NOTE:</B> ServiceMix can be run on a Java 1.4.x system, however, Java 5 is required to compile/build ServiceMix.</P>
+<OL>
+ <LI>From a browser, navigate to <SPAN class="nobr"><A href="http://incubator.apache.org/servicemix/download.html" title="Visit page outside Confluence" rel="nofollow">http://incubator.apache.org/servicemix/download.html<SUP><IMG class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif" height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN></LI>
+ <LI>Click the "ServiceMix 3.0.x Release" link under the "Latest Releases" section. This brings up another page.</LI>
+ <LI>Under the "Download Here" section, select the desired distribution (if necessary, scroll down to see the "Download Here" section).<BR>
+For a source distribution, the filename will be similar to: <TT>apache-servicemix-3.0.x-src.zip</TT>.</LI>
+ <LI>Extract ServiceMix from the ZIP file into a directory of your choice. Please remember the restrictions concerning illegal characters in Java paths, e.g. !, % etc.</LI>
+ <LI><A name="3.Installation-WindowsSourceInstallation"></A> Build ServiceMix using Maven 2.0.4 or greater and Java 5.<BR>
+The recommended method of building ServiceMix is the following:
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-java">cd [SM30UG:servicemix_install_dir]</PRE>
+</DIV></DIV>
+<P> where <TT>[SM30UG:servicemix_install_dir]</TT> is the directory in which ServiceMix was installed.</P>
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-java">mvn -Dprofile=step1
+mvn -Dprofile=step2</PRE>
+</DIV></DIV>
+<P>Both steps take around 10 to 15 minutes.</P></LI>
+ <LI>Unzip the distribution using your favorite zip tool. The windows distribution is available at
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-java">[SM30UG:servicemix_install_dir]\apache-servicemix\target\apache-servicemix-3.0-incubating.zip</PRE>
+</DIV></DIV></LI>
+ <LI>Proceed to the <A href="/confluence/display/SM30UG" title="View ServiceMix 3.0 User Guide space">SM30UG:#Starting ServiceMix</A> section of this document.</LI>
+ <LI>Following start-up, go to the <A href="/confluence/display/SM30UG" title="View ServiceMix 3.0 User Guide space">SM30UG:#Testing the Installation</A> section of this document.</LI>
+</OL>
+
+
+<P><EM>Warning:</EM> If you are building Servicemix 3.x under Windows using Cygwin there is a path name length limitation. If the length is exceeded you may see build errors. To fix this, move the ServiceMix source directory higher in the file system tree, e.g., /cygdrive/c/d/sm.</P>
+
+<H3><A name="3.Installation-WindowsDevelopers%27Release"></A>Windows Developers' Release</H3>
+
+<P>This procedure explains how to download and install the latest developers' snapshot. <B>NOTE:</B> ServiceMix can be run on a Java 1.4.x system, however, Java 5 is required to compile/build ServiceMix.</P>
+<OL>
+ <LI>From a browser, navigate to <SPAN class="nobr"><A href="http://www.servicemix.org/" title="Visit page outside Confluence" rel="nofollow">www.servicemix.org<SUP><IMG class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif" height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN>.</LI>
+ <LI>Click the Download link in the navigation pane (the left pane).</LI>
+ <LI>Click the "Current development SNAPSHOT release" link.</LI>
+ <LI>Select the version of ServiceMix to download (if necessary, scroll down to see the ServiceMix snapshots).</LI>
+ <LI>Extract the files from the ZIP file into a directory of your choice. Please remember the restrictions concerning illegal characters in Java paths, e.g. !, % etc.</LI>
+ <LI>If a binary snapshot was downloaded proceed to the <A href="/confluence/display/SM30UG" title="View ServiceMix 3.0 User Guide space">SM30UG:#Starting ServiceMix</A> section of this document.<BR>
+If a source snapshot was downloaded perform step 5 (building) and step 6 (unzipping) of the <A href="/confluence/display/SM30UG" title="View ServiceMix 3.0 User Guide space">SM30UG:#Windows Source Installation</A> procedure and proceed to the <A href="/confluence/display/SM30UG" title="View ServiceMix 3.0 User Guide space">SM30UG:#Starting ServiceMix</A> section of this document.</LI>
+ <LI>Following start-up, proceed to the <A href="/confluence/display/SM30UG" title="View ServiceMix 3.0 User Guide space">SM30UG:#Testing the Installation</A> section.</LI>
+</OL>
+
+
+<H2><A name="3.Installation-InstallationProcedureForUnix"></A>Installation Procedure For Unix</H2>
+
+
+<H3><A name="3.Installation-UnixBinaryInstallation"></A>Unix Binary Installation</H3>
+
+<P>This procedure explains how to download and install the binary distribution on a Unix system.</P>
+<OL>
+ <LI>Download the ServiceMix gzip file to the Unix machine, either using a browser or using a tool, i.e., wget, scp, ftp, etc.<BR>
+If the Unix machine has a browser:</LI>
+</OL>
+
+
+<P>a. Navigate to <SPAN class="nobr"><A href="http://www.servicemix.org/" title="Visit page outside Confluence" rel="nofollow">www.servicemix.org<SUP><IMG class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif" height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN>.<BR>
+b. Click the "Download" link in the navigation pane (the left pane).<BR>
+c. Click the "ServiceMix 3.x Release" link under the "Latest Releases" section. This brings up a new page.<BR>
+d. Under the "Download Here" section, select the desired distribution (if necessary,<BR>
+scroll down to see the "Download Here" section). For a binary Unix distribution, the filename<BR>
+will be similar to: apache-servicemix-x.x.x.tar.gz.</P>
+
+<P>OR</P>
+
+<P>If the Unix machine does NOT have a browser, tools such as wget, scp, or ftp can be used to download the ServiceMix distribution.<BR>
+It is beyond the scope of this document to explain the use of those tools. For convenience an example is provided below using<BR>
+a Windows machine (that has a browser) and a Unix machine with "wget" installed on it.<BR>
+<B>NOTE:</B> There are several alternative ways to perform this type of installation.</P>
+
+<P>a. Obtain the link to the ServiceMix distribution file. On the Windows machine with a browser, navigate to <SPAN class="nobr"><A href="http://www.servicemix.org/" title="Visit page outside Confluence" rel="nofollow">www.servicemix.org<SUP><IMG class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif" height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN>.<BR>
+b. Click the "Download" link in the left navigation pane.<BR>
+c. Click the "ServiceMix 3.x Release" link under the "Latest Releases" section. This brings up a new page.<BR>
+d. Under the "Download Here" section, roll-over the desired distribution (if necessary, scroll<BR>
+down to see the "Download Here" section). For a binary Unix distribution the filename will be<BR>
+similar to: servicemix-x.x.x.tar.gz.<BR>
+e. Right-click on the distribution name and "Copy Shortcut."<BR>
+f. On the Unix machine, change to the directory in which ServiceMix will be installed, e.g., /usr/local.<BR>
+f. Download the ServiceMix distribution to the Unix machine using the "wget" tool. For example, type "wget" followed by the saved shortcut:</P>
+<DIV class="preformatted"><DIV class="preformattedContent">
+<PRE>wget http://people.apache.org/repo/m2-incubating-repository/org/apache/servicemix/apache-servicemix/3.0-incubating/apache-servicemix-3.0-incubating-src.tar.gz
+</PRE>
+</DIV></DIV>
+<OL>
+ <LI>Extract the files from the gzip file into a directory of your choice. For example:
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-java">gunzip apache-servicemix-x.x.x.tar.gz
+tar xvf apache-servicemix-x.x.x.tar</PRE>
+</DIV></DIV>
+<P>Please remember the restrictions concerning illegal characters in Java paths, e.g. !, % etc.</P></LI>
+ <LI>Proceed to the <A href="/confluence/display/SM30UG" title="View ServiceMix 3.0 User Guide space">SM30UG:#Starting ServiceMix</A> section of this document.</LI>
+ <LI>Following start-up, go to the <A href="/confluence/display/SM30UG" title="View ServiceMix 3.0 User Guide space">SM30UG:#Testing the Installation</A> section.</LI>
+</OL>
+
+
+<H3><A name="3.Installation-UnixSourceInstallation"></A>Unix Source Installation</H3>
+
+<P>This procedure explains how to download and install the source distribution on a Unix system. This procedure assumes the Unix machine has a browser. Please see the previous <A href="/confluence/display/SM30UG" title="View ServiceMix 3.0 User Guide space">SM30UG:#Unix Binary Installation</A> section for ideas on how to install ServiceMix without a browser. <B>NOTE:</B> ServiceMix can be run on a Java 1.4.x system, however, Java 5 is required to compile/build ServiceMix.</P>
+<OL>
+ <LI>From a browser, navigate to <SPAN class="nobr"><A href="http://www.servicemix.org/" title="Visit page outside Confluence" rel="nofollow">www.servicemix.org<SUP><IMG class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif" height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN>.</LI>
+ <LI>Click the "Download" link in the navigation pane (the left pane).</LI>
+ <LI>Click the "ServiceMix 3.x Release" link under the "Latest Releases" section. This brings up a new page.</LI>
+ <LI>Under the "Download Here" section, select the desired distribution (if necessary, scroll down to see the "Download Here" section).<BR>
+For a source distribution, the filename will be similar to: <TT>servicemix-x.x-src.tar.gz</TT>.</LI>
+ <LI>Extract the files from the ZIP file into a directory of your choice. For example:
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-java">gunzip apache-servicemix.x.x-src.tar.gz
+tar xvf apache-servicemix.x.x-src.tar</PRE>
+</DIV></DIV>
+<P>Please remember the restrictions concerning illegal characters in Java paths, e.g. !, % etc.</P></LI>
+ <LI>Build ServiceMix using Maven 2.0.4 or greater and Java 5:
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-java">The preferred method of building ServiceMix is the following:
+cd [SM30UG:servicemix_install_dir]
+ where [SM30UG:servicemix_install_dir] is the directory in which ServiceMix was installed.
+mvn -Dprofile=step1
+mvn -Dprofile=step2</PRE>
+</DIV></DIV>
+<P>Both steps take around 10 to 15 minutes.</P></LI>
+ <LI>Uncompress the distribution that has just been created
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-java">cd [SM30UG:servicemix_install_dir]/apache-servicemix/target
+gunzip apache-servicemix-3.0-incubating.tar.gz
+tar xvf apache-servicemix-3.0-incubating.tar</PRE>
+</DIV></DIV></LI>
+ <LI>Proceed to the <A href="/confluence/display/SM30UG" title="View ServiceMix 3.0 User Guide space">SM30UG:#Starting ServiceMix</A> section of this document.</LI>
+ <LI>Following start-up, go to the <A href="/confluence/display/SM30UG" title="View ServiceMix 3.0 User Guide space">SM30UG:#Testing the Installation</A> section.</LI>
+</OL>
+
+
+<H3><A name="3.Installation-UnixDevelopers%27Release"></A>Unix Developers' Release</H3>
+
+<P>This procedure explains how to download and install the latest developers' snapshot. <B>NOTE:</B> ServiceMix can be run on a Java 1.4.x system, however, Java 5 is required to compile/build ServiceMix.</P>
+<OL>
+ <LI>From a browser, navigate to www.servicemix.org.</LI>
+ <LI>Click the Download link in the navigation pane (the left pane).</LI>
+ <LI>Click the "Current development SNAPSHOT release" link.</LI>
+ <LI>Select the version of ServiceMix to download (you may have to scroll down to see the ServiceMix snapshots). The filename will be similar to: <TT>servicemix-x.x.x-tar.gz</TT> or <TT>servicemix-x.x.x-src.tar.gz</TT>.</LI>
+ <LI>Extract the files from the gzip file into a directory of your choice. For example:
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-java">For a binary developer's snapshot:
+ gunzip apache-servicemix-x.x-x.tar.gz
+ tar xvf apache-servicemix-x.x.x.tar
+
+For a source developer's snapshot:
+ gunzip apache-servicemix-x.x.x-src.tar.gz
+ tar xvf apache-servicemix-x.x.x-src.tar</PRE>
+</DIV></DIV>
+<P>Please remember the restrictions concerning illegal characters in Java paths, e.g. !, % etc.</P></LI>
+ <LI>For a binary snapshot, proceed to the <A href="/confluence/display/SM30UG" title="View ServiceMix 3.0 User Guide space">SM30UG:#Starting ServiceMix</A> section of this document.<BR>
+If a source snapshot was downloaded perform steps 6 - 8 (building, uncompressing, starting) of the <A href="/confluence/display/SM30UG" title="View ServiceMix 3.0 User Guide space">SM30UG:#Unix Source Installation</A> procedure.</LI>
+ <LI>Proceed to the <A href="/confluence/display/SM30UG" title="View ServiceMix 3.0 User Guide space">SM30UG:#Testing the Installation</A> section.</LI>
+</OL>
+
+
+<H2><A name="3.Installation-StartingServiceMix"></A>Starting ServiceMix</H2>
+
+
+<H3><A name="3.Installation-OnWindows"></A>On Windows</H3>
+
+<P>From a console window, change to the installation directory and run <TT>ServiceMix</TT>. For the binary distribution, go to</P>
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-java">cd [SM30UG:servicemix_install_dir]</PRE>
+</DIV></DIV>
+<P>and for the source distribution go to the target directory, for example:</P>
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-java">cd [SM30UG:servicemix_install_dir]\apache-servicemix\target\apache-servicemix-3.0-incubating-SNAPSHOT</PRE>
+</DIV></DIV>
+<P>where <TT>servicemix_install_dir</TT> is the directory in which ServiceMix was installed, e.g., <TT>c:\Program Files\servicemix-3.x</TT>.</P>
+
+<P>Then type:</P>
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-java">bin\servicemix</PRE>
+</DIV></DIV>
+<P><EM>Note:</EM> Working directories get created relative to the current directory. For the working directories to be created in the proper place, ServiceMix must be launched from its home/installation directory.</P>
+
+<H3><A name="3.Installation-OnUnix"></A>On Unix</H3>
+
+<P>From a command shell, change to the installation directory and run <TT>ServiceMix</TT>. For the binary distribution, go to</P>
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-java">cd [SM30UG:servicemix_install_dir]</PRE>
+</DIV></DIV>
+<P>and for the source distribution go to the target directory, for example:</P>
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-java">cd [SM30UG:servicemix_install_dir]/apache-servicemix/target/apache-servicemix-3.0-incubating</PRE>
+</DIV></DIV>
+<P>where <TT>servicemix_install_dir</TT> is the directory in which ServiceMix was installed, e.g., <TT>/usr/local/servicemix-3.x</TT>.</P>
+
+<P>Then type:</P>
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-java">bin/servicemix
+
+OR
+
+nohup bin/servicemix > /tmp/smlog 2>&1 &</PRE>
+</DIV></DIV>
+<P><EM>Note:</EM> /tmp/smlog may be changed to another file name.</P>
+
+<P><EM>Note:</EM> Working directories get created relative to the current directory. For the working directories to be created in the proper place, ServiceMix must be launched from its home/installation directory.</P>
+<TABLE cellpadding="5" width="85%" cellspacing="8px" class="warningMacro" border="0" align="center"><COLGROUP><COL width="24"><COL></COLGROUP><TR><TD valign="top"><IMG src="http://goopen.org/confluence/images/icons/emoticons/forbidden.gif" width="16" height="16" align="absmiddle" alt="" border="0"></TD><TD><B class="strong">Warning</B><BR>
+<P>Do NOT close the console or shell in which ServiceMix was started, as that will terminate ServiceMix (unless ServiceMix was started with nohup).</P></TD></TR></TABLE>
+
+<H4><A name="3.Installation-TroubleshootingforUnix"></A>Troubleshooting for Unix</H4>
+
+<P>If the <TT>servicemix</TT> start-up script is not executable, change its permisssions. The <TT>servicemix</TT> script is located in the <TT>bin</TT> directory. For example:</P>
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-java">chmod 755 bin/servicemix</PRE>
+</DIV></DIV>
+
+<H2><A name="3.Installation-Troubleshooting"></A>Troubleshooting</H2>
+
+
+<H3><A name="3.Installation-Pathname"></A>Path name</H3>
+
+<P>In case you get a</P>
+<DIV class="preformatted"><DIV class="preformattedContent">
+<PRE>Exception in thread "main" java.lang.IllegalArgumentException
+</PRE>
+</DIV></DIV>
+<P>you may have some illegal characters in the path, e.g. !, % etc.</P>
+
+<H3><A name="3.Installation-Missinglibraries"></A>Missing libraries</H3>
+
+<P>Starting ServiceMix with old examples, <A href="cimero-editor.html" title="CIMERO Editor">CIMERO</A>-generated xml configuration files or custom code may cause errors due to missing libraries. Usually, the missing class is displayed at the very end of the output. Here, some examples are shown and explained.</P>
+<DIV class="panel"><DIV class="panelContent">
+<P>Caused by: java.lang.<B>NoClassDefFoundError:</B> org/<B>quartz</B>/JobExecutionException<BR>
+ at java.lang.Class.forName0(Native Method)<BR>
+ at java.lang.Class.forName(Class.java:242)<BR>
+ at org.springframework.util.ClassUtils.forName(ClassUtils.java:160)<BR>
+ at org.springframework.beans.factory.support.BeanDefinitionReaderUtils.createBeanDefinition(BeanDefinitionReaderUtils.java:95)<BR>
+ at org.springframework.beans.factory.xml.BeanDefinitionParserDelegate.parseBeanDefinitionElement(BeanDefinitionParserDelegate.java:452)<BR>
+ ... 53 more</P>
+</DIV></DIV>
+<P>Obviously (bold typed text), a class inside the quartz package cannot be found. A quick search for "quartz" in the Maven repository reveals <EM>[SM30UG:user_home]\.m2\repository\quartz\quartz\1.5.2\quartz-1.5.2.jar</EM> (or newer version) which has to be copied to <EM>[SM30UG:ServiceMix_home]\lib\quartz-1.5.2.jar</EM> - the error shall be resolved now. Of course, adding the directory containing the jar to the classpath is another possibility.</P>
+
+<P>Very similar is</P>
+<DIV class="panel"><DIV class="panelContent">
+<P>...<BR>
+Caused by: java.lang.<B>ClassNotFoundException</B>: org.apache.<B>servicemix.components</B>.file.FileWriter<BR>
+...</P>
+</DIV></DIV>
+<P>indicating that the whole servicemix-common package cannot be found. In the Maven repository, <EM>servicemix-components-3.0-incubating.jar</EM> (or newer version) can be found and copied to ServiceMix' lib directory. <B>Note:</B> As this is a ServiceMix' sub-project, the jar is available at <EM>[SM30UG:ServiceMix_home]\components</EM> as well.</P>
+
+<P>Slightly trickier is </P>
+<DIV class="panel"><DIV class="panelContent">
+<P>...<BR>
+Caused by: org.springframework.beans.factory.BeanDefinitionStoreException: <B>Unrecognized xbean namespace mapping:</B> <SPAN class="nobr"><A href="http://servicemix.apache.org/eip/1.0" title="Visit page outside Confluence" rel="nofollow">http://servicemix.apache.org/eip/1.0<SUP><IMG class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif" height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN><BR>
+...</P>
+</DIV></DIV>
+<P>A short www search leads to <A href="unrecognized-xbean-namespace-mapping.html" title="Unrecognized xbean namespace mapping">Unrecognized xbean namespace mapping</A>. With this information, one can infer that <EM>[SM30UG:user_home]\.m2\repository\org\apache\servicemix\servicemix-eip\3.0-incubating\servicemix-eip-3.0-incubating.jar</EM> (or newer version) has to be copied to <EM>[SM30UG:ServiceMix_home]\lib\servicemix-eip-3.0-incubating.jar</EM> so ServiceMix can find the classes.</P>
+
+<H2><A name="3.Installation-TestingtheInstallation"></A>Testing the Installation</H2>
+
+<P>If ServiceMix is up and running without problems, the Window's console window or the Unix command shell will display something similar to the following log line:</P>
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-java">INFO - JBIContainer.init(421) | ServiceMix JBI Container ([http:<SPAN class="code-comment">//servicemix.org/]) name: defaultJBI running version: 3.0-incubating</SPAN></PRE>
+</DIV></DIV>
+<P>ServiceMix's default port is 1099. From another window run netstat and search for port 1099.</P>
+
+<P>From a Windows console, type:</P>
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-java">netstat -an | find <SPAN class="code-quote">"1099"</SPAN></PRE>
+</DIV></DIV>
+<P><B>OR</B></P>
+
+<P>From a Unix command shell, type:</P>
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-java">netstat -an | grep 1099</PRE>
+</DIV></DIV>
+
+<H2><A name="3.Installation-StoppingServiceMix"></A>Stopping ServiceMix</H2>
+
+<P>For both Windows and Unix installations, terminate ServiceMix by typing "CTRL-C" in the command shell or console in which it is running.</P>
+
+<P>If ServiceMix was started in the background on Unix, the process can be killed, with the following:</P>
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-java">ps -ef | grep servicemix
+kill [SM30UG:PID]
+ where [SM30UG:PID] is the process id of the servicemix process.</PRE>
+</DIV></DIV>
+
+<H2><A name="3.Installation-ConfiguringServiceMix"></A>Configuring ServiceMix</H2>
+
+<P>After the installation, ServiceMix is running with a basic configuration, but no components. For details on configuring options, please see refer to the <SPAN class="nobr"><A href="http://goopen.org/confluence/pages/createpage.action?spaceKey=SM30UG&title=Configuration" title="Create Page in space SM30UG: Configuration" class="createlink">SM30UG:Configuration<SUP><IMG class="rendericon" src="http://goopen.org/confluence/images/icons/plus.gif" height="7" width="7" align="absmiddle" alt="" border="0"></SUP></A></SPAN> section.</P>
+
+<P><A href="/confluence/display/SM30UG" title="View ServiceMix 3.0 User Guide space">SM30UG:#top</A></P>
+<STYLE type="text/css">/*<![CDATA[*/
+table.ScrollbarTable {border: none;padding: 3px;width: 100%;padding: 3px;margin: 0px;background-color: #f0f0f0}
+table.ScrollbarTable td.ScrollbarPrevIcon {text-align: center;width: 16px;border: none;}
+table.ScrollbarTable td.ScrollbarPrevName {text-align: left;border: none;}
+table.ScrollbarTable td.ScrollbarParent {text-align: center;border: none;}
+table.ScrollbarTable td.ScrollbarNextName {text-align: right;border: none;}
+table.ScrollbarTable td.ScrollbarNextIcon {text-align: center;width: 16px;border: none;}
+
+/*]]>*/</STYLE><DIV class="Scrollbar"><TABLE class="ScrollbarTable"><TR><TD class="ScrollbarPrevIcon"><A href="../SM30UG/2-introduction.html"><IMG border="0" align="middle" src="http://goopen.org/confluence/images/icons/back_16.gif" width="16" height="16"></A></TD><TD width="33%" class="ScrollbarPrevName"><A href="../SM30UG/2-introduction.html">2. Introduction</A> </TD><TD width="33%" class="ScrollbarParent"><SUP><A href="users-guide.html"><IMG border="0" align="middle" src="http://goopen.org/confluence/images/icons/up_16.gif" width="8" height="8"></A></SUP><A href="users-guide.html">User's Guide</A></TD><TD width="33%" class="ScrollbarNextName"> <A href="../SM30UG/4-examples.html">4. Examples</A></TD><TD class="ScrollbarNextIcon"><A href="../SM30UG/4-examples.html"><IMG border="0" align="middle" src="http://goopen.org/confluence/images/icons/forwd_16.gif" width="16" height="16"></A></TD></TR></TABLE></DIV></DIV>
+
+ </DIV>
+ </TD>
+ </TR>
+ </TABLE>
+ </DIV>
+ </DIV>
+ <DIV id="site-footer">
+ Added by <A href="http://goopen.org/confluence/users/viewuserprofile.action?username=gnodet">Guillaume Nodet</A>,
+ last edited by <A href="http://goopen.org/confluence/users/viewuserprofile.action?username=gnodet">Guillaume Nodet</A> on Nov 08, 2006
+ (<A href="http://goopen.org/confluence/pages/diffpages.action?pageId=13489&originalId=14610">view change</A>)
+
+ (<A href="http://goopen.org/confluence/pages/editpage.action?pageId=13489">edit page</A>)
+ </DIV>
+
+ </BODY>
+
+</HTML>
\ No newline at end of file
Added: incubator/servicemix/site/main/5-jbi.data/jbi_architecture.jpg
URL: http://svn.apache.org/viewvc/incubator/servicemix/site/main/5-jbi.data/jbi_architecture.jpg?view=auto&rev=471422
==============================================================================
Binary file - no diff available.
Propchange: incubator/servicemix/site/main/5-jbi.data/jbi_architecture.jpg
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: incubator/servicemix/site/main/5-jbi.data/jbi_architecture.jpg.jpeg
URL: http://svn.apache.org/viewvc/incubator/servicemix/site/main/5-jbi.data/jbi_architecture.jpg.jpeg?view=auto&rev=471422
==============================================================================
Binary file - no diff available.
Propchange: incubator/servicemix/site/main/5-jbi.data/jbi_architecture.jpg.jpeg
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: incubator/servicemix/site/main/5-jbi.data/jbi_decoupling.jpg
URL: http://svn.apache.org/viewvc/incubator/servicemix/site/main/5-jbi.data/jbi_decoupling.jpg?view=auto&rev=471422
==============================================================================
Binary file - no diff available.
Propchange: incubator/servicemix/site/main/5-jbi.data/jbi_decoupling.jpg
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: incubator/servicemix/site/main/5-jbi.data/jbi_decoupling.jpg.jpeg
URL: http://svn.apache.org/viewvc/incubator/servicemix/site/main/5-jbi.data/jbi_decoupling.jpg.jpeg?view=auto&rev=471422
==============================================================================
Binary file - no diff available.
Propchange: incubator/servicemix/site/main/5-jbi.data/jbi_decoupling.jpg.jpeg
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: incubator/servicemix/site/main/5-jbi.data/jbi_invocation.jpg
URL: http://svn.apache.org/viewvc/incubator/servicemix/site/main/5-jbi.data/jbi_invocation.jpg?view=auto&rev=471422
==============================================================================
Binary file - no diff available.
Propchange: incubator/servicemix/site/main/5-jbi.data/jbi_invocation.jpg
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: incubator/servicemix/site/main/5-jbi.data/jbi_invocation.jpg.jpeg
URL: http://svn.apache.org/viewvc/incubator/servicemix/site/main/5-jbi.data/jbi_invocation.jpg.jpeg?view=auto&rev=471422
==============================================================================
Binary file - no diff available.
Propchange: incubator/servicemix/site/main/5-jbi.data/jbi_invocation.jpg.jpeg
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: incubator/servicemix/site/main/5-jbi.data/jbi_plugin_framework.png
URL: http://svn.apache.org/viewvc/incubator/servicemix/site/main/5-jbi.data/jbi_plugin_framework.png?view=auto&rev=471422
==============================================================================
Binary file - no diff available.
Propchange: incubator/servicemix/site/main/5-jbi.data/jbi_plugin_framework.png
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: incubator/servicemix/site/main/5-jbi.data/jbi_plugin_framework.png.jpeg
URL: http://svn.apache.org/viewvc/incubator/servicemix/site/main/5-jbi.data/jbi_plugin_framework.png.jpeg?view=auto&rev=471422
==============================================================================
Binary file - no diff available.
Propchange: incubator/servicemix/site/main/5-jbi.data/jbi_plugin_framework.png.jpeg
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: incubator/servicemix/site/main/5-jbi.data/jbi_wsdl_messaging_model.jpg
URL: http://svn.apache.org/viewvc/incubator/servicemix/site/main/5-jbi.data/jbi_wsdl_messaging_model.jpg?view=auto&rev=471422
==============================================================================
Binary file - no diff available.
Propchange: incubator/servicemix/site/main/5-jbi.data/jbi_wsdl_messaging_model.jpg
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: incubator/servicemix/site/main/5-jbi.data/jbi_wsdl_messaging_model.jpg.jpeg
URL: http://svn.apache.org/viewvc/incubator/servicemix/site/main/5-jbi.data/jbi_wsdl_messaging_model.jpg.jpeg?view=auto&rev=471422
==============================================================================
Binary file - no diff available.
Propchange: incubator/servicemix/site/main/5-jbi.data/jbi_wsdl_messaging_model.jpg.jpeg
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: incubator/servicemix/site/main/5-jbi.html
URL: http://svn.apache.org/viewvc/incubator/servicemix/site/main/5-jbi.html?view=auto&rev=471422
==============================================================================
--- incubator/servicemix/site/main/5-jbi.html (added)
+++ incubator/servicemix/site/main/5-jbi.html Sun Nov 5 05:39:56 2006
@@ -0,0 +1,486 @@
+
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<HTML>
+ <HEAD>
+<!--
+ Pier's plugin always overwrites the stylesheet so lets explicitly use another one
+ <link type="text/css" rel="stylesheet" href="autoexport:///SM/resources/space.css">
+-->
+ <LINK type="text/css" rel="stylesheet" href="resources/site.css">
+ <SCRIPT src="resources/space.js" type="text/javascript"></SCRIPT>
+ <TITLE>
+5. JBI
+ </TITLE>
+ <META http-equiv="Content-Type" content="text/html;charset=UTF-8"></HEAD>
+ <BODY onload="init()">
+
+ <!-- Banner -->
+ <DIV id="site-banner">
+
+ <TABLE border="0" cellpadding="0" cellspacing="0" width="100%">
+ <TR>
+ <TD align="left" class="topbardiv" nowrap="">
+ <IMG border="0" src="http://incubator.apache.org/servicemix/main/images/logo.jpg">
+ </TD>
+ <TD align="right" nowrap="">
+ <IMG border="0" src="http://incubator.apache.org/images/apache-incubator-logo.png">
+ </TD>
+ </TR>
+ </TABLE>
+
+ </DIV>
+
+ <!-- Bread crumbs and Quick Links -->
+ <DIV id="site-navbar">
+ <TABLE border="0" cellpadding="0" cellspacing="0" width="100%">
+ <TR>
+ <TD align="left" valign="middle" nowrap="">
+ <DIV id="site-breadcrumbs">
+<A href="home.html" title="ServiceMix">ServiceMix</A> > <A href="home.html" title="Home">Home</A> > <A href="users-guide.html" title="User's Guide">User's Guide</A> > <A href="" title="5. JBI">5. JBI</A>
+ </DIV>
+ </TD>
+ <TD align="right" valign="middle" nowrap="">
+ <DIV id="site-quicklinks">
+<P><A href="download.html" title="Download">Download</A> | <A href="documentation.html" title="Documentation">Documentation</A> | <A href="javadocs.html" title="JavaDocs">JavaDocs</A> | <A href="source.html" title="Source">Source</A> | <SPAN class="nobr"><A href="home.html" title="Visit page outside Confluence" rel="nofollow">Wiki<SUP><IMG class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif" height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN> | <A href="discussion-forums.html" title="Discussion Forums">Discussion Forums</A> | <A href="support.html" title="Support">Support</A></P>
+ </DIV>
+ </TD>
+ </TR>
+ </TABLE>
+ </DIV>
+
+<!-- Integrate google search later.
+ <form name="search" action="http://www.google.com/search" method="get">
+ <input type="hidden" name="ie" value="UTF- 8" />
+ <input type="hidden" name="oe" value="UTF- 8" />
+ <input type="hidden" name="domains" value="" />
+ <input type="hidden" name="sitesearch" value="" />
+ <input type="text" name="q" maxlength="255" value="" />
+ <input type="submit" name="btnG" value="Google Search" />
+ </form>
+-->
+
+ <DIV id="site-content">
+ <TABLE>
+ <TR>
+ <TD valign="top">
+ <DIV id="site-navigation">
+<H3><A name="Navigation-Overview"></A>Overview</H3>
+
+<UL class="alternate" type="square">
+ <LI><A href="home.html" title="Home">Home</A></LI>
+ <LI><SPAN class="nobr"><A href="http://www.apache.org/" title="Visit page outside Confluence" rel="nofollow">ASF<SUP><IMG class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif" height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN></LI>
+ <LI><A href="license.html" title="License">License</A></LI>
+ <LI><A href="faq.html" title="FAQ">FAQ</A></LI>
+ <LI><A href="download.html" title="Download">Download</A></LI>
+ <LI><A href="sitemap.html" title="SiteMap">SiteMap</A></LI>
+</UL>
+
+
+<H3><A name="Navigation-Community"></A>Community</H3>
+
+<UL class="alternate" type="square">
+ <LI><A href="users-guide.html" title="User's Guide">User's Guide</A></LI>
+ <LI><A href="documentation.html" title="Documentation">Documentation</A></LI>
+ <LI><A href="support.html" title="Support">Support</A></LI>
+ <LI><A href="discussion-forums.html" title="Discussion Forums">Discussion Forums</A></LI>
+ <LI><A href="mailing-lists.html" title="Mailing Lists">Mailing Lists</A></LI>
+ <LI><SPAN class="nobr"><A href="http://issues.apache.org/activemq/browse/SM" title="Visit page outside Confluence" rel="nofollow">Issues<SUP><IMG class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif" height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN></LI>
+ <LI><A href="contributing.html" title="Contributing">Contributing</A></LI>
+ <LI><SPAN class="nobr"><A href="http://goopen.org/confluence/pages/listpages-dirview.action?key=SM" title="Visit page outside Confluence" rel="nofollow">Wiki<SUP><IMG class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif" height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN></LI>
+ <LI><A href="team.html" title="Team">Team</A></LI>
+ <LI><A href="users.html" title="Users">Users</A></LI>
+</UL>
+
+
+<H3><A name="Navigation-Developers"></A>Developers</H3>
+
+<UL class="alternate" type="square">
+ <LI><A href="source.html" title="Source">Source</A></LI>
+ <LI><A href="building.html" title="Building">Building</A></LI>
+ <LI><A href="ideas.html" title="Ideas">Ideas</A></LI>
+ <LI><A href="becoming-a-committer.html" title="Becoming a committer">Becoming a committer</A></LI>
+ <LI><A href="release-guide.html" title="Release Guide">Release Guide</A></LI>
+ <LI><A href="related-projects.html" title="Related Projects">Related Projects</A></LI>
+ <LI><A href="tools.html" title="Tools">Tools</A></LI>
+ <LI><A href="resources.html" title="Resources">Resources</A></LI>
+</UL>
+
+ </DIV>
+ </TD>
+ <TD valign="top">
+ <DIV id="site-page">
+
+<!--
+ <div class="pagetitle">5. JBI</div>
+-->
+ <DIV class="wiki-content"><STYLE type="text/css">/*<![CDATA[*/
+table.ScrollbarTable {border: none;padding: 3px;width: 100%;padding: 3px;margin: 0px;background-color: #f0f0f0}
+table.ScrollbarTable td.ScrollbarPrevIcon {text-align: center;width: 16px;border: none;}
+table.ScrollbarTable td.ScrollbarPrevName {text-align: left;border: none;}
+table.ScrollbarTable td.ScrollbarParent {text-align: center;border: none;}
+table.ScrollbarTable td.ScrollbarNextName {text-align: right;border: none;}
+table.ScrollbarTable td.ScrollbarNextIcon {text-align: center;width: 16px;border: none;}
+
+/*]]>*/</STYLE><DIV class="Scrollbar"><TABLE class="ScrollbarTable"><TR><TD class="ScrollbarPrevIcon"><A href="../SM30UG/4-examples.html"><IMG border="0" align="middle" src="http://goopen.org/confluence/images/icons/back_16.gif" width="16" height="16"></A></TD><TD width="33%" class="ScrollbarPrevName"><A href="../SM30UG/4-examples.html">4. Examples</A> </TD><TD width="33%" class="ScrollbarParent"><SUP><A href="users-guide.html"><IMG border="0" align="middle" src="http://goopen.org/confluence/images/icons/up_16.gif" width="8" height="8"></A></SUP><A href="users-guide.html">User's Guide</A></TD><TD width="33%" class="ScrollbarNextName"> <A href="6-configuring-servicemix.html">6. Configuring ServiceMix</A></TD><TD class="ScrollbarNextIcon"><A href="6-configuring-servicemix.html"><IMG border="0" align="middle" src="http://goopen.org/confluence/images/icons/forwd_16.gif" width="16" height="16"></A></TD></TR></TABLE></DIV>
+<P><A name="5.JBI-top"></A></P>
+
+<H1><A name="5.JBI-5.JBI"></A>5. JBI</H1>
+
+<DIV>
+<UL>
+ <LI><A href="#5.JBI-Overview">Overview</A>
+<UL>
+ <LI><A href="#5.JBI-WhatisJBI%253F">What is JBI ?</A></LI>
+ <LI><A href="#5.JBI-JBIArchitecture">JBI Architecture</A></LI>
+</UL></LI>
+ <LI><A href="#5.JBI-WSDLmessagingmodel">WSDL messaging model</A>
+<UL>
+ <LI><A href="#5.JBI-Abstractmodel">Abstract model</A></LI>
+ <LI><A href="#5.JBI-Concretemodel">Concrete model</A></LI>
+</UL></LI>
+ <LI><A href="#5.JBI-NormalizedMessageRouter">Normalized Message Router</A>
+<UL>
+ <LI><A href="#5.JBI-Consumersandproviders">Consumers and providers</A></LI>
+ <LI><A href="#5.JBI-Normalizedmessage">Normalized message</A></LI>
+ <LI><A href="#5.JBI-DeliveryChannel">Delivery Channel</A></LI>
+ <LI><A href="#5.JBI-Endpointactivation">Endpoint activation</A></LI>
+ <LI><A href="#5.JBI-ServiceinvocationandMEP">Service invocation and MEP</A></LI>
+ <LI><A href="#5.JBI-Endpoints">Endpoints</A></LI>
+</UL></LI>
+ <LI><A href="#5.JBI-Invocationexample">Invocation example</A></LI>
+ <LI><A href="#5.JBI-JBIpackaging">JBI packaging</A></LI>
+ <LI><A href="#5.JBI-Othermaterials">Other materials</A></LI>
+</UL></DIV>
+
+<H2><A name="5.JBI-Overview"></A>Overview</H2>
+
+
+<H3><A name="5.JBI-WhatisJBI%3F"></A>What is JBI ?</H3>
+
+<TABLE class="sectionMacro" border="0" cellpadding="5" cellspacing="0" width="100%"><TBODY><TR>
+<TD class="confluenceTd" valign="top">
+<P>JBI is a java based standard to build integrations systems by using plug-in components which interoperates through mediated normalized message exchanges.<BR>
+The message exchange model is based on the web services description language (WSDL).</P>
+
+<P>The figure at the top shows a high level concept of JBI of the plug-in framework. The JBI environment provides interfaces to be used by plug-in components, while the components provides interfaces used by the JBI environment. Components do not interact with each other directly. Instead, as shown in the bottom figure, JBI acts as an intermediary to route messages between components. This separation is the key to decoupling between service providers and consumers, which is one of the goal of service oriented architectures. In addition, it provides a key point for message processing and monitoring.</P>
+
+<P>In this WSDL-based, service-oriented model, JBI plug-in components are responsible for providing and consuming services. By providing a service, a component is making available a function or functions that can be consumed by other components (or even itself). Such functions are modeled as WSDL 2.0 operations, which involve the exchange of one or more messages. A set of four WSDL-defined, basic message exchange patterns (MEPs) crisply defines the sequence of messages allowed during execution of an operation. This shared understanding, between consumer and provider components, of the message exchange pattern is the foundation of interoperability of such components in JBI.</P>
+
+<P>The services provided by components (if any) are described to JBI by the component, using WSDL 1.1 or 2.0. This provides an abstract, technology-neutral model of services using XML-based message exchanges. WSDL also provides a mechanism for declaring additional service metadata of interest to service consumers and JBI itself. Components can query JBI for the for the WSDL describing available services.</P></TD>
+<TD class="confluenceTd" valign="top">
+<DIV class="panel" style="border-style: solid; border-color: #ccc; "><DIV class="panelHeader" style="border-bottom-style: solid; border-bottom-color: #ccc; background-color: #ffffff; "><B>JBI plugin framework</B></DIV><DIV class="panelContent" style="background-color: #ffffff; ">
+<P><DIV align="center"><IMG src="5-jbi.data/jbi_plugin_framework.png" border="0"></DIV></P>
+</DIV></DIV>
+<DIV class="panel" style="border-style: solid; border-color: #ccc; "><DIV class="panelHeader" style="border-bottom-style: solid; border-bottom-color: #ccc; background-color: #ffffff; "><B>JBI decoupling</B></DIV><DIV class="panelContent" style="background-color: #ffffff; ">
+<P><DIV align="center"><IMG src="5-jbi.data/jbi_decoupling.jpg" border="0"></DIV></P>
+</DIV></DIV></TD></TR></TBODY></TABLE>
+
+<H3><A name="5.JBI-JBIArchitecture"></A>JBI Architecture</H3>
+
+<TABLE class="sectionMacro" border="0" cellpadding="5" cellspacing="0" width="100%"><TBODY><TR>
+<TD class="confluenceTd" valign="top">
+<P>This picture describes the architecture of the JBI system.</P>
+<UL>
+ <LI>The JBI environment provides deployment, control & monitoring features through JMX based administration tools</LI>
+ <LI>The Normalized Message Router or NMR, which provides the mediated message exchange infrastructure</LI>
+ <LI>Components (in white rectangles)</LI>
+</UL>
+
+
+<P>Components are divided in two categories:</P>
+<UL>
+ <LI>Service Engines (on top) provides business logic and transformation services and also consumes such services.</LI>
+ <LI>Binding Components provide connectivity to services external to the JBI environment.<BR>
+Service engines and binding components can function as service providers, consumers, or both. Note that the distinction between SEs and BCs is purely pragmatic, but the separation of business logic from communications logic reduces complexity and increases flexibility.</LI>
+</UL>
+
+
+<P>The JBI environment, in addition to the messaging system, defines a management structure based on JMX which provides standard mechanisms for:</P>
+<UL>
+ <LI>Installing components</LI>
+ <LI>Managing a component's life cycle (start / stop)</LI>
+ <LI>Deploying service artifacts to components<BR>
+JBI components often function as a type of container to which artifacts can be deployed to add new service or provider logic. For example, a service engine that provides XSLT-based transformation services would have XSLT style sheets deployed to it, in order to add new transformation operations. This process of adding such component-specific artifacts to an installed component is called deployment, to distinguish it from component installation. Such an artifact is called a service unit, while collection of deployment artifacts and associated metadata is called a service assembly.</LI>
+</UL>
+
+
+<P>The core message exchange concept implements WSDL messaging. Service requests are generated by consumer components, routed by the NMR, and delivered to a provider component. For example, the BPEL SE may generate a request, which happens to be provided by the external service provider connected to the WS-I BC. The NMR will route the request to the WS-I binding. The SE in this case is a service consumer, and the BC a provider.</P></TD>
+<TD class="confluenceTd" valign="top">
+<DIV class="panel" style="border-style: solid; border-color: #ccc; "><DIV class="panelHeader" style="border-bottom-style: solid; border-bottom-color: #ccc; background-color: #ffffff; "><B>JBI Architecture</B></DIV><DIV class="panelContent" style="background-color: #ffffff; ">
+<P><DIV align="center"><IMG src="5-jbi.data/jbi_architecture.jpg" border="0"></DIV></P>
+</DIV></DIV></TD></TR></TBODY></TABLE>
+<P><A href="/confluence/display/SM30UG" title="View ServiceMix 3.0 User Guide space">SM30UG:#top</A></P>
+
+<H2><A name="5.JBI-WSDLmessagingmodel"></A>WSDL messaging model</H2>
+
+<TABLE class="sectionMacro" border="0" cellpadding="5" cellspacing="0" width="100%"><TBODY><TR>
+<TD class="confluenceTd" valign="top">
+<P>JBI models services produced and consumed by components using Web Service Description Language 1.1 or 2.0. When the terminology differs between the two version, the 2.0 one is used. This is mainly the case for the interface and endpoint terms, which are called respectively "port type" and "port" in WSDL 1.1.</P>
+
+<P>WSDL provides a declarative model of message-based services on two levels:</P>
+<UL>
+ <LI>The <A href="/confluence/display/SM30UG" title="View ServiceMix 3.0 User Guide space"><B>abstract model</B></A> defines services without references to a particular protocol or wire encoding</LI>
+ <LI>The <A href="/confluence/display/SM30UG" title="View ServiceMix 3.0 User Guide space"><B>concrete model</B></A> is bound to a particular communication protocol and communications endpoint</LI>
+</UL>
+
+
+<P>JBI uses the abstract service model as the main basis for component interactions. Components play one of two roles in such interactions:</P>
+<UL>
+ <LI><B>Service provider</B>. The component that performs the given service (either directly or as a proxy for an external provider)</LI>
+ <LI><B>Service consumer</B>. The component that invokes a given service (either directly or as a proxy for an external consumer)</LI>
+</UL>
+</TD>
+<TD class="confluenceTd" valign="top">
+<DIV class="panel" style="border-style: solid; border-color: #ccc; "><DIV class="panelHeader" style="border-bottom-style: solid; border-bottom-color: #ccc; background-color: #ffffff; "><B>WSDL Messaging Model</B></DIV><DIV class="panelContent" style="background-color: #ffffff; ">
+<P><DIV align="center"><IMG src="5-jbi.data/jbi_wsdl_messaging_model.jpg" border="0"></DIV></P>
+</DIV></DIV></TD></TR></TBODY></TABLE>
+
+<H3><A name="5.JBI-Abstractmodel"></A>Abstract model</H3>
+
+<P>JBI models services produced and consumed by components using Web Service Description Language 1.1 or 2.0. When the terminology differs between the two version, the 2.0 one is used. This is mainly the case for the interface and endpoint terms, which are called respectively "port type" and "port" in WSDL 1.1.</P>
+
+<P>WSDL service description always include an abstract service model which defines:</P>
+<UL>
+ <LI><B>Message types</B> are defined using XML schema. These can be <B>normal</B> messages (for the expected use of the service) or <B>faults</B> (for abnormal processing conditions).</LI>
+ <LI><B>Operations</B> are interactions with a service defined in terms of normal and optional faults messages between a service consumer and a service provider. An operation is defined by:
+ <UL>
+ <LI>An <B>operation name</B> which is a qualified name</LI>
+ <LI>A <B>Message Exchange Pattern</B> (MEP) that describes the sequence, direction and cardinality of messages sent between the consumer and provider.</LI>
+ <LI><B>Message types</B> for each message in the MEP.</LI>
+ </UL>
+ </LI>
+ <LI><B>Interfaces</B> are collections of related operations. Note that this term is unrelated to the Java Language interface definition. An interface is defined by:
+ <UL>
+ <LI>An <B>interface name</B>: a qualified name identifying the service type globally</LI>
+ <LI>A set of <B>extended interfaces</B>. This is the same concept as in the Java Language. This means a service type may be composed of other service types.</LI>
+ </UL>
+ </LI>
+</UL>
+
+
+<P>JBI uses the abstract service model as the main basis for component interactions. Components play one of two roles in such interactions:</P>
+<UL>
+ <LI><B>Service provider</B>. The component that performs the given service (either directly or as a proxy for an external provider)</LI>
+ <LI><B>Service consumer</B>. The component that invokes a given service (either directly or as a proxy for an external consumer)</LI>
+</UL>
+
+
+<H3><A name="5.JBI-Concretemodel"></A>Concrete model</H3>
+
+<P>Concrete service descriptions in WSDL build upon the abstract service model, supplying information needed to "map" the abstract definition to a particular communications protocol and communications endpoint. JBI bases its component interaction model primarily on the abstract service model, thus giving it the desirable property of being communications protocol neutral. However, to be consistent with the WSDL service model, component interactions need to be defined using WSDL's concrete service model. In JBI this is a very simple model, using the abstract model "as is" wherever possible, thus creating a simple processing model for interacting components.</P>
+
+<P>The concrete service model defines the following items:</P>
+<UL>
+ <LI><B>Binding types</B>. A binding type identifies the type of protocol to which the service is being "bound".</LI>
+ <LI><B>Endpoints</B>. An endpoint designates the communications endpoint information needed by a service consumer to interact with a service provider, using a particular protocol. In JBI endpoints are pro forma; the only protocol used internally is the standard Java-based JBI messaging contracts, which do not involve the use of normal communications protocols at all. An endpoint definition includes the following items that are of interest to JBI:
+ <UL>
+ <LI><B>Endpoint name</B>. This is a simple name, used to designate the endpoint within its service.</LI>
+ <LI><B>Binding type</B>. This associates a binding type with an endpoint.</LI>
+ </UL>
+ </LI>
+ <LI><B>Service</B>. A service is a collection of endpoints that offer access to the same service. A service "implements" a particular service type (interface). A service has the following items:
+ <UL>
+ <LI><B>Service name</B>. A qualified name used to indicate the particular service implementation.</LI>
+ <LI><B>Service type name</B>. The name of the interface implemented by the service.</LI>
+ <LI><B>Endpoints</B>. The service "contains" one or more endpoints, which are the individual endpoints providing access to the concrete service.</LI>
+ </UL>
+ </LI>
+</UL>
+
+
+<P>Note that normally an endpoint is identified by the combination of its service name and its endpoint name. This combination is referred to as the <B>service endpoint</B>.</P>
+
+<P><A href="/confluence/display/SM30UG" title="View ServiceMix 3.0 User Guide space">SM30UG:#top</A></P>
+
+<H2><A name="5.JBI-NormalizedMessageRouter"></A>Normalized Message Router</H2>
+
+<P>The Normalized Message Router (or NMR) receives message exchanges from JBI components and routes them to the appropriate component for processing. This decouples the service producers from consumers and enable additional processing.</P>
+
+<H3><A name="5.JBI-Consumersandproviders"></A>Consumers and providers</H3>
+
+<P>JBI components (Service Engines and Binding Components) can act as a servicemix consumer, provider or both.<BR>
+The provider makes a WSDL-described service available through an endpoint. This service implements a WSDL interface, which is a collection of operations.<BR>
+The consumer can invoke the service by creating a message exchange that invoke a particular operation.<BR>
+Consumers and providers only share the abstract service definition and are thus decoupled, as the consumer does not know the protocol and location of the invoked service.<BR>
+Several services can implement the same WSDL interface so a consumer looking providers of an interface may find more than one endpoint</P>
+
+<H3><A name="5.JBI-Normalizedmessage"></A>Normalized message</H3>
+
+<P>JBI uses the concept of a normalized message for interactions between consumers and providers.<BR>
+A normalized message consists of three parts:</P>
+<UL>
+ <LI>A payload, which is an xml document that conforms to a WSDL message type without any protocol or encoding</LI>
+ <LI>Properties (or metadata) holds extra data associated with the message (security, transactions ...)</LI>
+ <LI>Attachments are arbitrary (non-xml) data that contain a data handler to manipulate them</LI>
+</UL>
+
+
+<H3><A name="5.JBI-DeliveryChannel"></A>Delivery Channel</H3>
+
+<P>A Delivery Channel is a bidirectional asynchronous communication pipes between a component and the NMR.<BR>
+A service consumer uses its delivery channel to initiate a service invocation, while the provider uses its delivery channel to receive such invocations.<BR>
+Each component is provided with a single delivery channel, so the same channel is used for both inbound and outbound communications.</P>
+
+<H3><A name="5.JBI-Endpointactivation"></A>Endpoint activation</H3>
+
+<P>Endpoint activation is the process by which a service provider tells the NMR that it provides services, making them known to the NMR so that it can route service invocations to that service.</P>
+
+<P>The activation is split in two steps"</P>
+<UL>
+ <LI>Declaring a service endpoint (service QName + endpoint name)</LI>
+ <LI>Providing metadata: the component has to provide a WSDL description of the activate endpoint<BR>
+The WSDL description will be used by the NMR to know which interfaces and operations are implemented by the activated endpoint.</LI>
+</UL>
+
+
+<H3><A name="5.JBI-ServiceinvocationandMEP"></A>Service invocation and MEP</H3>
+
+<P>Service invocation refers to an instance of an end-to-end interaction between a service consumer and a service provider.</P>
+
+<P>Four patterns are supported by JBI:</P>
+<UL>
+ <LI><B>In-Only</B>: consumer issues a request to provider with no error (fault) path provided.</LI>
+ <LI><B>Robust-In-Only</B>: consumer issues a request to provider. Provider may respond with a fault if it fails to process request.</LI>
+ <LI><B>In-Out</B>: consumer issues a request to provider, with expectation of response. Provider may respond with a fault if it fails to process request.</LI>
+ <LI><B>In-Optional-Out</B>: consumer issues a request to provider, which may result in a response. Consumer and provider both have the option of generating a fault in response to a message received during the interaction.</LI>
+</UL>
+
+
+<H3><A name="5.JBI-Endpoints"></A>Endpoints</H3>
+
+<P>JBI uses the same concept of endpoints as defined in WSDL 2.0.<BR>
+Endpoints refers to a particular address, accessible by a particular protocol, used to access a particular service.</P>
+
+<P>Endpoints have two distinct types:</P>
+<UL>
+ <LI><B>External endpoints</B> are endpoints outside the JBI environment. They are endpoints exposed by binding component acting as service consumers to expose an internal endpoint for the use of external service consumers</LI>
+ <LI><B>Internal endpoints</B> are exposed by service providers inside the JBI environment. They are accessed using the NMR APIs.</LI>
+</UL>
+
+
+<P>Binding components serve to map between internal and external endpoints. For example, an internal endpoint exposed outside the JBI environment by a binding component is mapped by the BC to an external provider endpoint for the use of external consumers.</P>
+
+<P>In JBI, endpoints are referred to (or addressed) in three distinct ways:</P>
+<UL>
+ <LI><B>Implicitly</B>: the NMR selects the endpoint based on the service type required</LI>
+ <LI><B>Explicitly</B>: a consumer chooses the endpoint based on its own logic and configuration</LI>
+ <LI><B>Dynamically</B>: an endpoint reference (EPR) is used within a message exchange to provide a " call-back" address that the service provider should use to send further message exchanges. EPRs are xml fragment created and resolved by JBI components.</LI>
+</UL>
+
+
+<H2><A name="5.JBI-Invocationexample"></A>Invocation example</H2>
+
+<P>This sequence diagram shows a InOut service invocation between a consumer and a provider.</P>
+<DIV class="panel" style="border-style: solid; border-color: #ccc; "><DIV class="panelHeader" style="border-bottom-style: solid; border-bottom-color: #ccc; background-color: #ffffff; "><B>Invocation example</B></DIV><DIV class="panelContent" style="background-color: #ffffff; ">
+<P><DIV align="center"><IMG src="5-jbi.data/jbi_invocation.jpg" border="0"></DIV></P>
+</DIV></DIV>
+<OL>
+ <LI>The consumer creates an InOut message exchange, populates the "in" message (the request) and send it to the NMR</LI>
+ <LI>The provider component polls the delivery channel for an exchange</LI>
+ <LI>It processes the request, populates the "out" message and send it back to the NMR</LI>
+ <LI>The consumer polls the delivery channel for the response</LI>
+ <LI>It processes the response and mark the exchange as "done"</LI>
+ <LI>The provider receives the "done" status from the delivery channel</LI>
+</OL>
+
+
+<P>This example is an asynchronous invocation, but JBI also handles synchronous calls. In such a case, the consumer call to send would be a sendSync and would block the thread until the response is received. On the provider side, if the provider wish to synchronously deliver the response, the call to send (#3) would block until the consumer acks the response.</P>
+
+<P>When an exchange involves a binding component, either as a consumer or a provider, the same diagram applies. The difference is that the exchange creation would be triggered by an external request (a JMS message, or an HTTP request) before step #1 and send the response after step #4. If the provider is a binding component which proxies a remote service, it would invoke the service between the steps #2 and #3.</P>
+
+<P>People may wonder why there is a need for a "done" status... In JBI, all exchanges are terminated by either a "done" or an "error" status. Errors are different from faults which are parts of the normal exchange processing. So, the done status is very useful to implement reliable message, transactions or passing streams inside the exchange.<BR>
+Let's take the example a file binding component, which would poll for files, send the content as an InOnly request, and delete them afterwards. For performance reasons, it will send an opened stream on the file, but it has to close the stream and delete the file once processed. If the consumer is asynchronous (which is better because it saves threads), it needs a way to know when the file has to be deleted, hence the need for the "done" status.</P>
+
+<P><A href="/confluence/display/SM30UG" title="View ServiceMix 3.0 User Guide space">SM30UG:#top</A></P>
+
+<H2><A name="5.JBI-JBIpackaging"></A>JBI packaging</H2>
+
+<P>JBI defines a standard packaging for installing new components and deploying artifacts onto these components that can function as "containers".<BR>
+All these artifacts contain a JBI descriptor in the META-INF directory called jbi.xml.</P>
+
+<P>We have already discussed some of these artifacts, but let's dive in them a bit more. There are four types of artifacts, all packaged as zip or jar files:</P>
+<UL>
+ <LI><B>Components</B> installers contain the libraries and resources needed to run the component. Components can references Shared Libraries.</LI>
+ <LI><B>Shared Libraries</B> are collection of jars that can be shared by several components</LI>
+ <LI><B>Service Units</B> are artifacts meant to be deploy to a specific component. Aside from the JBI descriptor, the service unit packaging is specific to a component and can take various forms: a single XSLT style sheet, a BPEL process, or some java classes ...</LI>
+ <LI><B>Service assemblies</B> are collections of Service Units. Service units can not be deployed directly and must be packaged in a service assembly which contains the service units and associated metadata.</LI>
+</UL>
+
+
+<P>A service assembly is thus a zip of zips. It can be compared to an EAR in the J2EE world. To ease the pain of packaging the JBI artifacts, ServiceMix provides a powerful maven based tooling which can package all the JBI artifacts and generate their JBI descriptors automatically. To ease the development more, we provide maven archetypes for JBI components and service units: archetypes are templates that can generate a project in one command line (see <A href="notes-on-creating-jbi-component-using-maven2.html" title="Notes on Creating JBI Component using maven2">Notes on Creating JBI Component using maven2</A>).</P>
+
+<P><A href="/confluence/display/SM30UG" title="View ServiceMix 3.0 User Guide space">SM30UG:#top</A></P>
+
+<H2><A name="5.JBI-Othermaterials"></A>Other materials</H2>
+
+<UL>
+ <LI><SPAN class="nobr"><A href="http://jcp.org/en/jsr/detail?id=208" title="Visit page outside Confluence" rel="nofollow">JSR208: Java Business Integration<SUP><IMG class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif" height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN></LI>
+ <LI><SPAN class="nobr"><A href="https://open-esb.dev.java.net/public/pdf/JBI-Components-Theory.pdf" title="Visit page outside Confluence" rel="nofollow">JBI Components: Part 1 (Theory)<SUP><IMG class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif" height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN> by Ron Ten-Hove</LI>
+ <LI><SPAN class="nobr"><A href="https://open-esb.dev.java.net/public/whitepapers/JBIforSOI.pdf" title="Visit page outside Confluence" rel="nofollow">Using JBI for service oriented integration<SUP><IMG class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif" height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN> by Ron Ten-Hove</LI>
+ <LI><SPAN class="nobr"><A href="http://www.theserverside.com/articles/article.tss?l=JBIforSOA" title="Visit page outside Confluence" rel="nofollow">JBI - A Standard-based approach for SOA<SUP><IMG class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif" height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN> by Meeraj Kinnumpurath</LI>
+ <LI>Steve Vinoski's <SPAN class="nobr"><A href="http://dsonline.computer.org/portal/site/dsonline/menuitem.9ed3d9924aeb0dcd82ccc6716bbe36ec/index.jsp?amp%3Bamp%3Bamp%3BpName=dso_level1&%3Bamp%3Bamp%3Bpath=dsonline%2F0507&%3Bamp%3Bamp%3Bfile=w4tow.xml&%3Bamp%3Bamp%3Bxsl=article.xsl&%3Bamp%3Bamp%3B" title="Visit page outside Confluence" rel="nofollow">JBI article<SUP><IMG class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif" height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN></LI>
+ <LI>Frank Summer's <SPAN class="nobr"><A href="http://www.artima.com/lejava/articles/jbi2.html" title="Visit page outside Confluence" rel="nofollow">SOA JBI<SUP><IMG class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif" height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN></LI>
+ <LI><SPAN class="nobr"><A href="http://www.webservices.org/weblog/warren_buckley/jbi_the_only_game_in_town" title="Visit page outside Confluence" rel="nofollow">JBI - the only game in town<SUP><IMG class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif" height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN></LI>
+ <LI>Carlos's <SPAN class="nobr"><A href="http://www.manageability.org/blog/stuff/jbi-containers" title="Visit page outside Confluence" rel="nofollow">blog post<SUP><IMG class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif" height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN> on JBI</LI>
+ <LI>JBI gains Industry support <SPAN class="nobr"><A href="http://www.ebizq.net/topics/dev_tools/features/6188.html" title="Visit page outside Confluence" rel="nofollow">EbizQ<SUP><IMG class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif" height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN></LI>
+ <LI><SPAN class="nobr"><A href="http://java.sun.com/integration/" title="Visit page outside Confluence" rel="nofollow">Sun's JBI site<SUP><IMG class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif" height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN></LI>
+ <LI><SPAN class="nobr"><A href="http://www.chwlund.com/" title="Visit page outside Confluence" rel="nofollow">Carl-Henrik Wolf Lund<SUP><IMG class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif" height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN> created a (Norwegian) <SPAN class="nobr"><A href="http://www.chwlund.com/?p=56" title="Visit page outside Confluence" rel="nofollow">presentation on JBI<SUP><IMG class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif" height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN></LI>
+ <LI><SPAN class="nobr"><A href="http://azur.typepad.com/bpel/2005/12/sca_jbi_and_mor.html" title="Visit page outside Confluence" rel="nofollow">SCA, JBI and more..<SUP><IMG class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif" height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN> which echos our <SPAN class="nobr"><A href="http://goopen.org/confluence/pages/createpage.action?spaceKey=SM30UG&title=How%20does%20ServiceMix%20compare%20to%20Tuscany%20or%20SCA" title="Create Page in space SM30UG: How does ServiceMix compare to Tuscany or SCA" class="createlink">FAQ entry<SUP><IMG class="rendericon" src="http://goopen.org/confluence/images/icons/plus.gif" height="7" width="7" align="absmiddle" alt="" border="0"></SUP></A></SPAN></LI>
+ <LI><SPAN class="nobr"><A href="http://dx.doi.org/10.1571/PSGP7-14-05CC" title="Visit page outside Confluence" rel="nofollow">Java Business Integration (JBI) Gains Industry Support<SUP><IMG class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif" height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN> by Patricia Seybold Group</LI>
+</UL>
+
+
+<P><A href="/confluence/display/SM30UG" title="View ServiceMix 3.0 User Guide space">SM30UG:#top</A></P>
+<STYLE type="text/css">/*<![CDATA[*/
+table.ScrollbarTable {border: none;padding: 3px;width: 100%;padding: 3px;margin: 0px;background-color: #f0f0f0}
+table.ScrollbarTable td.ScrollbarPrevIcon {text-align: center;width: 16px;border: none;}
+table.ScrollbarTable td.ScrollbarPrevName {text-align: left;border: none;}
+table.ScrollbarTable td.ScrollbarParent {text-align: center;border: none;}
+table.ScrollbarTable td.ScrollbarNextName {text-align: right;border: none;}
+table.ScrollbarTable td.ScrollbarNextIcon {text-align: center;width: 16px;border: none;}
+
+/*]]>*/</STYLE><DIV class="Scrollbar"><TABLE class="ScrollbarTable"><TR><TD class="ScrollbarPrevIcon"><A href="../SM30UG/4-examples.html"><IMG border="0" align="middle" src="http://goopen.org/confluence/images/icons/back_16.gif" width="16" height="16"></A></TD><TD width="33%" class="ScrollbarPrevName"><A href="../SM30UG/4-examples.html">4. Examples</A> </TD><TD width="33%" class="ScrollbarParent"><SUP><A href="users-guide.html"><IMG border="0" align="middle" src="http://goopen.org/confluence/images/icons/up_16.gif" width="8" height="8"></A></SUP><A href="users-guide.html">User's Guide</A></TD><TD width="33%" class="ScrollbarNextName"> <A href="6-configuring-servicemix.html">6. Configuring ServiceMix</A></TD><TD class="ScrollbarNextIcon"><A href="6-configuring-servicemix.html"><IMG border="0" align="middle" src="http://goopen.org/confluence/images/icons/forwd_16.gif" width="16" height="16"></A></TD></TR></TABLE></DIV></DIV>
+
+ </DIV>
+ </TD>
+ </TR>
+ </TABLE>
+ </DIV>
+ </DIV>
+ <DIV id="site-footer">
+ Added by <A href="http://goopen.org/confluence/users/viewuserprofile.action?username=gnodet">Guillaume Nodet</A>,
+ last edited by <A href="http://goopen.org/confluence/users/viewuserprofile.action?username=gnodet">Guillaume Nodet</A> on Nov 08, 2006
+ (<A href="http://goopen.org/confluence/pages/diffpages.action?pageId=13491&originalId=14627">view change</A>)
+ <SPAN id="show" class="inline-control-link"><A href="" onclick="showComment(); return false;">show comment</A></SPAN>
+ <SPAN id="hide" class="inline-control-link" style="display:none;"><A href="" onclick="hideComment(); return false;">hide comment</A></SPAN>
+ <DIV id="versionComment" class="noteMacro" style="display:none; padding: 5px;">
+ <B>Comment:</B>
+ INS link to further reading<BR>
+ <SPAN class="smalltext"><A href="http://goopen.org/confluence/pages/viewpreviouspageversions.action?pageId=13491">View page history</A></SPAN>
+ </DIV>
+
+ <SCRIPT>
+ var show = document.getElementById('show');
+ var hide = document.getElementById('hide');
+ var versionComment = document.getElementById('versionComment');
+
+ function showComment(){
+ show.style.display = 'none';
+ hide.style.display = 'inline';
+ versionComment.style.display = 'block';
+ }
+
+ function hideComment(){
+ show.style.display = 'inline';
+ hide.style.display = 'none';
+ versionComment.style.display = 'none';
+ }
+
+ </SCRIPT>
+
+ (<A href="http://goopen.org/confluence/pages/editpage.action?pageId=13491">edit page</A>)
+ </DIV>
+
+ </BODY>
+
+</HTML>
\ No newline at end of file