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 Wed, 22 Sep 2010 11:09:01 GMT
<html>
<head>
    <base href="https://cwiki.apache.org/confluence">
            <link rel="stylesheet" href="/confluence/s/1810/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/~davsclaus">Claus
Ibsen</a>
    </h4>
        <br/>
                         <h4>Changes (2)</h4>
                                 
    
<div id="page-diffs">
            <table class="diff" cellpadding="0" cellspacing="0">
            <tr><td class="diff-snipped" >...<br></td></tr>
            <tr><td class="diff-unchanged" > <br>*Environment:* <br></td></tr>
            <tr><td class="diff-changed-lines" >* Java Developer Kit (JDK) 1.5.x
(Java 5) <span class="diff-added-words"style="background-color: #dfd;">or better</span>
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" >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> <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">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> <br></td></tr>
            <tr><td class="diff-unchanged" >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-snipped" >...<br></td></tr>
        </table>
</div>                            <h4>Full Content</h4>
                    <div class="notificationGreySide">
        <div class='panelMacro'><table class='infoMacro'><colgroup><col
width='24'><col></colgroup><tr><td valign='top'><img src="/confluence/images/icons/emoticons/information.gif"
width="16" height="16" align="absmiddle" alt="" border="0"></td><td><b>Additional
Documentation</b><br />You can also find additional documentation on the <a
href="http://fusesource.com/docs/esb/4.2/getting_started/index.html" class="external-link"
rel="nofollow">Fuse ESB Getting Started Page</a></td></tr></table></div>



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

<div class='panelMacro'><table class='infoMacro'><colgroup><col width='24'><col></colgroup><tr><td
valign='top'><img src="/confluence/images/icons/emoticons/information.gif" width="16"
height="16" align="absmiddle" alt="" border="0"></td><td><b>Are You Familiar
With Web Applications?</b><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're using
ServiceMix instead of a web container and SUs/SAs instead of WARs.</td></tr></table></div>

<h2><a name="GettingStarted-Introduction"></a>Introduction</h2>
<p>First read the FAQ entry titled, <a href="/confluence/display/SM/What+is+JBI"
title="What is JBI">What is JBI</a> 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. </p>

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

<p>Once you've followed the tutorials to create some SUs and SAs, you'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. </p>

<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 3.x binary distribution.</li>
</ul>


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


<p><b>Environment:</b></p>
<ul>
	<li>Java Developer Kit (JDK) 1.5.x (Java 5) 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
</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>

<div class='panelMacro'><table class='warningMacro'><colgroup><col width='24'><col></colgroup><tr><td
valign='top'><img src="/confluence/images/icons/emoticons/forbidden.gif" width="16"
height="16" align="absmiddle" alt="" border="0"></td><td><b>Warning</b><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 <a href="/confluence/pages/createpage.action?spaceKey=SM&amp;title=activemq.xml&amp;linkCreation=true&amp;fromPageId=39182"
class="createlink">activemq.xml</a>; nested exception is java.lang.ClassCircularityError<br/>
org.springframework.beans.factory.BeanDefinitionStoreException: Unexpected exception parsing
XML document from class path resource <a href="/confluence/pages/createpage.action?spaceKey=SM&amp;title=activemq.xml&amp;linkCreation=true&amp;fromPageId=39182"
class="createlink">activemq.xml</a>; nested exception is java.lang.ClassCircularityError<br/>
To avoid this, add -Xverify:none flag to the java command line.</td></tr></table></div>

<div class='panelMacro'><table class='warningMacro'><colgroup><col width='24'><col></colgroup><tr><td
valign='top'><img src="/confluence/images/icons/emoticons/forbidden.gif" width="16"
height="16" align="absmiddle" alt="" border="0"></td><td><b>Warning</b><br
/>Don'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 <a href="http://en.wikipedia.org/wiki/Nohup" class="external-link" rel="nofollow">nohup</a>
utility.</td></tr></table></div>

<h3><a name="GettingStarted-StoppingServiceMix"></a>Stopping ServiceMix</h3>
<p>For both Windows and Unix installations, terminate ServiceMix by typing "CTRL-C"
on the command line where ServiceMix is running. ServiceMix uses the <a href="http://java.sun.com/j2se/1.4.2/docs/guide/lang/hook-design.html"
class="external-link" rel="nofollow">Java shutdown hook</a> to cleanly shut down
the container. </p>

<p>In ServiceMix 4.x you exit the shell by pressing "CTRL+D". To shutdown ServiceMix
4.x from the shell you type "osgi:shutdown".</p>

<h2><a name="GettingStarted-AdditionalResources"></a>Additional Resources</h2>
<p>After the installation, ServiceMix is running with a basic configuration. For details
on configuring additional options, please see <a href="/confluence/display/SM/Configuration"
title="Configuration">Configuration</a>.</p>

<p>Before trying to use ServiceMix, make sure to read the <a href="/confluence/display/SM/What+is+JBI"
title="What is JBI">What is JBI</a> document, take a look at the available <a
href="/confluence/display/SM/Components+list" title="Components list">Components list</a>
for a list of JBI compliant components and get an idea for the ServiceMix <a href="/confluence/display/SM/Architecture"
title="Architecture">Architecture</a> along with the supported <a href="/confluence/display/SM/NMR+Flows"
title="NMR Flows">NMR Flows</a>.</p>

<p>A good next step is to deploy and run the <a href="/confluence/display/SM/Examples"
title="Examples">Examples</a> that are part of the ServiceMix binary distribution.
The examples are located in the <em>examples</em> directory under the directory
in which ServiceMix was installed.</p>

<div class='panelMacro'><table class='tipMacro'><colgroup><col width='24'><col></colgroup><tr><td
valign='top'><img src="/confluence/images/icons/emoticons/check.gif" width="16" height="16"
align="absmiddle" alt="" border="0"></td><td><b>Handy Hint</b><br
/>Add <em>$SERVICEMIX_HOME/bin</em> directory to <em>$PATH</em>
variable to simplify execution of the examples.</td></tr></table></div>

<p>To view the statistics and operation of ServiceMix in a JMX Console and see how the
Management works please read the page about the <a href="/confluence/display/SM/JMX+Console"
title="JMX Console">JMX Console</a> and the page about <a href="/confluence/display/SM/Management"
title="Management">Management</a>. </p>

<h3><a name="GettingStarted-WorkingWiththeServiceMixSourceCode"></a>Working
With the ServiceMix Source Code </h3>
<p>If you're interested to dig in and work with the ServiceMix source code, take a look
at the <a href="/confluence/display/SM/Source" title="Source">Source</a> and the
<a href="/confluence/display/SM/Building" title="Building">Building</a> documents.
These documents will help you check out the ServiceMix source code using Subversion and build
it using Maven. </p>





    </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=45&originalVersion=44">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