Author: jstrachan
Date: Thu Jun 22 22:19:33 2006
New Revision: 416571
URL: http://svn.apache.org/viewvc?rev=416571&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=416571&r1=416570&r2=416571&view=diff
==============================================================================
--- incubator/activemq/site/activemq-performance-module-users-manual.html
(original)
+++ incubator/activemq/site/activemq-performance-module-users-manual.html Thu
Jun 22 22:19:33 2006
@@ -69,7 +69,7 @@
<UL class="alternate" type="square">
<LI><A href="home.html" title="Home">Home</A></LI>
<LI><A href="news.html" title="News">News</A></LI>
- <LI><A href="changes-in-40.html" title="Changes in 4.0">New in
4.0</A></LI>
+ <LI><A href="new-features.html" title="New Features">New
Features</A></LI>
<LI><A href="faq.html" title="FAQ">FAQ</A></LI>
<LI><A href="site.html" title="Site">Site</A></LI>
<LI><A href="articles.html" title="Articles">Articles</A></LI>
@@ -159,7 +159,7 @@
<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>
+ <LI><A href="new-features.html" title="New Features">More New
Features</A></LI>
</UL>
@@ -273,7 +273,7 @@
</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>
+<P>When you run the producer & consumer, it generates an XML performance
report in the current 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>
<H3><A name="ActiveMQPerformanceModuleUsersManual-Mavengoals"></A>Maven
goals</H3>
@@ -291,11 +291,11 @@
</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>
+<TD class="confluenceTd"> Starts the consumer's performance testing. The
generated report file can be found in the directory specified in the parameter
"sysTest.reportDir". </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>
+<TD class="confluenceTd"> Starts the producer's performance testing. The
generated report file can be found in the directory specified in the parameter
"sysTest.reportDir". </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>
@@ -309,9 +309,9 @@
<TH class="confluenceTh"> Description </TH>
</TR>
<TR>
-<TD class="confluenceTd"> sysTest.clientName </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. This will overwrite settings used to
configure each individual client using consumer.clientName and
producer.clientName. </TD>
+<TD class="confluenceTd"> sysTest.clientPrefix </TD>
+<TD class="confluenceTd"> JmsConsumer or JmsProducer </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. </TD>
</TR>
<TR>
<TD class="confluenceTd"> sysTest.numClients </TD>
@@ -341,8 +341,8 @@
</TR>
<TR>
<TD class="confluenceTd"> sysTest.reportName </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#_Dest#_<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.
</TD>
+<TD class="confluenceTd"> null </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_numClients#<EM>numDests#</EM><Dest
Distro>.xml and JmsConsumer_numClients#_numDests#_<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. </TD>
</TR>
<TR>
<TD class="confluenceTd"> sysTest.reportType </TD>
@@ -354,6 +354,26 @@
</UL>
</TD>
</TR>
+<TR>
+<TD class="confluenceTd"> sysTest.samplers </TD>
+<TD class="confluenceTd"> tp,cpu </TD>
+<TD class="confluenceTd"> Specifies the samplers that will be started. To use
enable more than one sampler, separate the values by commas without spaces.
Available values are:
+<UL>
+ <LI>'tp' - Throughput sampler</LI>
+ <LI>'cpu' - CPU Usage sampler</LI>
+</UL>
+</TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> sysTest.spiClass </TD>
+<TD class="confluenceTd"> org.apache.activemq.tool.spi.ActiveMQClassLoaderSPI
</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>
+ <LI>'org.apache.activemq.tool.ActiveMQClassLoaderSPI'</LI>
+</OL>
+</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>
@@ -366,16 +386,6 @@
<TH class="confluenceTh"> Description </TH>
</TR>
<TR>
-<TD class="confluenceTd"> producer.spiClass </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>
- <LI>'org.apache.activemq.tool.ActiveMQClassLoaderSPI'</LI>
-</OL>
-</TD>
-</TR>
-<TR>
<TD class="confluenceTd"> producer.sessTransacted </TD>
<TD class="confluenceTd"> false </TD>
<TD class="confluenceTd"> Specifies if the session created will be transacted
or not. See the JMS Specifications for more details. </TD>
@@ -393,26 +403,11 @@
</TD>
</TR>
<TR>
-<TD class="confluenceTd"> producer.clientName </TD>
-<TD class="confluenceTd"> null </TD>
-<TD class="confluenceTd"> Specifies the client name of the JMS Producer. </TD>
-</TR>
-<TR>
<TD class="confluenceTd"> producer.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>
</TR>
<TR>
-<TD class="confluenceTd"> producer.destCount </TD>
-<TD class="confluenceTd"> 1 </TD>
-<TD class="confluenceTd"> The number of destinations assigned to this
client.<SUP>2</SUP> </TD>
-</TR>
-<TR>
-<TD class="confluenceTd"> producer.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>2</SUP> </TD>
-</TR>
-<TR>
<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>
@@ -433,6 +428,11 @@
<TD class="confluenceTd"> The size of each text message to send. </TD>
</TR>
<TR>
+<TD class="confluenceTd"> producer.createNewMsg </TD>
+<TD class="confluenceTd"> false </TD>
+<TD class="confluenceTd"> If true, each send will create a new JMS Message
with the specified message size with incrementing text messages (i.e. Text
Message 1, Text Message 2, ...). If false, only one message will be created
before the send loop, and this message will be sent over and over again. </TD>
+</TR>
+<TR>
<TD class="confluenceTd"> producer.sendType </TD>
<TD class="confluenceTd"> time </TD>
<TD class="confluenceTd"> Send either time-based or message-count-based.
Available values are:
@@ -466,16 +466,6 @@
<TH class="confluenceTh"> Description </TH>
</TR>
<TR>
-<TD class="confluenceTd"> consumer.spiClass </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>
- <LI>'org.apache.activemq.tool.ActiveMQClassLoaderSPI'</LI>
-</OL>
-</TD>
-</TR>
-<TR>
<TD class="confluenceTd"> consumer.sessTransacted </TD>
<TD class="confluenceTd"> false </TD>
<TD class="confluenceTd"> Specifies if the session created will be transacted
or not. See the JMS Specifications for more details. </TD>
@@ -493,26 +483,11 @@
</TD>
</TR>
<TR>
-<TD class="confluenceTd"> consumer.clientName </TD>
-<TD class="confluenceTd"> null/JMSConsumer </TD>
-<TD class="confluenceTd"> Specifies the client name of the JMS consumer. The
default value is null for non-durable subscriber, and JMSConsumer for durable
subscriber. </TD>
-</TR>
-<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>
</TR>
<TR>
-<TD class="confluenceTd"> consumer.destCount </TD>
-<TD class="confluenceTd"> 1 </TD>
-<TD class="confluenceTd"> The number of destinations assigned to this
client.<SUP>3</SUP> </TD>
-</TR>
-<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>
-</TR>
-<TR>
<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>
@@ -550,7 +525,7 @@
<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>
+<P><SUP>3</SUP> <B>Note</B>: If you have more than one consumer receiving from
multiple destinations, it is a good idea to change the sysTest.destDistro to
'equal', since by default it uses 'all' and a consumer can
only receive from a single destination, hence all consumers will receive from
the first destination in the list only.</P>
<H3><A
name="ActiveMQPerformanceModuleUsersManual-ConfigurationforSPIConnectionFactory%3Aorg.apache.activemq.tool.spi.ActiveMQPojoSPI"></A>Configuration
for SPI Connection Factory: org.apache.activemq.tool.spi.ActiveMQPojoSPI</H3>
@@ -688,8 +663,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 13, 2006
- (<A
href="http://goopen.org/confluence/pages/diffpages.action?pageId=8591&originalId=8718";>view
change</A>)
+ last edited by <A
href="http://goopen.org/confluence/users/viewuserprofile.action?username=aco";>Adrian
Co</A> on Jun 23, 2006
+ (<A
href="http://goopen.org/confluence/pages/diffpages.action?pageId=8591&originalId=8848";>view
change</A>)
(<A
href="http://goopen.org/confluence/pages/editpage.action?pageId=8591";>edit
page</A>)
</DIV>
