You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@servicemix.apache.org by js...@apache.org on 2006/02/02 17:14:04 UTC
svn commit: r374419 [9/36] - /incubator/servicemix/site/
Added: incubator/servicemix/site/Geronimo+Integration
URL: http://svn.apache.org/viewcvs/incubator/servicemix/site/Geronimo%2BIntegration?rev=374419&view=auto
==============================================================================
--- incubator/servicemix/site/Geronimo+Integration (added)
+++ incubator/servicemix/site/Geronimo+Integration Thu Feb 2 08:12:18 2006
@@ -0,0 +1,643 @@
+
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+ <head>
+ <link rel="stylesheet" href="site.css" type="text/css">
+
+
+
+ <title>ServiceMix - Geronimo Integration</title>
+ </head>
+
+ <body>
+ <table width="100%" id="layout" style="padding:0px;margin0px;border-collapse:collapse;">
+ <tr>
+ <td colspan="3" style="padding:8px;">
+ <table width="100%" id="banner" style="padding:0px;margin:0px">
+ <tr id="header_row">
+ <td align="left" valign="middle" style="padding:0px;margin:0px;">
+ <span id="Content"><span><span class="nobr"><a href="http://incubator.apache.org/servicemix" rel="nofollow"><img align="absmiddle" border=0 src="images/logo.gif"></a></span></span></span>
+
+ </td>
+
+ </tr>
+ </table>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="3" id="breadcrumbs">
+ <table width="100%" id="banner" style="padding:0px;margin:0px">
+ <tr>
+ <td align="left">
+ <a href="">Home</a> | <a href="Navigation">Navigation</a> > Geronimo Integration
+ </td>
+ <td align="right">
+ <span id="Content"><span><a href="Download" title="Download">Download</a> | <span class="nobr"><a href="http://servicemix.codehaus.org/maven/servicemix-core/apidocs/" rel="nofollow">JavaDocs</a></span> | <a href="Source" title="Source">Source</a> | <span class="nobr"><a href="http://docs.codehaus.org/pages/listpages.action?key=SM" rel="nofollow">Wiki</a></span> |<span class="nobr"><a href="irc://irc.codehaus.org/servicemix" rel="nofollow">IRC</a></span> | <span class="nobr"><a href="http://servlet.uwyn.com/drone/log/hausbot/servicemix" rel="nofollow">IRC Log</a></span> | <a href="Mailing+Lists" title="Mailing Lists">Mailing Lists</a> | <span class="nobr"><a href="http://forums.logicblaze.com/forums/show/3.page" rel="nofollow">Discussion Forum</a></span>| <span class="nobr"><a href="http://jira.logicblaze.com/jira/browse/SM" rel="nofollow">Support</a></span></span></span>
+
+ </td>
+ </tr>
+ </table>
+ </td>
+ </tr>
+ <tr>
+ <td id="leftColumn" valign="top" style="padding-top: 0px;">
+ <span id="Content"><h3><a name="Navigation-Overview"></a>Overview</h3>
+ <ul class="alternate" type="square">
+ <li><a href="Home" title="Home">Home</a></li>
+ <li><a href="Introduction+to+ESB" title="Introduction to ESB">Introduction to ESB</a></li>
+ <li><a href="Background+to+ServiceMix" title="Background to ServiceMix">Background to ServiceMix</a></li>
+ <li><a href="News" title="News">News</a></li>
+ <li><a href="FAQ" title="FAQ">FAQ</a></li>
+ <li><a href="Download" title="Download">Download</a></li>
+ </ul>
+ <h3><a name="Navigation-Community"></a>Community</h3>
+ <ul class="alternate" type="square">
+ <li><span class="nobr"><a href="http://docs.codehaus.org/pages/listpages.action?key=SM" rel="nofollow">Wiki</a></span></li>
+ <li><a href="Mailing+Lists" title="Mailing Lists">Mailing Lists</a></li>
+ <li><a href="Contributing" title="Contributing">Contributing</a></li>
+ <li><a href="Team" title="Team">Team</a></li>
+ <li><a href="Users" title="Users">Users</a></li>
+ </ul>
+ <h3><a name="Navigation-Documentation"></a>Documentation</h3>
+ <ul class="alternate" type="square">
+ <li><a href="Getting+Started" title="Getting Started">Getting Started</a></li>
+ <li><a href="Running" title="Running">Running</a></li>
+ <li><a href="Examples" title="Examples">Examples</a></li>
+ <li><a href="Use+Cases" title="Use Cases">Use Cases</a></li>
+ <li><a href="Configuration" title="Configuration">Configuration</a></li>
+ <li><a href="Xml+Reference" title="Xml Reference">Xml Reference</a></li>
+ <li><a href="Management" title="Management">Management</a></li>
+ <li><a href="Architecture" title="Architecture">Architecture</a></li>
+ <li><a href="Clustering" title="Clustering">Clustering</a></li>
+ <li><a href="NMR+Flows" title="NMR Flows">NMR Flows</a></li>
+ <li><a href="Articles" title="Articles">Articles</a></li>
+ </ul>
+ <h3><a name="Navigation-Reference"></a>Reference</h3>
+ <ul class="alternate" type="square">
+ <li><span class="nobr"><a href="http://java.sun.com/integration/1.0/docs/sdk/api/index.html" rel="nofollow">JBI API</a></span></li>
+ <li><span class="nobr"><a href="http://servicemix.codehaus.org/maven/servicemix-core/apidocs/" rel="nofollow">JavaDocs</a></span></li>
+ <li><a href="Glossary" title="Glossary">Glossary</a></li>
+ </ul>
+ <h3><a name="Navigation-Features"></a>Features</h3>
+ <ul class="alternate" type="square">
+ <li><a href="Components" title="Components">Components</a></li>
+ <li><a href="Routing" title="Routing">Routing</a></li>
+ <li><a href="Transformation" title="Transformation">Transformation</a></li>
+ <li><a href="Spring+Client+Toolkit" title="Spring Client Toolkit">Spring Client Toolkit</a></li>
+ <li><a href="Client+API" title="Client API">Client API</a></li>
+ <li><a href="POJO+support" title="POJO support">POJO support</a></li>
+ <li><a href="Expressions" title="Expressions">Expressions</a></li>
+ <li><a href="Component+helper+classes" title="Component helper classes">Component helper classes</a></li>
+ <li><a href="Ant+Tasks" title="Ant Tasks">Ant Tasks</a></li>
+ <li><a href="JMX+Console" title="JMX Console">JMX Console</a></li>
+ </ul>
+ <h3><a name="Navigation-Integration"></a>Integration</h3>
+ <ul class="alternate" type="square">
+ <li><a href="Spring+support" title="Spring support">Spring support</a></li>
+ <li><a href="Geronimo+Integration" title="Geronimo Integration">Geronimo Integration</a></li>
+ <li><a href="JBoss+Deployer" title="JBoss Deployer">JBoss Integration</a></li>
+ <li><a href="Tomcat+Integration" title="Tomcat Integration">Tomcat Integration</a></li>
+ <li><a href="JNDI+configuration" title="JNDI configuration">JNDI configuration</a></li>
+ </ul>
+ <h3><a name="Navigation-ServiceMixComponents"></a>ServiceMix Components</h3>
+ <ul class="alternate" type="square">
+ <li><a href="BPEL" title="BPEL">BPEL</a></li>
+ <li><a href="Cache" title="Cache">Cache</a></li>
+ <li><a href="Drools" title="Drools">Drools</a></li>
+ <li><a href="Email" title="Email">Email</a></li>
+ <li><a href="File" title="File">File</a></li>
+ <li><a href="FTP" title="FTP">FTP</a></li>
+ <li><a href="Groovy" title="Groovy">Groovy</a></li>
+ <li><a href="HTTP" title="HTTP">HTTP</a></li>
+ <li><a href="Jabber" title="Jabber">Jabber</a></li>
+ <li><a href="JAX+WS" title="JAX WS">JAX WS</a></li>
+ <li><a href="JCA" title="JCA">JCA</a></li>
+ <li><a href="JMS" title="JMS">JMS</a></li>
+ <li><a href="Quartz" title="Quartz">Quartz</a></li>
+ <li><a href="Reflection" title="Reflection">Reflection</a></li>
+ <li><a href="RSS" title="RSS">RSS</a></li>
+ <li><a href="SAAJ" title="SAAJ">SAAJ</a></li>
+ <li><a href="Scripting" title="Scripting">Scripting</a></li>
+ <li><a href="ServiceMix" title="ServiceMix">ServiceMix</a></li>
+ <li><a href="Validation" title="Validation">Validation</a></li>
+ <li><a href="XFire" title="XFire">XFire</a></li>
+ <li><a href="XPath+Router" title="XPath Router">XPath Router</a></li>
+ <li><a href="XSLT" title="XSLT">XSLT</a></li>
+ <li><a href="XSQL" title="XSQL">XSQL</a></li>
+ <li><a href="VFS" title="VFS">VFS</a></li>
+ <li><a href="WSIF" title="WSIF">WSIF</a></li>
+ </ul>
+ <h3><a name="Navigation-Tooling"></a>Tooling</h3>
+ <ul class="alternate" type="square">
+ <li><a href="Eclipse+plugin" title="Eclipse plugin">Eclipse plugin</a></li>
+ <li><a href="JBoss+Deployer" title="JBoss Deployer">JBoss Deployer</a></li>
+ <li><a href="WAR+Deployment" title="WAR Deployment">WAR Deployment</a></li>
+ <li><a href="Maven+JBI+plugin" title="Maven JBI plugin">Maven JBI plugin</a></li>
+ <li><a href="Maven+SAR+plugin" title="Maven SAR plugin">Maven SAR plugin</a></li>
+ </ul>
+ <h3><a name="Navigation-Utilities"></a>Utilities</h3>
+ <ul class="alternate" type="square">
+ <li><a href="Reflection" title="Reflection">Reflection</a></li>
+ </ul>
+ <h3><a name="Navigation-OtherJBIsoftware"></a>Other JBI software</h3>
+ <ul class="alternate" type="square">
+ <li><span class="nobr"><a href="http://forge.objectweb.org/projects/celtix/" rel="nofollow">Celtix</a></span></li>
+ <li><span class="nobr"><a href="http://pxe.fivesight.com/wiki/display/PXE/Home" rel="nofollow" title="Visit page outside Confluence">PXE BPEL Engine</a></span></li>
+ </ul>
+ <h3><a name="Navigation-RelatedProjects"></a>Related Projects</h3>
+ <ul class="alternate" type="square">
+ <li><span class="nobr"><a href="http://activemq.codehaus.org/" rel="nofollow">ActiveMQ</a></span></li>
+ <li><span class="nobr"><a href="http://jencks.org/" rel="nofollow">Jencks</a></span></li>
+ <li><span class="nobr"><a href="http://lingo.codehaus.org/" rel="nofollow">Lingo</a></span></li>
+ <li><span class="nobr"><a href="http://activesoap.codehaus.org/" rel="nofollow">ActiveSOAP</a></span></li>
+ <li><span class="nobr"><a href="http://www.springframework.org/" rel="nofollow">Spring</a></span></li>
+ <li><span class="nobr"><a href="http://geronimo.apache.org/" rel="nofollow">Geronimo</a></span></li>
+ </ul>
+ <h3><a name="Navigation-Support"></a>Support</h3>
+ <ul class="alternate" type="square">
+ <li><span class="nobr"><a href="http://jira.logicblaze.com/jira/browse/SM" rel="nofollow">Issues</a></span></li>
+ <li><span class="nobr"><a href="http://jira.logicblaze.com/browse/SM?report=com.atlassian.jira.plugin.system.project:roadmap-panel" rel="nofollow">Roadmap</a></span></li>
+ <li><span class="nobr"><a href="http://jira.logicblaze.com/browse/SM?report=com.atlassian.jira.plugin.system.project:changelog-panel" rel="nofollow">Change log</a></span></li>
+ </ul>
+ <h3><a name="Navigation-Developers"></a>Developers</h3>
+ <ul class="alternate" type="square">
+ <li><a href="Source" title="Source">Source</a></li>
+ <li><a href="Roadmap" title="Roadmap">Roadmap</a></li>
+ <li><a href="Ideas" title="Ideas">Ideas</a></li>
+ <li><a href="Becoming+a+committer" title="Becoming a committer">Becoming a committer</a></li>
+ <li><a href="Release+Guide" title="Release Guide">Release Guide</a></li>
+ <li><span class="nobr"><a href="http://ci.codehaus.org/beetlejuice/viewProjectSummary.action?projectName=ServiceMix" rel="nofollow">BeetleJuice</a></span></li>
+ <li><span class="nobr"><a href="http://servicemix.codehaus.org/maven/clover/" rel="nofollow">Clover Report</a></span></li>
+ <li><span class="nobr"><a href="http://servicemix.codehaus.org/maven/xref/index.html" rel="nofollow">Source XRef</a></span></li>
+ <li><span class="nobr"><a href="http://servicemix.codehaus.org/maven/xref-test/index.html" rel="nofollow">Test Source XRef</a></span></li>
+ <li><span class="nobr"><a href="http://servicemix.codehaus.org/maven/servicemix.xsd.html" rel="nofollow">XSD</a></span></li>
+ </ul>
+ <h3><a name="Navigation-Toolsweuse"></a>Tools we use</h3><span><span class="nobr"><a href="http://www.yourkit.com" rel="nofollow"><img align="absmiddle" border=0 src="/download/attachments/25208/yjp.gif"></a></span></span></span>
+
+ <h3 class="heading3">Feeds</h3>
+ <table border="0" cellspacing="4px">
+ <tr>
+ <td align="right">
+ <a href="http://docs.codehaus.org/spaces/rss.action?key=SM&newPages=false"><img src="http://docs.codehaus.org/images/icons/rss.gif" border="0"></a><br/>
+ </td>
+ <td align="left">
+ <a href="http://docs.codehaus.org/spaces/rss.action?key=SM&newPages=false">Site</a>
+ </td>
+ </tr>
+ <tr>
+ <td align="right">
+ <a href="http://docs.codehaus.org/spaces/blogrss.action?key=SM"><img src="http://docs.codehaus.org/images/icons/rss.gif" border="0"></a>
+ </td>
+ <td align="left">
+ <a href="http://docs.codehaus.org/spaces/blogrss.action?key=SM">News</a>
+ </td>
+ </tr>
+ </table>
+ </td>
+ <td id="rightColumn" valign="top">
+
+ <div id="page_title">
+ <table width="100%">
+ <tr>
+ <td>
+ Geronimo Integration
+ </td>
+ <td align="right">
+
+ </td>
+ </tr>
+ </table>
+ </div>
+
+
+ <div>
+ <div id="Content">
+ <h2><a name="GeronimoIntegration-Introduction"></a>Introduction</h2>
+ <p><span class="nobr"><a href="http://geronimo.apache.org" rel="nofollow">Geronimo</a></span> is the J2EE server project of the Apache Software Foundation. ServiceMix is being tightly integrated with Geronimo so that it takes advantage of it's deployment architecture and to leverage Geronimo to implement J2EE JBI bindings.</p>
+ <p><b>Note:</b> The Geronimo deployment tool is currently under development, so this document is not complete, but is provided to give a preview of what is coming. This document will be completed when the underlying code is ready. If you are interested in this topic and how it progresses, please "watch" this page for future changes. To do so, click on "watch" in the upper right corner.</p>
+ <p>In the meantime, the ServiceMix on Geronimo deployment shown here is of the <tt>servicemix-web.war</tt> file. The Tomcat web application server is integrated with Geronimo as part of the Geronimo distribution. Therefore, when the <tt>servicemix-web.war</tt> file is deployed on Geronimo, it is being handed off to Tomcat by Geronimo. Additionally, the war file uses lightweight components, which are those components defined in a <tt>servicemix.xml</tt> file. Ultimately, the ServiceMix deployment on Geronimo will use heavyweight components. Heavyweight components accept service unit deployments, such as PXE. <br> The document is divided into two major sections. The first section discusses deploying ServiceMix on Geronimo. While the Geronimo deployment tool is under development this section shows how to deploy the ServiceMix web war file onto Geronimo. The second major section discusses how to deploy binding components and service engine components on ServiceMix, which is
running on Geronimo. </p>
+ <p>The organization of this document is:</p>
+ <ul>
+ <li><a href="#GeronimoIntegration-GeronimoIntegration">Geronimo Integration</a><ul>
+ <li><a href="#GeronimoIntegration-PreInstallationRequirements">Pre-Installation Requirements</a></li>
+ <li><a href="#GeronimoIntegration-DeployingServiceMixonGeronimo">Deploying ServiceMix on Geronimo</a></li>
+ <li><a href="#GeronimoIntegration-TestingtheServiceMixGeronimoDeployment">Testing the ServiceMix Geronimo Deployment</a></li>
+ <li><a href="#GeronimoIntegration-UndeployingServiceMixonGeronimo">Undeploying ServiceMix on Geronimo</a></li>
+ </ul>
+ </li>
+ <li><a href="#GeronimoIntegration-DeployingJBIComponents">Deploying JBI Components</a><ul>
+ <li><a href="#GeronimoIntegration-DeployingJBIComponentsonServiceMixRunningStandAlone">Deploying JBI Components on ServiceMix Running Stand-Alone</a></li>
+ <li><a href="#GeronimoIntegration-DeployingJBIComponentsonservicemixweb.waronGeronimo">Deploying JBI Components on servicemix-web.war on Geronimo</a></li>
+ <li><a href="#GeronimoIntegration-DeployingJBIComponentsonGeronimo">Deploying JBI Components on Geronimo</a></li>
+ </ul>
+ </li>
+ <li><a href="#GeronimoIntegration-RelatedDocumentation">Related Documentation</a></li>
+ <li><a href="#GeronimoIntegration-Status">Status</a></li>
+ </ul>
+ <h2><a name="GeronimoIntegration-GeronimoIntegration"></a>Geronimo Integration</h2>
+ <p>The following guide explains how to deploy ServiceMix 2.0.x on the <span class="nobr"><a href="http://geronimo.apache.org" rel="nofollow">Geronimo</a></span> application server. </p>
+ <h3><a name="GeronimoIntegration-PreInstallationRequirements"></a>Pre-Installation Requirements</h3>
+ <ul>
+ <li>Java Developer Kit (JDK) 1.4.x or greater to run ServiceMix (to build ServiceMix, JDK 1.5.x or greater is required)</li>
+ <li>The JAVA_HOME environment variable must be set to the directory where the JDK is installed, e.g. <tt>c:\Program Files\Java\jdk1.5.xx</tt>.</li>
+ <li>Maven 1.0.2 or greater (required when installing source or developer releases).</li>
+ <li>Geronimo version 1.0-M5 (Geronimo version 1.0-SNAPSHOT for deploying components)</li>
+ <li>ServiceMix 2.0.x</li>
+ </ul>
+ <p>The following platform was used to produce this deployment guide:</p>
+ <ul>
+ <li>Windows XP</li>
+ <li>Geronimo 1.0-M5 (Geronimo 1.0-SNAPSHOT for component deployment)</li>
+ <li>Java 5</li>
+ <li>ServiceMix 2.0.x</li>
+ </ul>
+ <h3><a name="GeronimoIntegration-DeployingServiceMixonGeronimo"></a>Deploying ServiceMix on Geronimo</h3>
+ <p>Execute the following steps to deploy ServiceMix on Geronimo. <b>NOTE:</b> This procedure will work on Unix platforms, as well as the Windows platform, with the appropriate substitutions, such as using the backslash ( / ) instead of the forward slash ( \ ).</p>
+ <p class="paragraph">
+ <ol>
+ <li>Geronimo must be downloaded and installed. For instructions please see the <span class="nobr"><a href="http://geronimo.apache.org" rel="nofollow">Geronimo</a></span> web site. In the Geronimo release of geronimo-1.0-M5 or greater, Tomcat is integrated with Geronimo. By default, Tomcat uses port 8080. This information will be used later.</li>
+ <li>Download the ServiceMix source code. Please see the <span class="nobr"><a href="http://www.servicemix.org/Getting+Started" rel="nofollow">Getting Started</a></span> guide for instructions.</li>
+ <li>Create the WAR file: <div class="code">
+ <div class="codeContent"><pre class="code-java">cd [servicemix_install_dir]\tooling\servicemix-web
+maven war</pre></div>
+ </div>
+ <p>where <tt>servicemix_install_dir</tt> is the directory in which ServiceMix was downloaded and installed. The war file can be found in <tt>[servicemix_install_dir]\tooling\servicemix-web\target\servicemix-web.war</tt>.</p>
+ </li>
+ <li>To deploy the ServiceMix WAR file on Geronimo, use the Geronimo <tt>deployer.jar</tt> tool found in the <tt>bin</tt> directory of the Geronimo base directory.<br> From a command shell: <div class="code">
+ <div class="codeContent"><pre class="code-java">cd [geronimo_install_dir]
+java -jar bin/deployer.jar --user system --password manager deploy [servicemix-2.0.x_install_dir]\tooling\servicemix-web\target\servicemix-web.war</pre></div>
+ </div>
+ <p>
+ <br clear="all"> You will see output similar to this:</p>
+ <div class="code">
+ <div class="codeContent"><pre class="code-java">Deployed servicemix-web @ http:<span class="code-comment">//Lisas:8080/servicemix-web</span></pre></div>
+ </div>
+ <p>The output in the Geronimo console window should show ServiceMix starting. Output will be similar to the following. This WAR file was not developed for use on Geronimo, but for use on Tomcat stand-alone, therefore, it does not contain a geronimo-web.xml deployment plan. For using the <tt>servicemix-web.war</tt> file on Tomcat, please see <span class="nobr"><a href="http://www.servicemix.org/Tomcat+Integration" rel="nofollow">Tomcat Integration</a></span>.</p>
+ <div class="code">
+ <div class="codeContent"><pre class="code-java">...
+Geronimo Application Server started
+13:13:17,062 WARN [JettyModuleBuilder] Web application does not contain a WEB-INF/geronimo-web.xml deployment plan. This may or may not
+ a problem, depending on whether you have things like resource references that need to be resolved. You can also give the deployer a sep
+te deployment plan file on the command line.</pre></div>
+ </div>
+ <p>If Geronimo is restarted the console log will show ServiceMix starting, as shown below. <b>Note:</b> Geronimo does not need to be restarted to deploy the WAR file. </p>
+ <div class="code">
+ <div class="codeContent"><pre class="code-java">Booting Geronimo Kernel (in Java 1.5.0_05)...
+Starting Geronimo Application Server
+[*****************] 100% 45s Startup complete
+ Listening on Ports:
+ 1099 0.0.0.0 RMI Naming
+ 1527 0.0.0.0 Derby Connector
+ 4201 0.0.0.0 ActiveIO Connector EJB
+ 4242 0.0.0.0 Remote Login Listener
+ 8019 0.0.0.0 Tomcat Connector AJP
+ 8080 0.0.0.0 Jetty Connector HTTP
+ 8090 0.0.0.0 Tomcat Connector HTTP
+ 8443 0.0.0.0 Jetty Connector HTTPS
+ 8453 0.0.0.0 Tomcat Connector HTTPS
+ 61616 0.0.0.0 ActiveMQ Message Broker Connector
+ Started Application Modules:
+ EAR: org/apache/geronimo/Console/Jetty
+ WAR: org/apache/geronimo/applications/Welcome/Jetty
+ WAR: servicemix-web
+ Web Applications:
+ http:<span class="code-comment">//Lisas:8080/
+</span> http:<span class="code-comment">//Lisas:8080/console
+</span> http:<span class="code-comment">//Lisas:8080/console-standard
+</span> http:<span class="code-comment">//Lisas:8080/servicemix-web
+</span>Geronimo Application Server started</pre></div>
+ </div>
+ <p><b>NOTE:</b> The console output is also logged in <tt>geronimo_install_dir\var\log\deployer.log</tt>.</p>
+ </li>
+ </ol>
+ </p>
+ <h3><a name="GeronimoIntegration-TestingtheServiceMixGeronimoDeployment"></a>Testing the ServiceMix Geronimo Deployment</h3>
+ <p>To ensure that ServiceMix is running on Geronimo, do any of the following:</p>
+ <p class="paragraph">
+ <ol>
+ <li>Use Geronimo's "list-modules" option on <tt>deployer.jar</tt> to see the <tt>servicemix-web</tt> application: <div class="code">
+ <div class="codeContent"><pre class="code-java">cd [geronimo_install_dir]
+java -jar bin/deployer.jar --user system --password manager list-modules</pre></div>
+ </div>
+ <p>Output will be similar to:</p>
+ <div class="code">
+ <div class="codeContent"><pre class="code-java">Found 33 modules
+ + org/apache/geronimo/Tomcat
+ + org/apache/geronimo/Jetty
+ + org/apache/geronimo/RMINaming
+ + org/apache/geronimo/ActiveMQServer
+ + org/apache/geronimo/TomcatRuntimeDeployer
+ + org/apache/geronimo/Server
+ + org/apache/geronimo/Security
+ + servicemix-web @ http:<span class="code-comment">//Lisas:8080/servicemix-web
+</span> + org/apache/geronimo/SystemDatabase
+ + org/apache/geronimo/applications/Welcome/Jetty @ http:<span class="code-comment">//Lisas:8080/
+</span> + org/apache/geronimo/SystemJMS
+...</pre></div>
+ </div>
+ <p>
+ <br clear="all">
+ <br clear="all">
+ </p>
+ </li>
+ <li>ServiceMix's default port is 1099. From another window run netstat and search for port 1099. <br clear="all"> From a Windows console, type: <div class="code">
+ <div class="codeContent"><pre class="code-java">netstat -an|find <span class="code-quote">"1099"</span></pre></div>
+ </div>
+ <p>
+ <br clear="all"><b>OR</b><br clear="all">
+ <br clear="all"> From a Unix command shell, type:</p>
+ <div class="code">
+ <div class="codeContent"><pre class="code-java">netstat -an|grep 1099</pre></div>
+ </div>
+ <p>
+ <br clear="all">
+ </p>
+ </li>
+ <li>Run the ServiceMix JMX Console. To do this, enter the following URL in a web browser: <span class="nobr"><a href="http://localhost:8080/servicemix-web:" rel="nofollow">http://localhost:8080/servicemix-web:</a></span><br clear="all">
+ <br clear="all"><img align="absmiddle" border=0 src="/download/attachments/28063/jmxconsolegeronimo.jpg"><br clear="all">
+ <br clear="all">
+ </li>
+ <li>An http binding example is supplied. To run the example program perform the following steps: <ol>
+ <li>From a browser, enter the URL <span class="nobr"><a href="http://localhost:8080/servicemix-web/examples" rel="nofollow">http://localhost:8080/servicemix-web/examples</a></span>. <br clear="all">
+ <br clear="all"><img align="absmiddle" border=0 src="/download/attachments/28063/httpbindingexample2.0.jpg"><br clear="all">
+ <br clear="all">
+ </li>
+ <li>Enter a name or some text in the text box (shown above) and click the Submit button. You will see: <br clear="all">
+ <br clear="all"><img align="absmiddle" border=0 src="/download/attachments/28063/httpbindingresultgeronimo.jpg"><br clear="all">
+ <br clear="all">
+ <br clear="all">
+ </li>
+ </ol>
+ </li>
+ </ol>
+ </p>
+ <h3><a name="GeronimoIntegration-UndeployingServiceMixonGeronimo"></a>Undeploying ServiceMix on Geronimo</h3>
+ <p>Execute the following steps to undeploy ServiceMix from Geronimo. </p>
+ <p class="paragraph">
+ <ol>
+ <li>To undeploy the ServiceMix WAR file, use the Geronimo <tt>deployer.jar</tt> tool found in the <tt>bin</tt> directory of the Geronimo base directory.<br> From a command shell: <div class="code">
+ <div class="codeContent"><pre class="code-java">cd [geronimo_install_dir]
+java -jar bin/deployer.jar --user system --password manager undeploy servicemix-web</pre></div>
+ </div>
+ <p>
+ <br clear="all"> The output in the Geronimo console window should show the ServiceMix WAR file being undeployed. Output will be similar to the following:</p>
+ <div class="code">
+ <div class="codeContent"><pre class="code-java">Module servicemix-web stopped.
+
+ Module servicemix-web unloaded.
+
+ Module servicemix-web uninstalled.
+
+ Undeployed servicemix-web</pre></div>
+ </div>
+ </li>
+ </ol>
+ </p>
+ <h2><a name="GeronimoIntegration-DeployingJBIComponents"></a>Deploying JBI Components</h2>
+ <p>Components can be deployed on ServiceMix in various configurations. For example, components can be deployed on ServiceMix running stand-alone or components can be deployed on ServiceMix which itself is deployed on an application server such as Geronimo.</p>
+ <p>First some background. A JBI component is either a service engine (SE) or a binding component (BC). These terms are defined in <a href="Introduction+to+ESB" title="Introduction to ESB">Introduction to ESB</a> and/or the <a href="Glossary" title="Glossary">Glossary</a>. A BC/SE is <b>installed</b> on ServiceMix by copying it into the <tt>install</tt> directory which resides under the ServiceMix home directory. So what gets deployed? JBI components can act as containers themselves. Artifacts can be <b>deployed</b> to an existing BC or SE to add more functionality to that component. Adding artifacts to installed components is called deployment. To deploy artifacts to a component the artifacts can be placed in the <tt>deploy</tt> directory under the ServiceMix home directory. Another term that is important to know is <em>service assembly</em>. A service assembly is a collection of deployment artifacts and metadata. A <em>service unit</em> is a single deployment artifact w
hich is deployed on a single component. For deployment to happen, the artifacts must be in a very specific format, which is specified in the JSR 208 specification. Please see chapter 6 of the <span class="nobr"><a class="createlink" href="http://docs.codehaus.org/pages/createpage.action?spaceKey=SM&title=copy+link+here&linkCreation=true&fromPageId=28063">JSR 208</a></span> specification for more details. In addition to deploying components, ServiceMix allows <tt>servicemix.xml</tt> files to be deployed in a similar method to deploying a component. </p>
+ <h3><a name="GeronimoIntegration-DeployingJBIComponentsonServiceMixRunningStandAlone"></a>Deploying JBI Components on ServiceMix Running Stand-Alone</h3>
+ <p>This section is included to show how to deploy a ServiceMix component on ServiceMix running stand-alone. It is helpful to see how this deployment is done to build up to the deployment on Geronimo. </p>
+ <p><b>Note:</b> These steps work on ServiceMix versions prior to 2.0, but it is now broken. Please see Jira issue: <span class="nobr"><a href="https://support.simulalabs.com/jira/browse/SM-154" rel="nofollow">SM-154</a></span>.</p>
+ <p>The following example shows a component "org.servicemix.components.servicemix.ServiceMixComponent" being deployed and then a service unit (Quartz) being deployed to the ServiceMixComponent. Note: that the service unit is a <tt>servicemix.xml</tt> file.</p>
+ <p>These steps were performed with a source distribution of ServiceMix 2.0.2 on Windows XP. The existing quartz binding example is modified in this example to turn it into a deployement unit.</p>
+ <p class="paragraph">
+ <ol>
+ <li>Modify the quartz binding <tt>servicemix.xml</tt> file to change it into a service unit. The <tt>servicemix.xml</tt> file is located in <tt>[servicemix_src_install_dir]\assembly\target\servicemix-2.0.2\bin\servicemix-2.0.2\examples\quartz-binding</tt>, where [servicemix_src_install_dir] is the directory in which the source distribution of ServiceMix is located.</li>
+ <li>Create a directory elsewhere, such as \temp\JBIcomponent</li>
+ <li>Copy servicemix.xml to \temp\JBIcomponent</li>
+ <li>cd \temp\JBIcomponent</li>
+ <li>Edit the <tt>servicemix.xml</tt> file. Change the "container" tags to "serviceunit" and save the file. The file should match the following: <div class="code">
+ <div class="codeContent"><pre class="code-java"><?xml version=<span class="code-quote">"1.0"</span> encoding=<span class="code-quote">"UTF-8"</span>?>
+<beans xmlns=<span class="code-quote">"http:<span class="code-comment">//xbean.org/schemas/spring/1.0"</span>
+</span> xmlns:spring=<span class="code-quote">"http:<span class="code-comment">//xbean.org/schemas/spring/1.0"</span>
+</span> xmlns:sm=<span class="code-quote">"http:<span class="code-comment">//servicemix.org/config/1.0"</span>
+</span> xmlns:xsi=<span class="code-quote">"http:<span class="code-comment">//www.w3.org/2001/XMLSchema-instance"</span>
+</span> xsi:schemaLocation="http:<span class="code-comment">//xbean.org/schemas/spring/1.0 ../../conf/spring-beans.xsd
+</span> http:<span class="code-comment">//servicemix.org/config/1.0 ../../conf/servicemix.xsd"
+</span> xmlns:my=<span class="code-quote">"http:<span class="code-comment">//servicemix.org/demo/"</span>>
+</span>
+ <!-- the JBI container -->
+ <sm:serviceunit spring:id=<span class="code-quote">"jbi"</span>>
+
+ <sm:activationSpecs>
+
+ <!-- lets kick off a timer every 5 seconds -->
+ <sm:activationSpec componentName=<span class="code-quote">"timer"</span> service=<span class="code-quote">"my:timer"</span>
+ destinationService=<span class="code-quote">"my:trace"</span>>
+ <sm:component>
+ <bean xmlns=<span class="code-quote">"http:<span class="code-comment">//xbean.org/schemas/spring/1.0"</span>
+</span> class=<span class="code-quote">"org.servicemix.components.quartz.QuartzComponent"</span>>
+ <property name=<span class="code-quote">"triggers"</span>>
+ <map>
+ <entry>
+ <key>
+ <bean class=<span class="code-quote">"org.quartz.SimpleTrigger"</span>>
+ <property name=<span class="code-quote">"repeatInterval"</span> value=<span class="code-quote">"5000"</span> />
+ <property name=<span class="code-quote">"repeatCount"</span> value=<span class="code-quote">"-1"</span> />
+ </bean>
+ </key>
+ <bean
+ class=<span class="code-quote">"org.quartz.JobDetail"</span>>
+ <property name=<span class="code-quote">"name"</span> value=<span class="code-quote">"My Example Job"</span> />
+ <property name=<span class="code-quote">"group"</span> value=<span class="code-quote">"ServiceMix"</span> />
+ </bean>
+ </entry>
+ </map>
+ </property>
+ </bean>
+ </sm:component>
+ </sm:activationSpec>
+
+
+ <!-- Route the event to a trace component that just outputs the event to the console -->
+ <sm:activationSpec componentName=<span class="code-quote">"trace"</span> service=<span class="code-quote">"my:trace"</span>>
+ <sm:component>
+ <bean xmlns=<span class="code-quote">"http:<span class="code-comment">//xbean.org/schemas/spring/1.0"</span>
+</span> class=<span class="code-quote">"org.servicemix.components.util.TraceComponent"</span> />
+ </sm:component>
+ </sm:activationSpec>
+
+ </sm:activationSpecs>
+ </sm:serviceunit>
+
+</beans></pre></div>
+ </div>
+ <p>This file will be used in a later step. <br clear="all">
+ </p>
+ </li>
+ <li>Two jar files must be created. These jar files will be copied into the ServiceMix <tt>deploy</tt> directory. The first jar file will contain the service component <tt>jbi.xml</tt> file. When this is copied to the <tt>deploy</tt> directory it deploys the <tt>ServiceMixComponent</tt> component. The second jar file will contain the service assembly and the <tt>jbi.xml</tt> descriptor file. When it is copied to the <tt>deploy</tt> directory of ServiceMix it deploys the service unit (Quartz) to the previously deployed component, <tt>ServiceMixComponent</tt>. <ol>
+ <li>The file service component <tt>jbi.xml</tt> file should contain: <div class="code">
+ <div class="codeContent"><pre class="code-java"><jbi xmlns=<span class="code-quote">"http:<span class="code-comment">//java.sun.com/xml/ns/jbi"</span>
+</span> xmlns:xsi=<span class="code-quote">"http:<span class="code-comment">//www.w3.org/2001/XMLSchema-instance"</span>
+</span> xsi:schemaLocation=<span class="code-quote">"http:<span class="code-comment">//java.sun.com/xml/ns/jbi"</span>
+</span> version=<span class="code-quote">"1.0"</span>>
+
+ <component type=<span class="code-quote">"service-engine"</span>>
+ <identification>
+ <name>servicemix-component</name>
+ <description>A ServiceMix Component that can be used to deploy servicemix.xml artifacts.</description>
+ </identification>
+ <component-class-name>org.servicemix.components.servicemix.ServiceMixComponent</component-class-name>
+ <component-class-path/>
+ </component>
+
+</jbi></pre></div>
+ </div>
+ </li>
+ <li>Put <tt>jbi.xml</tt> in an empty META-INF directory and put that into a jar file: <div class="code">
+ <div class="codeContent"><pre class="code-java">mkdir META-INF
+copy jbi.xml META-INF
+jar cvf service-component.jar *</pre></div>
+ </div>
+ </li>
+ <li>Create a zip file of the <tt>servicemix.xml</tt> file you modified above. The zip file should contain the <tt>servicemix.xml</tt> file and it should be called su1.zip to match the name it is called in the <tt>jbi.xml</tt> file. See the <tt>artifacts-name</tt> tag in the <tt>jbi.xml</tt> file for the name of the zip file.</li>
+ <li>Create the second jar file--this is the service assembly jar file. It will contain another <tt>jbi.xml</tt> file that is used for the service assembly and it will also contain the zip file, <tt>su1.zip</tt> in the following structure:<br> The service assembly <tt>jbi.xml</tt> should be match the following: <div class="code">
+ <div class="codeContent"><pre class="code-java"><jbi xmlns=<span class="code-quote">"http:<span class="code-comment">//java.sun.com/xml/ns/jbi"</span>
+</span> xmlns:xsi=<span class="code-quote">"http:<span class="code-comment">//www.w3.org/2001/XMLSchema-instance"</span>
+</span> xsi:schemaLocation=<span class="code-quote">"http:<span class="code-comment">//java.sun.com/xml/ns/jbi"</span>
+</span> version=<span class="code-quote">"1.0"</span>>
+
+ <service-assembly>
+ <identification>
+ <name>AU_1</name>
+ <description>Sample AU</description>
+ </identification>
+ <service-unit>
+ <identification>
+ <name>SU_1</name>
+ <description>Sample</description>
+ </identification>
+ <target>
+ <artifacts-zip>su1.zip</artifacts-zip>
+ <component-name>servicemix-component</component-name>
+ </target>
+ </service-unit>
+ </service-assembly>
+
+</jbi></pre></div>
+ </div>
+ <p>Copy the <tt>jbi.xml</tt> file to an empty META-INF directory, then create the jar file:</p>
+ <div class="code">
+ <div class="codeContent"><pre class="code-java">In a directory which contains these files, create the jar file:
+ META-INF/jbi.xml
+ su1.zip
+
+jar cvf sa_quartz.jar *</pre></div>
+ </div>
+ </li>
+ </ol>
+ </li>
+ <li>Deploy the two jar files. Copy <tt>service_component.jar</tt> and <tt>sa_quartz.jar</tt> to <tt>[servicemix_src_install_dir]\assembly\target\servicemix-2.0.\bin\servicemix-2.0.2\deploy</tt>. This can be done while ServiceMix is running or while ServiceMix is not running. In the second case, run ServiceMix to see the deployment. Output will be similar to: <div class="code">
+ <div class="codeContent"><pre class="code-java">ServiceMixComponent: deploy
+ServiceMixComponent: init: SU_1 path: C:\tmp1\servicemix-1.1-SNAPSHOT\target\servicemix-1.1-SNAPSHOT\bin\servicemix-1.1-SNAPSHOT\bin\..\wdir
+\defaultJBI\components\servicemix-component\serviceunit\SU_1
+[INFO] XmlBeanDefinitionReader - -Loading XML bean definitions from URL [file:C:/tmp1/servicemix-1.1-SNAPSHOT/target/servicemix-1.1-SNAPSHOT
+/bin/servicemix-1.1-SNAPSHOT/bin/../wdir/defaultJBI/components/servicemix-component/serviceunit/SU_1/servicemix.xml]
+...
+[INFO] DefaultListableBeanFactory - -Creating shared instance of singleton bean 'jbi'
+ServiceMixComponent: start: SU_1
+[INFO] JBIContainer - -Activating component <span class="code-keyword">for</span>: [container=defaultJBI,name=timer,id=timer] with service: {http:<span class="code-comment">//servicemix.org/demo/}timer
+</span> component: org.servicemix.components.quartz.QuartzComponent@1ecfe07
+[INFO] SimpleThreadPool - -Job execution threads will use class loader of thread: main
+[INFO] RAMJobStore - -RAMJobStore initialized.
+[INFO] StdSchedulerFactory - -Quartz scheduler 'DefaultQuartzScheduler' initialized from <span class="code-keyword">default</span> resource file in Quartz <span class="code-keyword">package</span>: 'quartz.pr
+operties'
+[INFO] StdSchedulerFactory - -Quartz scheduler version: 1.4.0
+[INFO] ComponentContextImpl - -Component: timer activated endpoint: {http:<span class="code-comment">//servicemix.org/demo/}timer : timer
+</span>[INFO] JBIContainer - -Activating component <span class="code-keyword">for</span>: [container=defaultJBI,name=trace,id=trace] with service: {http:<span class="code-comment">//servicemix.org/demo/}trace
+</span> component: org.servicemix.components.util.TraceComponent@8b8a47
+[INFO] ComponentContextImpl - -Component: trace activated endpoint: {http:<span class="code-comment">//servicemix.org/demo/}trace : trace
+</span>[INFO] DeploymentService - -Deployed ServiceUnit SU_1 to Component: servicemix-component
+[INFO] AutoDeploymentService - -Unpacked archive C:\tmp1\servicemix-1.1-SNAPSHOT\target\servicemix-1.1-SNAPSHOT\bin\servicemix-1.1-SNAPSHOT\
+bin\..\deploy\comp.jar to C:\tmp1\servicemix-1.1-SNAPSHOT\target\servicemix-1.1-SNAPSHOT\bin\servicemix-1.1-SNAPSHOT\bin\..\wdir\defaultJBI\
+tmp\comp.0.tmp
+[INFO] XmlBeanDefinitionReader - -Loading XML bean definitions from URL [file:/C:/tmp1/servicemix-1.1-SNAPSHOT/target/servicemix-1.1-SNAPSHO
+T/bin/servicemix-1.1-SNAPSHOT/bin/../wdir/defaultJBI/tmp/comp.0.tmp/META-INF/jbi.xml]
+...
+[INFO] DefaultListableBeanFactory - -Creating shared instance of singleton bean 'jbi'
+[INFO] AutoDeploymentService - -Unpacked archive C:\tmp1\servicemix-1.1-SNAPSHOT\target\servicemix-1.1-SNAPSHOT\bin\servicemix-1.1-SNAPSHOT\
+bin\..\deploy\sa_quartz.jar to C:\tmp1\servicemix-1.1-SNAPSHOT\target\servicemix-1.1-SNAPSHOT\bin\servicemix-1.1-SNAPSHOT\bin\..\wdir\defaul
+tJBI\tmp\sa_quartz.0.tmp
+[INFO] XmlBeanDefinitionReader - -Loading XML bean definitions from URL [file:/C:/tmp1/servicemix-1.1-SNAPSHOT/target/servicemix-1.1-SNAPSHO
+T/bin/servicemix-1.1-SNAPSHOT/bin/../wdir/defaultJBI/tmp/sa_quartz.0.tmp/META-INF/jbi.xml]
+[INFO] FileSystemXmlApplicationContext - -Bean factory <span class="code-keyword">for</span> application context [org.springframework.context.support.FileSystemXmlApplication
+[INFO] JBIContainer - -ServiceMix JBI Container (http:<span class="code-comment">//servicemix.org/) name: defaultJBI running version: ServiceMix.
+</span>[INFO] DeliveryChannel - -<span class="code-keyword">default</span> destination serviceName <span class="code-keyword">for</span> timer = {http:<span class="code-comment">//servicemix.org/demo/}trace
+</span>[INFO] QuartzScheduler - -Scheduler DefaultQuartzScheduler_$_NON_CLUSTERED started.
+[INFO] TraceComponent - -Exchange: org.servicemix.jbi.messaging.InOnlyImpl@a7dd39 received IN message: org.servicemix.jbi.messaging.Normaliz
+edMessageImpl@acdd02{properties: {org.servicemix.quartz.context=JobExecutionContext: trigger: 'ServiceMix.My Example Job job: ServiceMix.My
+Example Job fireTime: 'Thu Dec 08 14:15:06 PST 2005 scheduledFireTime: Thu Dec 08 14:15:05 PST 2005 previousFireTime: '<span class="code-keyword">null</span> nextFireTime: Th
+u Dec 08 14:15:06 PST 2005 isRecovering: <span class="code-keyword">false</span> refireCount: 0, org.servicemix.quartz.detail=JobDetail 'ServiceMix.My Example Job': jobClass
+: 'org.servicemix.components.quartz.ServiceMixJob isStateful: <span class="code-keyword">false</span> isVolatile: <span class="code-keyword">false</span> isDurable: <span class="code-keyword">false</span> requestsRecovers: <span class="code-keyword">false</span>, org.servicem
+ix.component=org.servicemix.components.quartz.QuartzComponent@1ecfe07}}
+[INFO] TraceComponent - -Body is: <?xml version=<span class="code-quote">"1.0"</span> encoding=<span class="code-quote">"UTF-8"</span>?><timer><name>My Example Job</name><group>ServiceMix</group><fullname
+>ServiceMix.My Example Job</fullname><description/><fireTime>Thu Dec 08 14:15:06 PST 2005</fireTime></timer>
+[INFO] TraceComponent - -Exchange: org.servicemix.jbi.messaging.InOnlyImpl@19ecd80 received IN message: org.servicemix.jbi.messaging.Normali
+zedMessageImpl@c5aa00{properties: {org.servicemix.quartz.context=JobExecutionContext: trigger: 'ServiceMix.My Example Job job: ServiceMix.My
+ Example Job fireTime: 'Thu Dec 08 14:15:06 PST 2005 scheduledFireTime: Thu Dec 08 14:15:06 PST 2005 previousFireTime: 'Thu Dec 08 14:15:05
+PST 2005 nextFireTime: Thu Dec 08 14:15:06 PST 2005 isRecovering: <span class="code-keyword">false</span> refireCount: 0, org.servicemix.quartz.detail=JobDetail 'ServiceMix.M
+y Example Job': jobClass: 'org.servicemix.components.quartz.ServiceMixJob isStateful: <span class="code-keyword">false</span> isVolatile: <span class="code-keyword">false</span> isDurable: <span class="code-keyword">false</span> requestsReco
+vers: <span class="code-keyword">false</span>, org.servicemix.component=org.servicemix.components.quartz.QuartzComponent@1ecfe07}}
+[INFO] TraceComponent - -Body is: <?xml version=<span class="code-quote">"1.0"</span> encoding=<span class="code-quote">"UTF-8"</span>?><timer><name>My Example Job</name><group>ServiceMix</group><fullname
+>ServiceMix.My Example Job</fullname><description/><fireTime>Thu Dec 08 14:15:06 PST 2005</fireTime></timer></pre></div>
+ </div>
+ </li>
+ </ol>
+ </p>
+ <h3><a name="GeronimoIntegration-DeployingComponentsonservicemixweb.war"></a>Deploying Components on servicemix-web.war</h3>
+ <p>This section is on hold until the Jira issue: is fixed.</p>
+ <h3><a name="GeronimoIntegration-DeployingJBIComponentsonGeronimoUsingtheGeronimoDeploymentTool"></a>Deploying JBI Components on Geronimo Using the Geronimo Deployment Tool</h3>
+ <p>This section discusses using the Geronimo deployment tool to deploy components. This is separate from the previous sections<br> dealing with the servicemix-web.war file. When the deployment tool is fully developed this will be the preferred method.<br> Currently only geronimo-1.0-SNAPSHOT can be used to perform this method. </p>
+ <p>The JBI spec describes in detail how to create a valid JBI deployment unit. In essence, it is a jar file with a META-INF/jbi.xml with other resource jars inside it. Please see <span class="nobr"><a class="createlink" href="http://docs.codehaus.org/pages/createpage.action?spaceKey=SM&title=Deployment+Units&linkCreation=true&fromPageId=28063">Deployment Units</a></span> for more information.</p>
+ <p class="paragraph">
+ <ol>
+ <li>Make sure that your geronimo server is running.</li>
+ <li>Run the geronimo deploy tool against your deployment unit (in this case jbcomponent.jar): <div class="code">
+ <div class="codeContent"><pre class="code-java">java -jar geronimo-1.0-SNAPSHOT/bin/deployer.jar --user system --password manager deploy jbcomponent.jar</pre></div>
+ </div>
+ </li>
+ </ol>
+ </p>
+ <p>That should deploy the component to geronimo. To check, just take a look at the geronimo logs for a message similar to:</p>
+ <p class="paragraph">
+ <div class="code">
+ <div class="codeContent"><pre class="code-java">11:44:24,865 INFO [Configuration] Started configuration example-engine-1
+11:44:24,869 INFO [ServiceMixDeployment] Starting: /Users/chirino/sandbox/geronimo/modules/assembly/target/geronimo-1.0-SNAPSHOT/config-store/20/META-INF/jbi.xml
+...
+11:44:25,783 INFO [DefaultListableBeanFactory] Creating shared instance of singleton bean 'jbi'</pre></div>
+ </div>
+ </p>
+ <h2><a name="GeronimoIntegration-RelatedDocumentation"></a>Related Documentation</h2>
+ <ul>
+ <li><span class="nobr"><a href="http://apache.geronimo.org" rel="nofollow">Geronimo</a></span></li>
+ <li><span class="nobr"><a href="http://www.servicemix.org/Tomcat+Integration" rel="nofollow">Tomcat Integration</a></span>.</li>
+ </ul>
+ <h2><a name="GeronimoIntegration-Status"></a>Status</h2>
+ <p>Please monitor the Jira issue <span class="nobr"><a href="https://jira.logicblaze.com/jira/browse/SM-140" rel="nofollow">SM-140</a></span> to get currrent information on the Geronimo deployer for ServiceMix.</p>
+ <p>Please monitor the Jira issue <span class="nobr"><a href="https://support.simulalabs.com/jira/browse/SM-154" rel="nofollow">SM-154</a></span> to get current information on the component deployment bug.</p>
+ </div>
+</div>
+
+
+ </td>
+ </tr>
+ <tr>
+ <td colspan="3" id="footer">
+ <table width="100%">
+ <tr>
+ <td align="left" valign="top">
+
+ </td>
+ <td align="right" valign="top">
+ <a style="color:#999;" href="http://docs.codehaus.org/pages/editpage.action?spaceKey=SM&title=Geronimo+Integration">[ edit ]</a>
+ </td>
+ </tr>
+ <table>
+ </td>
+ </tr>
+ </table>
+ </body>
+
+</html>
+
+
Added: incubator/servicemix/site/Getting+Started
URL: http://svn.apache.org/viewcvs/incubator/servicemix/site/Getting%2BStarted?rev=374419&view=auto
==============================================================================
--- incubator/servicemix/site/Getting+Started (added)
+++ incubator/servicemix/site/Getting+Started Thu Feb 2 08:12:18 2006
@@ -0,0 +1,567 @@
+
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+ <head>
+ <link rel="stylesheet" href="site.css" type="text/css">
+
+
+
+ <title>ServiceMix - Getting Started</title>
+ </head>
+
+ <body>
+ <table width="100%" id="layout" style="padding:0px;margin0px;border-collapse:collapse;">
+ <tr>
+ <td colspan="3" style="padding:8px;">
+ <table width="100%" id="banner" style="padding:0px;margin:0px">
+ <tr id="header_row">
+ <td align="left" valign="middle" style="padding:0px;margin:0px;">
+ <span id="Content"><span><span class="nobr"><a href="http://incubator.apache.org/servicemix" rel="nofollow"><img align="absmiddle" border=0 src="images/logo.gif"></a></span></span></span>
+
+ </td>
+
+ </tr>
+ </table>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="3" id="breadcrumbs">
+ <table width="100%" id="banner" style="padding:0px;margin:0px">
+ <tr>
+ <td align="left">
+ <a href="">Home</a> | <a href="Navigation">Navigation</a> > Getting Started
+ </td>
+ <td align="right">
+ <span id="Content"><span><a href="Download" title="Download">Download</a> | <span class="nobr"><a href="http://servicemix.codehaus.org/maven/servicemix-core/apidocs/" rel="nofollow">JavaDocs</a></span> | <a href="Source" title="Source">Source</a> | <span class="nobr"><a href="http://docs.codehaus.org/pages/listpages.action?key=SM" rel="nofollow">Wiki</a></span> |<span class="nobr"><a href="irc://irc.codehaus.org/servicemix" rel="nofollow">IRC</a></span> | <span class="nobr"><a href="http://servlet.uwyn.com/drone/log/hausbot/servicemix" rel="nofollow">IRC Log</a></span> | <a href="Mailing+Lists" title="Mailing Lists">Mailing Lists</a> | <span class="nobr"><a href="http://forums.logicblaze.com/forums/show/3.page" rel="nofollow">Discussion Forum</a></span>| <span class="nobr"><a href="http://jira.logicblaze.com/jira/browse/SM" rel="nofollow">Support</a></span></span></span>
+
+ </td>
+ </tr>
+ </table>
+ </td>
+ </tr>
+ <tr>
+ <td id="leftColumn" valign="top" style="padding-top: 0px;">
+ <span id="Content"><h3><a name="Navigation-Overview"></a>Overview</h3>
+ <ul class="alternate" type="square">
+ <li><a href="Home" title="Home">Home</a></li>
+ <li><a href="Introduction+to+ESB" title="Introduction to ESB">Introduction to ESB</a></li>
+ <li><a href="Background+to+ServiceMix" title="Background to ServiceMix">Background to ServiceMix</a></li>
+ <li><a href="News" title="News">News</a></li>
+ <li><a href="FAQ" title="FAQ">FAQ</a></li>
+ <li><a href="Download" title="Download">Download</a></li>
+ </ul>
+ <h3><a name="Navigation-Community"></a>Community</h3>
+ <ul class="alternate" type="square">
+ <li><span class="nobr"><a href="http://docs.codehaus.org/pages/listpages.action?key=SM" rel="nofollow">Wiki</a></span></li>
+ <li><a href="Mailing+Lists" title="Mailing Lists">Mailing Lists</a></li>
+ <li><a href="Contributing" title="Contributing">Contributing</a></li>
+ <li><a href="Team" title="Team">Team</a></li>
+ <li><a href="Users" title="Users">Users</a></li>
+ </ul>
+ <h3><a name="Navigation-Documentation"></a>Documentation</h3>
+ <ul class="alternate" type="square">
+ <li><a href="Getting+Started" title="Getting Started">Getting Started</a></li>
+ <li><a href="Running" title="Running">Running</a></li>
+ <li><a href="Examples" title="Examples">Examples</a></li>
+ <li><a href="Use+Cases" title="Use Cases">Use Cases</a></li>
+ <li><a href="Configuration" title="Configuration">Configuration</a></li>
+ <li><a href="Xml+Reference" title="Xml Reference">Xml Reference</a></li>
+ <li><a href="Management" title="Management">Management</a></li>
+ <li><a href="Architecture" title="Architecture">Architecture</a></li>
+ <li><a href="Clustering" title="Clustering">Clustering</a></li>
+ <li><a href="NMR+Flows" title="NMR Flows">NMR Flows</a></li>
+ <li><a href="Articles" title="Articles">Articles</a></li>
+ </ul>
+ <h3><a name="Navigation-Reference"></a>Reference</h3>
+ <ul class="alternate" type="square">
+ <li><span class="nobr"><a href="http://java.sun.com/integration/1.0/docs/sdk/api/index.html" rel="nofollow">JBI API</a></span></li>
+ <li><span class="nobr"><a href="http://servicemix.codehaus.org/maven/servicemix-core/apidocs/" rel="nofollow">JavaDocs</a></span></li>
+ <li><a href="Glossary" title="Glossary">Glossary</a></li>
+ </ul>
+ <h3><a name="Navigation-Features"></a>Features</h3>
+ <ul class="alternate" type="square">
+ <li><a href="Components" title="Components">Components</a></li>
+ <li><a href="Routing" title="Routing">Routing</a></li>
+ <li><a href="Transformation" title="Transformation">Transformation</a></li>
+ <li><a href="Spring+Client+Toolkit" title="Spring Client Toolkit">Spring Client Toolkit</a></li>
+ <li><a href="Client+API" title="Client API">Client API</a></li>
+ <li><a href="POJO+support" title="POJO support">POJO support</a></li>
+ <li><a href="Expressions" title="Expressions">Expressions</a></li>
+ <li><a href="Component+helper+classes" title="Component helper classes">Component helper classes</a></li>
+ <li><a href="Ant+Tasks" title="Ant Tasks">Ant Tasks</a></li>
+ <li><a href="JMX+Console" title="JMX Console">JMX Console</a></li>
+ </ul>
+ <h3><a name="Navigation-Integration"></a>Integration</h3>
+ <ul class="alternate" type="square">
+ <li><a href="Spring+support" title="Spring support">Spring support</a></li>
+ <li><a href="Geronimo+Integration" title="Geronimo Integration">Geronimo Integration</a></li>
+ <li><a href="JBoss+Deployer" title="JBoss Deployer">JBoss Integration</a></li>
+ <li><a href="Tomcat+Integration" title="Tomcat Integration">Tomcat Integration</a></li>
+ <li><a href="JNDI+configuration" title="JNDI configuration">JNDI configuration</a></li>
+ </ul>
+ <h3><a name="Navigation-ServiceMixComponents"></a>ServiceMix Components</h3>
+ <ul class="alternate" type="square">
+ <li><a href="BPEL" title="BPEL">BPEL</a></li>
+ <li><a href="Cache" title="Cache">Cache</a></li>
+ <li><a href="Drools" title="Drools">Drools</a></li>
+ <li><a href="Email" title="Email">Email</a></li>
+ <li><a href="File" title="File">File</a></li>
+ <li><a href="FTP" title="FTP">FTP</a></li>
+ <li><a href="Groovy" title="Groovy">Groovy</a></li>
+ <li><a href="HTTP" title="HTTP">HTTP</a></li>
+ <li><a href="Jabber" title="Jabber">Jabber</a></li>
+ <li><a href="JAX+WS" title="JAX WS">JAX WS</a></li>
+ <li><a href="JCA" title="JCA">JCA</a></li>
+ <li><a href="JMS" title="JMS">JMS</a></li>
+ <li><a href="Quartz" title="Quartz">Quartz</a></li>
+ <li><a href="Reflection" title="Reflection">Reflection</a></li>
+ <li><a href="RSS" title="RSS">RSS</a></li>
+ <li><a href="SAAJ" title="SAAJ">SAAJ</a></li>
+ <li><a href="Scripting" title="Scripting">Scripting</a></li>
+ <li><a href="ServiceMix" title="ServiceMix">ServiceMix</a></li>
+ <li><a href="Validation" title="Validation">Validation</a></li>
+ <li><a href="XFire" title="XFire">XFire</a></li>
+ <li><a href="XPath+Router" title="XPath Router">XPath Router</a></li>
+ <li><a href="XSLT" title="XSLT">XSLT</a></li>
+ <li><a href="XSQL" title="XSQL">XSQL</a></li>
+ <li><a href="VFS" title="VFS">VFS</a></li>
+ <li><a href="WSIF" title="WSIF">WSIF</a></li>
+ </ul>
+ <h3><a name="Navigation-Tooling"></a>Tooling</h3>
+ <ul class="alternate" type="square">
+ <li><a href="Eclipse+plugin" title="Eclipse plugin">Eclipse plugin</a></li>
+ <li><a href="JBoss+Deployer" title="JBoss Deployer">JBoss Deployer</a></li>
+ <li><a href="WAR+Deployment" title="WAR Deployment">WAR Deployment</a></li>
+ <li><a href="Maven+JBI+plugin" title="Maven JBI plugin">Maven JBI plugin</a></li>
+ <li><a href="Maven+SAR+plugin" title="Maven SAR plugin">Maven SAR plugin</a></li>
+ </ul>
+ <h3><a name="Navigation-Utilities"></a>Utilities</h3>
+ <ul class="alternate" type="square">
+ <li><a href="Reflection" title="Reflection">Reflection</a></li>
+ </ul>
+ <h3><a name="Navigation-OtherJBIsoftware"></a>Other JBI software</h3>
+ <ul class="alternate" type="square">
+ <li><span class="nobr"><a href="http://forge.objectweb.org/projects/celtix/" rel="nofollow">Celtix</a></span></li>
+ <li><span class="nobr"><a href="http://pxe.fivesight.com/wiki/display/PXE/Home" rel="nofollow" title="Visit page outside Confluence">PXE BPEL Engine</a></span></li>
+ </ul>
+ <h3><a name="Navigation-RelatedProjects"></a>Related Projects</h3>
+ <ul class="alternate" type="square">
+ <li><span class="nobr"><a href="http://activemq.codehaus.org/" rel="nofollow">ActiveMQ</a></span></li>
+ <li><span class="nobr"><a href="http://jencks.org/" rel="nofollow">Jencks</a></span></li>
+ <li><span class="nobr"><a href="http://lingo.codehaus.org/" rel="nofollow">Lingo</a></span></li>
+ <li><span class="nobr"><a href="http://activesoap.codehaus.org/" rel="nofollow">ActiveSOAP</a></span></li>
+ <li><span class="nobr"><a href="http://www.springframework.org/" rel="nofollow">Spring</a></span></li>
+ <li><span class="nobr"><a href="http://geronimo.apache.org/" rel="nofollow">Geronimo</a></span></li>
+ </ul>
+ <h3><a name="Navigation-Support"></a>Support</h3>
+ <ul class="alternate" type="square">
+ <li><span class="nobr"><a href="http://jira.logicblaze.com/jira/browse/SM" rel="nofollow">Issues</a></span></li>
+ <li><span class="nobr"><a href="http://jira.logicblaze.com/browse/SM?report=com.atlassian.jira.plugin.system.project:roadmap-panel" rel="nofollow">Roadmap</a></span></li>
+ <li><span class="nobr"><a href="http://jira.logicblaze.com/browse/SM?report=com.atlassian.jira.plugin.system.project:changelog-panel" rel="nofollow">Change log</a></span></li>
+ </ul>
+ <h3><a name="Navigation-Developers"></a>Developers</h3>
+ <ul class="alternate" type="square">
+ <li><a href="Source" title="Source">Source</a></li>
+ <li><a href="Roadmap" title="Roadmap">Roadmap</a></li>
+ <li><a href="Ideas" title="Ideas">Ideas</a></li>
+ <li><a href="Becoming+a+committer" title="Becoming a committer">Becoming a committer</a></li>
+ <li><a href="Release+Guide" title="Release Guide">Release Guide</a></li>
+ <li><span class="nobr"><a href="http://ci.codehaus.org/beetlejuice/viewProjectSummary.action?projectName=ServiceMix" rel="nofollow">BeetleJuice</a></span></li>
+ <li><span class="nobr"><a href="http://servicemix.codehaus.org/maven/clover/" rel="nofollow">Clover Report</a></span></li>
+ <li><span class="nobr"><a href="http://servicemix.codehaus.org/maven/xref/index.html" rel="nofollow">Source XRef</a></span></li>
+ <li><span class="nobr"><a href="http://servicemix.codehaus.org/maven/xref-test/index.html" rel="nofollow">Test Source XRef</a></span></li>
+ <li><span class="nobr"><a href="http://servicemix.codehaus.org/maven/servicemix.xsd.html" rel="nofollow">XSD</a></span></li>
+ </ul>
+ <h3><a name="Navigation-Toolsweuse"></a>Tools we use</h3><span><span class="nobr"><a href="http://www.yourkit.com" rel="nofollow"><img align="absmiddle" border=0 src="/download/attachments/25208/yjp.gif"></a></span></span></span>
+
+ <h3 class="heading3">Feeds</h3>
+ <table border="0" cellspacing="4px">
+ <tr>
+ <td align="right">
+ <a href="http://docs.codehaus.org/spaces/rss.action?key=SM&newPages=false"><img src="http://docs.codehaus.org/images/icons/rss.gif" border="0"></a><br/>
+ </td>
+ <td align="left">
+ <a href="http://docs.codehaus.org/spaces/rss.action?key=SM&newPages=false">Site</a>
+ </td>
+ </tr>
+ <tr>
+ <td align="right">
+ <a href="http://docs.codehaus.org/spaces/blogrss.action?key=SM"><img src="http://docs.codehaus.org/images/icons/rss.gif" border="0"></a>
+ </td>
+ <td align="left">
+ <a href="http://docs.codehaus.org/spaces/blogrss.action?key=SM">News</a>
+ </td>
+ </tr>
+ </table>
+ </td>
+ <td id="rightColumn" valign="top">
+
+ <div id="page_title">
+ <table width="100%">
+ <tr>
+ <td>
+ Getting Started
+ </td>
+ <td align="right">
+
+ </td>
+ </tr>
+ </table>
+ </div>
+
+
+ <div>
+ <div id="Content">
+ <h2><a name="GettingStarted-Introduction"></a>Introduction</h2>
+ <p>This document describes how to install and configure ServiceMix 2.x for both Unix and Windows' platforms. For instructions on installation and configuration of ServiceMix 1.x please see <span class="nobr"><a href="http://docs.codehaus.org/x/wp" rel="nofollow">Getting Started for ServiceMix 1.1</a></span>.</p>
+ <h2><a name="GettingStarted-DocumentOrganization"></a>Document Organization</h2>
+ <p>This document contains the following sections:</p>
+ <ul>
+ <li><a href="#GettingStarted-Introduction">Introduction</a></li>
+ <li><a href="#GettingStarted-DocumentOrganization">Document Organization</a></li>
+ <li><a href="#GettingStarted-PreInstallationRequirements">Pre-Installation Requirements</a></li>
+ <li><a href="#GettingStarted-InstallationProcedureForWindows">Installation Procedure For Windows</a><ul>
+ <li><a href="#GettingStarted-WindowsBinaryInstallation">Windows Binary Installation</a></li>
+ <li><a href="#GettingStarted-WindowsSourceInstallation">Windows Source Installation</a></li>
+ <li><a href="#GettingStarted-WindowsDeveloper%27sReleases">Windows Developer's Releases</a></li>
+ </ul>
+ </li>
+ <li><a href="#GettingStarted-InstallationProcedureforUnix">Installation Procedure for Unix</a><ul>
+ <li><a href="#GettingStarted-UnixBinaryInstallation">Unix Binary Installation</a></li>
+ <li><a href="#GettingStarted-UnixSourceInstallation">Unix Source Installation</a></li>
+ <li><a href="#GettingStarted-UnixDeveloper%27sReleases">Unix Developer's Releases</a></li>
+ </ul>
+ </li>
+ <li><a href="#GettingStarted-StartingServiceMix">Starting ServiceMix</a></li>
+ <li><a href="#GettingStarted-TestingtheInstallation">Testing the Installation</a></li>
+ <li><a href="#GettingStarted-StoppingServiceMix">Stopping ServiceMix</a></li>
+ <li><a href="#GettingStarted-ConfiguringServiceMix">Configuring ServiceMix</a></li>
+ <li><a href="#GettingStarted-AdditionalResources">Additional Resources</a></li>
+ </ul>
+ <h2><a name="GettingStarted-PreInstallationRequirements"></a>Pre-Installation Requirements</h2>
+ <p><b>Hardware:</b></p>
+ <ul>
+ <li>40 MB of disk space for the ServiceMix 2.x binary distribution.</li>
+ <li>24 MB of disk space for the ServiceMix 2.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.4.x or greater for deployment and 1.5.x (Java 5) for builds.</li>
+ <li>The JAVA_HOME environment variable must be set to the directory where the JDK is installed, e.g., <tt>c:\Program Files\jsdk.1.4.2-09</tt>.</li>
+ <li>Maven 1.0.2 or greater (required when installing source or developers' releases).</li>
+ </ul>
+ <h2><a name="GettingStarted-InstallationProcedureForWindows"></a>Installation Procedure For Windows</h2>
+ <h4><a name="GettingStarted-WindowsBinaryInstallation"></a>Windows Binary Installation</h4>
+ <p>This procedure explains how to download and install the binary distribution on a Windows system.</p>
+ <p class="paragraph">
+ <ol>
+ <li>From a browser, navigate to <span class="nobr"><a href="http://www.servicemix.org" rel="nofollow">www.servicemix.org</a></span>.</li>
+ <li>Click the Download link in the navigation pane (the left pane).</li>
+ <li>Click the "ServiceMix 2.x Release" link under the "Latest Releases" section.</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>servicemix-x.x.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="#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>
+ </p>
+ <h4><a name="GettingStarted-WindowsSourceInstallation"></a>Windows Source Installation</h4>
+ <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>
+ <p class="paragraph">
+ <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 "ServiceMix 2.x Release" link under the "Latest Releases" section.</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.zip</tt>.</li>
+ <li>Extract ServiceMix from the zip file into a directory of your choice.</li>
+ <li><a name="GettingStarted-WindowsSourceInstallation"></a> Build ServiceMix using Maven 1.0.2 or greater and Java 5. <div class="code">
+ <div class="codeContent"><pre class="code-java">The recommended method of building ServiceMix is the following:
+cd [servicemix_install_dir]
+ where [servicemix_install_dir] is the directory in which ServiceMix was installed.
+maven
+
+If the above build fails on some tests, type the following:
+cd [servicemix_install_dir]
+maven -Dmaven.test.skip=<span class="code-keyword">true</span></pre></div>
+ </div>
+ <table align="center" border=0 cellpadding=5 cellspacing="8px" class="infoMacro" width="85%">
+ <colgroup>
+ <col width=24>
+ <col>
+ </colgroup>
+ <tr>
+ <td valign="top"><img align="absmiddle" alt="" border=0 height=16 src="/images/icons/emoticons/information.gif" width=16></td>
+ <td><b class="strong">ServiceMix on Java 1.4</b><br>
+ <p>Some modules can be built on Java 1.4. To compile, run the following command<br> maven -Dservicemix.jdk14=true</p>
+ </td>
+ </tr>
+ </table>
+ </li>
+ <li>Start ServiceMix from the target directory: <div class="code">
+ <div class="codeContent"><pre class="code-java">cd [servicemix_install_dir]\assembly\target\servicemix-2.0.1\bin\servicemix-2.0.1\bin
+servicemix</pre></div>
+ </div>
+ </li>
+ <li>Proceed to <a href="#GettingStarted-TestingtheInstallation">Testing the Installation</a> section.</li>
+ </ol>
+ </p>
+ <h4><a name="GettingStarted-WindowsDeveloper%27sReleases"></a>Windows Developer's Releases</h4>
+ <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>
+ <p class="paragraph">
+ <ol>
+ <li>From a browser, navigate to <span class="nobr"><a href="http://www.servicemix.org" rel="nofollow">www.servicemix.org</a></span>.</li>
+ <li>Click the Download link in the navigation pane (the left pane).</li>
+ <li>Click the "Development SNAPSHOT releases can also be found here" 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="#GettingStarted-StartingServiceMix">Starting ServiceMix</a> section of this document.<br> If a source snapshot was downloaded perform step 6 and step 7 of the <a href="#GettingStarted-WindowsSourceInstallation">Windows Source Installation</a> procedure. </li>
+ <li>Following start-up, proceed to <a href="#GettingStarted-TestingtheInstallation">Testing the Installation</a> section.</li>
+ </ol>
+ </p>
+ <h2><a name="GettingStarted-InstallationProcedureForUnix"></a>Installation Procedure For Unix</h2>
+ <h4><a name="GettingStarted-UnixBinaryInstallation"></a><a name="GettingStarted-UnixBinaryInstallation"></a> Unix Binary Installation</h4>
+ <p>This procedure explains how to download and install the binary distribution on a Unix system. </p>
+ <p class="paragraph">
+ <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. <div class="code">
+ <div class="codeContent"><pre class="code-java">If the Unix machine has a browser:
+
+a. Navigate to www.servicemix.org.
+b. Click the <span class="code-quote">"Download"</span> link in the navigation pane (the left pane).
+c. Click the <span class="code-quote">"ServiceMix 2.x Release"</span> link under the <span class="code-quote">"Latest Releases"</span> section.
+d. Under the <span class="code-quote">"Download Here"</span> section, select the desired distribution (<span class="code-keyword">if</span> necessary,
+scroll down to see the <span class="code-quote">"Download Here"</span> section). For a binary Unix distribution the filename
+will be similar to: servicemix-x.x.x.tar.gz.
+
+OR
+
+If the Unix machine does NOT have a browser, tools such as wget, scp, or ftp can be used to download the ServiceMix distribution.
+It is beyond the scope of <span class="code-keyword">this</span> document to explain the use of those tools. For convenience an example is provided below using
+a Windows machine (that has a browser) and a Unix machine with <span class="code-quote">"wget"</span> installed on it.
+Note: There are several alternative ways to perform <span class="code-keyword">this</span> type of installation.
+
+a. Obtain the link to the ServiceMix distribution file. On the Windows machine with a browser, navigate to www.servicemix.org.
+b. Click the <span class="code-quote">"Download"</span> link in the left navigation pane.
+c. Click the <span class="code-quote">"ServiceMix 2.x Release"</span> link under the <span class="code-quote">"Latest Releases"</span> section.
+d. Under the <span class="code-quote">"Download Here"</span> section, roll-over the desired distribution (<span class="code-keyword">if</span> necessary, scroll
+down to see the <span class="code-quote">"Download Here"</span> section). For a binary Unix distribution the filename will be
+similar to: servicemix-x.x.x.tar.gz.
+e. Right-click on the distribution name and <span class="code-quote">"Copy Shortcut."</span>
+f. On the Unix machine, change to the directory in which ServiceMix will be installed, e.g., /usr/local.
+f. Download the ServiceMix distribution to the Unix machine using the <span class="code-quote">"wget"</span> tool. For example, type <span class="code-quote">"wget"</span> followed by the saved shortcut:
+
+ wget http:<span class="code-comment">//dist.codehaus.org/servicemix/distributions/servicemix-2.0.1.tar.gz</span></pre></div>
+ </div>
+ </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">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="#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.</li>
+ </ol>
+ </p>
+ <h4><a name="GettingStarted-UnixSourceInstallation"></a>Unix Source Installation</h4>
+ <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 section <a href="#GettingStarted-UnixBinaryInstallation">Unix Binary Installation</a> 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>
+ <p class="paragraph">
+ <ol>
+ <li>From a browser, navigate to <span class="nobr"><a href="http://www.servicemix.org" rel="nofollow">www.servicemix.org</a></span>.</li>
+ <li>Click the "Download" link in the navigation pane (the left pane).</li>
+ <li>Click the "ServiceMix 2.x Release" link under the "Latest Releases" section.</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-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> startup script is not executable, change it's permissions. For example: <div class="code">
+ <div class="codeContent"><pre class="code-java">cd [servicemix_install_dir]/assembly/target/servicemix-2.x/bin/servicemix-2.x/bin
+chmod 755 servicemix</pre></div>
+ </div>
+ </li>
+ <li>Start ServiceMix from the target directory: <div class="code">
+ <div class="codeContent"><pre class="code-java">cd [servicemix_install_dir]/assembly/target/servicemix-2.x/bin/servicemix-2.x/bin
+servicemix</pre></div>
+ </div>
+ </li>
+ <li>Proceed to <a href="#GettingStarted-TestingtheInstallation">Testing the Installation</a> section.</li>
+ </ol>
+ </p>
+ <h4><a name="GettingStarted-UnixDeveloper%27sReleases"></a>Unix Developer's Releases</h4>
+ <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>
+ <p class="paragraph">
+ <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 "Development SNAPSHOT releases can also be found here" 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="#GettingStarted-StartingServiceMix">Starting ServiceMix</a> section of this document. <br> If a source snapshot was downloaded perform steps 6 - 8 of the <a href="#GettingStarted-UnixSourceInstallation">Unix Source Installation</a> procedure.</p>
+ </li>
+ <li>Proceed to <a href="#GettingStarted-TestingtheInstallation">Testing the Installation</a> section.</li>
+ </ol>
+ </p>
+ <h2><a name="GettingStarted-StartingServiceMix"></a><a name="GettingStarted-StartingServiceMix"></a> Starting ServiceMix</h2>
+ <h4><a name="GettingStarted-OnWindows%3A"></a>On Windows:</h4>
+ <p>From a console window, change to the installation directory and run the <tt>servicemix</tt> program:</p>
+ <p class="paragraph">
+ <div class="code">
+ <div class="codeContent"><pre class="code-java">cd [servicemix_install_dir]\bin</pre></div>
+ </div>
+ </p>
+ <p>where <tt>servicemix_install_dir</tt> is the directory in which ServiceMix was installed, e.g., <tt>c:\Program Files\servicemix-2.x</tt>. <br clear="all"> Then type:</p>
+ <p class="paragraph">
+ <div class="code">
+ <div class="codeContent"><pre class="code-java">servicemix</pre></div>
+ </div>
+ </p>
+ <h4><a name="GettingStarted-OnUnix%3A"></a>On Unix:</h4>
+ <p>From a command shell, change to the installation directory and run the <tt>servicemix</tt> program:</p>
+ <p class="paragraph">
+ <div class="code">
+ <div class="codeContent"><pre class="code-java">cd [servicemix_install_dir]/bin</pre></div>
+ </div>
+ </p>
+ <p>where <tt>servicemix_install_dir</tt> is the directory in which ServiceMix was installed, e.g., <tt>/usr/local/servicemix-2.x</tt>. <br clear="all"> Then type:</p>
+ <p class="paragraph">
+ <div class="code">
+ <div class="codeContent"><pre class="code-java">servicemix
+
+OR
+
+servicemix > /tmp/smlog 2>&1 &
+Note: /tmp/smlog may be changed to another file name.</pre></div>
+ </div>
+ <table align="center" border=0 cellpadding=5 cellspacing="8px" class="warningMacro" width="85%">
+ <colgroup>
+ <col width=24>
+ <col>
+ </colgroup>
+ <tr>
+ <td valign="top"><img align="absmiddle" alt="" border=0 height=16 src="/images/icons/emoticons/forbidden.gif" width=16></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>
+ </p>
+ <h2><a name="GettingStarted-TestingtheInstallation"></a><a name="GettingStarted-TestingtheInstallation"></a> Testing the Installation</h2>
+ <p>The Window's console window or the Unix command shell will display something similar to the following log line if ServiceMix is up and running without any problems:</p>
+ <p class="paragraph">
+ <div class="code">
+ <div class="codeContent"><pre class="code-java">[INFO] JBIContainer -- ServiceMix JBI Container
+<http:<span class="code-comment">//servicemix.org/> name: defaultJBI running version: <span class="code-keyword">null</span></span></pre></div>
+ </div>
+ </p>
+ <p>
+ <br clear="all"> ServiceMix's default port is 1099. From another window run netstat and search for port 1099.</p>
+ <p>From a Windows console, type:</p>
+ <p class="paragraph">
+ <div class="code">
+ <div class="codeContent"><pre class="code-java">netstat -an|find <span class="code-quote">"1099"</span></pre></div>
+ </div>
+ </p>
+ <p><b>OR</b></p>
+ <p>From a Unix command shell, type:</p>
+ <p class="paragraph">
+ <div class="code">
+ <div class="codeContent"><pre class="code-java">netstat -an|grep 1099</pre></div>
+ </div>
+ </p>
+ <h2><a name="GettingStarted-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, for example:</p>
+ <p class="paragraph">
+ <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>
+ </p>
+ <h2><a name="GettingStarted-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 <a href="Configuration" title="Configuration">Configuration</a>.</p>
+ <h2><a name="GettingStarted-AdditionalResources"></a>Additional Resources</h2>
+ <p>Before trying to use ServiceMix you might want to read <a href="What+is+JBI" title="What is JBI">What is JBI</a>, take a look at the available <a href="Components" title="Components">Components</a> and get an idea for the <a href="Architecture" title="Architecture">Architecture</a> along with the supported <a href="NMR+Flows" title="NMR Flows">NMR Flows</a>.</p>
+ <p>A quick way to get started is to run the examples 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>
+ <p>For instructions on running the examples, please see <a href="Examples" title="Examples">Examples</a>.</p>
+ <p class="paragraph">
+ <table align="center" border=0 cellpadding=5 cellspacing="8px" class="tipMacro" width="85%">
+ <colgroup>
+ <col width=24>
+ <col>
+ </colgroup>
+ <tr>
+ <td valign="top"><img align="absmiddle" alt="" border=0 height=16 src="/images/icons/emoticons/check.gif" width=16></td>
+ <td><b class="strong">Handy Hint</b><br>
+ <p>Add <em>$SERVICEMIX_HOME/bin</em> directory to <em>$PATH</em> variable to simplify execution of the examples.</p>
+ </td>
+ </tr>
+ </table>
+ </p>
+ <p>To view the statistics and operation of ServiceMix in a JMX Console and see how the Management works please see the following documents:</p>
+ <ul>
+ <li><a href="JMX+Console" title="JMX Console">JMX Console</a></li>
+ <li><a href="Management" title="Management">Management</a></li>
+ </ul>
+ </div>
+</div>
+
+
+ </td>
+ </tr>
+ <tr>
+ <td colspan="3" id="footer">
+ <table width="100%">
+ <tr>
+ <td align="left" valign="top">
+
+ </td>
+ <td align="right" valign="top">
+ <a style="color:#999;" href="http://docs.codehaus.org/pages/editpage.action?spaceKey=SM&title=Getting+Started">[ edit ]</a>
+ </td>
+ </tr>
+ <table>
+ </td>
+ </tr>
+ </table>
+ </body>
+
+</html>
+
+