Modified: jmeter/trunk/docs/usermanual/build-adv-web-test-plan.html URL: http://svn.apache.org/viewvc/jmeter/trunk/docs/usermanual/build-adv-web-test-plan.html?rev=1664961&r1=1664960&r2=1664961&view=diff ============================================================================== --- jmeter/trunk/docs/usermanual/build-adv-web-test-plan.html (original) +++ jmeter/trunk/docs/usermanual/build-adv-web-test-plan.html Sun Mar 8 10:22:58 2015 @@ -1,363 +1,75 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd";> -<!-- - Licensed to the Apache Software Foundation (ASF) under one or more - contributor license agreements. See the NOTICE file distributed with - this work for additional information regarding copyright ownership. - The ASF licenses this file to You under the Apache License, Version 2.0 - (the "License"); you may not use this file except in compliance with - the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, software - distributed under the License is distributed on an "AS IS" BASIS, - WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - See the License for the specific language governing permissions and - limitations under the License. ---> - -<!-- Content Stylesheet for Site --> - - -<!-- start the processing --> -<html> -<head> -<link rel="stylesheet" type="text/css" href="../css/style.css"/> -<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/> - -<title>Apache JMeter - User's Manual: Building an Advanced Web Test Plan</title> -</head> - -<body bgcolor="#ffffff" text="#000000" link="#525D76"> -<table width="100%" cellspacing="0" border="0"> -<tr> -<td width="90%" align="left"> -<table border="0" cellspacing="0"> -<tr> -<td width="10%"> -<a href="http://www.apache.org";><img title="Apache Software Foundation" width="290" height="75" src="../images/asf-logo.png" border="0"/></a> -</td> -<td align="left" width="40%"> - -<a href="http://jmeter.apache.org/";><img width="182" height="88" src="../images/logo.jpg" alt="Apache JMeter" title="Apache JMeter" border="0"/></a> -</td> -</tr> -</table> -</td> -<td align="left" width="50%"> -<table cellspacing="0" align="right" border="0"> -<tr> -<td align="left"> <a href="https://twitter.com/share"; -class="twitter-share-button" -data-text="Powerful Load Testing with -Apache #JMeter" data-via="ApacheJMeter" -data-lang="en-gb" data-size="large">Tweet</a> -<script>!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0],p=/^http:/.test(d.location)?'http':'https';if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src=p+'://platform.twitter.com/widgets.js';fjs.parentNode.insertBefore(js,fjs);}}(document, 'script', 'twitter-wjs');</script> -</td> -<td align="right"> <a -href="https://twitter.com/ApacheJMeter"; -class="twitter-follow-button" -data-show-count="false" data-lang="en-gb" -data-size="large">Follow</a> -<script>!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0],p=/^http:/.test(d.location)?'http':'https';if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src=p+'://platform.twitter.com/widgets.js';fjs.parentNode.insertBefore(js,fjs);}}(document, 'script', 'twitter-wjs');</script> -</td> -</tr> -</table> -</td></tr> -</table> - -<table border="0" width="100%" cellspacing="4"> -<tr><td colspan="2"> -<hr noshade size="1"/> -</td></tr> -<tr> -<!-- LEFT SIDE NAVIGATION --> -<td width="20%" valign="top" nowrap="true"> -<table border="0" width="100%" cellspacing="0"> -<tr><td> -<p><strong>About</strong></p> -<ul> -<li><a href="../index.html">Overview</a> -</li> -<li><a href="http://twitter.com/ApacheJMeter";>JMeter on Twitter</a> -<img src="../images/twitter.png" align="top"/></li> -<li><a href="../issues.html">Issue Tracking</a> -</li> -<li><a href="http://projects.apache.org/feeds/rss/jmeter.xml";>Subscribe to What's New</a> -</li> -<li><a href="http://www.apache.org/licenses/";>License</a> -</li> -</ul> -<p><strong>Download</strong></p> -<ul> -<li><a href="../download_jmeter.cgi">Download Releases</a> -</li> -<li><a href="../nightly.html">Developer (Nightly) Builds</a> -</li> -</ul> -<p><strong>Documentation</strong></p> -<ul> -<li><a href="../changes.html">Changes per version</a> -</li> -<li><a href="../usermanual/get-started.html">Get Started</a> -</li> -<li><a href="../usermanual/index.html">User Manual</a> -</li> -<li><a href="../usermanual/best-practices.html">Best Practices</a> -</li> -<li><a href="../usermanual/component_reference.html">Component Reference</a> -</li> -<li><a href="../usermanual/functions.html">Functions Reference</a> -</li> -<li><a href="../api/index.html">Javadocs</a> -</li> -<li><a href="../building.html">Building JMeter and Add-Ons</a> -</li> -<li><a href="http://wiki.apache.org/jmeter";>JMeter Wiki</a> -</li> -<li><a href="http://wiki.apache.org/jmeter/JMeterFAQ";>FAQ (Wiki)</a> -</li> -</ul> -<p><strong>Tutorials (PDF format)</strong></p> -<ul> -<li><a href="../usermanual/jmeter_distributed_testing_step_by_step.pdf">Distributed Testing</a> -</li> -<li><a href="../usermanual/jmeter_proxy_step_by_step.pdf">Recording Tests</a> -</li> -<li><a href="../usermanual/junitsampler_tutorial.pdf">JUnit Sampler</a> -</li> -<li><a href="../usermanual/jmeter_accesslog_sampler_step_by_step.pdf">Access Log Sampler</a> -</li> -<li><a href="../extending/jmeter_tutorial.pdf">Extending JMeter</a> -</li> -</ul> -<p><strong>Community</strong></p> -<ul> -<li><a href="http://wiki.apache.org/jmeter/JMeterCommitters";>Contributors</a> -</li> -<li><a href="../mail.html">Mailing Lists</a> -</li> -<li><a href="../svnindex.html">SVN Repositories</a> -</li> -</ul> -<p><strong>Foundation</strong></p> -<ul> -<li><a href="http://www.apache.org/";>ASF</a> -</li> -<li><a href="http://www.apache.org/foundation/getinvolved.html";>Get Involved in the ASF</a> -</li> -<li><a href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a> -</li> -<li><a href="http://www.apache.org/foundation/thanks.html";>Thanks</a> -</li> -</ul> -</td></tr> -<tr><td> -<iframe src="http://www.apache.org/ads/button.html"; style="border-width:0; float: left;" frameborder="0" scrolling="no"></iframe> -</td></tr> -</table> -</td> -<td width="80%" align="left" valign="top"> -<table> -<tr> -<td bgcolor="#525D76"> -<div align="right"><a href="index.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Index</font></a></div> -</td> -<td bgcolor="#525D76"> -<div align="right"><a href="build-db-test-plan.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Next</font></a></div> -</td> -<td bgcolor="#525D76"> -<div align="right"><a href="build-web-test-plan.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Prev</font></a></div> -</td> -</tr> -</table> -<br> -<table border="0" cellspacing="0" cellpadding="2" width="100%"> -<tr><td bgcolor="#525D76"> -<font color="#ffffff" face="arial,helvetica,sanserif"> -<a name="building"><strong>6. Building an Advanced Web Test Plan</strong></a><a class="sectionlink" href="#building" title="Link to here">¶</a></font> -</td></tr> -<tr><td> -<blockquote> -<p> -In this section, you will learn how to create advanced - -<a href="build-test-plan.html"> -Test Plans -</a> - to test a Web site. -</p> -<p> -For an example of a basic Test Plan, see - -<a href="build-web-test-plan.html"> -Building a Web Test Plan -</a> -. -</p> -</blockquote> -</p> -</td></tr> -<tr><td><br></td></tr> -</table> -<table border="0" cellspacing="0" cellpadding="2" width="100%"> -<tr><td bgcolor="#525D76"> -<font color="#ffffff" face="arial,helvetica,sanserif"> -<a name="session_url_rewriting"><strong>6.1 Handling User Sessions With URL Rewriting</strong></a><a class="sectionlink" href="#session_url_rewriting" title="Link to here">¶</a></font> -</td></tr> -<tr><td> -<blockquote> -<p> -If your web application uses URL rewriting rather than cookies to save session information, -then you'll need to do a bit of extra work to test your site. -</p> -<p> -To respond correctly to URL rewriting, JMeter needs to parse the HTML -received from the server and retrieve the unique session ID. Use the appropriate -<a href="../usermanual/component_reference.html#HTTP_URL_Re-writing_Modifier">HTTP URL Re-writing Modifier</a> - +<!DOCTYPE html SYSTEM "about:legacy-compat"> +<html lang="en"><head><META http-equiv="Content-Type" content="text/html; charset=iso-8859-15"><title>Apache JMeter + - + User's Manual: Building an Advanced Web Test Plan</title><meta name="viewport" content="width=device-width, initial-scale=1"><link href="http://fonts.googleapis.com/css?family=Merriweather:400normal"; rel="stylesheet" type="text/css"><link rel="stylesheet" type="text/css" href="../css/new-style.css"></head><body role="document"><a href="#content" class="hidden">Main content</a><div class="header"><!-- + APACHE LOGO + --><div><a href="http://www.apache.org";><img title="Apache Software Foundation" width="290" height="75" src="../images/asf-logo.png" alt="Logo ASF"></a></div><!-- + PROJECT LOGO + --><div><a href="http://jmeter.apache.org/";><img src="../images/logo.jpg" alt="Apache JMeter"></a></div><div class="twitter"><div><a href="https://twitter.com/share"; class="twitter-share-button" data-text="Powerful Load Testing with Apache #JMeter" data-via="ApacheJMeter" data-lang="en-gb" data-size="large">Tweet</a><script> + (function(d,s,id){ + var js, + fjs=d.getElementsByTagName(s)[0], + p=/^http:/.test(d.location)?'http':'https'; + if (!d.getElementById(id)) { + js=d.createElement(s); + js.id=id; + js.src=p+'://platform.twitter.com/widgets.js'; + fjs.parentNode.insertBefore(js,fjs); + } + })(document, 'script', 'twitter-wjs'); + </script></div><div><a href="https://twitter.com/ApacheJMeter"; class="twitter-follow-button" data-show-count="false" data-lang="en-gb" data-size="large">Follow</a><script>(function(d,s,id){ + var js, + fjs=d.getElementsByTagName(s)[0], + p=/^http:/.test(d.location)?'http':'https'; + if (!d.getElementById(id)) { + js=d.createElement(s); + js.id=id; + js.src=p+'://platform.twitter.com/widgets.js'; + fjs.parentNode.insertBefore(js,fjs); + } + })(document, 'script', 'twitter-wjs'); + </script></div></div><div class="banner"><iframe src="http://www.apache.org/ads/bannerbar.html"; style="border-width:0;" frameborder="0" scrolling="no"></iframe><div class="clear"></div></div></div><div class="nav"><ul class="menu"><li><div class="menu-title">About</div><ul><li><a href="../index.html">Overview</a></li><li><a href="http://twitter.com/ApacheJMeter";>JMeter on Twitter<img src="../images/twitter.png" alt="Icon for JMeter on Twitter"></a></li><li><a href="../issues.html">Issue Tracking</a></li><li><a href="http://projects.apache.org/feeds/rss/jmeter.xml";>Subscribe to What's New</a></li><li><a href="http://www.apache.org/licenses/";>License</a></li></ul></li></ul><ul class="menu"><li><div class="menu-title">Download</div><ul><li><a href="../download_jmeter.cgi">Download Releases</a></li><li><a href="../nightly.html">Developer (Nightly) Builds</a></li></ul></li></ul><ul class="menu"><li><div class="menu-title">Documentation</div><ul><li><a href="../changes.html" >Changes per version</a></li><li><a href="../usermanual/get-started.html">Get >Started</a></li><li><a href="../usermanual/index.html">User >Manual</a></li><li><a href="../usermanual/best-practices.html">Best >Practices</a></li><li><a >href="../usermanual/component_reference.html">Component >Reference</a></li><li><a href="../usermanual/functions.html">Functions >Reference</a></li><li><a href="../api/index.html">Javadocs</a></li><li><a >href="../building.html">Building JMeter and Add-Ons</a></li><li><a >href="http://wiki.apache.org/jmeter";>JMeter Wiki</a></li><li><a >href="http://wiki.apache.org/jmeter/JMeterFAQ";>FAQ >(Wiki)</a></li></ul></li></ul><ul class="menu"><li><div >class="menu-title">Tutorials (PDF format)</div><ul><li><a >href="../usermanual/jmeter_distributed_testing_step_by_step.pdf">Distributed >Testing</a></li><li><a >href="../usermanual/jmeter_proxy_step_by_step.pdf">Recording >Tests</a></li><li><a href="../usermanual/junitsampler_tutorial.pdf">JUnit >Sampler</a></li><li><a href="../us ermanual/jmeter_accesslog_sampler_step_by_step.pdf">Access Log Sampler</a></li><li><a href="../extending/jmeter_tutorial.pdf">Extending JMeter</a></li></ul></li></ul><ul class="menu"><li><div class="menu-title">Community</div><ul><li><a href="http://wiki.apache.org/jmeter/JMeterCommitters";>Contributors</a></li><li><a href="../mail.html">Mailing Lists</a></li><li><a href="../svnindex.html">SVN Repositories</a></li></ul></li></ul><ul class="menu"><li><div class="menu-title">Foundation</div><ul><li><a href="http://www.apache.org/";>ASF</a></li><li><a href="http://www.apache.org/foundation/getinvolved.html";>Get Involved in the ASF</a></li><li><a href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a></li><li><a href="http://www.apache.org/foundation/thanks.html";>Thanks</a></li></ul></li></ul></div><div class="main" id="content"><ul class="pagelinks"><li><a href="build-web-test-plan.html">< Prev</a></li><li><a href="../index.html">Index</a></li><li><a href="build-db-te st-plan.html">Next ></a></li></ul><div class="section"><h1 id="building">6. Building an Advanced Web Test Plan<a class="sectionlink" href="#building" title="Link to here">¶</a></h1> +<p>In this section, you will learn how to create advanced +<a href="build-test-plan.html">Test Plans</a> to test a Web site.</p> + +<p>For an example of a basic Test Plan, see +<a href="build-web-test-plan.html">Building a Web Test Plan</a>.</p></div><div class="section"><h1 id="session_url_rewriting">6.1 Handling User Sessions With URL Rewriting<a class="sectionlink" href="#session_url_rewriting" title="Link to here">¶</a></h1> +<p>If your web application uses URL rewriting rather than cookies to save session information, +then you'll need to do a bit of extra work to test your site.</p> +<p>To respond correctly to URL rewriting, JMeter needs to parse the HTML +received from the server and retrieve the unique session ID. Use the appropriate <a href="../usermanual/component_reference.html#HTTP_URL_Re-writing_Modifier">HTTP URL Re-writing Modifier</a> to accomplish this. Simply enter the name of your session ID parameter into the modifier, and it will find it and add it to each request. If the request already has a value, it will be replaced. If "Cache Session Id?" is checked, then the last found session id will be saved, and will be used if the previous HTTP sample does not contain a session id. - </p> -<a name="url_rewriting_example"/> -<a class="sectionlink" href="#url_rewriting_example" title="Link to here">¶</a><p><b>URL Rewriting Example</b></p> - -<p> -Download -<a href="../demos/URLRewritingExample.jmx"> -this example -</a> -. In Figure 1 is shown a +<div class="example"><div class="title">URL Rewriting Example<a class="sectionlink" href="#url_rewriting_example" title="Link to here">¶</a></div> +<p>Download <a href="../demos/URLRewritingExample.jmx">this example</a>. In Figure 1 is shown a test plan using URL rewriting. Note that the URL Re-writing modifier is added to the SimpleController, -thus assuring that it will only affect requests under that SimpleController. -</p> - - -<p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/url_rewrite_example_a.png"/><br> -<font size="-1">Figure 1 - Test Tree -</font></td></tr></table></p> - - -<p> -In Figure 2, we see the URL Re-writing modifier GUI, which just has a field for the user to specify +thus assuring that it will only affect requests under that SimpleController.</p> +<figure><a href="../images/screenshots/url_rewrite_example_a.png"><img src="../images/screenshots/url_rewrite_example_a.png" width="" height="" alt="Figure 1 - Test Tree"></a><figcaption>Figure 1 - Test Tree</figcaption></figure> +<p>In Figure 2, we see the URL Re-writing modifier GUI, which just has a field for the user to specify the name of the session ID parameter. There is also a checkbox for indicating that the session ID should -be part of the path (separated by a ";"), rather than a request parameter -</p> - - -<p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/url_rewrite_example_b.png"/><br> -<font size="-1">Figure 2 - Request parameters -</font></td></tr></table></p> - - -</blockquote> -</p> -</td></tr> -<tr><td><br></td></tr> -</table> -<table border="0" cellspacing="0" cellpadding="2" width="100%"> -<tr><td bgcolor="#525D76"> -<font color="#ffffff" face="arial,helvetica,sanserif"> -<a name="header_manager"><strong>6.2 Using a Header Manager</strong></a><a class="sectionlink" href="#header_manager" title="Link to here">¶</a></font> -</td></tr> -<tr><td> -<blockquote> -<p> -The -<a href="../usermanual/component_reference.html#HTTP_Header_Manager">HTTP Header Manager</a> - lets you customize what information +be part of the path (separated by a ";"), rather than a request parameter</p> +<figure><a href="../images/screenshots/url_rewrite_example_b.png"><img src="../images/screenshots/url_rewrite_example_b.png" width="" height="" alt="Figure 2 - Request parameters"></a><figcaption>Figure 2 - Request parameters</figcaption></figure> +</div> +</div><div class="section"><h1 id="header_manager">6.2 Using a Header Manager<a class="sectionlink" href="#header_manager" title="Link to here">¶</a></h1> +<p>The <a href="../usermanual/component_reference.html#HTTP_Header_Manager">HTTP Header Manager</a> lets you customize what information JMeter sends in the HTTP request header. This header includes properties like "User-Agent", -"Pragma", "Referer", etc. -</p> -<p> -The -<a href="../usermanual/component_reference.html#HTTP_Header_Manager">HTTP Header Manager</a> -, like the -<a href="../usermanual/component_reference.html#HTTP_Cookie_Manager">HTTP Cookie Manager</a> -, +"Pragma", "Referer", etc.</p> +<p>The <a href="../usermanual/component_reference.html#HTTP_Header_Manager">HTTP Header Manager</a>, like the <a href="../usermanual/component_reference.html#HTTP_Cookie_Manager">HTTP Cookie Manager</a>, should probably be added at the Thread Group level, unless for some reason you wish to -specify different headers for the different -<a href="../usermanual/component_reference.html#HTTP_Request">HTTP Request</a> - objects in -your test. -</p> -</blockquote> -</p> -</td></tr> -<tr><td><br></td></tr> -</table> -<br> -<table> -<tr> -<td bgcolor="#525D76"> -<div align="right"><a href="index.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Index</font></a></div> -</td> -<td bgcolor="#525D76"> -<div align="right"><a href="build-db-test-plan.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Next</font></a></div> -</td> -<td bgcolor="#525D76"> -<div align="right"><a href="build-web-test-plan.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Prev</font></a></div> -</td> -</tr> -</table> -</td> -</tr> -<tr><td colspan="2"> -<hr noshade size="1"/> -</td></tr> -<tr><td colspan="2"> -<div align="center"><font color="#525D76" size="-1"><em> -Copyright © 1999-2015, Apache Software Foundation -</em></font></div> -</td></tr> -<tr><td colspan="2"> -<div align="center"><font color="#525D76" size="-1"> -Apache, Apache JMeter, JMeter, the Apache feather, and the Apache JMeter logo are -trademarks of the Apache Software Foundation. -</font> -</div> -</td></tr> -</table> -</body> -</html> -<!-- end the processing --> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - +specify different headers for the different <a href="../usermanual/component_reference.html#HTTP_Request">HTTP Request</a> objects in +your test.</p> +</div><ul class="pagelinks"><li><a href="build-web-test-plan.html">< Prev</a></li><li><a href="../index.html">Index</a></li><li><a href="build-db-test-plan.html">Next ></a></li></ul></div><div class="footer"><div class="copyright"> + Copyright © + 1999 – + 2015 + , Apache Software Foundation + </div><div class="trademarks">Apache, Apache JMeter, JMeter, the Apache + feather, and the Apache JMeter logo are + trademarks of the + Apache Software Foundation. + </div></div></body></html> \ No newline at end of file
Modified: jmeter/trunk/docs/usermanual/build-db-test-plan.html URL: http://svn.apache.org/viewvc/jmeter/trunk/docs/usermanual/build-db-test-plan.html?rev=1664961&r1=1664960&r2=1664961&view=diff ============================================================================== --- jmeter/trunk/docs/usermanual/build-db-test-plan.html (original) +++ jmeter/trunk/docs/usermanual/build-db-test-plan.html Sun Mar 8 10:22:58 2015 @@ -1,644 +1,198 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd";> -<!-- - Licensed to the Apache Software Foundation (ASF) under one or more - contributor license agreements. See the NOTICE file distributed with - this work for additional information regarding copyright ownership. - The ASF licenses this file to You under the Apache License, Version 2.0 - (the "License"); you may not use this file except in compliance with - the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, software - distributed under the License is distributed on an "AS IS" BASIS, - WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - See the License for the specific language governing permissions and - limitations under the License. ---> - -<!-- Content Stylesheet for Site --> - - -<!-- start the processing --> -<html> -<head> -<link rel="stylesheet" type="text/css" href="../css/style.css"/> -<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/> - -<title>Apache JMeter - User's Manual: Building a Simple Database Test Plan</title> -</head> - -<body bgcolor="#ffffff" text="#000000" link="#525D76"> -<table width="100%" cellspacing="0" border="0"> -<tr> -<td width="90%" align="left"> -<table border="0" cellspacing="0"> -<tr> -<td width="10%"> -<a href="http://www.apache.org";><img title="Apache Software Foundation" width="290" height="75" src="../images/asf-logo.png" border="0"/></a> -</td> -<td align="left" width="40%"> - -<a href="http://jmeter.apache.org/";><img width="182" height="88" src="../images/logo.jpg" alt="Apache JMeter" title="Apache JMeter" border="0"/></a> -</td> -</tr> -</table> -</td> -<td align="left" width="50%"> -<table cellspacing="0" align="right" border="0"> -<tr> -<td align="left"> <a href="https://twitter.com/share"; -class="twitter-share-button" -data-text="Powerful Load Testing with -Apache #JMeter" data-via="ApacheJMeter" -data-lang="en-gb" data-size="large">Tweet</a> -<script>!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0],p=/^http:/.test(d.location)?'http':'https';if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src=p+'://platform.twitter.com/widgets.js';fjs.parentNode.insertBefore(js,fjs);}}(document, 'script', 'twitter-wjs');</script> -</td> -<td align="right"> <a -href="https://twitter.com/ApacheJMeter"; -class="twitter-follow-button" -data-show-count="false" data-lang="en-gb" -data-size="large">Follow</a> -<script>!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0],p=/^http:/.test(d.location)?'http':'https';if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src=p+'://platform.twitter.com/widgets.js';fjs.parentNode.insertBefore(js,fjs);}}(document, 'script', 'twitter-wjs');</script> -</td> -</tr> -</table> -</td></tr> -</table> - -<table border="0" width="100%" cellspacing="4"> -<tr><td colspan="2"> -<hr noshade size="1"/> -</td></tr> -<tr> -<!-- LEFT SIDE NAVIGATION --> -<td width="20%" valign="top" nowrap="true"> -<table border="0" width="100%" cellspacing="0"> -<tr><td> -<p><strong>About</strong></p> -<ul> -<li><a href="../index.html">Overview</a> -</li> -<li><a href="http://twitter.com/ApacheJMeter";>JMeter on Twitter</a> -<img src="../images/twitter.png" align="top"/></li> -<li><a href="../issues.html">Issue Tracking</a> -</li> -<li><a href="http://projects.apache.org/feeds/rss/jmeter.xml";>Subscribe to What's New</a> -</li> -<li><a href="http://www.apache.org/licenses/";>License</a> -</li> -</ul> -<p><strong>Download</strong></p> -<ul> -<li><a href="../download_jmeter.cgi">Download Releases</a> -</li> -<li><a href="../nightly.html">Developer (Nightly) Builds</a> -</li> -</ul> -<p><strong>Documentation</strong></p> -<ul> -<li><a href="../changes.html">Changes per version</a> -</li> -<li><a href="../usermanual/get-started.html">Get Started</a> -</li> -<li><a href="../usermanual/index.html">User Manual</a> -</li> -<li><a href="../usermanual/best-practices.html">Best Practices</a> -</li> -<li><a href="../usermanual/component_reference.html">Component Reference</a> -</li> -<li><a href="../usermanual/functions.html">Functions Reference</a> -</li> -<li><a href="../api/index.html">Javadocs</a> -</li> -<li><a href="../building.html">Building JMeter and Add-Ons</a> -</li> -<li><a href="http://wiki.apache.org/jmeter";>JMeter Wiki</a> -</li> -<li><a href="http://wiki.apache.org/jmeter/JMeterFAQ";>FAQ (Wiki)</a> -</li> -</ul> -<p><strong>Tutorials (PDF format)</strong></p> -<ul> -<li><a href="../usermanual/jmeter_distributed_testing_step_by_step.pdf">Distributed Testing</a> -</li> -<li><a href="../usermanual/jmeter_proxy_step_by_step.pdf">Recording Tests</a> -</li> -<li><a href="../usermanual/junitsampler_tutorial.pdf">JUnit Sampler</a> -</li> -<li><a href="../usermanual/jmeter_accesslog_sampler_step_by_step.pdf">Access Log Sampler</a> -</li> -<li><a href="../extending/jmeter_tutorial.pdf">Extending JMeter</a> -</li> -</ul> -<p><strong>Community</strong></p> -<ul> -<li><a href="http://wiki.apache.org/jmeter/JMeterCommitters";>Contributors</a> -</li> -<li><a href="../mail.html">Mailing Lists</a> -</li> -<li><a href="../svnindex.html">SVN Repositories</a> -</li> -</ul> -<p><strong>Foundation</strong></p> -<ul> -<li><a href="http://www.apache.org/";>ASF</a> -</li> -<li><a href="http://www.apache.org/foundation/getinvolved.html";>Get Involved in the ASF</a> -</li> -<li><a href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a> -</li> -<li><a href="http://www.apache.org/foundation/thanks.html";>Thanks</a> -</li> -</ul> -</td></tr> -<tr><td> -<iframe src="http://www.apache.org/ads/button.html"; style="border-width:0; float: left;" frameborder="0" scrolling="no"></iframe> -</td></tr> -</table> -</td> -<td width="80%" align="left" valign="top"> -<table> -<tr> -<td bgcolor="#525D76"> -<div align="right"><a href="index.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Index</font></a></div> -</td> -<td bgcolor="#525D76"> -<div align="right"><a href="build-ftp-test-plan.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Next</font></a></div> -</td> -<td bgcolor="#525D76"> -<div align="right"><a href="build-adv-web-test-plan.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Prev</font></a></div> -</td> -</tr> -</table> -<br> -<table border="0" cellspacing="0" cellpadding="2" width="100%"> -<tr><td bgcolor="#525D76"> -<font color="#ffffff" face="arial,helvetica,sanserif"> -<a name="building"><strong>7. Building a Database Test Plan</strong></a><a class="sectionlink" href="#building" title="Link to here">¶</a></font> -</td></tr> -<tr><td> -<blockquote> -<p> -In this section, you will learn how to create a basic - -<a href="build-test-plan.html"> -Test Plan -</a> - to test a database server. +<!DOCTYPE html SYSTEM "about:legacy-compat"> +<html lang="en"><head><META http-equiv="Content-Type" content="text/html; charset=iso-8859-15"><title>Apache JMeter + - + User's Manual: Building a Simple Database Test Plan</title><meta name="viewport" content="width=device-width, initial-scale=1"><link href="http://fonts.googleapis.com/css?family=Merriweather:400normal"; rel="stylesheet" type="text/css"><link rel="stylesheet" type="text/css" href="../css/new-style.css"></head><body role="document"><a href="#content" class="hidden">Main content</a><div class="header"><!-- + APACHE LOGO + --><div><a href="http://www.apache.org";><img title="Apache Software Foundation" width="290" height="75" src="../images/asf-logo.png" alt="Logo ASF"></a></div><!-- + PROJECT LOGO + --><div><a href="http://jmeter.apache.org/";><img src="../images/logo.jpg" alt="Apache JMeter"></a></div><div class="twitter"><div><a href="https://twitter.com/share"; class="twitter-share-button" data-text="Powerful Load Testing with Apache #JMeter" data-via="ApacheJMeter" data-lang="en-gb" data-size="large">Tweet</a><script> + (function(d,s,id){ + var js, + fjs=d.getElementsByTagName(s)[0], + p=/^http:/.test(d.location)?'http':'https'; + if (!d.getElementById(id)) { + js=d.createElement(s); + js.id=id; + js.src=p+'://platform.twitter.com/widgets.js'; + fjs.parentNode.insertBefore(js,fjs); + } + })(document, 'script', 'twitter-wjs'); + </script></div><div><a href="https://twitter.com/ApacheJMeter"; class="twitter-follow-button" data-show-count="false" data-lang="en-gb" data-size="large">Follow</a><script>(function(d,s,id){ + var js, + fjs=d.getElementsByTagName(s)[0], + p=/^http:/.test(d.location)?'http':'https'; + if (!d.getElementById(id)) { + js=d.createElement(s); + js.id=id; + js.src=p+'://platform.twitter.com/widgets.js'; + fjs.parentNode.insertBefore(js,fjs); + } + })(document, 'script', 'twitter-wjs'); + </script></div></div><div class="banner"><iframe src="http://www.apache.org/ads/bannerbar.html"; style="border-width:0;" frameborder="0" scrolling="no"></iframe><div class="clear"></div></div></div><div class="nav"><ul class="menu"><li><div class="menu-title">About</div><ul><li><a href="../index.html">Overview</a></li><li><a href="http://twitter.com/ApacheJMeter";>JMeter on Twitter<img src="../images/twitter.png" alt="Icon for JMeter on Twitter"></a></li><li><a href="../issues.html">Issue Tracking</a></li><li><a href="http://projects.apache.org/feeds/rss/jmeter.xml";>Subscribe to What's New</a></li><li><a href="http://www.apache.org/licenses/";>License</a></li></ul></li></ul><ul class="menu"><li><div class="menu-title">Download</div><ul><li><a href="../download_jmeter.cgi">Download Releases</a></li><li><a href="../nightly.html">Developer (Nightly) Builds</a></li></ul></li></ul><ul class="menu"><li><div class="menu-title">Documentation</div><ul><li><a href="../changes.html" >Changes per version</a></li><li><a href="../usermanual/get-started.html">Get >Started</a></li><li><a href="../usermanual/index.html">User >Manual</a></li><li><a href="../usermanual/best-practices.html">Best >Practices</a></li><li><a >href="../usermanual/component_reference.html">Component >Reference</a></li><li><a href="../usermanual/functions.html">Functions >Reference</a></li><li><a href="../api/index.html">Javadocs</a></li><li><a >href="../building.html">Building JMeter and Add-Ons</a></li><li><a >href="http://wiki.apache.org/jmeter";>JMeter Wiki</a></li><li><a >href="http://wiki.apache.org/jmeter/JMeterFAQ";>FAQ >(Wiki)</a></li></ul></li></ul><ul class="menu"><li><div >class="menu-title">Tutorials (PDF format)</div><ul><li><a >href="../usermanual/jmeter_distributed_testing_step_by_step.pdf">Distributed >Testing</a></li><li><a >href="../usermanual/jmeter_proxy_step_by_step.pdf">Recording >Tests</a></li><li><a href="../usermanual/junitsampler_tutorial.pdf">JUnit >Sampler</a></li><li><a href="../us ermanual/jmeter_accesslog_sampler_step_by_step.pdf">Access Log Sampler</a></li><li><a href="../extending/jmeter_tutorial.pdf">Extending JMeter</a></li></ul></li></ul><ul class="menu"><li><div class="menu-title">Community</div><ul><li><a href="http://wiki.apache.org/jmeter/JMeterCommitters";>Contributors</a></li><li><a href="../mail.html">Mailing Lists</a></li><li><a href="../svnindex.html">SVN Repositories</a></li></ul></li></ul><ul class="menu"><li><div class="menu-title">Foundation</div><ul><li><a href="http://www.apache.org/";>ASF</a></li><li><a href="http://www.apache.org/foundation/getinvolved.html";>Get Involved in the ASF</a></li><li><a href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a></li><li><a href="http://www.apache.org/foundation/thanks.html";>Thanks</a></li></ul></li></ul></div><div class="main" id="content"><ul class="pagelinks"><li><a href="build-adv-web-test-plan.html">< Prev</a></li><li><a href="../index.html">Index</a></li><li><a href="build-f tp-test-plan.html">Next ></a></li></ul><div class="section"><h1 id="building">7. Building a Database Test Plan<a class="sectionlink" href="#building" title="Link to here">¶</a></h1> +<p>In this section, you will learn how to create a basic +<a href="build-test-plan.html">Test Plan</a> to test a database server. You will create fifty users that send 2 SQL requests to the database server. Also, you will tell the users to run their tests 100 times. So, the total number of requests is (50 users) x (2 requests) x (repeat 100 times) = 10'000 JDBC requests. To construct the Test Plan, you will use the following elements: +<a href="test_plan.html#thread_group">Thread Group</a>, +<a href="../usermanual/component_reference.html#JDBC_Request">JDBC Request</a>, <a href="../usermanual/component_reference.html#Summary_Report">Summary Report</a>.</p> -<a href="test_plan.html#thread_group"> -Thread Group -</a> -, - -<a href="../usermanual/component_reference.html#JDBC_Request">JDBC Request</a> -, -<a href="../usermanual/component_reference.html#Summary_Report">Summary Report</a> -. -</p> -<p> -<table border="1" bgcolor="#bbbb00" width="50%" cellspacing="0" cellpadding="2"> -<tr><td>This example uses the MySQL database driver. +<div class="clear"></div><div class="note">This example uses the MySQL database driver. To use this driver, its containing .jar file (ex. mysql-connector-java-X.X.X-bin.jar) must be copied to the JMeter +<b>./lib</b> directory (see <a href="get-started.html#classpath">JMeter's Classpath</a> +for more details).</div><div class="clear"></div> -<b> -./lib -</b> - directory (see -<a href="get-started.html#classpath"> -JMeter's Classpath -</a> - -for more details). -</td></tr> -</table> -</p> -</blockquote> -</p> -</td></tr> -<tr><td><br></td></tr> -</table> -<table border="0" cellspacing="0" cellpadding="2" width="100%"> -<tr><td bgcolor="#525D76"> -<font color="#ffffff" face="arial,helvetica,sanserif"> -<a name="adding_users"><strong>7.1 Adding Users</strong></a><a class="sectionlink" href="#adding_users" title="Link to here">¶</a></font> -</td></tr> -<tr><td> -<blockquote> -<p> -The first step you want to do with every JMeter Test Plan is to add a - -<a href="test_plan.html#thread_group"> -Thread Group -</a> - element. The Thread Group +</div><div class="section"><h1 id="adding_users">7.1 Adding Users<a class="sectionlink" href="#adding_users" title="Link to here">¶</a></h1> +<p>The first step you want to do with every JMeter Test Plan is to add a +<a href="test_plan.html#thread_group">Thread Group</a> element. The Thread Group tells JMeter the number of users you want to simulate, how often the users should -send requests, and the how many requests they should send. -</p> -<p> -Go ahead and add the ThreadGroup element by first selecting the Test Plan, +send requests, and the how many requests they should send.</p> + +<p>Go ahead and add the ThreadGroup element by first selecting the Test Plan, clicking your right mouse button to get the Add menu, and then select +<b>Add</b> --> <b>ThreadGroup</b>.</p> -<b> -Add -</b> - --> -<b> -ThreadGroup -</b> -. -</p> -<p> -You should now see the Thread Group element under Test Plan. If you do not +<p>You should now see the Thread Group element under Test Plan. If you do not see the element, then "expand" the Test Plan tree by clicking on the -Test Plan element. -</p> -<p> -Next, you need to modify the default properties. Select the Thread Group element +Test Plan element.</p> + +<p>Next, you need to modify the default properties. Select the Thread Group element in the tree, if you have not already selected it. You should now see the Thread Group Control Panel in the right section of the JMeter window (see Figure 7.1 -below) -</p> -<p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/jdbctest/threadgroup1.png"/><br> -<font size="-1"> -Figure 7.1. Thread Group with Default Values -</font></td></tr></table></p> -<p> -Start by providing a more descriptive name for our Thread Group. In the name -field, enter JDBC Users. -</p> -<p> -<table border="1" bgcolor="#bbbb00" width="50%" cellspacing="0" cellpadding="2"> -<tr><td>You will need a valid database, database table, and user-level access to that +below)</p> + +<figure><a href="../images/screenshots/jdbctest/threadgroup1.png"><img src="../images/screenshots/jdbctest/threadgroup1.png" width="" height="" alt=" +Figure 7.1. Thread Group with Default Values"></a><figcaption> +Figure 7.1. Thread Group with Default Values</figcaption></figure> + +<p>Start by providing a more descriptive name for our Thread Group. In the name +field, enter JDBC Users.</p> + +<div class="clear"></div><div class="note">You will need a valid database, database table, and user-level access to that table. In the example shown here, the database is 'cloud' and the table name is -'vm_instance'. -</td></tr> -</table> -</p> -<p> -Next, increase the number of users to 50. -</p> -<p> -In the next field, the Ramp-Up Period, leave the the value of 10 +'vm_instance'.</div><div class="clear"></div> + +<p>Next, increase the number of users to 50.</p> + +<p>In the next field, the Ramp-Up Period, leave the the value of 10 seconds. This property tells JMeter how long to delay between starting each user. For example, if you enter a Ramp-Up Period of 10 seconds, JMeter will finish starting all of your users by the end of the 10 seconds. So, if we have 50 users and a 10 second Ramp-Up Period, then the delay between starting users would be 200 milliseconds (10 seconds / 50 users = 0.2 user per second). If you set the -value to 0, then JMeter will immediately start all of your users. -</p> -<p> -Finally, enter a value of 100 in +value to 0, then JMeter will immediately start all of your users.</p> + +<p>Finally, enter a value of 100 in the Loop Count field. This property tells JMeter how many times to repeat your test. To have JMeter repeatedly run your Test Plan, select the Forever -checkbox. -</p> -<p> -<table border="1" bgcolor="#bbbb00" width="50%" cellspacing="0" cellpadding="2"> -<tr><td>In most applications, you have to manually accept +checkbox.</p> + +<div class="clear"></div><div class="note">In most applications, you have to manually accept changes you make in a Control Panel. However, in JMeter, the Control Panel automatically accepts your changes as you make them. If you change the name of an element, the tree will be updated with the new text after you -leave the Control Panel (for example, when selecting another tree element). -</td></tr> -</table> -</p> -<p> -See Figure 7.2 for the completed JDBC Users Thread Group. -</p> -<p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/jdbctest/threadgroup2.png"/><br> -<font size="-1"> -Figure 7.2. JDBC Users Thread Group -</font></td></tr></table></p> -</blockquote> -</p> -</td></tr> -<tr><td><br></td></tr> -</table> -<table border="0" cellspacing="0" cellpadding="2" width="100%"> -<tr><td bgcolor="#525D76"> -<font color="#ffffff" face="arial,helvetica,sanserif"> -<a name="adding_requests"><strong>7.2 Adding JDBC Requests</strong></a><a class="sectionlink" href="#adding_requests" title="Link to here">¶</a></font> -</td></tr> -<tr><td> -<blockquote> -<p> -Now that we have defined our users, it is time to define the tasks that they -will be performing. In this section, you will specify the JDBC requests to -perform. -</p> -<p> -Begin by selecting the JDBC Users element. Click your right mouse button -to get the w -<b> -Add -</b> - menu, and then select -<b> -Add -</b> - --> -<b> -Config Element -</b> - --> -<b> -JDBC Connection Configuration -</b> -. -Then, select this new element to view its Control Panel (see Figure 7.3). -</p> -<p> -Set up the following fields (these assume we will be using a MySQL database called 'cloud'): -</p> -<ul> - - -<li> -Variable name (here: myDatabase) bound to pool. This needs to uniquely identify the configuration. It is used by the JDBC Sampler to identify the configuration to be used. -</li> - - -<li> -Database URL: jdbc:mysql://ipOfTheServer:3306/cloud -</li> +leave the Control Panel (for example, when selecting another tree element).</div><div class="clear"></div> +<p>See Figure 7.2 for the completed JDBC Users Thread Group.</p> -<li> -JDBC Driver class: com.mysql.jdbc.Driver -</li> - - -<li> -Username: the username of database -</li> - - -<li> -Password: password for the username -</li> +<figure><a href="../images/screenshots/jdbctest/threadgroup2.png"><img src="../images/screenshots/jdbctest/threadgroup2.png" width="" height="" alt=" +Figure 7.2. JDBC Users Thread Group"></a><figcaption> +Figure 7.2. JDBC Users Thread Group</figcaption></figure> +</div><div class="section"><h1 id="adding_requests">7.2 Adding JDBC Requests<a class="sectionlink" href="#adding_requests" title="Link to here">¶</a></h1> +<p>Now that we have defined our users, it is time to define the tasks that they +will be performing. In this section, you will specify the JDBC requests to +perform.</p> +<p>Begin by selecting the JDBC Users element. Click your right mouse button +to get the w<b>Add</b> menu, and then select <b>Add</b> --> <b>Config Element</b> --> <b>JDBC Connection Configuration</b>. +Then, select this new element to view its Control Panel (see Figure 7.3).</p> + +<p>Set up the following fields (these assume we will be using a MySQL database called 'cloud'):</p> +<ul> +<li>Variable name (here: myDatabase) bound to pool. This needs to uniquely identify the configuration. It is used by the JDBC Sampler to identify the configuration to be used.</li> +<li>Database URL: jdbc:mysql://ipOfTheServer:3306/cloud</li> +<li>JDBC Driver class: com.mysql.jdbc.Driver</li> +<li>Username: the username of database</li> +<li>Password: password for the username</li> </ul> -<p> -The other fields on the screen can be left as the defaults. -</p> -<p> -JMeter creates a database connection pool with the configuration settings as specified in the Control Panel. +<p>The other fields on the screen can be left as the defaults.</p> +<p>JMeter creates a database connection pool with the configuration settings as specified in the Control Panel. The pool is referred to in JDBC Requests in the 'Variable Name' field. Several different JDBC Configuration elements can be used, but they must have unique names. Every JDBC Request must refer to a JDBC Configuration pool. More than one JDBC Request can refer to the same pool. - </p> -<p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/jdbctest/jdbc-config.png"/><br> -<font size="-1"> -Figure 7.3. JDBC Configuration -</font></td></tr></table></p> -<p> -Selecting the JDBC Users element again. Click your right mouse button -to get the -<b> -Add -</b> - menu, and then select -<b> -Add -</b> - --> -<b> -Sampler -</b> - --> -<b> -JDBC Request -</b> -. -Then, select this new element to view its Control Panel (see Figure 7.4). -</p> -<p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/jdbctest/JDBCRequest.png"/><br> -<font size="-1"> -Figure 7.4. JDBC Request -</font></td></tr></table></p> -<p> -In our Test Plan, we will make two JDBC requests. The first one is for +<figure><a href="../images/screenshots/jdbctest/jdbc-config.png"><img src="../images/screenshots/jdbctest/jdbc-config.png" width="" height="" alt=" +Figure 7.3. JDBC Configuration"></a><figcaption> +Figure 7.3. JDBC Configuration</figcaption></figure> + +<p>Selecting the JDBC Users element again. Click your right mouse button +to get the <b>Add</b> menu, and then select <b>Add</b> --> <b>Sampler</b> --> <b>JDBC Request</b>. +Then, select this new element to view its Control Panel (see Figure 7.4).</p> + +<figure><a href="../images/screenshots/jdbctest/JDBCRequest.png"><img src="../images/screenshots/jdbctest/JDBCRequest.png" width="" height="" alt=" +Figure 7.4. JDBC Request"></a><figcaption> +Figure 7.4. JDBC Request</figcaption></figure> + +<p>In our Test Plan, we will make two JDBC requests. The first one is for select all 'Running' VM instances, and the second is to select 'Expunging' VM instance (obviously you should change these to examples appropriate for your particular database). These -are illustrated below. -</p> -<p> -<table border="1" bgcolor="#bbbb00" width="50%" cellspacing="0" cellpadding="2"> -<tr><td>JMeter sends requests in the order that you add them to the tree. -</td></tr> -</table> -</p> -<p> -Start by editing the following properties (see Figure 7.5): - -<ul> - - -<li> -Change the Name to 'VM Running'. -</li> - - -<li> -Enter the Pool Name: 'myDatabase' (same as in the configuration element) -</li> - - -<li> -Enter the SQL Query String field. -</li> - - -<li> -Enter the Parameter values field with 'Running' value. -</li> - - -<li> -Enter the Parameter types with 'VARCHAR'. -</li> +are illustrated below.</p> +<div class="clear"></div><div class="note">JMeter sends requests in the order that you add them to the tree.</div><div class="clear"></div> +<p>Start by editing the following properties (see Figure 7.5): +<ul> +<li>Change the Name to 'VM Running'.</li> +<li>Enter the Pool Name: 'myDatabase' (same as in the configuration element)</li> +<li>Enter the SQL Query String field.</li> +<li>Enter the Parameter values field with 'Running' value.</li> +<li>Enter the Parameter types with 'VARCHAR'.</li> </ul> +</p> +<figure><a href="../images/screenshots/jdbctest/JDBCRequest2.png"><img src="../images/screenshots/jdbctest/JDBCRequest2.png" width="" height="" alt=" +Figure 7.5. JDBC Request for the first SQL request"></a><figcaption> +Figure 7.5. JDBC Request for the first SQL request</figcaption></figure> -</p> -<p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/jdbctest/JDBCRequest2.png"/><br> -<font size="-1"> -Figure 7.5. JDBC Request for the first SQL request -</font></td></tr></table></p> -<p> -Next, add the second JDBC Request and edit the following properties (see +<p>Next, add the second JDBC Request and edit the following properties (see Figure 7.6): - <ul> - - -<li> -Change the Name to 'VM Expunging'. -</li> - - -<li> -Change the value of Parameter values to 'Expunging'. -</li> - - +<li>Change the Name to 'VM Expunging'.</li> +<li>Change the value of Parameter values to 'Expunging'.</li> </ul> - - </p> -<p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/jdbctest/JDBCRequest3.png"/><br> -<font size="-1"> -Figure 7.6. JDBC Request for the second request -</font></td></tr></table></p> -</blockquote> -</p> -</td></tr> -<tr><td><br></td></tr> -</table> -<table border="0" cellspacing="0" cellpadding="2" width="100%"> -<tr><td bgcolor="#525D76"> -<font color="#ffffff" face="arial,helvetica,sanserif"> -<a name="adding_listener"><strong>7.3 Adding a Listener to View/Store the Test Results</strong></a><a class="sectionlink" href="#adding_listener" title="Link to here">¶</a></font> -</td></tr> -<tr><td> -<blockquote> -<p> -The final element you need to add to your Test Plan is a - -<a href="component_reference.html#listeners"> -Listener -</a> -. This element is -responsible for storing all of the results of your JDBC requests in a file -and presenting the results. -</p> -<p> -Select the -<i> -JDBC Users -</i> - element and add a -<a href="../usermanual/component_reference.html#Summary_Report">Summary Report</a> - -listener ( -<b> -Add -</b> - --> -<b> -Listener -</b> - --> -<b> -Summary Report -</b> -). -</p> -<p> -Save the test plan, and run the test with the menu -<b> -Run -</b> - --> -<b> -Start -</b> - or -<b> -Ctrl+R -</b> -</p> -<p> -The listener shows the results. -</p> -<p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/jdbctest/jdbc-results.png"/><br> -<font size="-1"> -Figure 7.7. Graph results Listener -</font></td></tr></table></p> -</blockquote> -</p> -</td></tr> -<tr><td><br></td></tr> -</table> -<br> -<table> -<tr> -<td bgcolor="#525D76"> -<div align="right"><a href="index.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Index</font></a></div> -</td> -<td bgcolor="#525D76"> -<div align="right"><a href="build-ftp-test-plan.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Next</font></a></div> -</td> -<td bgcolor="#525D76"> -<div align="right"><a href="build-adv-web-test-plan.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Prev</font></a></div> -</td> -</tr> -</table> -</td> -</tr> -<tr><td colspan="2"> -<hr noshade size="1"/> -</td></tr> -<tr><td colspan="2"> -<div align="center"><font color="#525D76" size="-1"><em> -Copyright © 1999-2015, Apache Software Foundation -</em></font></div> -</td></tr> -<tr><td colspan="2"> -<div align="center"><font color="#525D76" size="-1"> -Apache, Apache JMeter, JMeter, the Apache feather, and the Apache JMeter logo are -trademarks of the Apache Software Foundation. -</font> -</div> -</td></tr> -</table> -</body> -</html> -<!-- end the processing --> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - +<figure><a href="../images/screenshots/jdbctest/JDBCRequest3.png"><img src="../images/screenshots/jdbctest/JDBCRequest3.png" width="" height="" alt=" +Figure 7.6. JDBC Request for the second request"></a><figcaption> +Figure 7.6. JDBC Request for the second request</figcaption></figure> +</div><div class="section"><h1 id="adding_listener">7.3 Adding a Listener to View/Store the Test Results<a class="sectionlink" href="#adding_listener" title="Link to here">¶</a></h1> +<p>The final element you need to add to your Test Plan is a +<a href="component_reference.html#listeners">Listener</a>. This element is +responsible for storing all of the results of your JDBC requests in a file +and presenting the results.</p> +<p>Select the <i>JDBC Users</i> element and add a <a href="../usermanual/component_reference.html#Summary_Report">Summary Report</a> +listener (<b>Add</b> --> <b>Listener</b> --> <b>Summary Report</b>).</p> +<p>Save the test plan, and run the test with the menu <b>Run</b> --> <b>Start</b> or <b>Ctrl+R</b></p> +<p>The listener shows the results.</p> +<figure><a href="../images/screenshots/jdbctest/jdbc-results.png"><img src="../images/screenshots/jdbctest/jdbc-results.png" width="" height="" alt=" +Figure 7.7. Graph results Listener"></a><figcaption> +Figure 7.7. Graph results Listener</figcaption></figure> + +</div><ul class="pagelinks"><li><a href="build-adv-web-test-plan.html">< Prev</a></li><li><a href="../index.html">Index</a></li><li><a href="build-ftp-test-plan.html">Next ></a></li></ul></div><div class="footer"><div class="copyright"> + Copyright © + 1999 – + 2015 + , Apache Software Foundation + </div><div class="trademarks">Apache, Apache JMeter, JMeter, the Apache + feather, and the Apache JMeter logo are + trademarks of the + Apache Software Foundation. + </div></div></body></html> \ No newline at end of file Modified: jmeter/trunk/docs/usermanual/build-ftp-test-plan.html URL: http://svn.apache.org/viewvc/jmeter/trunk/docs/usermanual/build-ftp-test-plan.html?rev=1664961&r1=1664960&r2=1664961&view=diff ============================================================================== --- jmeter/trunk/docs/usermanual/build-ftp-test-plan.html (original) +++ jmeter/trunk/docs/usermanual/build-ftp-test-plan.html Sun Mar 8 10:22:58 2015 @@ -1,716 +1,194 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd";> -<!-- - Licensed to the Apache Software Foundation (ASF) under one or more - contributor license agreements. See the NOTICE file distributed with - this work for additional information regarding copyright ownership. - The ASF licenses this file to You under the Apache License, Version 2.0 - (the "License"); you may not use this file except in compliance with - the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, software - distributed under the License is distributed on an "AS IS" BASIS, - WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - See the License for the specific language governing permissions and - limitations under the License. ---> - -<!-- Content Stylesheet for Site --> - - -<!-- start the processing --> -<html> -<head> -<link rel="stylesheet" type="text/css" href="../css/style.css"/> -<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/> - -<title>Apache JMeter - User's Manual: Building an FTP Test Plan</title> -</head> - -<body bgcolor="#ffffff" text="#000000" link="#525D76"> -<table width="100%" cellspacing="0" border="0"> -<tr> -<td width="90%" align="left"> -<table border="0" cellspacing="0"> -<tr> -<td width="10%"> -<a href="http://www.apache.org";><img title="Apache Software Foundation" width="290" height="75" src="../images/asf-logo.png" border="0"/></a> -</td> -<td align="left" width="40%"> - -<a href="http://jmeter.apache.org/";><img width="182" height="88" src="../images/logo.jpg" alt="Apache JMeter" title="Apache JMeter" border="0"/></a> -</td> -</tr> -</table> -</td> -<td align="left" width="50%"> -<table cellspacing="0" align="right" border="0"> -<tr> -<td align="left"> <a href="https://twitter.com/share"; -class="twitter-share-button" -data-text="Powerful Load Testing with -Apache #JMeter" data-via="ApacheJMeter" -data-lang="en-gb" data-size="large">Tweet</a> -<script>!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0],p=/^http:/.test(d.location)?'http':'https';if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src=p+'://platform.twitter.com/widgets.js';fjs.parentNode.insertBefore(js,fjs);}}(document, 'script', 'twitter-wjs');</script> -</td> -<td align="right"> <a -href="https://twitter.com/ApacheJMeter"; -class="twitter-follow-button" -data-show-count="false" data-lang="en-gb" -data-size="large">Follow</a> -<script>!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0],p=/^http:/.test(d.location)?'http':'https';if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src=p+'://platform.twitter.com/widgets.js';fjs.parentNode.insertBefore(js,fjs);}}(document, 'script', 'twitter-wjs');</script> -</td> -</tr> -</table> -</td></tr> -</table> - -<table border="0" width="100%" cellspacing="4"> -<tr><td colspan="2"> -<hr noshade size="1"/> -</td></tr> -<tr> -<!-- LEFT SIDE NAVIGATION --> -<td width="20%" valign="top" nowrap="true"> -<table border="0" width="100%" cellspacing="0"> -<tr><td> -<p><strong>About</strong></p> -<ul> -<li><a href="../index.html">Overview</a> -</li> -<li><a href="http://twitter.com/ApacheJMeter";>JMeter on Twitter</a> -<img src="../images/twitter.png" align="top"/></li> -<li><a href="../issues.html">Issue Tracking</a> -</li> -<li><a href="http://projects.apache.org/feeds/rss/jmeter.xml";>Subscribe to What's New</a> -</li> -<li><a href="http://www.apache.org/licenses/";>License</a> -</li> -</ul> -<p><strong>Download</strong></p> -<ul> -<li><a href="../download_jmeter.cgi">Download Releases</a> -</li> -<li><a href="../nightly.html">Developer (Nightly) Builds</a> -</li> -</ul> -<p><strong>Documentation</strong></p> -<ul> -<li><a href="../changes.html">Changes per version</a> -</li> -<li><a href="../usermanual/get-started.html">Get Started</a> -</li> -<li><a href="../usermanual/index.html">User Manual</a> -</li> -<li><a href="../usermanual/best-practices.html">Best Practices</a> -</li> -<li><a href="../usermanual/component_reference.html">Component Reference</a> -</li> -<li><a href="../usermanual/functions.html">Functions Reference</a> -</li> -<li><a href="../api/index.html">Javadocs</a> -</li> -<li><a href="../building.html">Building JMeter and Add-Ons</a> -</li> -<li><a href="http://wiki.apache.org/jmeter";>JMeter Wiki</a> -</li> -<li><a href="http://wiki.apache.org/jmeter/JMeterFAQ";>FAQ (Wiki)</a> -</li> -</ul> -<p><strong>Tutorials (PDF format)</strong></p> -<ul> -<li><a href="../usermanual/jmeter_distributed_testing_step_by_step.pdf">Distributed Testing</a> -</li> -<li><a href="../usermanual/jmeter_proxy_step_by_step.pdf">Recording Tests</a> -</li> -<li><a href="../usermanual/junitsampler_tutorial.pdf">JUnit Sampler</a> -</li> -<li><a href="../usermanual/jmeter_accesslog_sampler_step_by_step.pdf">Access Log Sampler</a> -</li> -<li><a href="../extending/jmeter_tutorial.pdf">Extending JMeter</a> -</li> -</ul> -<p><strong>Community</strong></p> -<ul> -<li><a href="http://wiki.apache.org/jmeter/JMeterCommitters";>Contributors</a> -</li> -<li><a href="../mail.html">Mailing Lists</a> -</li> -<li><a href="../svnindex.html">SVN Repositories</a> -</li> -</ul> -<p><strong>Foundation</strong></p> -<ul> -<li><a href="http://www.apache.org/";>ASF</a> -</li> -<li><a href="http://www.apache.org/foundation/getinvolved.html";>Get Involved in the ASF</a> -</li> -<li><a href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a> -</li> -<li><a href="http://www.apache.org/foundation/thanks.html";>Thanks</a> -</li> -</ul> -</td></tr> -<tr><td> -<iframe src="http://www.apache.org/ads/button.html"; style="border-width:0; float: left;" frameborder="0" scrolling="no"></iframe> -</td></tr> -</table> -</td> -<td width="80%" align="left" valign="top"> -<table> -<tr> -<td bgcolor="#525D76"> -<div align="right"><a href="index.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Index</font></a></div> -</td> -<td bgcolor="#525D76"> -<div align="right"><a href="build-ldap-test-plan.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Next</font></a></div> -</td> -<td bgcolor="#525D76"> -<div align="right"><a href="build-db-test-plan.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Prev</font></a></div> -</td> -</tr> -</table> -<br> -<table border="0" cellspacing="0" cellpadding="2" width="100%"> -<tr><td bgcolor="#525D76"> -<font color="#ffffff" face="arial,helvetica,sanserif"> -<a name="building"><strong>8. Building an FTP Test Plan</strong></a><a class="sectionlink" href="#building" title="Link to here">¶</a></font> -</td></tr> -<tr><td> -<blockquote> -<p> -In this section, you will learn how to create a basic - -<a href="build-test-plan.html"> -Test Plan -</a> - to test an FTP site. You will +<!DOCTYPE html SYSTEM "about:legacy-compat"> +<html lang="en"><head><META http-equiv="Content-Type" content="text/html; charset=iso-8859-15"><title>Apache JMeter + - + User's Manual: Building an FTP Test Plan</title><meta name="viewport" content="width=device-width, initial-scale=1"><link href="http://fonts.googleapis.com/css?family=Merriweather:400normal"; rel="stylesheet" type="text/css"><link rel="stylesheet" type="text/css" href="../css/new-style.css"></head><body role="document"><a href="#content" class="hidden">Main content</a><div class="header"><!-- + APACHE LOGO + --><div><a href="http://www.apache.org";><img title="Apache Software Foundation" width="290" height="75" src="../images/asf-logo.png" alt="Logo ASF"></a></div><!-- + PROJECT LOGO + --><div><a href="http://jmeter.apache.org/";><img src="../images/logo.jpg" alt="Apache JMeter"></a></div><div class="twitter"><div><a href="https://twitter.com/share"; class="twitter-share-button" data-text="Powerful Load Testing with Apache #JMeter" data-via="ApacheJMeter" data-lang="en-gb" data-size="large">Tweet</a><script> + (function(d,s,id){ + var js, + fjs=d.getElementsByTagName(s)[0], + p=/^http:/.test(d.location)?'http':'https'; + if (!d.getElementById(id)) { + js=d.createElement(s); + js.id=id; + js.src=p+'://platform.twitter.com/widgets.js'; + fjs.parentNode.insertBefore(js,fjs); + } + })(document, 'script', 'twitter-wjs'); + </script></div><div><a href="https://twitter.com/ApacheJMeter"; class="twitter-follow-button" data-show-count="false" data-lang="en-gb" data-size="large">Follow</a><script>(function(d,s,id){ + var js, + fjs=d.getElementsByTagName(s)[0], + p=/^http:/.test(d.location)?'http':'https'; + if (!d.getElementById(id)) { + js=d.createElement(s); + js.id=id; + js.src=p+'://platform.twitter.com/widgets.js'; + fjs.parentNode.insertBefore(js,fjs); + } + })(document, 'script', 'twitter-wjs'); + </script></div></div><div class="banner"><iframe src="http://www.apache.org/ads/bannerbar.html"; style="border-width:0;" frameborder="0" scrolling="no"></iframe><div class="clear"></div></div></div><div class="nav"><ul class="menu"><li><div class="menu-title">About</div><ul><li><a href="../index.html">Overview</a></li><li><a href="http://twitter.com/ApacheJMeter";>JMeter on Twitter<img src="../images/twitter.png" alt="Icon for JMeter on Twitter"></a></li><li><a href="../issues.html">Issue Tracking</a></li><li><a href="http://projects.apache.org/feeds/rss/jmeter.xml";>Subscribe to What's New</a></li><li><a href="http://www.apache.org/licenses/";>License</a></li></ul></li></ul><ul class="menu"><li><div class="menu-title">Download</div><ul><li><a href="../download_jmeter.cgi">Download Releases</a></li><li><a href="../nightly.html">Developer (Nightly) Builds</a></li></ul></li></ul><ul class="menu"><li><div class="menu-title">Documentation</div><ul><li><a href="../changes.html" >Changes per version</a></li><li><a href="../usermanual/get-started.html">Get >Started</a></li><li><a href="../usermanual/index.html">User >Manual</a></li><li><a href="../usermanual/best-practices.html">Best >Practices</a></li><li><a >href="../usermanual/component_reference.html">Component >Reference</a></li><li><a href="../usermanual/functions.html">Functions >Reference</a></li><li><a href="../api/index.html">Javadocs</a></li><li><a >href="../building.html">Building JMeter and Add-Ons</a></li><li><a >href="http://wiki.apache.org/jmeter";>JMeter Wiki</a></li><li><a >href="http://wiki.apache.org/jmeter/JMeterFAQ";>FAQ >(Wiki)</a></li></ul></li></ul><ul class="menu"><li><div >class="menu-title">Tutorials (PDF format)</div><ul><li><a >href="../usermanual/jmeter_distributed_testing_step_by_step.pdf">Distributed >Testing</a></li><li><a >href="../usermanual/jmeter_proxy_step_by_step.pdf">Recording >Tests</a></li><li><a href="../usermanual/junitsampler_tutorial.pdf">JUnit >Sampler</a></li><li><a href="../us ermanual/jmeter_accesslog_sampler_step_by_step.pdf">Access Log Sampler</a></li><li><a href="../extending/jmeter_tutorial.pdf">Extending JMeter</a></li></ul></li></ul><ul class="menu"><li><div class="menu-title">Community</div><ul><li><a href="http://wiki.apache.org/jmeter/JMeterCommitters";>Contributors</a></li><li><a href="../mail.html">Mailing Lists</a></li><li><a href="../svnindex.html">SVN Repositories</a></li></ul></li></ul><ul class="menu"><li><div class="menu-title">Foundation</div><ul><li><a href="http://www.apache.org/";>ASF</a></li><li><a href="http://www.apache.org/foundation/getinvolved.html";>Get Involved in the ASF</a></li><li><a href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a></li><li><a href="http://www.apache.org/foundation/thanks.html";>Thanks</a></li></ul></li></ul></div><div class="main" id="content"><ul class="pagelinks"><li><a href="build-db-test-plan.html">< Prev</a></li><li><a href="../index.html">Index</a></li><li><a href="build-ldap-t est-plan.html">Next ></a></li></ul><div class="section"><h1 id="building">8. Building an FTP Test Plan<a class="sectionlink" href="#building" title="Link to here">¶</a></h1> +<p>In this section, you will learn how to create a basic +<a href="build-test-plan.html">Test Plan</a> to test an FTP site. You will create four users that send requests for two files on a FTP site. Also, you will tell the users to run their tests twice. So, the total number of -requests is (4 users) x (2 requests) x (repeat 2 times) = 16 FTP requests. -</p> -<p> -To construct the Test Plan, you will use the following elements: - -<a href="test_plan.html#thread_group"> -Thread Group -</a> -, - -<a href="../usermanual/component_reference.html#FTP_Request">FTP Request</a> -, - -<a href="../usermanual/component_reference.html#FTP_Request_Defaults">FTP Request Defaults</a> -, and - -<a href="../usermanual/component_reference.html#View_Results_in_Table">View Results in Table</a> -. -</p> -</blockquote> -</p> -</td></tr> -<tr><td><br></td></tr> -</table> -<table border="0" cellspacing="0" cellpadding="2" width="100%"> -<tr><td bgcolor="#525D76"> -<font color="#ffffff" face="arial,helvetica,sanserif"> -<a name="adding_users"><strong>8.1 Adding Users</strong></a><a class="sectionlink" href="#adding_users" title="Link to here">¶</a></font> -</td></tr> -<tr><td> -<blockquote> -<p> -The first step you want to do with every JMeter Test Plan is to add a - -<a href="test_plan.html#thread_group"> -Thread Group -</a> - element. The Thread Group tells +requests is (4 users) x (2 requests) x (repeat 2 times) = 16 FTP requests.</p> +<p>To construct the Test Plan, you will use the following elements: +<a href="test_plan.html#thread_group">Thread Group</a>, +<a href="../usermanual/component_reference.html#FTP_Request">FTP Request</a>, +<a href="../usermanual/component_reference.html#FTP_Request_Defaults">FTP Request Defaults</a>, and +<a href="../usermanual/component_reference.html#View_Results_in_Table">View Results in Table</a>.</p> + +</div><div class="section"><h1 id="adding_users">8.1 Adding Users<a class="sectionlink" href="#adding_users" title="Link to here">¶</a></h1> +<p>The first step you want to do with every JMeter Test Plan is to add a +<a href="test_plan.html#thread_group">Thread Group</a> element. The Thread Group tells JMeter the number of users you want to simulate, how often the users should send -requests, and the how many requests they should send. -</p> -<p> -Go ahead and add the Thread Group element by first selecting the Test Plan, +requests, and the how many requests they should send.</p> + +<p>Go ahead and add the Thread Group element by first selecting the Test Plan, clicking your right mouse button to get the Add menu, and then select +<b>Add</b> --> <b>ThreadGroup.</b></p> -<b> -Add -</b> - --> -<b> -ThreadGroup. -</b> -</p> -<p> -You should now see the -<b> -Thread Group -</b> - element under -<b> -Test Plan. -</b> - If you do not +<p>You should now see the <b>Thread Group</b> element under <b>Test Plan.</b> If you do not see the element, then "expand" the Test Plan tree by clicking on the +<b>Test Plan</b> element.</p> -<b> -Test Plan -</b> - element. -</p> -<p> -Next, you need to modify the default properties. Select the -<b> -Thread Group -</b> - element +<p>Next, you need to modify the default properties. Select the <b>Thread Group</b> element in the tree, if you have not already selected it. You should now see the Thread Group Control Panel in the right section of the JMeter window (see Figure 8.1 -below) -</p> -<p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/webtest/threadgroup.png"/><br> -<font size="-1"> -Figure 8.1. Thread Group with Default Values -</font></td></tr></table></p> -<p> -Start by providing a more descriptive name for our -<b> -Thread Group. -</b> - In the name -field, enter 'FTP Users'. -</p> -<p> -Next, increase the number of users to 4. -</p> -<p> -In the next field, the -<i> -Ramp-Up -</i> - Period, leave the the default value of 0 +below)</p> + +<figure><a href="../images/screenshots/webtest/threadgroup.png"><img src="../images/screenshots/webtest/threadgroup.png" width="" height="" alt=" +Figure 8.1. Thread Group with Default Values"></a><figcaption> +Figure 8.1. Thread Group with Default Values</figcaption></figure> + +<p>Start by providing a more descriptive name for our <b>Thread Group.</b> In the name +field, enter 'FTP Users'.</p> + +<p>Next, increase the number of users to 4.</p> + +<p>In the next field, the <i>Ramp-Up</i> Period, leave the the default value of 0 seconds. This property tells JMeter how long to delay between starting each -user. For example, if you enter a -<i> -Ramp-Up -</i> - Period of 5 seconds, JMeter will +user. For example, if you enter a <i>Ramp-Up</i> Period of 5 seconds, JMeter will finish starting all of your users by the end of the 5 seconds. So, if we have -5 users and a 5 second -<i> -Ramp-Up -</i> - Period, then the delay between starting users +5 users and a 5 second <i>Ramp-Up</i> Period, then the delay between starting users would be 1 second (5 users / 5 seconds = 1 user per second). If you set the -value to 0, then JMeter will immediately start all of your users. -</p> -<p> -Finally, enter a value of 2 in -the -<i> -Loop Count -</i> - field. This property tells JMeter how many times to repeat your -test. To have JMeter repeatedly run your -<b> -Test Plan, -</b> - select the -<i> -Forever -</i> +value to 0, then JMeter will immediately start all of your users.</p> -checkbox. -</p> -<p> -<table border="1" bgcolor="#bbbb00" width="50%" cellspacing="0" cellpadding="2"> -<tr><td>In most applications, you have to manually accept +<p>Finally, enter a value of 2 in +the <i>Loop Count</i> field. This property tells JMeter how many times to repeat your +test. To have JMeter repeatedly run your <b>Test Plan,</b> select the <i>Forever</i> +checkbox.</p> + +<div class="clear"></div><div class="note">In most applications, you have to manually accept changes you make in a Control Panel. However, in JMeter, the Control Panel automatically accepts your changes as you make them. If you change the name of an element, the tree will be updated with the new text after you -leave the Control Panel (for example, when selecting another tree element). -</td></tr> -</table> -</p> -<p> -See Figure 8.2 for the completed FTP Users Thread Group. -</p> -<p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/ftptest/threadgroup2.png"/><br> -<font size="-1"> -Figure 8.2. FTP Users Thread Group -</font></td></tr></table></p> -</blockquote> -</p> -</td></tr> -<tr><td><br></td></tr> -</table> -<table border="0" cellspacing="0" cellpadding="2" width="100%"> -<tr><td bgcolor="#525D76"> -<font color="#ffffff" face="arial,helvetica,sanserif"> -<a name="adding_defaults"><strong>8.2 Adding Default FTP Request Properties</strong></a><a class="sectionlink" href="#adding_defaults" title="Link to here">¶</a></font> -</td></tr> -<tr><td> -<blockquote> -<p> -Now that we have defined our users, it is time define the tasks that they +leave the Control Panel (for example, when selecting another tree element).</div><div class="clear"></div> + +<p>See Figure 8.2 for the completed FTP Users Thread Group.</p> + +<figure><a href="../images/screenshots/ftptest/threadgroup2.png"><img src="../images/screenshots/ftptest/threadgroup2.png" width="" height="" alt=" +Figure 8.2. FTP Users Thread Group"></a><figcaption> +Figure 8.2. FTP Users Thread Group</figcaption></figure> + +</div><div class="section"><h1 id="adding_defaults">8.2 Adding Default FTP Request Properties<a class="sectionlink" href="#adding_defaults" title="Link to here">¶</a></h1> +<p>Now that we have defined our users, it is time define the tasks that they will be performing. In this section, you will specify the default settings -for your FTP requests. And then, in section 8.3, you will add -<b> -FTP Request -</b> +for your FTP requests. And then, in section 8.3, you will add <b>FTP Request</b> +elements which use some of the default settings you specified here.</p> -elements which use some of the default settings you specified here. +<p>Begin by selecting the FTP Users element. Click your right mouse button +to get the Add menu, and then select <b>Add</b> --> <b>Config Element</b> --> <b>FTP Request +Defaults.</b> Then, select this new element to view its Control Panel (see Figure 8.3). </p> -<p> -Begin by selecting the FTP Users element. Click your right mouse button -to get the Add menu, and then select -<b> -Add -</b> - --> -<b> -Config Element -</b> - --> -<b> -FTP Request -Defaults. -</b> - Then, select this new element to view its Control Panel (see Figure 8.3). -</p> -<p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/ftptest/ftp-defaults.png"/><br> -<font size="-1"> -Figure 8.3. FTP Request Defaults -</font></td></tr></table></p> -<p> +<figure><a href="../images/screenshots/ftptest/ftp-defaults.png"><img src="../images/screenshots/ftptest/ftp-defaults.png" width="" height="" alt=" +Figure 8.3. FTP Request Defaults"></a><figcaption> +Figure 8.3. FTP Request Defaults</figcaption></figure> -Like most JMeter elements, the -<a href="../usermanual/component_reference.html#FTP_Request_Defaults">FTP Request Defaults</a> - Control -Panel has a name field that you can modify. In this example, leave this field with -the default value. -</p> <p> -Skip to the next field, which is the FTP Server's Server Name/IP. For the +Like most JMeter elements, the <a href="../usermanual/component_reference.html#FTP_Request_Defaults">FTP Request Defaults</a> Control +Panel has a name field that you can modify. In this example, leave this field with +the default value.</p> + +<p>Skip to the next field, which is the FTP Server's Server Name/IP. For the Test Plan that you are building, all FTP requests will be sent to the same FTP server, ftp.domain.com in this case. Enter this domain name into the field. This is the only field that we will specify a default, so leave the remaining -fields with their default values. -</p> -<p> -<table border="1" bgcolor="#bbbb00" width="50%" cellspacing="0" cellpadding="2"> -<tr><td>The FTP Request Defaults element does not tell JMeter +fields with their default values.</p> + +<div class="clear"></div><div class="note">The FTP Request Defaults element does not tell JMeter to send an FTP request. It simply defines the default values that the -FTP Request elements use. -</td></tr> -</table> -</p> -<p> -See Figure 8.4 for the completed FTP Request Defaults element -</p> -<p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/ftptest/ftp-defaults2.png"/><br> -<font size="-1"> -Figure 8.4. FTP Defaults for our Test Plan -</font></td></tr></table></p> -</blockquote> -</p> -</td></tr> -<tr><td><br></td></tr> -</table> -<table border="0" cellspacing="0" cellpadding="2" width="100%"> -<tr><td bgcolor="#525D76"> -<font color="#ffffff" face="arial,helvetica,sanserif"> -<a name="adding_requests"><strong>8.3 Adding FTP Requests</strong></a><a class="sectionlink" href="#adding_requests" title="Link to here">¶</a></font> -</td></tr> -<tr><td> -<blockquote> -<p> -In our -<b> -Test Plan -</b> -, we need to make two -<b> -FTP requests -</b> -. -</p> -<p> -<table border="1" bgcolor="#bbbb00" width="50%" cellspacing="0" cellpadding="2"> -<tr><td>JMeter sends requests in the order that they appear in the tree. -</td></tr> -</table> -</p> -<p> -Start by adding the first -<a href="../usermanual/component_reference.html#FTP_Request">FTP Request</a> +FTP Request elements use.</div><div class="clear"></div> -to the FTP Users element ( -<b> -Add -</b> - --> -<b> -Sampler -</b> - --> -<b> -FTP Request -</b> -). -Then, select the -<b> -FTP Request -</b> - element in the tree and edit the following properties -(see Figure 8.5): +<p>See Figure 8.4 for the completed FTP Request Defaults element</p> -<ol> +<figure><a href="../images/screenshots/ftptest/ftp-defaults2.png"><img src="../images/screenshots/ftptest/ftp-defaults2.png" width="" height="" alt=" +Figure 8.4. FTP Defaults for our Test Plan"></a><figcaption> +Figure 8.4. FTP Defaults for our Test Plan</figcaption></figure> +</div><div class="section"><h1 id="adding_requests">8.3 Adding FTP Requests<a class="sectionlink" href="#adding_requests" title="Link to here">¶</a></h1> -<li> -Change the -<i> -Name -</i> - to "File1". -</li> - - -<li> -Change the -<i> -Remote File -</i> - field to "/directory/file1.txt". -</li> - - -<li> -Change the -<i> -Username -</i> - field to "anonymous". -</li> - - -<li> -Change the -<i> -Password -</i> - field to "[email protected]". -</li> +<p>In our <b>Test Plan</b>, we need to make two <b>FTP requests</b>.</p> +<div class="clear"></div><div class="note">JMeter sends requests in the order that they appear in the tree.</div><div class="clear"></div> +<p>Start by adding the first <a href="../usermanual/component_reference.html#FTP_Request">FTP Request</a> +to the FTP Users element (<b>Add</b> --> <b>Sampler</b> --> <b>FTP Request</b>). +Then, select the <b>FTP Request</b> element in the tree and edit the following properties +(see Figure 8.5): +<ol> +<li>Change the <i>Name</i> to "File1".</li> +<li>Change the <i>Remote File</i> field to "/directory/file1.txt".</li> +<li>Change the <i>Username</i> field to "anonymous".</li> +<li>Change the <i>Password</i> field to "[email protected]".</li> </ol> - - -</p> -<p> -<table border="1" bgcolor="#bbbb00" width="50%" cellspacing="0" cellpadding="2"> -<tr><td>You do not have to set the -<i> -Server Name -</i> - field because you already specified -this value in the -<b> -FTP Request Defaults -</b> - element. -</td></tr> -</table> </p> -<p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/ftptest/ftp-request.png"/><br> -<font size="-1"> -Figure 8.5. FTP Request for file1 -</font></td></tr></table></p> -<p> -Next, add the second -<b> -FTP Request -</b> - and edit the following properties (see -Figure 8.6: - -<ol> +<div class="clear"></div><div class="note">You do not have to set the <i>Server Name</i> field because you already specified +this value in the <b>FTP Request Defaults</b> element.</div><div class="clear"></div> -<li> -Change the -<i> -Name -</i> - to "File2". -</li> - - -<li> -Change the -<i> -Remote File -</i> - field to "/directory/file2.txt". -</li> - - -<li> -Change the -<i> -Username -</i> - field to "anonymous". -</li> - - -<li> -Change the -<i> -Password -</i> - field to "[email protected]". -</li> - +<figure><a href="../images/screenshots/ftptest/ftp-request.png"><img src="../images/screenshots/ftptest/ftp-request.png" width="" height="" alt=" +Figure 8.5. FTP Request for file1"></a><figcaption> +Figure 8.5. FTP Request for file1</figcaption></figure> +<p>Next, add the second <b>FTP Request</b> and edit the following properties (see +Figure 8.6: +<ol> +<li>Change the <i>Name</i> to "File2".</li> +<li>Change the <i>Remote File</i> field to "/directory/file2.txt".</li> +<li>Change the <i>Username</i> field to "anonymous".</li> +<li>Change the <i>Password</i> field to "[email protected]".</li> </ol> - - -</p> -<p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/ftptest/ftp-request2.png"/><br> -<font size="-1"> -Figure 8.6. FTP Request for file2 -</font></td></tr></table></p> -</blockquote> -</p> -</td></tr> -<tr><td><br></td></tr> -</table> -<table border="0" cellspacing="0" cellpadding="2" width="100%"> -<tr><td bgcolor="#525D76"> -<font color="#ffffff" face="arial,helvetica,sanserif"> -<a name="adding_listener"><strong>8.4 Adding a Listener to View/Store the Test Results</strong></a><a class="sectionlink" href="#adding_listener" title="Link to here">¶</a></font> -</td></tr> -<tr><td> -<blockquote> -<p> -The final element you need to add to your -<b> -Test Plan -</b> - is a - -<a href="component_reference.html#listeners"> -Listener -</a> -. This element is -responsible for storing all of the results of your -<b> -FTP requests -</b> - in a file and presenting -a visual model of the data. </p> -<p> -Select the FTP Users element and add a -<a href="../usermanual/component_reference.html#View_Results_in_Table">View Results in Table</a> - -listener ( -<b> -Add -</b> - --> -<b> -Listener -</b> - --> -<b> -View Results in Table -</b> -). -</p> -<p> -Run your test and view the results. -</p> -<p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/ftptest/ftp-results.png"/><br> -<font size="-1"> -Figure 8.7. View Results in Table Listener -</font></td></tr></table></p> -</blockquote> -</p> -</td></tr> -<tr><td><br></td></tr> -</table> -<br> -<table> -<tr> -<td bgcolor="#525D76"> -<div align="right"><a href="index.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Index</font></a></div> -</td> -<td bgcolor="#525D76"> -<div align="right"><a href="build-ldap-test-plan.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Next</font></a></div> -</td> -<td bgcolor="#525D76"> -<div align="right"><a href="build-db-test-plan.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Prev</font></a></div> -</td> -</tr> -</table> -</td> -</tr> -<tr><td colspan="2"> -<hr noshade size="1"/> -</td></tr> -<tr><td colspan="2"> -<div align="center"><font color="#525D76" size="-1"><em> -Copyright © 1999-2015, Apache Software Foundation -</em></font></div> -</td></tr> -<tr><td colspan="2"> -<div align="center"><font color="#525D76" size="-1"> -Apache, Apache JMeter, JMeter, the Apache feather, and the Apache JMeter logo are -trademarks of the Apache Software Foundation. -</font> -</div> -</td></tr> -</table> -</body> -</html> -<!-- end the processing --> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - +<figure><a href="../images/screenshots/ftptest/ftp-request2.png"><img src="../images/screenshots/ftptest/ftp-request2.png" width="" height="" alt=" +Figure 8.6. FTP Request for file2"></a><figcaption> +Figure 8.6. FTP Request for file2</figcaption></figure> + +</div><div class="section"><h1 id="adding_listener">8.4 Adding a Listener to View/Store the Test Results<a class="sectionlink" href="#adding_listener" title="Link to here">¶</a></h1> +<p>The final element you need to add to your <b>Test Plan</b> is a + <a href="component_reference.html#listeners">Listener</a>. This element is +responsible for storing all of the results of your <b>FTP requests</b> in a file and presenting +a visual model of the data.</p> + +<p>Select the FTP Users element and add a <a href="../usermanual/component_reference.html#View_Results_in_Table">View Results in Table</a> +listener (<b>Add</b> --> <b>Listener</b> --> <b>View Results in Table</b>).</p> +<p>Run your test and view the results.</p> + +<figure><a href="../images/screenshots/ftptest/ftp-results.png"><img src="../images/screenshots/ftptest/ftp-results.png" width="" height="" alt=" +Figure 8.7. View Results in Table Listener"></a><figcaption> +Figure 8.7. View Results in Table Listener</figcaption></figure> + +</div><ul class="pagelinks"><li><a href="build-db-test-plan.html">< Prev</a></li><li><a href="../index.html">Index</a></li><li><a href="build-ldap-test-plan.html">Next ></a></li></ul></div><div class="footer"><div class="copyright"> + Copyright © + 1999 – + 2015 + , Apache Software Foundation + </div><div class="trademarks">Apache, Apache JMeter, JMeter, the Apache + feather, and the Apache JMeter logo are + trademarks of the + Apache Software Foundation. + </div></div></body></html> \ No newline at end of file
