servicemix-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From conflue...@apache.org
Subject [CONF] Apache ServiceMix > Getting Started
Date Fri, 04 Mar 2011 15:30:01 GMT
<html>
<head>
    <base href="https://cwiki.apache.org/confluence">
            <link rel="stylesheet" href="/confluence/s/2036/9/13/_/styles/combined.css?spaceKey=SM&amp;forWysiwyg=true"
type="text/css">
    </head>
<body style="background: white;" bgcolor="white" class="email-body">
<div id="pageContent">
<div id="notificationFormat">
<div class="wiki-content">
<div class="email">
    <h2><a href="https://cwiki.apache.org/confluence/display/SM/Getting+Started">Getting
Started</a></h2>
    <h4>Page <b>edited</b> by             <a href="https://cwiki.apache.org/confluence/display/~nanthrax">Jean-Baptiste
Onofré</a>
    </h4>
        <br/>
                         <h4>Changes (31)</h4>
                                 
    
<div id="page-diffs">
                    <table class="diff" cellpadding="0" cellspacing="0">
    
            <tr><td class="diff-unchanged" >h1. Getting Started <br></td></tr>
            <tr><td class="diff-changed-lines" >The purpose of this document is
to provide a starting point for those new to ServiceMix and <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">JBI.</span>
<span class="diff-added-words"style="background-color: #dfd;">OSGi.</span> Please
read through each section here and if you have any questions, please just hop on the ServiceMix
user [mailing list|Mailing Lists] to ask any questions you might have. <br></td></tr>
            <tr><td class="diff-unchanged" > <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">{info:title=Are
You Familiar With Web Applications?} <br>If you are at all familiar with web applications,
then you should find that the high level steps of getting started with ServiceMix are not
much different than getting started in building web applications and deploying them to a web
container like Jetty or Tomcat. First you need a good understanding of web application concepts.
Next, you walk through some tutorials and examples to help you build and package a web application.
Third, you install the binary distribution of the web container so that you can deploy your
WAR files and run your application. The same basic steps apply here except that you&#39;re
using ServiceMix instead of a web container and SUs/SAs instead of WARs.  <br>{info}
<br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">h2.
Introduction, OSGi and ServiceMix <br>ServiceMix is a complete and professional integration
platform powered by OSGi. It provides an enterprise ready powerful Enterprise Service Bus
(ESB). Thanks to OSGi, ServiceMix is a highly configurable platform and allow you to extend
it very easily. <br></td></tr>
            <tr><td class="diff-unchanged" > <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">h2.
Introduction <br>First read the FAQ entry titled, [What is JBI] and each page linked
to that page. This document provides some good base knowledge about JBI concepts before diving
any deeper into the the use of the technology.  <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">OSGi
is a dynamic module system for Java. OSGi provides the standardized primitives that allow
applications to be constructed from small, reusable and collaborative components. <br></td></tr>
            <tr><td class="diff-unchanged" > <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">The
OSGi Service Platform provides the functions to change the composition dynamically on the
device of a variety of networks, without requiring restarts. <br>To minimize the coupling,
as well as make these couplings managed, the OSGi technology provides a service-oriented architecture
that enables these components to dynamically discover eath other for collaboration. <br>
<br>ServiceMix integrates a large number of projects such as: <br>* [Apache Karaf|http://karaf.apache.org]
is the ServiceMix kernel <br>* [Apache ActiveMQ|http://activemq.apache.org] as message
broker <br>* [Apache Camel|http://camel.apache.org] as message routing, components provider
and EIP framework <br>* [Apache CXF|http://cxf.apache.org] as WS-* and RESTful WebService
provider <br>* [Apache ODE|http://ode.apache.org] as WS-BPEL embedded engine <br>
<br></td></tr>
            <tr><td class="diff-unchanged" >h2. Tutorials  <br>The [Tutorials]
section is the next step. These tutorials walk you through the basic use of the technology
and show you how to build various examples. We are working to continually add new tutorials
so please check back often. If there is a use case that you&#39;d like to see, please
hop on the ServiceMix user [mailing list|Mailing Lists] to discuss it. We&#39;re all very
interested in what you&#39;d like to see and we highly encourage contributions from the
community.  <br> <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">{excerpt}
<br></td></tr>
            <tr><td class="diff-unchanged" >h2. Installing the ServiceMix Binary
Distribution  <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">{excerpt}
<br>Once you&#39;ve followed the tutorials to create some SUs and SAs, you&#39;ll
need to deploy them to ServiceMix. This requires that you install the binary distribution
of ServiceMix so that you can deploy your SAs to it. Below are the steps to achieve this.
 <br></td></tr>
            <tr><td class="diff-unchanged" > <br>h3. Pre-Installation Requirements
<br>*Hardware:*  <br></td></tr>
            <tr><td class="diff-changed-lines" >* 100 MB of disk space for the
ServiceMix <span class="diff-changed-words"><span class="diff-deleted-chars"style="color:#999;background-color:#fdd;text-decoration:line-through;">3</span><span
class="diff-added-chars"style="background-color: #dfd;">4</span>.x</span> binary
distribution. <br></td></tr>
            <tr><td class="diff-unchanged" > <br>*Operating Systems:* <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">*
Windows: Windows XP SP2, Windows 2000  <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">*
Windows: Windows XP SP2, Windows 2000, Windows Vista, Windows 7  <br></td></tr>
            <tr><td class="diff-unchanged" >* Unix: Any Linux/Unix platform that
supports Java  <br> <br>*Environment:* <br></td></tr>
            <tr><td class="diff-changed-lines" >* Java Developer Kit (JDK) <span
class="diff-changed-words">1.<span class="diff-deleted-chars"style="color:#999;background-color:#fdd;text-decoration:line-through;">5</span><span
class="diff-added-chars"style="background-color: #dfd;">6</span>.x</span> (Java
<span class="diff-changed-words"><span class="diff-deleted-chars"style="color:#999;background-color:#fdd;text-decoration:line-through;">5</span><span
class="diff-added-chars"style="background-color: #dfd;">6</span>)</span> or
better for both deployment and compiling. <br></td></tr>
            <tr><td class="diff-unchanged" > <br>h3. Binary Distribution
Installation Procedure  <br></td></tr>
            <tr><td class="diff-snipped" >...<br></td></tr>
            <tr><td class="diff-unchanged" >*Windows:* <br>{code}   <br></td></tr>
            <tr><td class="diff-changed-lines" >&gt; <span class="diff-changed-words">.\bin\servicemix<span
class="diff-added-chars"style="background-color: #dfd;">.bat</span></span>
<br></td></tr>
            <tr><td class="diff-unchanged" >{code}  <br> <br></td></tr>
            <tr><td class="diff-snipped" >...<br></td></tr>
            <tr><td class="diff-unchanged" >{code}   <br>$ ./bin/servicemix
<br></td></tr>
            <tr><td class="diff-unchanged" >{code}   <br></td></tr>
            <tr><td class="diff-unchanged" > <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">{warning:title=Warning}
<br>Using a IBM 1.5 JVM, you can have error at startup looking like this : <br>Caught
: org.springframework.beans.factory.BeanDefinitionStoreException: Unexpected exception parsing
XML document from class path resource [activemq.xml]; nested exception is java.lang.ClassCircularityError
<br>org.springframework.beans.factory.BeanDefinitionStoreException: Unexpected exception
parsing XML document from class path resource [activemq.xml]; nested exception is java.lang.ClassCircularityError
<br>To avoid this, add -Xverify:none flag to the java command line. <br>{warning}
<br> <br>{warning:title=Warning} <br>Don&#39;t close the window containing
the command prompt in which ServiceMix is running as doing so will terminate ServiceMix. On
Linux/Unix, this can be worked around by starting ServiceMix with the [nohup|http://en.wikipedia.org/wiki/Nohup]
utility. <br>{warning} <br> <br>h3. Stopping ServiceMix <br>For both
Windows and Unix installations, terminate ServiceMix by typing &quot;CTRL-C&quot;
on the command line where ServiceMix is running. ServiceMix uses the [Java shutdown hook|http://java.sun.com/j2se/1.4.2/docs/guide/lang/hook-design.html]
to cleanly shut down the container.  <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">ServiceMix
start and you are in the ServiceMix shell. <br></td></tr>
            <tr><td class="diff-unchanged" > <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">In
ServiceMix 4.x you exit the shell by pressing &quot;CTRL+D&quot;. To shutdown ServiceMix
4.x from the shell you type &quot;osgi:shutdown&quot;. <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">{excerpt}
<br>Do not close the console or shell in which ServiceMix was started, as that will
terminate ServiceMix (unless ServiceMix was started with nohup). <br>{excerpt} <br></td></tr>
            <tr><td class="diff-unchanged" > <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">h2.
Additional Resources <br>After the installation, ServiceMix is running with a basic
configuration. For details on configuring additional options, please see [Configuration].
<br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">You
can also start ServiceMix directly in background: <br></td></tr>
            <tr><td class="diff-unchanged" > <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">Before
trying to use ServiceMix, make sure to read the [What is JBI] document, take a look at the
available [Components list] for a list of JBI compliant components and get an idea for the
ServiceMix [Architecture] along with the supported [NMR Flows]. <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">*Windows:*
<br>{code} <br>&gt; .\bin\start.bat <br>{code} <br></td></tr>
            <tr><td class="diff-unchanged" > <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">A
good next step is to deploy and run the [Examples] that are part of the ServiceMix binary
distribution. The examples are located in the _examples_ directory under the directory in
which ServiceMix was installed. <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">*Linux/Unix:*
<br>{code} <br>$ ./bin/start <br>{code} <br></td></tr>
            <tr><td class="diff-unchanged" > <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">{tip:title=Handy
Hint} <br>Add _$SERVICEMIX_HOME/bin_ directory to _$PATH_ variable to simplify execution
of the examples. <br>{tip} <br></td></tr>
            <tr><td class="diff-unchanged" > <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">To
view the statistics and operation of ServiceMix in a JMX Console and see how the Management
works please read the page about the [JMX Console] and the page about [Management].  <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">h3.
Stopping ServiceMix <br>For both Windows and Unix installations, terminate ServiceMix
by typing &quot;CTRL-D&quot; on the command line where ServiceMix is running. <br></td></tr>
            <tr><td class="diff-unchanged" > <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">[Getting
Started with Fuse ESB|http://fusesource.com/docs/esb/4.3/esb_getting_started/index.html] provides
a detailed overview of ServiceMix, the requirements for installing ActiveMQ, and a good tutorial
to get you up and running quickly. In addition, [FuseSource|http://fusesource.com] provides
detailed documentation on using ServiceMix at [http://fuseosurce.com/docs/esb]. <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">You
can also type &quot;osgi:shutdown&quot; in the ServiceMix shell. <br></td></tr>
            <tr><td class="diff-unchanged" > <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">h3.
Working With the ServiceMix Source Code  <br>If you&#39;re interested to dig in
and work with the ServiceMix source code, take a look at the [Source] and the [Building] documents.
These documents will help you check out the ServiceMix source code using Subversion and build
it using Maven.  <br>{excerpt} <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">If
you started ServiceMix in background, you can use: <br></td></tr>
            <tr><td class="diff-unchanged" > <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">*Windows:*
<br>{code} <br>&gt; .\bin\stop.bat <br>{code} <br> <br>*Linux/Unix:*
<br>{code} <br>$ ./bin/stop <br>{code} <br> <br></td></tr>
            <tr><td class="diff-unchanged" >{children:all=true} <br></td></tr>
    
            </table>
    </div>                            <h4>Full Content</h4>
                    <div class="notificationGreySide">
        <h1><a name="GettingStarted-GettingStarted"></a>Getting Started</h1>
<p>The purpose of this document is to provide a starting point for those new to ServiceMix
and OSGi. Please read through each section here and if you have any questions, please just
hop on the ServiceMix user <a href="/confluence/display/SM/Mailing+Lists" title="Mailing
Lists">mailing list</a> to ask any questions you might have.</p>

<h2><a name="GettingStarted-Introduction%2COSGiandServiceMix"></a>Introduction,
OSGi and ServiceMix</h2>
<p>ServiceMix is a complete and professional integration platform powered by OSGi. It
provides an enterprise ready powerful Enterprise Service Bus (ESB). Thanks to OSGi, ServiceMix
is a highly configurable platform and allow you to extend it very easily.</p>

<p>OSGi is a dynamic module system for Java. OSGi provides the standardized primitives
that allow applications to be constructed from small, reusable and collaborative components.</p>

<p>The OSGi Service Platform provides the functions to change the composition dynamically
on the device of a variety of networks, without requiring restarts.<br/>
To minimize the coupling, as well as make these couplings managed, the OSGi technology provides
a service-oriented architecture that enables these components to dynamically discover eath
other for collaboration.</p>

<p>ServiceMix integrates a large number of projects such as:</p>
<ul>
	<li><a href="http://karaf.apache.org" class="external-link" rel="nofollow">Apache
Karaf</a> is the ServiceMix kernel</li>
	<li><a href="http://activemq.apache.org" class="external-link" rel="nofollow">Apache
ActiveMQ</a> as message broker</li>
	<li><a href="http://camel.apache.org" class="external-link" rel="nofollow">Apache
Camel</a> as message routing, components provider and EIP framework</li>
	<li><a href="http://cxf.apache.org" class="external-link" rel="nofollow">Apache
CXF</a> as WS-* and RESTful WebService provider</li>
	<li><a href="http://ode.apache.org" class="external-link" rel="nofollow">Apache
ODE</a> as WS-BPEL embedded engine</li>
</ul>


<h2><a name="GettingStarted-Tutorials"></a>Tutorials </h2>
<p>The <a href="/confluence/display/SM/Tutorials" title="Tutorials">Tutorials</a>
section is the next step. These tutorials walk you through the basic use of the technology
and show you how to build various examples. We are working to continually add new tutorials
so please check back often. If there is a use case that you'd like to see, please hop on the
ServiceMix user <a href="/confluence/display/SM/Mailing+Lists" title="Mailing Lists">mailing
list</a> to discuss it. We're all very interested in what you'd like to see and we highly
encourage contributions from the community. </p>

<h2><a name="GettingStarted-InstallingtheServiceMixBinaryDistribution"></a>Installing
the ServiceMix Binary Distribution </h2>

<h3><a name="GettingStarted-PreInstallationRequirements"></a>Pre-Installation
Requirements</h3>
<p><b>Hardware:</b> </p>
<ul>
	<li>100 MB of disk space for the ServiceMix 4.x binary distribution.</li>
</ul>


<p><b>Operating Systems:</b></p>
<ul>
	<li>Windows: Windows XP SP2, Windows 2000, Windows Vista, Windows 7</li>
	<li>Unix: Any Linux/Unix platform that supports Java</li>
</ul>


<p><b>Environment:</b></p>
<ul>
	<li>Java Developer Kit (JDK) 1.6.x (Java 6) or better for both deployment and compiling.</li>
</ul>


<h3><a name="GettingStarted-BinaryDistributionInstallationProcedure"></a>Binary
Distribution Installation Procedure </h3>
<p>This procedure explains how to download and install the binary distribution.</p>

<ol>
	<li>Download the binary distribution for your platform (either a tarball for a zip
file). The latest release can be downloaded here: <a href="http://servicemix.apache.org/download.html"
class="external-link" rel="nofollow">http://servicemix.apache.org/download.html</a></li>
	<li>Extract the download into a directory of your choice.</li>
	<li>Proceed to the <a href="#GettingStarted-StartingServiceMix">Starting ServiceMix</a>
section of this document.</li>
	<li>Following start-up, go to <a href="#GettingStarted-TestingtheInstallation">Testing
the Installation</a> section of this document.</li>
</ol>


<h3><a name="GettingStarted-StartingServiceMix"></a>Starting ServiceMix</h3>
<p>This section provides instructions on starting ServiceMix from both Windows and Unix
platforms. Below are the steps to follow: </p>

<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-java"> 
&gt; cd &lt;SERVICEMIX_HOME&gt;
</pre>
</div></div> 

<p>The &lt;SERVICEMIX_HOME&gt; above is just simply a placeholder for the ServiceMix
binary distribution directory, i.e., the directory you expanded from the downloaded tarball
or zip file. </p>

<p><b>Windows:</b></p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-java">  
&gt; .\bin\servicemix.bat
</pre>
</div></div> 

<p><b>Linux/Unix:</b></p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-java">  
$ ./bin/servicemix
</pre>
</div></div>  

<p>ServiceMix start and you are in the ServiceMix shell.</p>


<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>


<p>You can also start ServiceMix directly in background:</p>

<p><b>Windows:</b></p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-java">
&gt; .\bin\start.bat
</pre>
</div></div>

<p><b>Linux/Unix:</b></p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-java">
$ ./bin/start
</pre>
</div></div>


<h3><a name="GettingStarted-StoppingServiceMix"></a>Stopping ServiceMix</h3>
<p>For both Windows and Unix installations, terminate ServiceMix by typing "CTRL-D"
on the command line where ServiceMix is running.</p>

<p>You can also type "osgi:shutdown" in the ServiceMix shell.</p>

<p>If you started ServiceMix in background, you can use:</p>

<p><b>Windows:</b></p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-java">
&gt; .\bin\stop.bat
</pre>
</div></div>

<p><b>Linux/Unix:</b></p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-java">
$ ./bin/stop
</pre>
</div></div>




    </div>
        <div id="commentsSection" class="wiki-content pageSection">
        <div style="float: right;">
            <a href="https://cwiki.apache.org/confluence/users/viewnotifications.action"
class="grey">Change Notification Preferences</a>
        </div>
        <a href="https://cwiki.apache.org/confluence/display/SM/Getting+Started">View
Online</a>
        |
        <a href="https://cwiki.apache.org/confluence/pages/diffpagesbyversion.action?pageId=39182&revisedVersion=47&originalVersion=46">View
Changes</a>
                |
        <a href="https://cwiki.apache.org/confluence/display/SM/Getting+Started?showComments=true&amp;showCommentArea=true#addcomment">Add
Comment</a>
            </div>
</div>
</div>
</div>
</div>
</body>
</html>

Mime
View raw message