You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@activemq.apache.org by js...@apache.org on 2006/06/23 07:19:34 UTC
svn commit: r416571 -
/incubator/activemq/site/activemq-performance-module-users-manual.html
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>