You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@servicemix.apache.org by ks...@apache.org on 2014/08/05 21:33:46 UTC
svn commit: r1615985 - in /servicemix/site/production:
developers/remote-debugging-servicemix-in-eclipse.html index.html
Author: ksobkowiak
Date: Tue Aug 5 19:33:46 2014
New Revision: 1615985
URL: http://svn.apache.org/r1615985
Log:
[scm-publish] Updating main website contents
Modified:
servicemix/site/production/developers/remote-debugging-servicemix-in-eclipse.html
servicemix/site/production/index.html
Modified: servicemix/site/production/developers/remote-debugging-servicemix-in-eclipse.html
URL: http://svn.apache.org/viewvc/servicemix/site/production/developers/remote-debugging-servicemix-in-eclipse.html?rev=1615985&r1=1615984&r2=1615985&view=diff
==============================================================================
--- servicemix/site/production/developers/remote-debugging-servicemix-in-eclipse.html (original)
+++ servicemix/site/production/developers/remote-debugging-servicemix-in-eclipse.html Tue Aug 5 19:33:46 2014
@@ -98,25 +98,16 @@
</td>
<td height="100%" width="100%">
<div class="wiki-content">
-<p>This page explains how to set up remote-debugging of ServiceMix using Eclipse.</p><p>Basically, you have to perform the following steps:</p><ol><li><p><a href="Remote-debugging ServiceMix in Eclipse#Enabling Remote Debugging in ServiceMix.html">Enable remote debugging in <tt>servicemix.bat</tt></a></p></li><li><p><a href="Remote-debugging ServiceMix in Eclipse#Specifying a Remote Debugging Launch Configuration.html">Specify a remote-debugging launch configuration</a> </p></li><li><p><a href="Remote-debugging ServiceMix in Eclipse#Performing Debugging.html">Start SM and switch to Debug-Perspective</a></p></li></ol><h2 id="EnableremotedebugginginServiceMix">Enable remote debugging in ServiceMix</h2><p>The following section in <tt>servicemix.bat</tt> is the one that matters:</p><pre>
-if "%SERVICEMIX_DEBUG%" == "" goto :SERVICEMIX_DEBUG_END
- rem Use the defaults if JAVA_DEBUG_OPTS was not set
- if "%JAVA_DEBUG_OPTS%" == "" set JAVA_DEBUG_OPTS=%DEFAULT_JAVA_DEBUG_OPTS%
-
- set "JAVA_OPTS=%JAVA_DEBUG_OPTS% %JAVA_OPTS%"
- call :warn Enabling Java debug options: %JAVA_DEBUG_OPTS%
-:SERVICEMIX_DEBUG_END
-</pre><p>In order to activate it, you need to set the environment variable <tt>SERVICEMIX_DEBUG</tt>.</p><p>For instance in Windows:</p><pre>
-SET SERVICEMIX_DEBUG=TRUE
-</pre><p>Or in Linux:</p><pre>
-export SERVICEMIX_DEBUG=TRUE
-</pre><p>ServiceMix runs in debugging mode if you can see the following output when running it:</p><pre>
-...
-servicemix.bat: Enabling Java debug options: -Xdebug -Xnoagent -Djava.compiler=NONE -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=5005
-...
-</pre><p>The debugging options can be modified in <tt>servicemix.bat</tt> via the <tt>DEFAULT_JAVA_DEBUG_OPTS</tt>. The default values are:</p><pre>
-set DEFAULT_JAVA_DEBUG_OPTS=-Xdebug -Xnoagent -Djava.compiler=NONE -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=5005
-</pre><h2 id="SpecifyingaRemoteDebuggingLaunchConfiguration">Specifying a Remote Debugging Launch Configuration</h2><p>Specify an Eclipse Remote Java Application debug launch configuration on the project you want to monitor. </p><ol><li><p>Open <tt>Run - Debug</tt></p></li><li><p>Mark <tt>Remote Java Application</tt></p></li><li><p>Create a <tt>New Launch Configuration</tt></p></li><li><p>Specify a name, the project you want to debug (e.g. <tt>servicemix-wsn2005</tt>) and the connection properties.</p></li><li><p><tt>Apply</tt>.</p></li></ol><p>See <a href="http://www.onjava.com/lpt/a/6174">http://www.onjava.com/lpt/a/6174</a> for details.</p><h2 id="PerformingDebugging">Performing Debugging</h2><ol><li><p>Add breakpoints/debug information to the relevant code inside Eclipse. </p></li><li><p>Start ServiceMix.</p></li><li><p>Start debugging with the previously created launch configuration.</p></li><li><p>Switch to debug perspective.</p></li><li><p>Exercise the error-causing behaviour
.</p></li><li><p>Wait for Eclipse to be notified of the breakpoints.</p></li></ol>
+<p>This page explains how to set up remote-debugging of ServiceMix using Eclipse.</p><p>Basically, you have to perform the following steps:</p><ol><li><p><a href="#EnablingRemoteDebugginginServiceMix.html">Enable remote debugging in <tt>servicemix.bat</tt></a></p></li><li><p><a href="#SpecifyingaRemoteDebuggingLaunchConfiguration.html">Specify a remote-debugging launch configuration</a> </p></li><li><p><a href="#PerformingDebugging.html">Start SM and switch to Debug-Perspective</a></p></li></ol><h2 id="EnableremotedebugginginServiceMix">Enable remote debugging in ServiceMix</h2><p>You can debug ServiceMix or any application deployed onto it using remote debugging. Remote debugging can be easily activated by using the <tt>debug</tt> parameter on the command line.</p><pre>> bin/servicemix debug
+</pre><p>or on Windows</p><pre>> bin\servicemix.bat debug
+</pre><p>Another option is to set the <tt>KARAF_DEBUG</tt> environment variable to <tt>TRUE</tt>.</p><p>This can be done using the following command on Unix systems:</p><pre>export KARAF_DEBUG=true
+</pre><p>On Windows, use the following command</p><pre>set KARAF_DEBUG=true
+</pre><p>Then, you can launch ServiceMix using the usual way:</p><pre>bin/servicemix
+</pre><p>or</p><pre>bin\servicemix.bat
+</pre><p>The debugging options can be modified in <tt>servicemix.bat</tt> via the <tt>DEFAULT_JAVA_DEBUG_OPTS</tt>. The default values are:</p><pre>set DEFAULT_JAVA_DEBUG_OPTS=-Xdebug -Xnoagent -Djava.compiler=NONE -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=5005
+</pre><p>This option works fine when it is needed to debug a project deployed top of Apache ServiceMix. Nervertheless, you will be blocked if you would like to debug the server ServiceMix. In this case, you can change the following parameter <tt>suspend=y</tt> in the <tt>servicemix</tt> script file: </p><pre>export DEFAULT_JAVA_DEBUG_OPTS='-Xdebug -Xnoagent -Djava.compiler=NONE -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=5005'
+</pre><p>and on Windows,</p><pre>set DEFAULT_JAVA_DEBUG_OPTS='-Xdebug -Xnoagent -Djava.compiler=NONE -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=5005'
+</pre><p>That will cause the JVM to pause just before running <tt>main()</tt> until you attach a debugger then it will resume the execution. This way you can set your breakpoints anywhere in the code and you should hit them no matter how early in the startup they are.</p><h2 id="SpecifyingaRemoteDebuggingLaunchConfiguration">Specifying a Remote Debugging Launch Configuration</h2><p>Specify an Eclipse Remote Java Application debug launch configuration on the project you want to monitor. </p><ol><li><p>Open <tt>Run - Debug</tt></p></li><li><p>Mark <tt>Remote Java Application</tt></p></li><li><p>Create a <tt>New Launch Configuration</tt></p></li><li><p>Specify a name, the project you want to debug (e.g. <tt>servicemix-wsn2005</tt>) and the connection properties; In connection properties please change port from 8000 to 5005.</p></li><li><p><tt>Apply</tt>.</p></li></ol><p>See <a href="http://www.onjava.com/lpt/a/6174">http://www.onjava.com/lpt/a/6174</a> for details.</p><h2 id="Performin
gDebugging">Performing Debugging</h2><ol><li><p>Add breakpoints/debug information to the relevant code inside Eclipse. </p></li><li><p>Start ServiceMix.</p></li><li><p>Start debugging with the previously created launch configuration.</p></li><li><p>Switch to debug perspective.</p></li><li><p>Exercise the error-causing behaviour.</p></li><li><p>Wait for Eclipse to be notified of the breakpoints.</p></li></ol>
</div>
</td>
</tr>
Modified: servicemix/site/production/index.html
URL: http://svn.apache.org/viewvc/servicemix/site/production/index.html?rev=1615985&r1=1615984&r2=1615985&view=diff
==============================================================================
--- servicemix/site/production/index.html (original)
+++ servicemix/site/production/index.html Tue Aug 5 19:33:46 2014
@@ -98,7 +98,7 @@
</td>
<td height="100%" width="100%">
<div class="wiki-content">
-<table class="sectionMacro" border="0" cellpadding="5px" cellspacing="0" width="100%"><tr><td class="confluenceTd" valign="top"><p><a href="http://servicemix.apache.org/">Apache ServiceMix</a> is a flexible, open-source integration container that unifies the features and functionality of Apache <a href="http://activemq.apache.org">ActiveMQ</a>, <a href="http://camel.apache.org">Camel</a>, <a href="http://cxf.apache.org">CXF</a>, and <a href="http://karaf.apache.org">Karaf</a> into a powerful runtime platform you can use to build your own integrations solutions. It provides a complete, enterprise ready ESB exclusively powered by OSGi.</p><p>It is being released under <a href="WEB-INF/classes/META-INF/LICENSE.html">Apache License v2</a>.</p><p>The main features are:</p><ul><li><p>reliable messaging with <a href="http://activemq.apache.org">Apache ActiveMQ</a></p></li><li><p>messaging, routing and Enterprise Integration Patterns with <a href="http://camel.apache.org">Apache Camel</a></
p></li><li><p>WS‐* and RESTful web services with <a href="http://cxf.apache.org">Apache CXF</a></p></li><li><p>OSGi-based server runtime powered by <a href="http://karaf.apache.org">Apache Karaf</a></p></li></ul><p>Through additional installable features, ServiceMix also supports:</p><ul><li><p>BPM engine via <a href="http://activiti.org">Activiti</a></p></li><li><p>full JPA support via <a href="http://openjpa.apache.org/">Apache OpenJPA</a></p></li><li><p>XA transaction management via JTA via <a href="http://aries.apache.org">Apache Aries</a></p></li><li><p>legacy support for the JBI standard (deprecated after the ServiceMix 3.x series) through the Apache ServiceMix NMR that includes a rich Event, Messaging and Audit API</p></li></ul><p>Applications for ServiceMix can be built using:</p><ul><li><p>OSGi Blueprint</p></li><li><p>OSGi Declarative Services</p></li><li><p>Spring DM (legacy)</p></li></ul></td><td class="confluenceTd" valign="top"><div style="text-align: center;"><
p><strong><a href="downloads.html">Download ServiceMix 5.1.1</a></strong><br/><a href="downloads.html"><img width="256" border="0" src="images/servicemix-box.jpg"/></a></p></div><script src="http://widgets.twimg.com/j/2/widget.js"></script><script>new TWTR.Widget({ version: 2, type: 'search', search: '#servicemix', interval: 6000, title: 'What do people say about', subject: 'ServiceMix', width: 250, height: 300, theme: { shell: { background: '#5b8fbe', color: '#ffffff' }, tweets: { background: '#ffffff', color: '#444444', links: '#1985b5' } }, features: { scrollbar: false, loop: true, live: true, hashtags: true, timestamp: true, avatars: true, toptweets: true, behavior: 'default' }}).render().start();</script></td></tr></table><h2 id="Newsnews"><a href="news.html">News</a></h2><h2 id="ServiceMix5.1.1released">ServiceMix 5.1.1 released</h2><p>The ServiceMix team is pleased to announce the availability of Apache
ServiceMix 5.1.1.<br/>This release contains a few bug fixes and picks up a new version of Apache Camel.</p><p>Major dependency versions for this release:</p><ul><li><p>Activiti 5.15.1</p></li><li><p>Apache ActiveMQ 5.10.0</p></li><li><p>Apache Camel 2.13.2</p></li><li><p>Apache CXF 2.7.11</p></li><li><p>Apache Karaf 2.3.4</p></li></ul><p>For more information, please see the <a href="downloads/servicemix-5.1.1">release notes</a></p><h2 id="ServiceMix5.0.3released">ServiceMix 5.0.3 released</h2><p>The ServiceMix team is pleased to announce the availability of Apache ServiceMix 5.0.3.<br/>This is a fix release that includes a few bug fixes. It also comes with new versions<br/>of Camel and CXF.</p><p>Major dependency versions for this release:</p><ul><li><p>Activiti 5.15.1</p></li><li><p>Apache ActiveMQ 5.9.0</p></li><li><p>Apache Camel 2.12.4</p></li><li><p>Apache CXF 2.7.11</p></li><li><p>Apache Karaf 2.3.4</p></li></ul><p>For more information, please see the <a href="downloads/servi
cemix-5.0.3">release notes</a></p><h2 id="AnewcommitterandanewPMCmember">A new committer and a new PMC member</h2><p>The ServiceMix community has been active doing new releases the past few months.<br/>This is only possible by the support we get from our entire community.</p><p>Whenever a contributor stands out because of the quality of his patches and the<br/>amount of time and energy spent on the project, we are happy to invite him to<br/>become a committer on the project. Please welcome Wim Verreydt as our newest<br/>committer!</p><p>It is also very encouraging to see a new committer grow to be even more involved<br/>and active in the project after becoming a committer. In recognition of his<br/>continued contribution and commitment to the project, the Apache ServiceMix PMC<br/>has invited Krzysztof Sobkowiak to join the PMC.</p><p>On behalf of the ServiceMix PMC: Welcome aboard, guys!</p>
+<table class="sectionMacro" border="0" cellpadding="5px" cellspacing="0" width="100%"><tr><td class="confluenceTd" valign="top"><p><a href="http://servicemix.apache.org/">Apache ServiceMix</a> is a flexible, open-source integration container that unifies the features and functionality of Apache <a href="http://activemq.apache.org">ActiveMQ</a>, <a href="http://camel.apache.org">Camel</a>, <a href="http://cxf.apache.org">CXF</a>, and <a href="http://karaf.apache.org">Karaf</a> into a powerful runtime platform you can use to build your own integrations solutions. It provides a complete, enterprise ready ESB exclusively powered by OSGi.</p><p>It is being released under <a href="overview/license.html">Apache License v2</a>.</p><p>The main features are:</p><ul><li><p>reliable messaging with <a href="http://activemq.apache.org">Apache ActiveMQ</a></p></li><li><p>messaging, routing and Enterprise Integration Patterns with <a href="http://camel.apache.org">Apache Camel</a></p></li><li><p>WS
‐* and RESTful web services with <a href="http://cxf.apache.org">Apache CXF</a></p></li><li><p>OSGi-based server runtime powered by <a href="http://karaf.apache.org">Apache Karaf</a></p></li></ul><p>Through additional installable features, ServiceMix also supports:</p><ul><li><p>BPM engine via <a href="http://activiti.org">Activiti</a></p></li><li><p>full JPA support via <a href="http://openjpa.apache.org/">Apache OpenJPA</a></p></li><li><p>XA transaction management via JTA via <a href="http://aries.apache.org">Apache Aries</a></p></li><li><p>legacy support for the JBI standard (deprecated after the ServiceMix 3.x series) through the Apache ServiceMix NMR that includes a rich Event, Messaging and Audit API</p></li></ul><p>Applications for ServiceMix can be built using:</p><ul><li><p>OSGi Blueprint</p></li><li><p>OSGi Declarative Services</p></li><li><p>Spring DM (legacy)</p></li></ul></td><td class="confluenceTd" valign="top"><div style="text-align: center;"><p><strong><a hre
f="downloads.html">Download ServiceMix 5.1.1</a></strong><br/><a href="downloads.html"><img width="256" border="0" src="images/servicemix-box.jpg"/></a></p></div><script src="http://widgets.twimg.com/j/2/widget.js"></script><script>new TWTR.Widget({ version: 2, type: 'search', search: '#servicemix', interval: 6000, title: 'What do people say about', subject: 'ServiceMix', width: 250, height: 300, theme: { shell: { background: '#5b8fbe', color: '#ffffff' }, tweets: { background: '#ffffff', color: '#444444', links: '#1985b5' } }, features: { scrollbar: false, loop: true, live: true, hashtags: true, timestamp: true, avatars: true, toptweets: true, behavior: 'default' }}).render().start();</script></td></tr></table><h2 id="Newsnews"><a href="news.html">News</a></h2><h2 id="ServiceMix5.1.1released">ServiceMix 5.1.1 released</h2><p>The ServiceMix team is pleased to announce the availability of Apache ServiceMix 5.1.1
.<br/>This release contains a few bug fixes and picks up a new version of Apache Camel.</p><p>Major dependency versions for this release:</p><ul><li><p>Activiti 5.15.1</p></li><li><p>Apache ActiveMQ 5.10.0</p></li><li><p>Apache Camel 2.13.2</p></li><li><p>Apache CXF 2.7.11</p></li><li><p>Apache Karaf 2.3.4</p></li></ul><p>For more information, please see the <a href="downloads/servicemix-5.1.1">release notes</a></p><h2 id="ServiceMix5.0.3released">ServiceMix 5.0.3 released</h2><p>The ServiceMix team is pleased to announce the availability of Apache ServiceMix 5.0.3.<br/>This is a fix release that includes a few bug fixes. It also comes with new versions<br/>of Camel and CXF.</p><p>Major dependency versions for this release:</p><ul><li><p>Activiti 5.15.1</p></li><li><p>Apache ActiveMQ 5.9.0</p></li><li><p>Apache Camel 2.12.4</p></li><li><p>Apache CXF 2.7.11</p></li><li><p>Apache Karaf 2.3.4</p></li></ul><p>For more information, please see the <a href="downloads/servicemix-5.0.3">rel
ease notes</a></p><h2 id="AnewcommitterandanewPMCmember">A new committer and a new PMC member</h2><p>The ServiceMix community has been active doing new releases the past few months.<br/>This is only possible by the support we get from our entire community.</p><p>Whenever a contributor stands out because of the quality of his patches and the<br/>amount of time and energy spent on the project, we are happy to invite him to<br/>become a committer on the project. Please welcome Wim Verreydt as our newest<br/>committer!</p><p>It is also very encouraging to see a new committer grow to be even more involved<br/>and active in the project after becoming a committer. In recognition of his<br/>continued contribution and commitment to the project, the Apache ServiceMix PMC<br/>has invited Krzysztof Sobkowiak to join the PMC.</p><p>On behalf of the ServiceMix PMC: Welcome aboard, guys!</p>
</div>
</td>
</tr>