Author: jstrachan
Date: Mon Jun 12 06:49:27 2006
New Revision: 413654
URL: http://svn.apache.org/viewvc?rev=413654&view=rev
Log:
Latest export from confluence
Modified:
incubator/activemq/site/activemq-performance-module-users-manual.html
incubator/activemq/site/features.html
Modified: incubator/activemq/site/activemq-performance-module-users-manual.html
URL: http://svn.apache.org/viewvc/incubator/activemq/site/activemq-performance-module-users-manual.html?rev=413654&r1=413653&r2=413654&view=diff
==============================================================================
--- incubator/activemq/site/activemq-performance-module-users-manual.html (original)
+++ incubator/activemq/site/activemq-performance-module-users-manual.html Mon Jun 12 06:49:27
2006
@@ -157,6 +157,7 @@
<LI><A href="visualisation.html" title="Visualisation">Visualisation</A></LI>
<LI><A href="kaha-persistence.html" title="Kaha Persistence">Kaha Persistence</A></LI>
<LI><A href="async-sends.html" title="Async Sends">Async Sends</A></LI>
+ <LI><A href="jmsxuserid.html" title="JMSXUserID">JMSXUserID</A></LI>
<LI><A href="changes-in-40.html" title="Changes in 4.0">Other new features</A></LI>
</UL>
@@ -217,6 +218,7 @@
<LI><A href="wire-protocol.html" title="Wire Protocol">Wire Protocol</A></LI>
<LI><A href="developer-guide.html" title="Developer Guide">Developer Guide</A></LI>
<LI><A href="becoming-a-committer.html" title="Becoming a committer">Becoming
a committer</A></LI>
+ <LI><SPAN class="nobr"><A href="http://ci.gbuild.org/continuum/" title="Visit
page outside Confluence" rel="nofollow">GBuild<SUP><IMG class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif"
height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN></LI>
<LI><A href="integration-tests.html" title="Integration Tests">Integration Tests</A></LI>
<LI><A href="" title="ActiveMQ Performance Module Users Manual">Maven2 Performance
Plugin</A></LI>
<LI><A href="benchmark-tests.html" title="Benchmark Tests">Benchmark Tests</A></LI>
@@ -249,31 +251,25 @@
<H3><A name="ActiveMQPerformanceModuleUsersManual-Prerequisites"></A>Prerequisites</H3>
<P>Currently we have not released the plugin so you could well have to build it yourself
first. Start with a complete build of Apache ActiveMQ and then do</P>
-
<DIV class="code"><DIV class="codeContent">
<PRE class="code-java">cd tooling/maven-activemq-perf-plugin
mvn clean install</PRE>
</DIV></DIV>
-
<P>To run the following Maven goals make sure you are inside a Maven2 project directory
where its POM is enabled with the Maven2 plugin such as the <SPAN class="nobr"><A
href="http://svn.apache.org/repos/asf/incubator/activemq/trunk/activemq-perftest/" title="Visit
page outside Confluence" rel="nofollow">activemq-perftest module<SUP><IMG class="rendericon"
src="http://goopen.org/confluence/images/icons/linkext7.gif" height="0" width="0" align="absmiddle"
alt="" border="0"></SUP></A></SPAN>.</P>
<H3><A name="ActiveMQPerformanceModuleUsersManual-Gettingstarted"></A>Getting
started</H3>
<P>To get started try typing the following commands into separate shells from the <SPAN
class="nobr"><A href="http://svn.apache.org/repos/asf/incubator/activemq/trunk/activemq-perftest/"
title="Visit page outside Confluence" rel="nofollow">activemq-perftest directory<SUP><IMG
class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif" height="0"
width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN></P>
-
<DIV class="code"><DIV class="codeContent">
-<PRE class="code-java">mvn activemq-perf:broker -Durl=broker:tcp:<SPAN class="code-comment">//localhost:61616
+<PRE class="code-java">mvn activemq-perf:broker -Durl=broker:tcp:<SPAN class="code-comment">//localhost:61616
</SPAN>mvn activemq-perf:consumer
mvn activemq-perf:producer</PRE>
</DIV></DIV>
-
<P>If you run the broker on a different machine then change the producer and consumer
commands to</P>
-
<DIV class="code"><DIV class="codeContent">
<PRE class="code-java">mvn activemq-perf:consumer -Dfactory.brokerUrl=tcp:<SPAN
class="code-comment">//host:port
</SPAN>mvn activemq-perf:producer -Dfactory.brokerUrl=tcp:<SPAN class="code-comment">//host:port</SPAN></PRE>
</DIV></DIV>
-
<P>where you switch host:port with the actual values.</P>
<P>When you run the producer & consume it generates an XML performance report
in the target/test-perf/ directory so that you can graph and chart the results etc. See the
<A href="sample-report.html" title="sample report">sample report</A></P>
@@ -301,17 +297,22 @@
<TD class="confluenceTd"> Starts the producer's performance testing. The generated
report file can be found in the directory specified in the parameter "sysTest.reportDirectory".
</TD>
</TR>
</TBODY></TABLE>
-<P><SUP>1</SUP> <B>Note</B>:The parameters for both consumer
and producers are described in the next section. (<A href="sample-report.html" title="sample
report">sample report</A>) </P>
+<P><SUP>1</SUP> <B>Note</B>:The parameters for both consumer
and producers are described in the next section. (<A href="sample-report.html" title="sample
report">sample report</A>)</P>
<H3><A name="ActiveMQPerformanceModuleUsersManual-ConfigurationforrunningasystemofJMSClients%28Producer%2FConsumer%29"></A>Configuration
for running a system of JMS Clients (Producer/Consumer)</H3>
<TABLE class="confluenceTable"><TBODY>
<TR>
<TH class="confluenceTh"> Configuration Key </TH>
-<TH class="confluenceTh"> Default Value </TH>
+<TH class="confluenceTh"> Default Value<BR clear="all"> </TH>
<TH class="confluenceTh"> Description </TH>
</TR>
<TR>
+<TD class="confluenceTd"> sysTest.clientName<BR clear="all"> </TD>
+<TD class="confluenceTd"> <system specific><BR clear="all"> </TD>
+<TD class="confluenceTd"> Specifies the client name prefix that will be use for each
system. By default it will use JmsConsumer for consumer systems, and JmsProducer for producer
systems.<BR clear="all"> </TD>
+</TR>
+<TR>
<TD class="confluenceTd"> sysTest.numClients </TD>
<TD class="confluenceTd"> 1 </TD>
<TD class="confluenceTd"> Specifies the number of JMS Clients to start. </TD>
@@ -337,6 +338,20 @@
<TD class="confluenceTd"> /target/test-perf </TD>
<TD class="confluenceTd"> The directory where the sampler report will be saved. </TD>
</TR>
+<TR>
+<TD class="confluenceTd"> sysTest.reportName<BR clear="all"> </TD>
+<TD class="confluenceTd"> <system specific> </TD>
+<TD class="confluenceTd"> The default filename the sampler report will be saved us.
There is usually no need to set this setting as the default value will create either JmsProducer_Client#<EM>Dest#</EM><Dest
Distro>.xml and JmsConsumer_Client#<EM>Dest#</EM><Dest Distro>.xml,
where # represents the number of clients and destinations set for that system, and <Dest
Distro> specifies the destination distribution for the system.<BR clear="all">
</TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> sysTest.reportType<BR clear="all"> </TD>
+<TD class="confluenceTd"> xml </TD>
+<TD class="confluenceTd"> Specifies the manner of generating the performance report.
Available values are:* 'xml' - Write the performance report into an xml
file. Specified by reportDirectory and reportName. A verbose summary will also be displayed
at the end of the test.
+<UL>
+ <LI>'verbose' - All information will be written to the standard
output, which includes settings, sampler data, and performance summary.</LI>
+</UL>
+</TD>
+</TR>
</TBODY></TABLE>
<P><SUP>1</SUP> <B>Note</B>: If the number of destinations
is less than the number of clients and the distribution type is either 'equal'
or 'divide', each client will send/receive from only one destination, distributing
the destinations among the clients. i.e. if there are 5 producers and 2 destinations, 3 producers
will send to destination 1, and 2 producers will send to destination 2. Also, a consumer can
only receive from a single destination, unless composite destination is supported and specified.</P>
@@ -661,8 +676,8 @@
</DIV>
<DIV id="site-footer">
Added by <A href="http://goopen.org/confluence/users/viewuserprofile.action?username=aco">Adrian
Co</A>,
- last edited by <A href="http://goopen.org/confluence/users/viewuserprofile.action?username=jstrachan">James
Strachan</A> on Jun 07, 2006
- (<A href="http://goopen.org/confluence/pages/diffpages.action?pageId=8591&originalId=8615">view
change</A>)
+ last edited by <A href="http://goopen.org/confluence/users/viewuserprofile.action?username=aco">Adrian
Co</A> on Jun 12, 2006
+ (<A href="http://goopen.org/confluence/pages/diffpages.action?pageId=8591&originalId=8703">view
change</A>)
(<A href="http://goopen.org/confluence/pages/editpage.action?pageId=8591">edit
page</A>)
</DIV>
Modified: incubator/activemq/site/features.html
URL: http://svn.apache.org/viewvc/incubator/activemq/site/features.html?rev=413654&r1=413653&r2=413654&view=diff
==============================================================================
--- incubator/activemq/site/features.html (original)
+++ incubator/activemq/site/features.html Mon Jun 12 06:49:27 2006
@@ -157,6 +157,7 @@
<LI><A href="visualisation.html" title="Visualisation">Visualisation</A></LI>
<LI><A href="kaha-persistence.html" title="Kaha Persistence">Kaha Persistence</A></LI>
<LI><A href="async-sends.html" title="Async Sends">Async Sends</A></LI>
+ <LI><A href="jmsxuserid.html" title="JMSXUserID">JMSXUserID</A></LI>
<LI><A href="changes-in-40.html" title="Changes in 4.0">Other new features</A></LI>
</UL>
@@ -217,6 +218,7 @@
<LI><A href="wire-protocol.html" title="Wire Protocol">Wire Protocol</A></LI>
<LI><A href="developer-guide.html" title="Developer Guide">Developer Guide</A></LI>
<LI><A href="becoming-a-committer.html" title="Becoming a committer">Becoming
a committer</A></LI>
+ <LI><SPAN class="nobr"><A href="http://ci.gbuild.org/continuum/" title="Visit
page outside Confluence" rel="nofollow">GBuild<SUP><IMG class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif"
height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN></LI>
<LI><A href="integration-tests.html" title="Integration Tests">Integration Tests</A></LI>
<LI><A href="activemq-performance-module-users-manual.html" title="ActiveMQ Performance
Module Users Manual">Maven2 Performance Plugin</A></LI>
<LI><A href="benchmark-tests.html" title="Benchmark Tests">Benchmark Tests</A></LI>
|