Author: jstrachan
Date: Wed Jun 7 02:55:48 2006
New Revision: 412350
URL: http://svn.apache.org/viewvc?rev=412350&view=rev
Log:
Latest export from confluence
Modified:
incubator/activemq/site/activemq-performance-module-users-manual.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=412350&r1=412349&r2=412350&view=diff
==============================================================================
--- incubator/activemq/site/activemq-performance-module-users-manual.html
(original)
+++ incubator/activemq/site/activemq-performance-module-users-manual.html Wed
Jun 7 02:55:48 2006
@@ -241,7 +241,32 @@
<!--
<div class="pagetitle">ActiveMQ Performance Module Users
Manual</div>
-->
- <DIV class="wiki-content"><H2><A
name="ActiveMQPerformanceModuleUsersManual-ConfigurationforrunningasystemofJMSClients%28Producer%2FConsumer%29"></A>Configuration
for running a system of JMS Clients (Producer/Consumer)</H2>
+ <DIV class="wiki-content"><H2><A
name="ActiveMQPerformanceModuleUsersManual-RunningMaven2PerformanceTest"></A>Running
Maven 2 Performance Test</H2>
+
+<TABLE class="confluenceTable"><TBODY>
+<TR>
+<TH class="confluenceTh"> Goal </TH>
+<TH class="confluenceTh"> Description </TH>
+</TR>
+<TR>
+<TD class="confluenceTd"> activemq-perf:broker </TD>
+<TD class="confluenceTd"> Starts broker using the activemq configuration file
located in "src\main\resources\broker-conf" where the default config
is activemq.xml. <BR clear="all">
+ Parameters: <BR clear="all">
+ 1. -DconfigType - specifies the type of configuration to use. Its
value must be one of the filename in the "..\broker-config" directory
(e.g. -DconfigType=kaha). <BR clear="all">
+ 2. -DconfigFile - path to config file other than those in
"src\..\broker-config".e.g -DconfigFile=c:\dir\activemq.xml) </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> activemq-perf:consumer </TD>
+<TD class="confluenceTd"> Starts the consumer's performance testing. The
generated report file can be found in the directory specified in the parameter
"sysTest.reportDirectory". </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> activemq-perf:producer </TD>
+<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.</P>
+
+<H2><A
name="ActiveMQPerformanceModuleUsersManual-ConfigurationforrunningasystemofJMSClients%28Producer%2FConsumer%29"></A>Configuration
for running a system of JMS Clients (Producer/Consumer)</H2>
<TABLE class="confluenceTable"><TBODY>
<TR>
@@ -257,7 +282,7 @@
<TR>
<TD class="confluenceTd"> sysTest.totalDests </TD>
<TD class="confluenceTd"> 1 </TD>
-<TD class="confluenceTd"> Specifies the total number of destinations to use
for the whole system test.</TD>
+<TD class="confluenceTd"> Specifies the total number of destinations to use
for the whole system test. </TD>
</TR>
<TR>
<TD class="confluenceTd"> sysTest.destDistro </TD>
@@ -272,14 +297,14 @@
</TR>
<TR>
<TD class="confluenceTd"> sysTest.reportDirectory </TD>
-<TD class="confluenceTd"> null </TD>
+<TD class="confluenceTd"> /target/test-perf</TD>
<TD class="confluenceTd"> The directory where the sampler report will be
saved. </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>
<H2><A
name="ActiveMQPerformanceModuleUsersManual-ConfigurationforrunningaJMSProducer"></A>Configuration
for running a JMS Producer</H2>
+
<TABLE class="confluenceTable"><TBODY>
<TR>
<TH class="confluenceTh"> Configuration Key </TH>
@@ -315,7 +340,7 @@
</TR>
<TR>
<TD class="confluenceTd"> producer.destName </TD>
-<TD class="confluenceTd"> TEST.FOO</TD>
+<TD class="confluenceTd"> TEST.FOO </TD>
<TD class="confluenceTd"> The prefix of the destination name to use. To
specify a queue, prefix the destination name with 'queue://', for
topics, prefix the destination with 'topic://'. If no prefix is
specified, a topic will be created. </TD>
</TR>
<TR>
@@ -329,7 +354,7 @@
<TD class="confluenceTd"> The starting index of the destination name. i.e. if
destName='TEST.FOO', destCount=3, destIndex=3, 3 topics will be
created with names, TEST.FOO.3, TEST.FOO.4, TEST.FOO.5.<SUP>2</SUP> </TD>
</TR>
<TR>
-<TD class="confluenceTd"> producer.destComposite </TD>
+<TD class="confluenceTd"> producer.destComposite </TD>
<TD class="confluenceTd"> false </TD>
<TD class="confluenceTd"> If there are more than one destination, and
destComposite=true, the destinations will be merged into one. This assumes that
the provider supports composite destinations. </TD>
</TR>
@@ -350,21 +375,21 @@
</TR>
<TR>
<TD class="confluenceTd"> producer.sendCount </TD>
-<TD class="confluenceTd"> 1000000 msgs <BR>
-(1 million) </TD>
+<TD class="confluenceTd"> 1000000 msgs <BR clear="all">
+ (1 million) </TD>
<TD class="confluenceTd"> If sendType=count, send this number of messages.
</TD>
</TR>
<TR>
<TD class="confluenceTd"> producer.sendDuration </TD>
-<TD class="confluenceTd"> 300000 ms<BR>
-(5 mins) </TD>
+<TD class="confluenceTd"> 300000 ms <BR clear="all">
+ (5 mins) </TD>
<TD class="confluenceTd"> If sendType=time, send messages for this number of
milliseconds. </TD>
</TR>
</TBODY></TABLE>
-
<P><SUP>2</SUP> <B>Note</B>: If you are using the Producer JMS System to
create the producers, you need not bother with these settings, as this will be
overwritten by the destination distribution method. i.e. if you specify 2
producers, 5 destinations, and equal distribution, producer 1 will have a
destCount=2 and a destIndex=0, while producer 2 will have a destCount=2, and a
destIndex=2. Any previous value will be overwritten.</P>
<H2><A
name="ActiveMQPerformanceModuleUsersManual-ConfigurationforrunningaJMSConsumer"></A>Configuration
for running a JMS Consumer</H2>
+
<TABLE class="confluenceTable"><TBODY>
<TR>
<TH class="confluenceTh"> Configuration Key </TH>
@@ -373,7 +398,7 @@
</TR>
<TR>
<TD class="confluenceTd"> consumer.spiClass </TD>
-<TD class="confluenceTd"> null </TD>
+<TD class="confluenceTd"> null </TD>
<TD class="confluenceTd"> The service provider interface class that allows the
client to create a generic connection factory. Current available SPI classes
include:
<OL>
<LI>'org.apache.activemq.tool.ActiveMQPojoSPI'</LI>
@@ -401,7 +426,7 @@
<TR>
<TD class="confluenceTd"> consumer.destName </TD>
<TD class="confluenceTd"> TEST.FOO </TD>
-<TD class="confluenceTd"> The prefix of the destination name to use. To
specify a queue, prefix the destination name with
'queue://', for topics, prefix the destination with
'topic://'. If no prefix is specified, a topic will be created. </TD>
+<TD class="confluenceTd"> The prefix of the destination name to use. To
specify a queue, prefix the destination name with 'queue://', for
topics, prefix the destination with 'topic://'. If no prefix is
specified, a topic will be created. </TD>
</TR>
<TR>
<TD class="confluenceTd"> consumer.destCount </TD>
@@ -411,10 +436,10 @@
<TR>
<TD class="confluenceTd"> consumer.destIndex </TD>
<TD class="confluenceTd"> 0 </TD>
-<TD class="confluenceTd"> The starting index of the destination name. i.e. if
destName='TEST.FOO', destCount=3, destIndex=3, 3 topics will be
created with names, TEST.FOO.3, TEST.FOO.4, TEST.FOO.5.<SUP>3</SUP></TD>
+<TD class="confluenceTd"> The starting index of the destination name. i.e. if
destName='TEST.FOO', destCount=3, destIndex=3, 3 topics will be
created with names, TEST.FOO.3, TEST.FOO.4, TEST.FOO.5.<SUP>3</SUP> </TD>
</TR>
<TR>
-<TD class="confluenceTd"> consumer.destComposite </TD>
+<TD class="confluenceTd"> consumer.destComposite </TD>
<TD class="confluenceTd"> false </TD>
<TD class="confluenceTd"> If there are more than one destination, and
destComposite=true, the destinations will be merged into one. This assumes that
the provider supports composite destinations. </TD>
</TR>
@@ -424,7 +449,7 @@
<TD class="confluenceTd"> If true, create a durable subscriber, otherwise
create a message consumer. See the JMS Specifications for more details. </TD>
</TR>
<TR>
-<TD class="confluenceTd"> consumer.asyncRecv </TD>
+<TD class="confluenceTd"> consumer.asyncRecv </TD>
<TD class="confluenceTd"> true </TD>
<TD class="confluenceTd"> If true, asynchronously receive messages using the
onMessage() method, otherwise use the receive() method. </TD>
</TR>
@@ -445,24 +470,22 @@
</TR>
<TR>
<TD class="confluenceTd"> consumer.recvCount </TD>
-<TD class="confluenceTd"> 1000000 msgs<BR>
-(1 million) </TD>
+<TD class="confluenceTd"> 1000000 msgs <BR clear="all">
+ (1 million) </TD>
<TD class="confluenceTd"> If recvType=count, receive this much messages. </TD>
</TR>
<TR>
<TD class="confluenceTd"> consumer.recvType </TD>
-<TD class="confluenceTd"> 300000 ms<BR>
-(5 mins) </TD>
+<TD class="confluenceTd"> 300000 ms <BR clear="all">
+ (5 mins) </TD>
<TD class="confluenceTd"> If recvType=time, receive messages for this specific
time duration. </TD>
</TR>
</TBODY></TABLE>
-
<P><SUP>3</SUP> <B>Note</B>: If you are using the Consumer JMS System to
create the consumers, you need not bother with these settings, as this will be
overwritten by the destination distribution method. i.e. if you specify 2
consumer, 5 destinations, and equal distribution, consumer 1 will have a
destCount=2 and a destIndex=0, while consumer 2 will have a destCount=2, and a
destIndex=2. Any previous value will be overwritten. Although, it should be
noted that unless composite destination is supported and specified, each
consumer will choose only one destination to receive from.</P>
-
<H2><A
name="ActiveMQPerformanceModuleUsersManual-ConfigurationforSPIConnectionFactory%3Aorg.apache.activemq.tool.spi.ActiveMQPojoSPI"></A>Configuration
for SPI Connection Factory: org.apache.activemq.tool.spi.ActiveMQPojoSPI</H2>
-<P><B>Description:</B> This provides details in configuring the JMS Connection
Factory created by ActiveMQPojoSPI. Default values are based from the default
values of the service provider
org.apache.activemq.ActiveMQConnectionFactory.</P>
+<P><B>Description:</B> This provides details in configuring the JMS Connection
Factory created by ActiveMQPojoSPI. Default values are based from the default
values of the service provider
org.apache.activemq.ActiveMQConnectionFactory.</P>
<TABLE class="confluenceTable"><TBODY>
<TR>
<TH class="confluenceTh"> Configuration Key </TH>
@@ -560,21 +583,20 @@
</TR>
</TBODY></TABLE>
-
<H2><A
name="ActiveMQPerformanceModuleUsersManual-ConfigurationforSPIConnectionFactory%3Aorg.apache.activemq.tool.spi.ActiveMQClassLoaderSPI"></A>Configuration
for SPI Connection Factory:
org.apache.activemq.tool.spi.ActiveMQClassLoaderSPI</H2>
+
<P><B>Description:</B> This provides details in configuring the JMS Connection
Factory created by ActiveMQClassLoaderSPI. Default values are based from the
default values of the service provider
org.apache.activemq.ActiveMQConnectionFactory.</P>
<P>ActiveMQClassLoaderSPI loads from the classpath
"org.apache.activemq.ActiveMQConnectionFactory" and configures it
using reflection. Configuration is generally based on the API of the class
loaded. General format is factory.YYY or factory.XXX.YYY, where the last
variable (YYY) is the property to set and everything in between is the getter
of the class to use to set (YYY). For example:</P>
-
<OL>
<LI>To set the value for asyncSend in ActiveMQConnectionFactory,
use:<BR>
- <TT>factory.useAsyncSend=true</TT>, which is equivalent to calling
<TT>factory.setUseAsyncSend(true)</TT></LI>
+<TT>factory.useAsyncSend=true</TT>, which is equivalent to calling
<TT>factory.setUseAsyncSend(true)</TT></LI>
</OL>
<OL>
<LI>To set the queue prefetch for ActiveMQConnectionFactory, use:<BR>
- <TT>factory.prefetchPolicy.queuePrefetch=1</TT>, which is equivalent to
calling <TT>factory.getPrefetchPolicy().setQueuePrefetch(1)</TT></LI>
+<TT>factory.prefetchPolicy.queuePrefetch=1</TT>, which is equivalent to
calling <TT>factory.getPrefetchPolicy().setQueuePrefetch(1)</TT></LI>
</OL>
@@ -588,8 +610,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=aco";>Adrian
Co</A> on Jun 07, 2006
- (<A
href="http://goopen.org/confluence/pages/diffpages.action?pageId=8591&originalId=8593";>view
change</A>)
+ last edited by <A
href="http://goopen.org/confluence/users/viewuserprofile.action?username=foconer";>foconer</A>
on Jun 07, 2006
+ (<A
href="http://goopen.org/confluence/pages/diffpages.action?pageId=8591&originalId=8597";>view
change</A>)
(<A
href="http://goopen.org/confluence/pages/editpage.action?pageId=8591";>edit
page</A>)
</DIV>
