You are viewing a plain text version of this content. The canonical link for it is here.
Posted to jmeter-dev@jakarta.apache.org by se...@apache.org on 2007/07/09 13:37:35 UTC

svn commit: r554610 - in /jakarta/jmeter/branches/rel-2-2/docs: changes.html usermanual/component_reference.html

Author: sebb
Date: Mon Jul  9 04:37:34 2007
New Revision: 554610

URL: http://svn.apache.org/viewvc?view=rev&rev=554610
Log:
Update site docs

Modified:
    jakarta/jmeter/branches/rel-2-2/docs/changes.html
    jakarta/jmeter/branches/rel-2-2/docs/usermanual/component_reference.html

Modified: jakarta/jmeter/branches/rel-2-2/docs/changes.html
URL: http://svn.apache.org/viewvc/jakarta/jmeter/branches/rel-2-2/docs/changes.html?view=diff&rev=554610&r1=554609&r2=554610
==============================================================================
--- jakarta/jmeter/branches/rel-2-2/docs/changes.html (original)
+++ jakarta/jmeter/branches/rel-2-2/docs/changes.html Mon Jul  9 04:37:34 2007
@@ -188,7 +188,7 @@
 									
 
 												<li	>
-								Transaction Controller now generates Sample with subresults
+								Transaction Controller now optionally generates a Sample with subresults
 						</li>
 									
 
@@ -243,41 +243,38 @@
 
 						</ul>
 							  									 				<h4	>
-								Known problems:
+								Incompatible changes (usage):
 						</h4>
 							  									 				<p	>
-								Thread active counts are always zero in CSV and XML files when running remote tests.
-
-						</p>
-							  									 				<p	>
-								The property file_format.testlog=2.1 is treated the same as 2.2.
-However JMeter does honour the 3 testplan versions.
-						</p>
-							  									 				<p	>
 								
-Bug 22510 - JMeter always uses the first entry in the keystore.
 
-						</p>
-							  									 				<p	>
-								
-Remote mode does not work if JMeter is installed in a directory where the path name contains spaces.
+												<b	>
+								N.B. The javax.net.ssl properties have been moved from jmeter.properties to system.properties,
+and will no longer work if defined in jmeter.properties.
+						</b>
+									
+
+												<br	>
+						</br>
+									
+The new arrangement is more flexible, as it allows arbitrary system properties to be defined.
 
 						</p>
 							  									 				<p	>
 								
-BeanShell test elements leak memory.
-This can be reduced by using a file instead of including the script in the test element.
+SSL session contexts are now created per-thread, rather than being shared.
+This generates a more realistic load for HTTPS tests.
+The change is likely to slow down tests with many SSL threads.
+The original behaviour can be enabled by setting the JMeter property:
 
-						</p>
-							  									 				<p	>
+												<pre	>
 								
-Variables and functions do not work in Listeners in client-server (remote) mode so they cannot be used
-to name log files in client-server mode.
+https.sessioncontext.shared=true
+
+						</pre>
+									
 
 						</p>
-							  									 				<h4	>
-								Incompatible changes (usage):
-						</h4>
 							  									 				<p	>
 								
 The LDAP Extended Sampler now uses the same panel for both Thread Bind and Single-Bind tests.
@@ -304,28 +301,12 @@
 
 						</p>
 							  									 				<p	>
-								The Transaction Controller no longer appears as a separate sample; it now includes its nested samples as subsamples
-						</p>
-							  									 				<p	>
 								
 Control-Z no longer used for Remote Start All - this now uses Control+Shift+R
 
 						</p>
 							  									 				<p	>
 								
-By default, SSL session contexts are created per-thread, rather than being shared.
-The original behaviour can be enabled by setting the JMeter property:
-
-												<pre	>
-								
-https.sessioncontext.shared=true
-
-						</pre>
-									
-
-						</p>
-							  									 				<p	>
-								
 HttpClient now uses pre-emptive authentication. 
 This can be changed by setting the following:
 
@@ -341,12 +322,6 @@
 									
 
 						</p>
-							  									 				<p	>
-								
-The javax.net.ssl properties have been moved from jmeter.properties to system.properties,
-and will no longer work if defined in jmeter.properties.
-
-						</p>
 							  									 				<h4	>
 								Incompatible changes (development):
 						</h4>
@@ -377,6 +352,44 @@
 								
 Removed method saveUsingJPEGEncoder() from SaveGraphicsService.
 It was unused so far, and used the only Sun-specific class in JMeter.
+
+						</p>
+							  									 				<h4	>
+								Known problems:
+						</h4>
+							  									 				<p	>
+								Transaction Controller parent mode does not support nested Transaction Controllers.
+Doing so may cause a Null Pointer Exception in TestCompiler.
+
+						</p>
+							  									 				<p	>
+								Thread active counts are always zero in CSV and XML files when running remote tests.
+
+						</p>
+							  									 				<p	>
+								The property file_format.testlog=2.1 is treated the same as 2.2.
+However JMeter does honour the 3 testplan versions.
+						</p>
+							  									 				<p	>
+								
+Bug 22510 - JMeter always uses the first entry in the keystore.
+
+						</p>
+							  									 				<p	>
+								
+Remote mode does not work if JMeter is installed in a directory where the path name contains spaces.
+
+						</p>
+							  									 				<p	>
+								
+BeanShell test elements leak memory.
+This can be reduced by using a file instead of including the script in the test element.
+
+						</p>
+							  									 				<p	>
+								
+Variables and functions do not work in Listeners in client-server (remote) mode so they cannot be used
+to name log files in client-server mode.
 
 						</p>
 							  									 				<h4	>

Modified: jakarta/jmeter/branches/rel-2-2/docs/usermanual/component_reference.html
URL: http://svn.apache.org/viewvc/jakarta/jmeter/branches/rel-2-2/docs/usermanual/component_reference.html?view=diff&rev=554610&r1=554609&r2=554610
==============================================================================
--- jakarta/jmeter/branches/rel-2-2/docs/usermanual/component_reference.html (original)
+++ jakarta/jmeter/branches/rel-2-2/docs/usermanual/component_reference.html Mon Jul  9 04:37:34 2007
@@ -4922,12 +4922,29 @@
 		</td></tr>
 				<tr><td>
 		  															
-		
+	    
 												<p	>
-								The Transaction Controller times how long it takes for all its children to run.
-			It then adds a "sample" entry to the test output with the total elapsed time.
-			The name of the element is used to name the "sample".
-		
+								
+	    The Transaction Comntroller is used to group samplers by generating an additional
+	    sample which totals the nested samples.
+	    For JMeter versions after 2.3, there are two modes of operation
+	    
+												<ul	>
+								
+	    
+												<li	>
+								additional sample is added after the nested samples
+						</li>
+									
+	    
+												<li	>
+								additional sample is added as a parent of the nested samples
+						</li>
+									
+	    
+						</ul>
+									
+	    
 						</p>
 									
 		
@@ -4942,21 +4959,26 @@
 									
 		
 												<p	>
-								For JMeter versions after 2.2, the controlled samples no longer appear as separate samples, but as subsamples.
-		Also the Transaction Sample is only regarded as successful if all its sub-samples are successful.
-		This is similar to the way the HTTP Samplers work when retrieving embedded objects (images etc).
-		The individual samples can still be seen in the Tree View Listener,
+								The generated sample is only regarded as successful if all its sub-samples are successful.
+						</p>
+									
+		
+												<p	>
+								
+		In parent mode, the individual samples can still be seen in the Tree View Listener,
 		but no longer appear as separate entries in other Listeners.
+		Also, the sub-samples do not appear in CSV log files, but they can be saved to XML files.
 		
 						</p>
 									
 		
 												<p><table border="1" bgcolor="#bbbb00" width="50%" cellspacing="0" cellpadding="2">
 		<tr><td>						
-		Assertions (etc) can be added to the Transaction Controller.
+		In parent mode, Assertions (etc) can be added to the Transaction Controller.
 		However by default they will be applied to both the individual samples and the overall transaction sample.
 		To limit the scope of the Assertions, use a Simple Controller to contain the samples, and add the Assertions
 		to the Simple Controller.
+		Parent mode controllers do not currently properly support nested transaction controllers of either type.
 		
 			</td></tr>
 	</table></p>
@@ -4971,6 +4993,17 @@
 			<tr>
 			<td>Name</td>
 			<td>						Descriptive name for this controller that is shown in the tree, and used to name the transaction.
+			</td>
+			<td>
+											Yes
+								</td>
+		</tr>
+			<tr>
+			<td>Generate Parent Sample</td>
+			<td>						
+	If checked, then the sample is generated as a parent of the other samples,
+	otherwise the sample is generated as an independent sample.
+	
 			</td>
 			<td>
 											Yes



---------------------------------------------------------------------
To unsubscribe, e-mail: jmeter-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: jmeter-dev-help@jakarta.apache.org