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 [17/36] - /incubator/servicemix/site/
Added: incubator/servicemix/site/JMS
URL: http://svn.apache.org/viewcvs/incubator/servicemix/site/JMS?rev=374419&view=auto
==============================================================================
--- incubator/servicemix/site/JMS (added)
+++ incubator/servicemix/site/JMS Thu Feb 2 08:12:18 2006
@@ -0,0 +1,355 @@
+
<!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 - JMS</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> > JMS
+ </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>
+ JMS
+ </td>
+ <td align="right">
+
+ </td>
+ </tr>
+ </table>
+ </div>
+
+
+ <div>
+ <div id="Content">
+ <p>The JMS components allow you to send and receive JMS messages. The JMS components assume that the NormalizedMessage they are given are ready for marshalling into/out of JMS, so they don't try to implement a SOAP stack or perform any complex message transformation other than to map NMS to JMS or vice versa.</p>
+ <p>If you wish to customize the marshalling from NMS to JMS or vice versa you can customize the JmsMarshaler used to perform the mapping.</p>
+ <p class="paragraph">
+ <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">Performance Note</b><br>
+ <p>If you wish to process messages in a high performance setting and want to use connection & thread pooling, transaction & exception & retry handling and want to support parallel processing of inbound messages we recommend you use the <a href="JCA" title="JCA">JCA</a> support for inbound JMS messages.</p>
+ </td>
+ </tr>
+ </table>
+ </p>
+ <h3><a name="JMS-ReceivingJMSmessages"></a>Receiving JMS messages</h3>
+ <p>The JmsReceiverComponent subscribes to the given destination using Spring's JmsTemplate and dispatches the message into the JBI container. Here's an <span class="nobr"><a href="http://svn.apache.org/repos/asf/incubator/servicemix/trunk/servicemix-components/src/test/resources/org/apache/servicemix/components/xslt/example.xml" rel="nofollow">example</a></span> of subscribing to a JMS destination (in this case a topic) and forwarding the JBI message onto another JBI component - which in this case is the <em>foo:transformer</em> service.</p>
+ <p class="paragraph">
+ <div class="code">
+ <div class="codeContent"><pre class="code-xml"><span class="code-tag"><sm:activationSpec componentName=<span class="code-quote">"myJmsReceiver"</span> service=<span class="code-quote">"foo:myJmsReceiver"</span> destinationService=<span class="code-quote">"foo:transformer"</span>></span>
+ <span class="code-tag"><sm:component></span><span class="code-tag"><bean class=<span class="code-quote">"org.apache.servicemix.components.jms.JmsReceiverComponent"</span>></span>
+ <span class="code-tag"><property name=<span class="code-quote">"template"</span>></span>
+ <span class="code-tag"><bean class=<span class="code-quote">"org.springframework.jms.core.JmsTemplate"</span>></span>
+ <span class="code-tag"><property name=<span class="code-quote">"connectionFactory"</span>></span>
+ <span class="code-tag"><ref local=<span class="code-quote">"jmsFactory"</span>/></span>
+ <span class="code-tag"></property></span>
+ <span class="code-tag"><property name=<span class="code-quote">"defaultDestinationName"</span> value=<span class="code-quote">"test.org.apache.servicemix.components.xslt.source"</span>/></span>
+ <span class="code-tag"><property name=<span class="code-quote">"pubSubDomain"</span> value=<span class="code-quote">"true"</span>/></span>
+ <span class="code-tag"></bean></span>
+ <span class="code-tag"></property></span>
+ <span class="code-tag"></bean></span><span class="code-tag"></sm:component></span>
+<span class="code-tag"></sm:activationSpec></span></pre></div>
+ </div>
+ </p>
+ <p>If you wish to use JCA or some other mechanism to subscribe to JMS you can use the JmsInBinding.</p>
+ <h3><a name="JMS-SendingJMSmessages"></a>Sending JMS messages</h3>
+ <p>The JmsSenderComponent will send JMS messages from the input message exchange. This component uses Spring's JmsTemplate to perform the sending. The following <span class="nobr"><a href="http://svn.apache.org/repos/asf/incubator/servicemix/trunk/servicemix-components/src/test/resources/org/apache/servicemix/components/xslt/example.xml" rel="nofollow">example</a></span> demonstrates a component which when invoked will send a message to a given JMS topic</p>
+ <p class="paragraph">
+ <div class="code">
+ <div class="codeContent"><pre class="code-xml"><span class="code-tag"><sm:activationSpec componentName=<span class="code-quote">"myJmsSender"</span> service=<span class="code-quote">"foo:myJmsSender"</span>></span>
+ <span class="code-tag"><sm:component></span><span class="code-tag"><bean class=<span class="code-quote">"org.apache.servicemix.components.jms.JmsSenderComponent"</span>></span>
+ <span class="code-tag"><property name=<span class="code-quote">"template"</span>></span>
+ <span class="code-tag"><bean class=<span class="code-quote">"org.springframework.jms.core.JmsTemplate"</span>></span>
+ <span class="code-tag"><property name=<span class="code-quote">"connectionFactory"</span>></span>
+ <span class="code-tag"><ref local=<span class="code-quote">"jmsFactory"</span>/></span>
+ <span class="code-tag"></property></span>
+ <span class="code-tag"><property name=<span class="code-quote">"defaultDestinationName"</span> value=<span class="code-quote">"test.org.apache.servicemix.components.xslt.source"</span>/></span>
+ <span class="code-tag"><property name=<span class="code-quote">"pubSubDomain"</span> value=<span class="code-quote">"true"</span>/></span>
+ <span class="code-tag"></bean></span>
+ <span class="code-tag"></property></span>
+ <span class="code-tag"></bean></span><span class="code-tag"></sm:component></span>
+<span class="code-tag"></sm:activationSpec></span></pre></div>
+ </div>
+ </p>
+ <h3><a name="JMS-JMSbridges"></a>JMS bridges</h3>
+ <p>Its a very common requirement to create a message bridge; routing messages from one messaging system to another. With ServiceMix we can connect any transport with any transport - but for now lets focus on JMS to JMS bridging. Imagine for example you wish to route messages from ActiveMQ to MQSeries, or from WebLogic JMS to ActiveMQ.</p>
+ <p>The following <span class="nobr"><a href="https://svn.apache.org/repos/asf/incubator/servicemix/trunk/servicemix-components/src/test/resources/org/apache/servicemix/components/xslt/pipeline.xml" rel="nofollow">example</a></span> demonstrates how to setup a JMS bridge in ServiceMix</p>
+ <p class="paragraph">
+ <div class="code">
+ <div class="codeContent"><pre class="code-xml"><beans <span class="code-keyword">xmlns:sm</span>=<span class="code-quote">"http://servicemix.apache.org/config/1.0"</span>
+ <span class="code-keyword">xmlns:foo</span>=<span class="code-quote">"http://servicemix.org/demo/pipeline/"</span>>
+
+ <span class="code-tag"><span class="code-comment"><!-- the JBI container and its components --></span></span>
+ <span class="code-tag"><sm:container id=<span class="code-quote">"jbi"</span> embedded=<span class="code-quote">"true"</span>></span>
+ <span class="code-tag"><sm:activationSpecs></span>
+
+ <span class="code-tag"><sm:activationSpec componentName=<span class="code-quote">"myJmsReceiver"</span> service=<span class="code-quote">"foo:myJmsReceiver"</span> destinationService=<span class="code-quote">"foo:transformer"</span>></span>
+ <span class="code-tag"><sm:component></span><span class="code-tag"><bean class=<span class="code-quote">"org.apache.servicemix.components.jms.JmsReceiverComponent"</span>></span>
+ <span class="code-tag"><property name=<span class="code-quote">"template"</span>></span>
+ <span class="code-tag"><bean class=<span class="code-quote">"org.springframework.jms.core.JmsTemplate"</span>></span>
+ <span class="code-tag"><property name=<span class="code-quote">"connectionFactory"</span>></span>
+ <span class="code-tag"><ref local=<span class="code-quote">"jmsFactory"</span>/></span>
+ <span class="code-tag"></property></span>
+ <span class="code-tag"><property name=<span class="code-quote">"defaultDestinationName"</span> value=<span class="code-quote">"demo.cheese.source"</span>/></span>
+ <span class="code-tag"><property name=<span class="code-quote">"pubSubDomain"</span> value=<span class="code-quote">"true"</span>/></span>
+ <span class="code-tag"></bean></span>
+ <span class="code-tag"></property></span>
+ <span class="code-tag"></bean></span><span class="code-tag"></sm:component></span>
+ <span class="code-tag"></sm:activationSpec></span>
+
+ <span class="code-tag"><sm:activationSpec componentName=<span class="code-quote">"transformer"</span> service=<span class="code-quote">"foo:transformer"</span> destinationService=<span class="code-quote">"foo:transformedSender"</span>></span>
+ <span class="code-tag"><sm:component></span><span class="code-tag"><bean class=<span class="code-quote">"org.apache.servicemix.components.xslt.XsltComponent"</span>></span>
+ <span class="code-tag"><property name=<span class="code-quote">"xsltResource"</span> value=<span class="code-quote">"classpath:org/apache/servicemix/components/xslt/transform.xsl"</span>/></span>
+ <span class="code-tag"></bean></span><span class="code-tag"></sm:component></span>
+ <span class="code-tag"></sm:activationSpec></span>
+
+ <span class="code-tag"><sm:activationSpec componentName=<span class="code-quote">"transformedSender"</span> service=<span class="code-quote">"foo:transformedSender"</span>></span>
+ <span class="code-tag"><sm:component></span><span class="code-tag"><bean class=<span class="code-quote">"org.apache.servicemix.components.jms.JmsSenderComponent"</span>></span>
+ <span class="code-tag"><property name=<span class="code-quote">"template"</span>></span>
+ <span class="code-tag"><bean class=<span class="code-quote">"org.springframework.jms.core.JmsTemplate"</span>></span>
+ <span class="code-tag"><property name=<span class="code-quote">"connectionFactory"</span>></span>
+ <span class="code-tag"><ref local=<span class="code-quote">"jmsFactory"</span>/></span>
+ <span class="code-tag"></property></span>
+ <span class="code-tag"><property name=<span class="code-quote">"defaultDestinationName"</span> value=<span class="code-quote">"demo.cheese.result"</span>/></span>
+ <span class="code-tag"><property name=<span class="code-quote">"pubSubDomain"</span> value=<span class="code-quote">"true"</span>/></span>
+ <span class="code-tag"></bean></span>
+ <span class="code-tag"></property></span>
+ <span class="code-tag"></bean></span><span class="code-tag"></sm:component></span>
+ <span class="code-tag"></sm:activationSpec></span>
+
+ <span class="code-tag"></sm:activationSpecs></span>
+ <span class="code-tag"></sm:container></span>
+
+ <span class="code-tag"><bean id=<span class="code-quote">"jmsFactory"</span> class=<span class="code-quote">"org.apache.activemq.pool.PooledConnectionFactory"</span>></span>
+ <span class="code-tag"><property name=<span class="code-quote">"connectionFactory"</span>></span>
+ <span class="code-tag"><bean class=<span class="code-quote">"org.apache.activemq.ActiveMQConnectionFactory"</span>></span>
+ <span class="code-tag"><property name=<span class="code-quote">"brokerURL"</span> value=<span class="code-quote">"vm://localhost?broker.persistent=false"</span>/></span>
+ <span class="code-tag"></bean></span>
+ <span class="code-tag"></property></span>
+ <span class="code-tag"></bean></span>
+
+<span class="code-tag"></beans></span></pre></div>
+ </div>
+ </p>
+ <p>This example is performing an <a href="XSLT" title="XSLT">XSLT</a> transform on the messages as well - you can perform arbitrary processing of the messages in the bridge, performing rules processing or content based routing. Obviously you could miss out the transformation step and just route the inbound message on one JMS provider to another JMS provider without any transform step.</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=JMS">[ edit ]</a>
+ </td>
+ </tr>
+ <table>
+ </td>
+ </tr>
+ </table>
+ </body>
+
+</html>
+
+
Added: incubator/servicemix/site/JMX+Console
URL: http://svn.apache.org/viewcvs/incubator/servicemix/site/JMX%2BConsole?rev=374419&view=auto
==============================================================================
--- incubator/servicemix/site/JMX+Console (added)
+++ incubator/servicemix/site/JMX+Console Thu Feb 2 08:12:18 2006
@@ -0,0 +1,408 @@
+
<!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 - JMX Console</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="Home">Home</a> > <a href="Management">Management</a> > JMX Console
+ </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>
+ JMX Console
+ </td>
+ <td align="right">
+
+ </td>
+ </tr>
+ </table>
+ </div>
+
+
+ <div>
+ <div id="Content">
+ <h1><a name="JMXConsole-UsingaJMXConsolewithServiceMix"></a>Using a JMX Console with ServiceMix</h1>
+ <p>This document explains how to connect a JMX Console to ServiceMix. The following three open source JMX Consoles will be discussed: </p>
+ <ul>
+ <li><a href="#JMXConsole-UsingJConsole">JConsole</a></li>
+ <li><a href="#JMXConsole-UsingMC4J">MC4J</a></li>
+ <li><a href="#JMXConsole-ServiceMixJMXConsole">ServiceMix JMX Console</a></li>
+ </ul>
+ <p class="paragraph">
+ <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">JMX Connector URI has changed for version 3.x!</b><br>
+ <p>ServiceMix will now use the jndiPath = jmxrmi<br> e.g. service:jmx:rmi:///jndi/rmi://localhost:1099/jmxrmi</p>
+ </td>
+ </tr>
+ </table>
+ </p>
+ <p>The ServiceMix JBIContainer exposes internal services and Components through JMX. The JBIContainer can be passed as a JMXBeanServer or, it can be configured to create one if one doesn't exist (see <a href="Configuration" title="Configuration">Configuration</a>). If the JBIContainer creates its own MBeanServer instance, it also creates an RMI JMXConnector - to allow remote connections. The <a href="Ant+Tasks" title="Ant Tasks">Ant Tasks</a> use the following:</p>
+ <p class="paragraph">
+ <div class="code">
+ <div class="codeHeader"><b>Creating remote JMX Connector to the JBIContainer</b></div>
+ <div class="codeContent"><pre class="code-java"><span class="code-object">String</span> jndiPath = <span class="code-quote">"jmxrmi"</span>;
+JMXServiceURL url = <span class="code-keyword">new</span> JMXServiceURL (<span class="code-quote">"service:jmx:rmi:<span class="code-comment">///jndi/rmi://<namingHost>:<namingPort>/"</span> + jndiPath) ;
+</span>JMXConnector connector = JMXConnectorFactory.connect(url);</pre></div>
+ </div>
+ </p>
+ <p>
+ <br clear="all"> The following configuration variables are required for the next sections. </p>
+ <p><b>NOTE:</b> The values shown are the default settings for ServiceMix version 3.x <a name="JMXConsole-settings"></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">Default Settings</b><br>
+ <p>The <em>default</em> namingPort is <b>1099</b><br> The <em>default</em> container name is <b>jmxrmi</b><br> The JMX Service URL is: service:jmx:rmi:///jndi/rmi://localhost:1099/jmxrmi</p>
+ </td>
+ </tr>
+ </table>
+ </p>
+ <p><b>NOTE:</b> The values shown are the default settings for ServiceMix version 2.x <a name="JMXConsole-settings"></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">Default Settings</b><br>
+ <p>The <em>default</em> namingPort is <b>1099</b><br> The <em>default</em> container name is <b>defaultJBI</b><br> The JMX Service URL is: service:jmx:rmi:///jndi/rmi://localhost:1099/defaultJBIJMX</p>
+ </td>
+ </tr>
+ </table>
+ </p>
+ <h2><a name="JMXConsole-UsingJConsole"></a>Using JConsole</h2>
+ <p>The Java-2 Platform, Standard Edition (J2SE) 5.0 release includes a JMX monitoring tool, JConsole. JConsole monitors applications running on the Java platform and provides information on their performance and resource consumption. Please see <span class="nobr"><a href="http://java.sun.com/developer/technicalArticles/J2SE/jconsole.html" rel="nofollow">Sun's</a></span> documentation for more information on using this tool. Please see the following sections for instructions on configuring and using JConsole with ServiceMix.</p>
+ <p><b>NOTE:</b> This tool is available with the Java 5 release only.</p>
+ <h4><a name="JMXConsole-HowtoConnectJConsoletoMonitorServiceMix"></a>How to Connect JConsole to Monitor ServiceMix</h4>
+ <p>This section explains how to configure JConsole to monitor ServiceMix. The ServiceMix port number, the ServiceMix container id, and the JMX Service URL will be required. This information was specified in the previous section, in the <a href="#JMXConsole-settings">Default Settings</a> box.</p>
+ <p class="paragraph">
+ <ol>
+ <li>ServiceMix should be running first. Please see the <span class="nobr"><a href="http://www.servicemix.org/Getting+Started" rel="nofollow">Getting Started</a></span> guide for instructions on running ServiceMix.</li>
+ <li>Start JConsole from a command shell. The JConsole executable can be found in the <tt>bin</tt> directory of the J2SE installation directory. <div class="code">
+ <div class="codeContent"><pre class="code-java">cd [J2SE_install_dir]\bin
+jconsole</pre></div>
+ </div>
+ <p>The JConsole window will appear. <br clear="all">
+ <br clear="all">
+ </p>
+ </li>
+ <li>Click on the "Advanced" tab. The following URL must be entered in the "JMX URL" box: service:jmx:rmi:///jndi/rmi://hostname:port/app_to_monitor. Where the <tt>hostname</tt> is name of the host on which the application to be monitored is running, the <tt>port</tt> is the port number to connect to the application, and the <tt>app_to_monitor</tt> is the JMX enabled application to monitor. For example, if none of the defaults for ServiceMix have been modified and ServiceMix is running on <tt>localhost</tt>, enter the following: <tt>service:jmx:rmi:///jndi/rmi://localhost:1099/defaultJBIJMX</tt>. <br clear="all">
+ <br clear="all"><img align="absmiddle" border=0 src="/download/attachments/27342/jconsoleagentscr.jpg"><br clear="all">
+ <br clear="all">
+ </li>
+ <li>Click the <b>Connect</b> box to connect to the ServiceMix container. <tt>org.servicemix</tt> will be visible in the console. Click on <tt>org.servicemix</tt> to see its MBeans. <br clear="all">
+ <br clear="all"><img align="absmiddle" border=0 src="/download/attachments/27342/jconsoleconnection.jpg"><br clear="all">
+ </li>
+ </ol>
+ </p>
+ <h4><a name="JMXConsole-TestingJConsolewithServiceMix"></a>Testing JConsole with ServiceMix</h4>
+ <p class="paragraph">
+ <ol>
+ <li>To see JConsole in action, start one of the ServiceMix examples running, for instance, the <span class="nobr"><a href="http://www.servicemix.org/Basic" rel="nofollow"><em>Basic</em></a></span> Example: <br clear="all">
+ <div class="code">
+ <div class="codeContent"><pre class="code-java">cd [servicemix_install_dir]\examples\basic
+..\..\bin\servicemix servicemix.xml</pre></div>
+ </div>
+ <p>where <tt>servicemix_install_dir</tt> is the directory in which ServiceMix was installed.</p>
+ </li>
+ <li>Run JConsole (see the previous section) and click on <tt>org.servicemix</tt>.</li>
+ <li>Click on <tt>org.servicemix.jbi.framework.ComponentMBeanImpl</tt>. The components of the <em>Basic</em> example will be shown. Clicking on any of them will show the monitoring information available. <br clear="all">
+ <br clear="all"><img align="absmiddle" border=0 src="/download/attachments/27342/jconsolembeans.jpg"><br clear="all">
+ </li>
+ </ol>
+ </p>
+ <h2><a name="JMXConsole-UsingMC4J"></a>Using MC4J</h2>
+ <p><span class="nobr"><a href="http://mc4j.org/confluence/display/MC4J/Home" rel="nofollow" title="Visit page outside Confluence">MC4J</a></span> is a JMX Console. It can connect to J2EE servers, MBeans, and other applications to monitor them.</p>
+ <h4><a name="JMXConsole-HowtoConnectMC4JtoMonitorServiceMix"></a>How to Connect MC4J to Monitor ServiceMix</h4>
+ <p>This section explains how to configure MC4J to monitor ServiceMix. The ServiceMix port number, the ServiceMix container id, and the JMX Service URL will be required. This information was specified in a previous section in the <a href="#JMXConsole-settings">Default Settings</a> box. The server connection type will also be required - it is <b>JSR160</b>.</p>
+ <p class="paragraph">
+ <ol>
+ <li>ServiceMix should be running first. Please see the <span class="nobr"><a href="http://www.servicemix.org/Getting+Started" rel="nofollow">Getting Started</a></span> guide for instructions on running ServiceMix.</li>
+ <li>Click on the MC4J executable <tt>MC4J Console 1.2b9.exe</tt> (for Windows) to start MC4J. The executable can be found in the top-level directory of the MC4J installation. The MC4J window will appear.</li>
+ <li>Select "Management>Create Server Connection..." from the menu. This will start "My Wizard". The connection to ServiceMix can be created using the wizard. <br clear="all">
+ <br clear="all"><img align="absmiddle" border=0 src="/download/attachments/27342/mc4jwizard.jpg"><br clear="all">
+ <br clear="all">
+ </li>
+ <li>Enter the following into the text boxes/pull-down menus:<br><b>Select your server connection type:</b> JSR160<br><b>Name:</b> This can any name, for example, ServiceMix<br><b>Server URL:</b> service:jmx:rmi:///jndi/rmi://localhost:1099/defaultJBIJMX<br> The Server URL is <tt>service:jmx:rmi:///jndi/rmi://hostname:port/app_to_monitor</tt>. Where the <tt>hostname</tt> is name of the host on which the application to be monitored is running, the <tt>port</tt> is the port number to connect to the application, and the <tt>app_to_monitor</tt> is the JMX-enabled application to monitor. For example, if none of the defaults for ServiceMix have been modified and ServiceMix is running on <tt>localhost</tt>, enter the following: <tt>service:jmx:rmi:///jndi/rmi://localhost:1099/defaultJBIJMX</tt>. </li>
+ <li>Accept the defaults for the rest of the fields in the Wizard.</li>
+ <li>Click "Next."</li>
+ <li>Click "Finish" in the next window.<br> A connection to ServiceMix has been added to MC4J! <br clear="all">
+ <br clear="all"><img align="absmiddle" border=0 src="/download/attachments/27342/mc4jconnections.jpg"><br clear="all">
+ </li>
+ </ol>
+ </p>
+ <h3><a name="JMXConsole-TestingMC4JwithServiceMix"></a>Testing MC4J with ServiceMix</h3>
+ <p class="paragraph">
+ <ol>
+ <li>To see MC4J in action, start one of the ServiceMix examples running, for instance, the <span class="nobr"><a href="http://www.servicemix.org/File+Binding" rel="nofollow"><em>file binding</em></a></span> Example: <br clear="all">
+ <div class="code">
+ <div class="codeContent"><pre class="code-java">cd [servicemix_install_dir]\examples\file-binding
+..\..\bin\servicemix servicemix.xml</pre></div>
+ </div>
+ <p>where <tt>servicemix_install_dir</tt> is the directory in which ServiceMix was installed.</p>
+ </li>
+ <li>Run MC4J (see the previous section) and click on <tt>org.servicemix</tt>.</li>
+ <li>Click on <tt>org.servicemix.jbi.framework.ComponentMBeanImpl</tt>. The components of the <em>File Binding</em> example will be shown. Right-click on a component and select "Available dashboards...>Basic MBean View" to see the information shown in the diagram below. For more details on using MC4J, please see the MC4J <span class="nobr"><a href="http://mc4j.org/confluence/display/MC4J/Home" rel="nofollow" title="Visit page outside Confluence">documentation</a></span>. <br clear="all">
+ <br clear="all"><img align="absmiddle" border=0 src="/download/attachments/27342/mc4jfilebinding.jpg"></li>
+ </ol>
+ </p>
+ <h2><a name="JMXConsole-ServiceMixJMXConsole"></a>ServiceMix JMX Console</h2>
+ <p>ServiceMix includes a simple JMX operational console. A ServiceMix WAR file can be created and deployed inside any Servlet / J2EE application server in a standard deployment unit. The benefit of the ServiceMix WAR file is that it includes a JMX Console that allows a web browser to be used to view JMX attributes and statistics.</p>
+ <h4><a name="JMXConsole-StartingtheServiceMixJMXConsole"></a>Starting the ServiceMix JMX Console</h4>
+ <p>To create the ServiceMix WAR file from a source download of ServiceMix do the following:</p>
+ <p class="paragraph">
+ <ol>
+ <li>Download and build 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 to which ServiceMix was downloaded.</p>
+ </li>
+ <li>Deploy the WAR file into any servlet engine. Instructions for deploying ServiceMix on Tomcat, JBoss, and Geronimo can be found at the following links: <ul>
+ <li><span class="nobr"><a href="http://www.servicemix.org/Tomcat+Integration" rel="nofollow">Tomcat</a></span></li>
+ <li><span class="nobr"><a href="http://www.servicemix.org/JBoss+Deployer" rel="nofollow">JBoss</a></span></li>
+ <li><span class="nobr"><a href="http://www.servicemix.org/Geronimo+Integration" rel="nofollow">Geronimo</a></span></li>
+ </ul>
+ </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>. You will see the following: <br clear="all">
+ <br clear="all"><img align="absmiddle" border=0 src="/download/attachments/27342/jmxconsole.jpg"></li>
+ </ol>
+ </p>
+ <h4><a name="JMXConsole-UsingtheServiceMixJMXConsole"></a>Using the ServiceMix JMX Console</h4>
+ <p>For examples of how to use the ServiceMix JMX Console, please see <span class="nobr"><a href="http://www.servicemix.org/War+Deployment" rel="nofollow">War Deployment</a></span>.</p>
+ <h2><a name="JMXConsole-RelatedDocumentation"></a>Related Documentation</h2>
+ <ul>
+ <li><span class="nobr"><a href="http://java.sun.com/developer/technicalArticles/J2SE/jconsole.html" rel="nofollow">Sun's JConsole</a></span></li>
+ <li><span class="nobr"><a href="http://mc4j.org/confluence/display/MC4J/Home" rel="nofollow" title="Visit page outside Confluence">MC4J</a></span></li>
+ <li><span class="nobr"><a href="http://www.servicemix.org/War+Deployment" rel="nofollow">War Deployment</a></span>.</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=JMX+Console">[ edit ]</a>
+ </td>
+ </tr>
+ <table>
+ </td>
+ </tr>
+ </table>
+ </body>
+
+</html>
+
+
Added: incubator/servicemix/site/JNDI+configuration
URL: http://svn.apache.org/viewcvs/incubator/servicemix/site/JNDI%2Bconfiguration?rev=374419&view=auto
==============================================================================
--- incubator/servicemix/site/JNDI+configuration (added)
+++ incubator/servicemix/site/JNDI+configuration Thu Feb 2 08:12:18 2006
@@ -0,0 +1,256 @@
+
<!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 - JNDI configuration</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> > JNDI configuration
+ </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>
+ JNDI configuration
+ </td>
+ <td align="right">
+
+ </td>
+ </tr>
+ </table>
+ </div>
+
+
+ <div>
+ <div id="Content">
+ <p>ServiceMix can be embedded in any application server, Java SE or EE platform. When working inside an application server you probably want to reuse the application servers JNDI provider and tooling.</p>
+ <p>When you are working in embedded mode, you probably want a JNDI provider to use to configure the services available to other JBI components which do not use dependency injection and Spring to configure themselves.</p>
+ <p>For a standalone JNDI provider, we do recommend using our own Spring based JNDI provider which is the default in the stand alone ServiceMix server. To use add the following jndi.properties file to your classpath</p>
+ <p class="paragraph">
+ <div class="code">
+ <div class="codeContent"><pre class="code-none">java.naming.factory.initial = org.servicemix.jbi.jndi.SpringInitialContextFactory</pre></div>
+ </div>
+ </p>
+ <p>Note that you can also add a line</p>
+ <p class="paragraph">
+ <div class="code">
+ <div class="codeContent"><pre class="code-none">java.naming.provider.url = classpath:foo/bar.xml</pre></div>
+ </div>
+ </p>
+ <p>Where the value is any valid Spring resource string such as a <span class="nobr"><a href="file://foo/bar.xml" rel="nofollow">file://foo/bar.xml</a></span> or a URL such as <span class="nobr"><a href="http://acme.com/whatnot.xml" rel="nofollow">http://acme.com/whatnot.xml</a></span>. The default value is assumed to be classpath://jndi.xml.</p>
+ <p>Then you can create a regular Spring XML configuration file to create a JNDI context (called <em>jndi</em>), which by default is a file called jndi.xml on the classpath</p>
+ <p>[Unable to download http://cvs.servicemix.codehaus.org/*checkout*/servicemix/base/src/main/release/conf/jndi.xml?rev=HEAD : http://cvs.servicemix.codehaus.org/*checkout*/servicemix/base/src/main/release/conf/jndi.xml?rev=HEAD].</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=JNDI+configuration">[ edit ]</a>
+ </td>
+ </tr>
+ <table>
+ </td>
+ </tr>
+ </table>
+ </body>
+
+</html>
+
+