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/09/07 16:16:48 UTC
svn commit: r441090 [1/4] - in /incubator/servicemix/site/sm30ug: ./
5-jbi.data/ basic.data/ file-binding.data/ resources/ rss-binding.data/
Author: chirino
Date: Thu Sep 7 07:16:46 2006
New Revision: 441090
URL: http://svn.apache.org/viewvc?view=rev&rev=441090
Log:
Latest export from confluence
Added:
incubator/servicemix/site/sm30ug/0-disclaimer.html
incubator/servicemix/site/sm30ug/1-quick-start.html
incubator/servicemix/site/sm30ug/2-introduction.html
incubator/servicemix/site/sm30ug/3-installation.html
incubator/servicemix/site/sm30ug/4-examples.html
incubator/servicemix/site/sm30ug/5-jbi.data/
incubator/servicemix/site/sm30ug/5-jbi.data/jbi_architecture.jpg (with props)
incubator/servicemix/site/sm30ug/5-jbi.data/jbi_architecture.jpg.jpeg (with props)
incubator/servicemix/site/sm30ug/5-jbi.data/jbi_decoupling.jpg (with props)
incubator/servicemix/site/sm30ug/5-jbi.data/jbi_decoupling.jpg.jpeg (with props)
incubator/servicemix/site/sm30ug/5-jbi.data/jbi_invocation.jpg (with props)
incubator/servicemix/site/sm30ug/5-jbi.data/jbi_invocation.jpg.jpeg (with props)
incubator/servicemix/site/sm30ug/5-jbi.data/jbi_plugin_framework.png (with props)
incubator/servicemix/site/sm30ug/5-jbi.data/jbi_plugin_framework.png.jpeg (with props)
incubator/servicemix/site/sm30ug/5-jbi.data/jbi_wsdl_messaging_model.jpg (with props)
incubator/servicemix/site/sm30ug/5-jbi.data/jbi_wsdl_messaging_model.jpg.jpeg (with props)
incubator/servicemix/site/sm30ug/5-jbi.html
incubator/servicemix/site/sm30ug/basic.data/
incubator/servicemix/site/sm30ug/basic.data/basicflow1.jpg (with props)
incubator/servicemix/site/sm30ug/basic.data/basicflow1.jpg.jpeg (with props)
incubator/servicemix/site/sm30ug/basic.data/basicflow_as_usecase.jpg (with props)
incubator/servicemix/site/sm30ug/basic.data/basicflow_as_usecase.jpg.jpeg (with props)
incubator/servicemix/site/sm30ug/basic.html
incubator/servicemix/site/sm30ug/bridge.html
incubator/servicemix/site/sm30ug/file-binding.data/
incubator/servicemix/site/sm30ug/file-binding.data/filebinding_as_usecase.jpg (with props)
incubator/servicemix/site/sm30ug/file-binding.data/filebinding_as_usecase.jpg.jpeg (with props)
incubator/servicemix/site/sm30ug/file-binding.data/filebindingexample.jpg (with props)
incubator/servicemix/site/sm30ug/file-binding.data/filebindingexample.jpg.jpeg (with props)
incubator/servicemix/site/sm30ug/file-binding.html
incubator/servicemix/site/sm30ug/loan-broker-bpel.html
incubator/servicemix/site/sm30ug/loan-broker.html
incubator/servicemix/site/sm30ug/resources/
incubator/servicemix/site/sm30ug/resources/space.css
incubator/servicemix/site/sm30ug/rss-binding.data/
incubator/servicemix/site/sm30ug/rss-binding.data/rssflow.jpg (with props)
incubator/servicemix/site/sm30ug/rss-binding.data/rssflow.jpg.jpeg (with props)
incubator/servicemix/site/sm30ug/rss-binding.data/usecase_for_rss.jpg (with props)
incubator/servicemix/site/sm30ug/rss-binding.data/usecase_for_rss.jpg.jpeg (with props)
incubator/servicemix/site/sm30ug/rss-binding.html
incubator/servicemix/site/sm30ug/users-guide.html
incubator/servicemix/site/sm30ug/vfs-binding.html
incubator/servicemix/site/sm30ug/wsdl-first.html
Added: incubator/servicemix/site/sm30ug/0-disclaimer.html
URL: http://svn.apache.org/viewvc/incubator/servicemix/site/sm30ug/0-disclaimer.html?view=auto&rev=441090
==============================================================================
--- incubator/servicemix/site/sm30ug/0-disclaimer.html (added)
+++ incubator/servicemix/site/sm30ug/0-disclaimer.html Thu Sep 7 07:16:46 2006
@@ -0,0 +1,97 @@
+
+<!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:///SM30UG/resources/space.css">
+-->
+ <LINK type="text/css" rel="stylesheet" href="resources/site.css">
+ <SCRIPT src="resources/space.js" type="text/javascript"></SCRIPT>
+ <TITLE>
+0. Disclaimer
+ </TITLE>
+ <META http-equiv="Content-Type" content="text/html;charset=UTF-8"></HEAD>
+ <BODY onload="init()">
+
+ <!-- Banner -->
+ <DIV id="site-banner">
+ </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="users-guide.html" title="ServiceMix 3.0 User Guide">ServiceMix 3.0 User Guide</A> > <A href="users-guide.html" title="User's Guide">User's Guide</A> > <A href="" title="0. Disclaimer">0. Disclaimer</A>
+ </DIV>
+ </TD>
+ <TD align="right" valign="middle" nowrap="">
+ <DIV id="site-quicklinks">
+ </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">
+ </DIV>
+ </TD>
+ <TD valign="top">
+ <DIV id="site-page">
+
+<!--
+ <div class="pagetitle">0. Disclaimer</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 width="33%" class="ScrollbarPrevName"> </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="1-quick-start.html">1. Quick start</A></TD><TD class="ScrollbarNextIcon"><A href="1-quick-start.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="0.Disclaimer-top"></A></P>
+
+<H1><A name="0.Disclaimer-0.Disclaimer"></A>0. Disclaimer</H1>
+
+<P>Apache ServiceMix is an effort undergoing incubation at the Apache Software Foundation (ASF), sponsored by the Geronimo PMC.<BR>
+Incubation is required of all newly accepted projects until a further review indicates that the infrastructure,<BR>
+communications, and decision making process have stabilized in a manner consistent with other successful ASF projects.</P>
+
+<P>While incubation status is not necessarily a reflection of the completeness or stability of the code, it does<BR>
+indicate that the project has yet to be fully endorsed by the ASF.</P></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 Sep 06, 2006
+
+ (<A href="http://goopen.org/confluence/pages/editpage.action?pageId=13486">edit page</A>)
+ </DIV>
+
+ </BODY>
+
+</HTML>
\ No newline at end of file
Added: incubator/servicemix/site/sm30ug/1-quick-start.html
URL: http://svn.apache.org/viewvc/incubator/servicemix/site/sm30ug/1-quick-start.html?view=auto&rev=441090
==============================================================================
--- incubator/servicemix/site/sm30ug/1-quick-start.html (added)
+++ incubator/servicemix/site/sm30ug/1-quick-start.html Thu Sep 7 07:16:46 2006
@@ -0,0 +1,222 @@
+
+<!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:///SM30UG/resources/space.css">
+-->
+ <LINK type="text/css" rel="stylesheet" href="resources/site.css">
+ <SCRIPT src="resources/space.js" type="text/javascript"></SCRIPT>
+ <TITLE>
+1. Quick start
+ </TITLE>
+ <META http-equiv="Content-Type" content="text/html;charset=UTF-8"></HEAD>
+ <BODY onload="init()">
+
+ <!-- Banner -->
+ <DIV id="site-banner">
+ </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="users-guide.html" title="ServiceMix 3.0 User Guide">ServiceMix 3.0 User Guide</A> > <A href="users-guide.html" title="User's Guide">User's Guide</A> > <A href="" title="1. Quick start">1. Quick start</A>
+ </DIV>
+ </TD>
+ <TD align="right" valign="middle" nowrap="">
+ <DIV id="site-quicklinks">
+ </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">
+ </DIV>
+ </TD>
+ <TD valign="top">
+ <DIV id="site-page">
+
+<!--
+ <div class="pagetitle">1. Quick start</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="0-disclaimer.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="0-disclaimer.html">0. Disclaimer</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="2-introduction.html">2. Introduction</A></TD><TD class="ScrollbarNextIcon"><A href="2-introduction.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="1.Quickstart-top"></A></P>
+
+<H1><A name="1.Quickstart-1.Quickstart"></A>1. Quick start</H1>
+
+<P>If you are in a hurry to have Apache ServiceMix up and running right away, this article will provide you with some basic steps for downloading, building (when needed) and run the server in no time. This is clearly not a complete guide so you may want to check the other links in the <A href="users-guide.html" title="User's Guide">Apache ServiceMix v3.0 - User's Guide</A> main section for further information.</P>
+
+<P>All you need is 5 to 10 minutes and to follow these basic steps.</P>
+<UL>
+ <LI><A href="#1.Quickstart-Background" title="Background on 1. Quick start">Background</A></LI>
+ <LI><A href="#1.Quickstart-Gettingthesoftware" title="Getting the software on 1. Quick start">Getting the software</A></LI>
+ <LI><A href="#1.Quickstart-Starttheserver" title="Start the server on 1. Quick start">Start the server</A></LI>
+ <LI><A href="#1.Quickstart-Deployasampleapplication" title="Deploy a sample application on 1. Quick start">Deploy a sample application</A></LI>
+</UL>
+
+
+<H2><A name="1.Quickstart-Background"></A>Background</H2>
+
+<P>Apache ServiceMix is a JBI implementation that is completely opensource and under the Apache License. ServiceMix v3.0 is the first official release of the JBI container by the Apache Software Foundation.</P>
+
+<P><A href="#1.Quickstart-top" title="top on 1. Quick start">top</A></P>
+
+<H2><A name="1.Quickstart-Gettingthesoftware"></A>Getting the software</H2>
+
+<P>At this time you have one option to get the software. The fastest and easiest way is to get the binary directly from the Apache site. Since this article is intended to help you to have Apache ServiceMix up and running in the fastest way only the binary download will be covered at this time.</P>
+
+<H3><A name="1.Quickstart-Prerequisites"></A>Prerequisites</H3>
+
+<P>Although this installation path is the fastest one, still you will need to install some software before installing ServiceMix.</P>
+
+<H4><A name="1.Quickstart-J2SE1.5"></A>J2SE 1.5</H4>
+
+<P>ServiceMix requires a Java 5 environment to run.<BR>
+Refer to the following URL for details on how to download and install J2SE 1.5: <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>.</P>
+
+<H3><A name="1.Quickstart-Downloadbinaries"></A>Download binaries</H3>
+
+<P>Depending on the platform you plan to install and run Apache ServiceMix you will select the appropriate installation image. Open a Web browser and access the following URL, there you will find the available packages for download (binaries and source code).</P>
+
+<P><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></P>
+
+<P>Select the file compression format compatible with your system (zip, tar.gz) by clicking directly on the link, download it and expand the binary to your hard drive in a new directory. For example in <TT>z:/servicemix</TT>, from now on this directory will be referenced as <servicemix_home>.</P>
+
+<P>The installation of Apache ServiceMix is as simple as uncompressing the .zip or .tar files. The next step is to start the server.</P>
+
+<P><A href="#1.Quickstart-top" title="top on 1. Quick start">top</A></P>
+
+<H2><A name="1.Quickstart-Starttheserver"></A>Start the server</H2>
+
+<P>With Apache ServiceMix already installed, open a command line console and change directory to <B><servicemix_home></B>.<BR>
+To start the server, run the following command:</P>
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-java">bin/servicemix</PRE>
+</DIV></DIV>
+<P>Once the server is started, you should see the following informations on the command line console:</P>
+<DIV class="preformatted" style="border-style: solid; "><DIV class="preformattedContent">
+<PRE>Starting Apache ServiceMix ESB: 3.0-incubating-SNAPSHOT
+
+Loading Apache ServiceMix from servicemix.xml on the CLASSPATH
+INFO - JBIContainer - ServiceMix 3.0-incubating-SNAPSHOT JBI Container (ServiceMix) is starting
+INFO - JBIContainer - For help or more informations please see: http://incubator.apache.org/servicemix/
+INFO - ComponentMBeanImpl - Initializing component: #SubscriptionManager#
+INFO - DeploymentService - Restoring service assemblies
+INFO - JBIContainer - ServiceMix JBI Container (ServiceMix) started
+</PRE>
+</DIV></DIV>
+<P>At this point, you have Apache ServiceMix up and running and the time spent has been minimal. The following section will propose to deploy one of the sample application.</P>
+
+<P><A href="#1.Quickstart-top" title="top on 1. Quick start">top</A></P>
+
+<H2><A name="1.Quickstart-Deployasampleapplication"></A>Deploy a sample application</H2>
+
+<P>While you will lear in the remaining of this guide how to create and package a JBI application, we will just use a pre-built packaging for now.</P>
+
+<P>Open another command line console in the <B><servicemix_home></B> directory and run the following commands.</P>
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-java">cp components/servicemix-shared-*.zip install
+cp components/servicemix-http-*.zip install
+cp components/servicemix-jsr181-*.zip install
+cp examples/wsdl-first/wsdl-first-sa-*.zip deploy</PRE>
+</DIV></DIV>
+<P>These commands will:</P>
+<UL>
+ <LI>install the servicemix-shared Shared Library</LI>
+ <LI>install the servicemix-http and servicemix-jsr181 JBI components</LI>
+ <LI>deploy a JBI Service Assembly which expose a service over HTTP/SOAP</LI>
+</UL>
+
+
+<P>You should see the following on the command line console:</P>
+<DIV class="preformatted" style="border-style: solid; "><DIV class="preformattedContent">
+<PRE>INFO - AutoDeploymentService - Directory: install: Archive changed: processing servicemix-shared-3.0-incubating-SNAPSHOT-installer.zip ...
+INFO - AutoDeploymentService - Directory: install: Finished installation of archive: servicemix-shared-3.0-incubating-SNAPSHOT-installer.zip
+INFO - AutoDeploymentService - Directory: install: Archive changed: processing servicemix-http-3.0-incubating-SNAPSHOT-installer.zip ...
+INFO - jetty - Logging to org.apache.servicemix.http.jetty.JCLLogger@12ef4c6 via org.apache.servicemix.http.jetty.JCLLogger
+INFO - ComponentMBeanImpl - Starting component: servicemix-http
+INFO - ComponentMBeanImpl - Initializing component: servicemix-http
+INFO - AutoDeploymentService - Directory: install: Finished installation of archive: servicemix-http-3.0-incubating-SNAPSHOT-installer.zip
+INFO - AutoDeploymentService - Directory: install: Archive changed: processing servicemix-jsr181-3.0-incubating-SNAPSHOT-installer.zip ...
+INFO - ComponentMBeanImpl - Starting component: servicemix-jsr181
+INFO - ComponentMBeanImpl - Initializing component: servicemix-jsr181
+INFO - AutoDeploymentService - Directory: install: Finished installation of archive: servicemix-jsr181-3.0-incubating-SNAPSHOT-installer.zip
+INFO - AutoDeploymentService - Directory: deploy: Archive changed: processing wsdl-first-sa-3.0-incubating-SNAPSHOT.zip ...
+INFO - ServiceAssemblyLifeCycle - Starting service assembly: wsdl-first-sa
+INFO - ServiceUnitLifeCycle - Initializing service unit: wsdl-first-jsr181-su
+INFO - ServiceUnitLifeCycle - Initializing service unit: wsdl-first-http-su
+INFO - ServiceUnitLifeCycle - Starting service unit: wsdl-first-jsr181-su
+INFO - ServiceUnitLifeCycle - Starting service unit: wsdl-first-http-su
+INFO - jetty - jetty-6.0.0rc2
+INFO - jetty - Started SelectChannelConnector @ localhost:8192
+INFO - AutoDeploymentService - Directory: deploy: Finished installation of archive: wsdl-first-sa-3.0-incubating-SNAPSHOT.zip
+</PRE>
+</DIV></DIV>
+<P>Now, open a web broser to the following location:</P>
+
+<P><SPAN class="nobr"><A href="http://localhost:8192/PersonService/main.wsdl" title="Visit page outside Confluence" rel="nofollow">http://localhost:8192/PersonService/main.wsdl<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></P>
+
+<P>You should see the WSDL of the web service that have just deployed !</P>
+
+<P><A href="#1.Quickstart-top" title="top on 1. Quick start">top</A></P>
+
+<H2><A name="1.Quickstart-Summary"></A>Summary</H2>
+
+<P>This article showed you how simple is to have Apache Servicemix up and running. The overall time for getting the server running should be less than five minutes if you have the prerequisite (Java 1.5) already installed. Additionally, this article also showed you how to deploy and test a simple Web Service in less than five minutes.</P>
+
+<P><A href="#1.Quickstart-top" title="top on 1. Quick start">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="0-disclaimer.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="0-disclaimer.html">0. Disclaimer</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="2-introduction.html">2. Introduction</A></TD><TD class="ScrollbarNextIcon"><A href="2-introduction.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 Sep 06, 2006
+ (<A href="http://goopen.org/confluence/pages/diffpages.action?pageId=13487&originalId=13509">view change</A>)
+
+ (<A href="http://goopen.org/confluence/pages/editpage.action?pageId=13487">edit page</A>)
+ </DIV>
+
+ </BODY>
+
+</HTML>
\ No newline at end of file
Added: incubator/servicemix/site/sm30ug/2-introduction.html
URL: http://svn.apache.org/viewvc/incubator/servicemix/site/sm30ug/2-introduction.html?view=auto&rev=441090
==============================================================================
--- incubator/servicemix/site/sm30ug/2-introduction.html (added)
+++ incubator/servicemix/site/sm30ug/2-introduction.html Thu Sep 7 07:16:46 2006
@@ -0,0 +1,243 @@
+
+<!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:///SM30UG/resources/space.css">
+-->
+ <LINK type="text/css" rel="stylesheet" href="resources/site.css">
+ <SCRIPT src="resources/space.js" type="text/javascript"></SCRIPT>
+ <TITLE>
+2. Introduction
+ </TITLE>
+ <META http-equiv="Content-Type" content="text/html;charset=UTF-8"></HEAD>
+ <BODY onload="init()">
+
+ <!-- Banner -->
+ <DIV id="site-banner">
+ </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="users-guide.html" title="ServiceMix 3.0 User Guide">ServiceMix 3.0 User Guide</A> > <A href="users-guide.html" title="User's Guide">User's Guide</A> > <A href="" title="2. Introduction">2. Introduction</A>
+ </DIV>
+ </TD>
+ <TD align="right" valign="middle" nowrap="">
+ <DIV id="site-quicklinks">
+ </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">
+ </DIV>
+ </TD>
+ <TD valign="top">
+ <DIV id="site-page">
+
+<!--
+ <div class="pagetitle">2. Introduction</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="1-quick-start.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="1-quick-start.html">1. Quick start</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="3-installation.html">3. Installation</A></TD><TD class="ScrollbarNextIcon"><A href="3-installation.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="2.Introduction-top"></A></P>
+
+<H1><A name="2.Introduction-2.Introduction"></A>2. Introduction</H1>
+
+<DIV>
+<UL>
+ <LI><A href="#2.Introduction-IntroductiontoESB">Introduction to ESB</A>
+<UL>
+ <LI><A href="#2.Introduction-TheProblem">The Problem</A></LI>
+ <LI><A href="#2.Introduction-TheESBApproach">The ESB Approach</A></LI>
+ <LI><A href="#2.Introduction-WhatisJavaBusinessIntegration%2528JBI%2529%253F">What is Java Business Integration (JBI)?</A></LI>
+ <LI><A href="#2.Introduction-WhyServiceMix">Why ServiceMix</A></LI>
+</UL></LI>
+ <LI><A href="#2.Introduction-BackgroundtoServiceMix">Background to ServiceMix</A>
+<UL>
+ <LI><A href="#2.Introduction-Background">Background</A></LI>
+ <LI><A href="#2.Introduction-CharacteristicsofanAgileESB">Characteristics of an Agile ESB</A>
+<UL>
+ <LI><A href="#2.Introduction-Standardsbased">Standards based</A></LI>
+ <LI><A href="#2.Introduction-Flexible">Flexible</A></LI>
+ <LI><A href="#2.Introduction-Reliable">Reliable</A></LI>
+ <LI><A href="#2.Introduction-BreadthofConnectivity">Breadth of Connectivity</A></LI>
+</UL></LI>
+ <LI><A href="#2.Introduction-Conclusion">Conclusion</A></LI>
+</UL></LI>
+ <LI><A href="#2.Introduction-FeaturesOverview">Features Overview</A></LI>
+</UL></DIV>
+
+<H2><A name="2.Introduction-IntroductiontoESB"></A>Introduction to ESB</H2>
+
+<P>This document introduces the general concept of an Enterprise Service Bus (ESB) and the Java Business Integration (JBI) specification, followed by a discussion of ServiceMix, an open source ESB implementation based on the JBI standard <SPAN class="nobr"><A href="http://www.jcp.org/en/jsr/detail?id=208" title="Visit page outside Confluence" rel="nofollow">JSR 208<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>.</P>
+
+<H3><A name="2.Introduction-TheProblem"></A>The Problem</H3>
+
+<P>Enterprise networks commonly deploy disparate applications, platforms, and business processes that need to communicate or exchange data with each other. The applications, platforms and processes have non-compatible data formats and non-compatible communications protocols. If an enterprise needs to interface with external systems, the integration problem extends outside of a company, encompassing its business partners' IT systems and processes as well.</P>
+
+<P>In recent years, there have been several technologies attempting to solve these problems such as Enterprise Applicaton Integration <SPAN class="nobr"><A href="http://goopen.org/confluence/pages/createpage.action?spaceKey=SM30UG&title=Glossary&linkCreation=true&fromPageId=13488" title="Create Page: Glossary" class="createlink">(EAI)<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>, Business-to-Business <SPAN class="nobr"><A href="http://goopen.org/confluence/pages/createpage.action?spaceKey=SM30UG&title=Glossary&linkCreation=true&fromPageId=13488" title="Create Page: Glossary" class="createlink">(B2B)<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>, Service Oriented Architecture (<SPAN class="nobr"><A href="http://goopen.org/confluence/pages/createpage.a
ction?spaceKey=SM30UG&title=Glossary&linkCreation=true&fromPageId=13488" title="Create Page: Glossary" class="createlink">SOA)<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>, and <SPAN class="nobr"><A href="http://goopen.org/confluence/pages/createpage.action?spaceKey=SM30UG&title=Glossary&linkCreation=true&fromPageId=13488" title="Create Page: Glossary" class="createlink">Web Services<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>. These solutions addressed some of the integration problems, but were proprietary, expensive, and time-consuming to implement. These solutions range from expensive vendor solutions (high cost, vendor lock-in) to home-grown custom solutions (high maintenance, high cost). The overwhelming disadvantages of these solutions are hi
gh cost and low flexibility due to non-standard implementations.</P>
+
+<H3><A name="2.Introduction-TheESBApproach"></A>The ESB Approach</H3>
+
+<P>A standards-based ESB solves the integration problem without the drawbacks of the other solutions. The purpose of an ESB is to facilitate application and process integration by providing distributed processing, intelligent <SPAN class="nobr"><A href="http://goopen.org/confluence/pages/createpage.action?spaceKey=SM30UG&title=Glossary&linkCreation=true&fromPageId=13488" title="Create Page: Glossary" class="createlink">routing<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>, security, and dynamic data <SPAN class="nobr"><A href="http://goopen.org/confluence/pages/createpage.action?spaceKey=SM30UG&title=Glossary&linkCreation=true&fromPageId=13488" title="Create Page: Glossary" class="createlink">transformation<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
>. In an ESB these services are infrastructure services so each application does not have to implement these requirements independently and in a proprietary manner.</P>
+
+<P>The ESB addresses the disadvantages of existing solutions by creating a standard infrastructure for integration. Point-to-point solutions, where each of <EM>n</EM> components requires <EM>n</EM>-1 interfaces for full communication, are replaced by a bus solution where each component requires a single interface to the bus for global communication. An ESB provides distributed messaging, routing, business process orchestration, reliability and security. It also provides pluggable services and, because of the standard bus, these pluggable services can be provided by third parties and still interoperate reliably with the bus.</P>
+
+<P>Attributes of an ESB integration infrastructure are:</P>
+<OL>
+ <LI>distributed - to remove geographical constraints</LI>
+ <LI>message-based - to promote loose coupling</LI>
+ <LI>open standards-based - to preserve investment and encourage partipicipation</LI>
+ <LI>reliable - to meet the requirements of mission-critical business operations</LI>
+</OL>
+
+
+<P>As an integration infrastructure, the ESB provides a number of functions including:</P>
+<OL>
+ <LI>routing</LI>
+ <LI>transformation</LI>
+ <LI>visibility - into messages for content-based routing</LI>
+</OL>
+
+
+<P>An ESB also supports requirements such as security, <SPAN class="nobr"><A href="http://goopen.org/confluence/pages/createpage.action?spaceKey=SM30UG&title=Glossary&linkCreation=true&fromPageId=13488" title="Create Page: Glossary" class="createlink">orchestration<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>, and <SPAN class="nobr"><A href="http://goopen.org/confluence/pages/createpage.action?spaceKey=SM30UG&title=Glossary&linkCreation=true&fromPageId=13488" title="Create Page: Glossary" class="createlink">transactionality<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>. These exist in "hard-wired" integration methods, but are not available automatically in a service-oriented architecture. One of the key requirements for the ESB is to give l
oosely coupled, service-based integration methods a level of enterprise-class reliability and security.</P>
+
+<P>A newer requirement for ESBs is the ability to allow not only loosely-coupled requests found in a service oriented architecture, but also to provide the infrastructure for an Event Driven Architecture <SPAN class="nobr"><A href="http://goopen.org/confluence/pages/createpage.action?spaceKey=SM30UG&title=Glossary&linkCreation=true&fromPageId=13488" title="Create Page: Glossary" class="createlink">(EDA)<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>. SOA and EDA provide complementary functionality. In EDA an event triggers a message to be sent to other applications that are decoupled from the application that triggered the event. This is an asynchronous operation as the recipient applications may receive or pick-up their messages at a later time, whereas the SOA messaging model is typically synchronous in nature.</P>
+
+<H3><A name="2.Introduction-WhatisJavaBusinessIntegration%28JBI%29%3F"></A>What is Java Business Integration (JBI)?</H3>
+
+<P>JBI is an architecture for integration systems specifying plug-in components that interoperate by exchanging messages, rather than by interacting directly. This decoupling increases flexibility because each component needs to know how to interact with the JBI bus only and not with <EM>n</EM> number of other components. JBI components provide services, consume services, or sometimes both. There are two types of components: Service Engines (SE) and Binding Components (BC). The SEs provide business logic and transformation services. The BCs provide connectivity for applications that are external to the JBI. The separation of business and processing logic from communication logic makes the implementation of components much less complex.</P>
+
+<P>The mediated message exchange between components is provided by the Normalized Message Router (NMR). The NMR routes normalized messages between service providers and consumers. A normalized message consists of two parts: the message content (payload) and the message metadata. The message metadata contains information such as security information, that can affect the processing of the message as it routes through the JBI. Messages flowing into the JBI, via binding components, are translated into a normalized (neutral) format, then routed to their destination. Prior to final delivery the normalized message is translated into the appropriate format for the recipient. A message can be routed through several JBI components depending on what processing is needed.</P>
+
+<P>The JBI environment also supplies a set of services for self management, including services for component installation and life cycle management of components.</P>
+
+<P>In summary, the JBI specification creates a standards-based technology for enterprise application integration. For more details on the JBI specification please see the <A href="5-jbi.html" title="5. JBI">JBI section</A>.</P>
+
+<H3><A name="2.Introduction-WhyServiceMix"></A>Why ServiceMix</H3>
+
+<P>There are many vendors that provide ESB solutions, but there is not universal agreement as to the best design or architecture for an ESB. LogicBlaze has implemented the ServiceMix ESB based on the JBI (JSR 208) specification in order to create a standards based ESB and the ServiceMix ESB combines the functionality of both a Service Oriented Architecture (S0A) and Event Driven Architecture (EDA) to achieve an agile, enterprise ESB.</P>
+
+<P>As previously stated, ServiceMix is an open source ESB that is based on the Java Business Integration (JBI) standard. These two factors, open source and open standards-based, allow for low entry cost, maximum flexibility, reuse, and investment protection.</P>
+
+<P>Low entry cost is a result of the open source model, which allows developers to leverage the work of the development community when implementing components to plug into the ESB, or using the ESB as an integral part of a larger solution.</P>
+
+<P>Flexibility results from the fact that any number of third party vendors supply components and bindings that conform to the JBI open standard specification can be supported. These components and bindings not only interoperate with each other and external applications via the ServiceMix ESB, but can easily be replaced with alternate components that provide the same or enhanced services.</P>
+
+<P>Reuse and investment protection also results from the adherence to standards. Not only can developers swap out ESB components, or use components in another JBI-standard ESB, but they can swap out the entire ESB and still use the standard plug-in components.</P>
+
+<P>As an agile ESB, ServiceMix allows plug-in services which can combine to create a service oriented architecture. ServiceMix allows services to operate in an event driven way as well. In other words, the services are decoupled and listen on the bus for service requests. The bus is responsible for quality of service (QoS) features such as message persistence, guaranteed delivery, failure handling, and transaction support.</P>
+
+<P>ServiceMix supports event driven architecture for events occurring both internal and external to the bus. In other words, JMS binding components can listen for the arrival of messages, i.e., the "event" on topics or queues which are external to the bus, while other components can listen for messages on the normalized message bus.</P>
+
+<P>While decoupled (EDA) operation (as described in the previous two paragraphs) is more appropriate for the scalability and reliabilty required for high transaction production environments, synchronous request/response communication found in SOA implementations, is also supported. Thus, ServiceMix effectively combines SOA and EDA for the development and deployment of composite enterprise applications.</P>
+
+<P><A href="#2.Introduction-top" title="top on 2. Introduction">top</A></P>
+
+<H2><A name="2.Introduction-BackgroundtoServiceMix"></A>Background to ServiceMix</H2>
+
+
+<H3><A name="2.Introduction-Background"></A>Background</H3>
+
+<P>The Enterprise Service Bus (ESB)- which can be defined as middleware that brings together both integration technologies and runtime services to make business services widely available for reuse - offers the best solution for meeting today's enterprise application integration challenges by providing a software infrastructure that enables SOA. However, there are currently a number of different vendors that provide ESB solutions, some of which focus purely on SOAP/HTTP and others who provide multi-protocol capabilities. Because these vendors span the horizon from big enterprise generalists (app servers), to mid-tier enterprise integration providers, all the way to smaller, ESB/integration specific-providers; there doesn't seem to be an established consensus regarding the key requirements for an ESB.</P>
+
+<P>As application architects, we have often thought about what requirements would define an ESB designed specifically to cater to the needs of an agile, enterprise integration model. In building for these specific requirements, we realized that we actually needed to develop a new type of ESB, hence the ServiceMix project.</P>
+
+<H3><A name="2.Introduction-CharacteristicsofanAgileESB"></A>Characteristics of an Agile ESB</H3>
+
+<P>The main criteria we were looking for in our ESB are as follows:</P>
+
+<H4><A name="2.Introduction-Standardsbased"></A>Standards based</H4>
+
+<P>While standards-based support is marketed by many ESB vendors, the support is provided externally, requiring developers to work with proprietary APIs when directly interacting with internal APIs. ServiceMix was designed with the requirement to eliminate product API lock-in, by being built from the ground up to support the Java Business Integration specification (JSR 208). Our agile ESB needs to use JBI as a first class citizen, but also support POJO deployment for ease of use and testing.</P>
+
+<H4><A name="2.Introduction-Flexible"></A>Flexible</H4>
+
+<P>Another characteristic of an agile ESB is the flexibility with which it can be deployed within enterprise application integration framework: standalone, embedded in an application component, or as part of the services supported by an application server. This allows for component re-use throughout the enterprise. For example, the binding for a real-time data feed might be aggregated as a web-service running within an application server, or streamed directly into a fat client on a traders desk. An agile ESB should be able to run both types of configurations seamlessly.</P>
+
+<P>To provide rapid prototyping, an agile ESB should support both scripting languages and embedded rule engines, allowing business processes to be modeled and deployed quickly.</P>
+
+<H4><A name="2.Introduction-Reliable"></A>Reliable</H4>
+
+<P>Our ESB needs to handle network outages and system failures and to be able to reroute message flows and requests to circumvent failures.</P>
+
+<H4><A name="2.Introduction-BreadthofConnectivity"></A>Breadth of Connectivity</H4>
+
+<P>An agile ESB must support both two way reliable Web-services and Message Oriented-Middleware and needs to co-operate seamlessly with EIS and custom components, such as batch files.</P>
+
+<H3><A name="2.Introduction-Conclusion"></A>Conclusion</H3>
+
+<P>We also wanted our agile ESB to be vendor independent and open source, to promote user control of source code and direction. An added benefit of this is not only the zero purchase cost, but the total cost of ownership will be reduced where users are actively contributing and maintaining our ESB.</P>
+
+<P>We rapidly came to the conclusion, that as there was no single product that would adequately meet our needs, we would have to just go<BR>
+a head and build one!</P>
+
+<P><A href="#2.Introduction-top" title="top on 2. Introduction">top</A></P>
+
+<H2><A name="2.Introduction-FeaturesOverview"></A>Features Overview</H2>
+
+<P>ServiceMix is lightweight and easily embeddable, has integrated <SPAN class="nobr"><A href="http://goopen.org/confluence/pages/createpage.action?spaceKey=SM30UG&title=Spring%20support&linkCreation=true&fromPageId=13488" title="Create Page: Spring support" class="createlink">Spring support<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> and can be run at the edge of the network (inside a client or server), as a standalone ESB provider or as a service within another ESB. You can use ServiceMix in Java SE or a Java EE application server.</P>
+
+<P>ServiceMix uses <SPAN class="nobr"><A href="http://www.activemq.org/" title="Visit page outside Confluence" rel="nofollow">ActiveMQ<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> to provide remoting, clustering, reliability and distributed failover.</P>
+
+<P>ServiceMix is completely integrated into <SPAN class="nobr"><A href="http://goopen.org/confluence/pages/createpage.action?spaceKey=SM30UG&title=Geronimo%20Integration&linkCreation=true&fromPageId=13488" title="Create Page: Geronimo Integration" class="createlink">Apache Geronimo<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>, which allows you to deploy JBI components and services directly into Geronimo. ServiceMix is being JBI certified as part of the Geronimo project.</P>
+
+<P>Other J2EE application servers ServiceMix has been integrated with include <SPAN class="nobr"><A href="http://goopen.org/confluence/pages/createpage.action?spaceKey=SM30UG&title=JBoss%20Deployer&linkCreation=true&fromPageId=13488" title="Create Page: JBoss Deployer" class="createlink">JBoss<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>, <SPAN class="nobr"><A href="http://goopen.org/confluence/pages/createpage.action?spaceKey=SM30UG&title=JOnAS%20Integration&linkCreation=true&fromPageId=13488" title="Create Page: JOnAS Integration" class="createlink">JOnAS<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> with more to follow.</P>
+
+<P><A href="#2.Introduction-top" title="top on 2. Introduction">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="1-quick-start.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="1-quick-start.html">1. Quick start</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="3-installation.html">3. Installation</A></TD><TD class="ScrollbarNextIcon"><A href="3-installation.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 Sep 06, 2006
+ (<A href="http://goopen.org/confluence/pages/diffpages.action?pageId=13488&originalId=13508">view change</A>)
+
+ (<A href="http://goopen.org/confluence/pages/editpage.action?pageId=13488">edit page</A>)
+ </DIV>
+
+ </BODY>
+
+</HTML>
\ No newline at end of file
Added: incubator/servicemix/site/sm30ug/3-installation.html
URL: http://svn.apache.org/viewvc/incubator/servicemix/site/sm30ug/3-installation.html?view=auto&rev=441090
==============================================================================
--- incubator/servicemix/site/sm30ug/3-installation.html (added)
+++ incubator/servicemix/site/sm30ug/3-installation.html Thu Sep 7 07:16:46 2006
@@ -0,0 +1,420 @@
+
+<!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:///SM30UG/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">
+ </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="users-guide.html" title="ServiceMix 3.0 User Guide">ServiceMix 3.0 User Guide</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">
+ </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">
+ </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="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="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="4-examples.html">4. Examples</A></TD><TD class="ScrollbarNextIcon"><A href="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></LI>
+ <LI><A href="#3.Installation-TestingtheInstallation">Testing the Installation</A></LI>
+</UL></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.</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>.</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>
+
+
+<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>
+
+<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.</LI>
+ <LI>Proceed to the <A href="#3.Installation-StartingServiceMix" title="Starting ServiceMix on 3. Installation">Starting ServiceMix</A> section of this document.</LI>
+ <LI>Following start-up, go to the <A href="#3.Installation-TestingtheInstallation" title="Testing the Installation on 3. Installation">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.</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 [servicemix_install_dir]</PRE>
+</DIV></DIV>
+<P> where <SPAN class="nobr"><A href="http://goopen.org/confluence/pages/createpage.action?spaceKey=SM30UG&title=servicemix_install_dir&linkCreation=true&fromPageId=13489" title="Create Page: servicemix_install_dir" class="createlink">servicemix_install_dir<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> is the directory in which ServiceMix was installed.</P>
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-java">mvn -Dmaven.test.skip=<SPAN class="code-keyword">true</SPAN> -Dprofile=step1
+mvn -Dmaven.test.skip=<SPAN class="code-keyword">true</SPAN> -Dprofile=step2</PRE>
+</DIV></DIV></LI>
+ <LI>Unzip the distribution using your favorite zip tool</LI>
+ <LI>Start ServiceMix from the target directory, for example:
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-java">cd [servicemix_install_dir]\apache-servicemix\target\apache-servicemix-3.0-incubating-SNAPSHOT
+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></LI>
+ <LI>Proceed to the <A href="#3.Installation-TestingtheInstallation" title="Testing the Installation on 3. Installation">Testing the Installation</A> section.</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.</LI>
+ <LI>If a binary snapshot was downloaded proceed to the <A href="#3.Installation-StartingServiceMix" title="Starting ServiceMix on 3. Installation">Starting ServiceMix</A> section of this document.<BR>
+If a source snapshot was downloaded perform step 6 and step 7 of the <A href="#3.Installation-WindowsSourceInstallation" title="Windows Source Installation on 3. Installation">Windows Source Installation</A> procedure.</LI>
+ <LI>Following start-up, proceed to the <A href="#3.Installation-TestingtheInstallation" title="Testing the Installation on 3. Installation">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: 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:<BR>
+ wget <SPAN class="nobr"><A href="http://dist.codehaus.org/servicemix/distributions/servicemix-3.0.x.tar.gz" title="Visit page outside Confluence" rel="nofollow">http://dist.codehaus.org/servicemix/distributions/servicemix-3.0.x.tar.gz<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></P>
+<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 servicemix-x.x.x.tar.gz
+tar xvf servicemix-x.x.x.tar</PRE>
+</DIV></DIV></LI>
+ <LI>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:
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-java">cd [servicemix_install_dir]/bin
+ where [servicemix_install_dir] is the directory in which ServiceMix was installed.
+chmod 755 servicemix</PRE>
+</DIV></DIV></LI>
+ <LI>Proceed to the <A href="#3.Installation-StartingServiceMix" title="Starting ServiceMix on 3. Installation">Starting ServiceMix</A> section of this document.</LI>
+ <LI>Following start-up, go to the <A href="#3.Installation-TestingtheInstallation" title="Testing the Installation on 3. Installation">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="#3.Installation-UnixBinaryInstallation" title="Unix Binary Installation on 3. Installation">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 servicemix.x.x-src.tar.gz
+tar xvf servicemix.x.x-src.tar</PRE>
+</DIV></DIV></LI>
+ <LI>Build ServiceMix using Maven 1.0.2 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 [servicemix_install_dir]
+ where [servicemix_install_dir] is the directory in which ServiceMix was installed.
+maven clean test
+
+If the above build fails on some tests, <SPAN class="code-keyword">do</SPAN> the following:
+cd [servicemix_install_dir]
+maven m:clean
+maven \-Dmaven.test.skip=<SPAN class="code-keyword">true</SPAN></PRE>
+</DIV></DIV></LI>
+ <LI>If the <TT>servicemix</TT> start-up script is not executable, change its permissions. For example:
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-java">cd [servicemix_install_dir]/servicemix-assembly/target/servicemix-3.x/bin/servicemix-3.x/bin
+chmod 755 servicemix</PRE>
+</DIV></DIV></LI>
+ <LI>Start ServiceMix from the target directory, for example:
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-java">cd [servicemix_install_dir]/servicemix-assembly/target/servicemix-3.x/bin/servicemix-3.x
+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></LI>
+ <LI>Proceed to <A href="#3.Installation-TestingtheInstallation" title="Testing the Installation on 3. Installation">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 servicemix-x.x-x.tar.gz
+ tar xvf servicemix-x.x.x.tar
+
+For a source developer's snapshot:
+ gunzip servicemix-x.x.x-src.tar.gz
+ tar xvf servicemix-x.x.x-src.tar</PRE>
+</DIV></DIV></LI>
+ <LI>If a binary snapshot was downloaded the <TT>servicemix</TT> script may need its permissions changed to make it executable:
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-java">cd [servicemix_install_dir]/bin
+ where [servicemix_install_dir] is the directory in which ServiceMix was installed.
+chmod 755 servicemix</PRE>
+</DIV></DIV>
+<P>For a binary snapshot, proceed to the <A href="#3.Installation-StartingServiceMix" title="Starting ServiceMix on 3. Installation">Starting ServiceMix</A> section of this document.<BR>
+If a source snapshot was downloaded perform steps 6 - 8 of the <A href="#3.Installation-UnixSourceInstallation" title="Unix Source Installation on 3. Installation">Unix Source Installation</A> procedure.</P></LI>
+ <LI>Proceed to the <A href="#3.Installation-TestingtheInstallation" title="Testing the Installation on 3. Installation">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>:</P>
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-java">cd [servicemix_install_dir]</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>.
+<BR clear="all">
+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>:</P>
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-java">cd [servicemix_install_dir]</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>.
+<BR clear="all">
+Then type:</P>
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-java">bin/servicemix
+
+OR
+
+nohup bin/servicemix > /tmp/smlog 2>&1 &
+Note: /tmp/smlog may be changed to another file name.</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>
+<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>
+
+<H3><A name="3.Installation-TestingtheInstallation"></A>Testing the Installation</H3>
+
+<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-SNAPSHOT</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 [PID]
+ where [PID] is the process id of the servicemix process.</PRE>
+</DIV></DIV>
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-java"></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&linkCreation=true&fromPageId=13489" title="Create Page: Configuration" class="createlink">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="#3.Installation-top" title="top on 3. Installation">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="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="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="4-examples.html">4. Examples</A></TD><TD class="ScrollbarNextIcon"><A href="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 Sep 06, 2006
+ (<A href="http://goopen.org/confluence/pages/diffpages.action?pageId=13489&originalId=13510">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