You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@jmeter.apache.org by mi...@apache.org on 2017/04/01 14:01:03 UTC
svn commit: r1789801 [9/12] - in /jmeter/trunk: build/ docs/
docs/images/screenshots/ docs/images/screenshots/changes/3.2/
docs/images/screenshots/http-config/ docs/images/screenshots/jms/
docs/localising/ docs/usermanual/ src/core/org/apache/jmeter/ut...
Added: jmeter/trunk/docs/usermanual/include_controller_tutorial.html
URL: http://svn.apache.org/viewvc/jmeter/trunk/docs/usermanual/include_controller_tutorial.html?rev=1789801&view=auto
==============================================================================
--- jmeter/trunk/docs/usermanual/include_controller_tutorial.html (added)
+++ jmeter/trunk/docs/usermanual/include_controller_tutorial.html Sat Apr 1 14:01:02 2017
@@ -0,0 +1,95 @@
+<!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
+ -
+ Include Controller Tutorial</title><meta name="author" value="JMeter developers"><meta name="email" value="dev@jmeter.apache.org"><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 href="https://maxcdn.bootstrapcdn.com/font-awesome/4.6.1/css/font-awesome.min.css" rel="stylesheet" type="text/css"><link rel="stylesheet" type="text/css" href="../css/new-style.css"><link rel="apple-touch-icon-precomposed" href="../images/apple-touch-icon.png"><link rel="icon" href="../images/favicon.png"><meta name="msapplication-TileColor" content="#ffffff"><meta name="msapplication-TileImage" content="../images/mstile-144x144.png"><meta name="theme-color" content="#ffffff"></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" class="asf-logo logo" src="../images/asf-logo.svg" alt="Logo ASF"></a></div><!--
+ PROJECT LOGO
+ --><div><a href="http://jmeter.apache.org/"><img class="logo" src="../images/logo.svg" alt="Apache JMeter"></a></div><div class="banner"><a href="http://www.apache.org/events/current-event.html"><img src="http://www.apache.org/events/current-event-234x60.png" alt="Current Apache event teaser"></a><div class="clear"></div></div></div><div class="nav"><ul class="menu"><li onClick="return true"><div class="menu-title">About</div><ul><li><a href="../index.html">Overview</a></li><li><a href="http://www.apache.org/licenses/">License</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><div class="menu-title">Download</div><ul><li><a href="../download_jmeter.cgi">Download Releases</a></li><li><a href="../changes.html">Release Notes</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><div class="menu-title">Documentation</div><ul><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="../usermanual/properties_reference.html">Properties Reference</a></li><li><a href="../changes_history.html">Change History</a></li><li><a href="../api/index.html">Javadocs</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 onClick="return true"><div class="menu-title">Tutorials</div><ul><li><a href="../usermanual/jmeter_distributed_testing_step_by_step.html">Distributed Testing</a></li><li><a href="../usermanual/jmeter_proxy_step_by_step.html">Recording Tests</a></li><li><a href="../usermanual/junitsampler_tutorial.html">JUnit Sampler</a></li><li><a href="../usermanual/jmeter_accesslog_sampler_step_by_step.html">Access Log
Sampler</a></li><li><a href="../usermanual/jmeter_tutorial.html">Extending JMeter</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><div class="menu-title">Community</div><ul><li><a href="../issues.html">Issue Tracking</a></li><li><a href="../mail.html">Mailing Lists</a></li><li><a href="../svnindex.html">Source Repositories</a></li><li><a href="../building.html">Building and Contributing</a></li><li><a href="https://projects.apache.org/project.html?jmeter">Project info at Apache</a></li><li><a href="http://wiki.apache.org/jmeter/JMeterCommitters">Contributors</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><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"><div class="social-media"><ul class="social-media-links"><li class="twitter"><a href="https://twitter.com/ApacheJMeter" title="Follow us on Twitter"><i class="fa fa-twitter" aria-hidden="true"></i>Twitter</a></li><li class="github"><a href="https://github.com/apache/jmeter" title="Fork us on github"><i class="fa fa-github" aria-hidden="true"></i>github</a></li></ul></div><ul class="pagelinks"><li><a href="best-practices.html">< Prev</a></li><li><a href="../index.html">Index</a></li><li><a href="component_reference.html">Next ></a></li></ul><div class="section"><h1 id="include">42. Include Controller Tutorial<a class="sectionlink" href="#include" title="Link to here">¶</a></h1>
+<p>
+This is a short tutorial explaining the basics of the Include Controller. The Include Controller
+provides an easy way to include modules in a test plan. It is different than the Module Controller
+in a couple of ways.
+</p>
+
+<ul>
+<li>the Include Controller loads a simple controller with all it's samples, where as the Module
+ Controller can use any controller</li>
+<li>the Include Controller doesn't use the workbench</li>
+<li>the Module Controller doesn't load from a file</li>
+<li>the Include Controller loads the module at runtime and doesn't display the contents of the
+ Simple Controller</li>
+</ul>
+
+<p>
+There are a couple of reasons why one might want to use the include controller.
+</p>
+
+<ul>
+ <li>Break a test plan into reusable modules</li>
+ <li>Reduce the cost of maintaining test plans</li>
+ <li>Reduce duplication of common process</li>
+</ul>
+
+<p>
+For example, say you need to test an application that requires login. If each test plan had the login requests,
+a change in the login process would require updating all test plans. By making the login a module, all other
+test plans can reuse it. When the login process changes, the change is made to the module and all other test
+plans get the change. One limitation of the current implementation is the contents of the module are only
+loaded at runtime, so users can't view or edit the contents of an included module.
+</p>
+
+<figure><a href="../images/screenshots/includecontroller.png"><img src="../images/screenshots/includecontroller.png" width="417" height="130" alt="Include Controller"></a><figcaption>Include Controller</figcaption></figure>
+
+<p>
+The Include Controller has two properties. The <span class="code">name</span> and the <span class="code">filename</span>. The <span class="code">name</span>
+is the descriptive name for the controller in the test plan. The <span class="code">filename</span> is the name of the <span class="code">.jmx</span> file.
+</p>
+
+<div class="subsection"><h2 id="step-by-step">42.1 Step-by-step<a class="sectionlink" href="#step-by-step" title="Link to here">¶</a></h2>
+
+<ol>
+ <li>Start JMeter</li>
+ <li>Select the workbench</li>
+ <li><span class="menuchoice"><span class="guimenuitem">Add</span> → <span class="guimenuitem">Logic Controller</span> → <span class="guimenuitem">Simple Controller</span></span>
+ </li>
+ <li>Enter <span class="code">module1</span> in the name</li>
+ <li>Now add one or more samples to the controller</li>
+ <li>Once the samples are added, right click on <span class="code">module1</span></li>
+ <li>Select <span class="code">save as</span> and save it as <span class="code">module1.jmx</span></li>
+</ol>
+
+</div>
+
+<p>
+<span class="code">module1.jmx</span> can now be used with any test plan. The Include Controller hasn't been tested
+with other controllers as the root element. If you need to use other controllers, use a Simple Controller
+as the root and add other controllers to it.
+</p>
+
+</div><ul class="pagelinks"><li><a href="best-practices.html">< Prev</a></li><li><a href="../index.html">Index</a></li><li><a href="component_reference.html">Next ></a></li></ul><div class="share-links">
+ Share this page:
+ <ul><li class="fb"><a data-social-url="https://facebook.com/sharer/sharer.php?u=" title="Share on facebook"><i class="fa fa-facebook" aria-hidden="true"></i>share</a></li><li class="twitter"><a data-social-url="https://twitter.com/intent/tweet?url=" title="Tweet on twitter"><i class="fa fa-twitter" aria-hidden="true"></i>tweet</a></li><li class="gplus"><a data-social-url="https://plus.google.com/share?url=" title="Share on Google+"><i class="fa fa-google-plus" aria-hidden="true"></i>share</a></li></ul></div></div><div class="footer"><div class="copyright">
+ Copyright ©
+ 1999 –
+ 2017
+ , 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><script>(function(){
+ // fill in the current location into social links on this page.
+ "use strict";
+ var as = document.getElementsByTagName('a');
+ var loc = document.location.href;
+ if (!loc.toLowerCase().startsWith('http')) {
+ return;
+ }
+ for (var i=0; i<as.length; i++) {
+ var href = as[i].getAttribute('data-social-url');
+ if (href !== null) {
+ as[i].href = href + encodeURIComponent(loc);
+ }
+ }
+ })();</script></body></html>
\ No newline at end of file
Propchange: jmeter/trunk/docs/usermanual/include_controller_tutorial.html
------------------------------------------------------------------------------
svn:eol-style = native
Modified: jmeter/trunk/docs/usermanual/index.html
URL: http://svn.apache.org/viewvc/jmeter/trunk/docs/usermanual/index.html?rev=1789801&r1=1789800&r2=1789801&view=diff
==============================================================================
--- jmeter/trunk/docs/usermanual/index.html (original)
+++ jmeter/trunk/docs/usermanual/index.html Sat Apr 1 14:01:02 2017
@@ -5,7 +5,7 @@
APACHE LOGO
--><div><a href="http://www.apache.org"><img title="Apache Software Foundation" class="asf-logo logo" src="../images/asf-logo.svg" alt="Logo ASF"></a></div><!--
PROJECT LOGO
- --><div><a href="http://jmeter.apache.org/"><img class="logo" src="../images/logo.svg" alt="Apache JMeter"></a></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 onClick="return true"><div class="menu-title">About</div><ul><li><a href="../index.html">Overview</a></li><li><a href="http://www.apache.org/licenses/">License</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><div class="menu-title">Download</div><ul><li><a href="../download_jmeter.cgi">Download Releases</a></li><li><a href="../changes.html">Release Notes</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><div class="menu-title">Documentation</div><ul><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="../usermanual/properties_reference.html">Properties Reference</a></li><li><a href="../changes_history.html">Change History</a></li><li><a href="../api/index.html">Javadocs</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 onClick="return true"><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="../usermanual/jmeter_accesslog_sampler_step_by_step.pdf">Access Log Sampler</a></li><li><a href="../e
xtending/jmeter_tutorial.pdf">Extending JMeter</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><div class="menu-title">Community</div><ul><li><a href="../issues.html">Issue Tracking</a></li><li><a href="../mail.html">Mailing Lists</a></li><li><a href="../svnindex.html">Source Repositories</a></li><li><a href="../building.html">Building and Contributing</a></li><li><a href="https://projects.apache.org/project.html?jmeter">Project info at Apache</a></li><li><a href="http://wiki.apache.org/jmeter/JMeterCommitters">Contributors</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><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="mai
n" id="content"><div class="social-media"><ul class="social-media-links"><li class="twitter"><a href="https://twitter.com/ApacheJMeter" title="Follow us on Twitter"><i class="fa fa-twitter" aria-hidden="true"></i>Twitter</a></li><li class="github"><a href="https://github.com/apache/jmeter" title="Fork us on github"><i class="fa fa-github" aria-hidden="true"></i>github</a></li></ul></div><ul class="pagelinks"><li><a href="../index.html">Index</a></li><li><a href="intro.html">Next ></a></li></ul><div class="section"><h1 id="index">User's Manual<a class="sectionlink" href="#index" title="Link to here">¶</a></h1>
+ --><div><a href="http://jmeter.apache.org/"><img class="logo" src="../images/logo.svg" alt="Apache JMeter"></a></div><div class="banner"><a href="http://www.apache.org/events/current-event.html"><img src="http://www.apache.org/events/current-event-234x60.png" alt="Current Apache event teaser"></a><div class="clear"></div></div></div><div class="nav"><ul class="menu"><li onClick="return true"><div class="menu-title">About</div><ul><li><a href="../index.html">Overview</a></li><li><a href="http://www.apache.org/licenses/">License</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><div class="menu-title">Download</div><ul><li><a href="../download_jmeter.cgi">Download Releases</a></li><li><a href="../changes.html">Release Notes</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><div class="menu-title">Documentation</div><ul><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="../usermanual/properties_reference.html">Properties Reference</a></li><li><a href="../changes_history.html">Change History</a></li><li><a href="../api/index.html">Javadocs</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 onClick="return true"><div class="menu-title">Tutorials</div><ul><li><a href="../usermanual/jmeter_distributed_testing_step_by_step.html">Distributed Testing</a></li><li><a href="../usermanual/jmeter_proxy_step_by_step.html">Recording Tests</a></li><li><a href="../usermanual/junitsampler_tutorial.html">JUnit Sampler</a></li><li><a href="../usermanual/jmeter_accesslog_sampler_step_by_step.html">Access Log
Sampler</a></li><li><a href="../usermanual/jmeter_tutorial.html">Extending JMeter</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><div class="menu-title">Community</div><ul><li><a href="../issues.html">Issue Tracking</a></li><li><a href="../mail.html">Mailing Lists</a></li><li><a href="../svnindex.html">Source Repositories</a></li><li><a href="../building.html">Building and Contributing</a></li><li><a href="https://projects.apache.org/project.html?jmeter">Project info at Apache</a></li><li><a href="http://wiki.apache.org/jmeter/JMeterCommitters">Contributors</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><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"><div class="social-media"><ul class="social-media-links"><li class="twitter"><a href="https://twitter.com/ApacheJMeter" title="Follow us on Twitter"><i class="fa fa-twitter" aria-hidden="true"></i>Twitter</a></li><li class="github"><a href="https://github.com/apache/jmeter" title="Fork us on github"><i class="fa fa-github" aria-hidden="true"></i>github</a></li></ul></div><ul class="pagelinks"><li><a href="../index.html">Index</a></li><li><a href="get-started.html">Next ></a></li></ul><div class="section"><h1 id="index">User's Manual<a class="sectionlink" href="#index" title="Link to here">¶</a></h1>
<p>Click on the section name to go straight to the section.
Click on the "+" to go to the relevant section of the detailed section list,
where you can select individual subsections.</p>
@@ -196,12 +196,12 @@
</ul>
</div>
-</div><ul class="pagelinks"><li><a href="../index.html">Index</a></li><li><a href="intro.html">Next ></a></li></ul><div class="share-links">
+</div><ul class="pagelinks"><li><a href="../index.html">Index</a></li><li><a href="get-started.html">Next ></a></li></ul><div class="share-links">
Share this page:
<ul><li class="fb"><a data-social-url="https://facebook.com/sharer/sharer.php?u=" title="Share on facebook"><i class="fa fa-facebook" aria-hidden="true"></i>share</a></li><li class="twitter"><a data-social-url="https://twitter.com/intent/tweet?url=" title="Tweet on twitter"><i class="fa fa-twitter" aria-hidden="true"></i>tweet</a></li><li class="gplus"><a data-social-url="https://plus.google.com/share?url=" title="Share on Google+"><i class="fa fa-google-plus" aria-hidden="true"></i>share</a></li></ul></div></div><div class="footer"><div class="copyright">
Copyright ©
1999 –
- 2016
+ 2017
, Apache Software Foundation
</div><div class="trademarks">Apache, Apache JMeter, JMeter, the Apache
feather, and the Apache JMeter logo are
Added: jmeter/trunk/docs/usermanual/jmeter_accesslog_sampler_step_by_step.html
URL: http://svn.apache.org/viewvc/jmeter/trunk/docs/usermanual/jmeter_accesslog_sampler_step_by_step.html?rev=1789801&view=auto
==============================================================================
--- jmeter/trunk/docs/usermanual/jmeter_accesslog_sampler_step_by_step.html (added)
+++ jmeter/trunk/docs/usermanual/jmeter_accesslog_sampler_step_by_step.html Sat Apr 1 14:01:02 2017
@@ -0,0 +1,122 @@
+<!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
+ -
+ Access log sampler Step-by-step</title><meta name="author" value="JMeter developers"><meta name="email" value="dev@jmeter.apache.org"><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 href="https://maxcdn.bootstrapcdn.com/font-awesome/4.6.1/css/font-awesome.min.css" rel="stylesheet" type="text/css"><link rel="stylesheet" type="text/css" href="../css/new-style.css"><link rel="apple-touch-icon-precomposed" href="../images/apple-touch-icon.png"><link rel="icon" href="../images/favicon.png"><meta name="msapplication-TileColor" content="#ffffff"><meta name="msapplication-TileImage" content="../images/mstile-144x144.png"><meta name="theme-color" content="#ffffff"></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" class="asf-logo logo" src="../images/asf-logo.svg" alt="Logo ASF"></a></div><!--
+ PROJECT LOGO
+ --><div><a href="http://jmeter.apache.org/"><img class="logo" src="../images/logo.svg" alt="Apache JMeter"></a></div><div class="banner"><a href="http://www.apache.org/events/current-event.html"><img src="http://www.apache.org/events/current-event-234x60.png" alt="Current Apache event teaser"></a><div class="clear"></div></div></div><div class="nav"><ul class="menu"><li onClick="return true"><div class="menu-title">About</div><ul><li><a href="../index.html">Overview</a></li><li><a href="http://www.apache.org/licenses/">License</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><div class="menu-title">Download</div><ul><li><a href="../download_jmeter.cgi">Download Releases</a></li><li><a href="../changes.html">Release Notes</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><div class="menu-title">Documentation</div><ul><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="../usermanual/properties_reference.html">Properties Reference</a></li><li><a href="../changes_history.html">Change History</a></li><li><a href="../api/index.html">Javadocs</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 onClick="return true"><div class="menu-title">Tutorials</div><ul><li><a href="../usermanual/jmeter_distributed_testing_step_by_step.html">Distributed Testing</a></li><li><a href="../usermanual/jmeter_proxy_step_by_step.html">Recording Tests</a></li><li><a href="../usermanual/junitsampler_tutorial.html">JUnit Sampler</a></li><li><a href="../usermanual/jmeter_accesslog_sampler_step_by_step.html">Access Log
Sampler</a></li><li><a href="../usermanual/jmeter_tutorial.html">Extending JMeter</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><div class="menu-title">Community</div><ul><li><a href="../issues.html">Issue Tracking</a></li><li><a href="../mail.html">Mailing Lists</a></li><li><a href="../svnindex.html">Source Repositories</a></li><li><a href="../building.html">Building and Contributing</a></li><li><a href="https://projects.apache.org/project.html?jmeter">Project info at Apache</a></li><li><a href="http://wiki.apache.org/jmeter/JMeterCommitters">Contributors</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><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"><div class="social-media"><ul class="social-media-links"><li class="twitter"><a href="https://twitter.com/ApacheJMeter" title="Follow us on Twitter"><i class="fa fa-twitter" aria-hidden="true"></i>Twitter</a></li><li class="github"><a href="https://github.com/apache/jmeter" title="Fork us on github"><i class="fa fa-github" aria-hidden="true"></i>github</a></li></ul></div><ul class="pagelinks"><li><a href="junitsampler_tutorial.html">< Prev</a></li><li><a href="../index.html">Index</a></li><li><a href="jmeter_tutorial.html">Next ></a></li></ul><div class="section"><h1 id="access-log-sampler">29. Access log sampler Step-by-step<a class="sectionlink" href="#access-log-sampler" title="Link to here">¶</a></h1>
+
+<p>
+This is a short tutorial on JMeter's access log sampler. The purpose of the Access Log Sampler
+is to provide an easy way to simulate production traffic. There are several benefits to using access logs.
+</p>
+
+<ul>
+ <li>Rather than guess what users are doing, the test plan is using real traffic data</li>
+ <li>As the traffic pattern changes, the access log provides a record of individual changes and general shifts in usage</li>
+ <li>Access logs contain a lot of useful data, which may provide some insight</li>
+ <li>Access logs can be minded to determine different types of users</li>
+ <li>Access logs can capture detailed session information</li>
+</ul>
+
+<p>
+The down side of using access logs for test plans is you have to configure the webserver to output the request
+information. This may not be appropriate where security is an issue. For example, if the webserver dumps the post
+data from each request to the access logs, users login and password would be stored in plain text. Here are some
+general cases where access logs might be inappropriate.
+</p>
+
+<ul>
+ <li>Security sensitive applications where the data is encrypted</li>
+ <li>The application does not allow fine grain control of which request parameters are written to the access logs</li>
+ <li>The application needs correlation between requests</li>
+ <li>The webserver cannot be configured to append the post data to the access log</li>
+ <li>The webserver is hosting multiple applications, but doesn't provide a way to log the requests of one application to a separate file</li>
+</ul>
+
+<p>
+To take advantage of access logs, the first thing is the webserver needs to be configured to use extended
+log format. Links for configuring the popular containers are provided below.
+</p>
+
+<ul>
+ <li><a href="http://e-docs.bea.com/wls/docs70/adminguide/web_server.html#113868">BEA Weblogic</a></li>
+ <li><a href="http://tomcat.apache.org/tomcat-8.5-doc/config/valve.html#Access_Log_Valve">Tomcat</a></li>
+ <li><a href="http://e-docs.bea.com/wls/docs61/adminguide/web_server.html#113868">Websphere</a></li>
+ <li><a href="http://www.caucho.com/resin-3.0/config/log.xtp#access-log">Resin</a></li>
+</ul>
+
+<p>
+In some cases, it may be desirable to write custom logging, so that sensitive information is not written
+to the access logs. This article does not cover the techniques for writing custom logging.
+</p>
+
+<div class="subsection"><h2 id="step-by-step">29.1 Step-by-Step<a class="sectionlink" href="#step-by-step" title="Link to here">¶</a></h2>
+
+<ol>
+ <li>Start JMeter</li>
+ <li>Select <span class="code">Test Plan</span></li>
+ <li>Right click
+ <span class="menuchoice"><span class="guimenuitem">Add</span> → <span class="guimenuitem">Threads (Users)</span> → <span class="guimenuitem">Thread Group</span></span>
+ <figure><a href="../images/screenshots/add-threadgroup.png"><img src="../images/screenshots/add-threadgroup.png" width="676" height="233" alt="Add Thread Group"></a><figcaption>Add Thread Group</figcaption></figure>
+ </li>
+ <li>Select <span class="code">Thread Group</span></li>
+ <li>Right click
+ <span class="menuchoice"><span class="guimenuitem">Add</span> → <span class="guimenuitem">Sampler</span> → <span class="guimenuitem">Access Log Sampler</span></span>
+ <figure><a href="../images/screenshots/add-access-log-sampler.png"><img src="../images/screenshots/add-access-log-sampler.png" width="704" height="283" alt="Add Access Log Sampler"></a><figcaption>Add Access Log Sampler</figcaption></figure>
+ </li>
+ <li>Right click on <span class="code">Thread Group</span>
+ <span class="menuchoice"><span class="guimenuitem">Add</span> → <span class="guimenuitem">Listener</span> → <span class="guimenuitem">Aggregate Report</span></span>
+ <figure><a href="../images/screenshots/add-aggregate-report.png"><img src="../images/screenshots/add-aggregate-report.png" width="752" height="326" alt="Add Aggregate Report"></a><figcaption>Add Aggregate Report</figcaption></figure>
+ </li>
+ <li>Select the <span class="code">Access Log Sampler</span>
+ <figure><a href="../images/screenshots/accesslogsampler.png"><img src="../images/screenshots/accesslogsampler.png" width="702" height="305" alt="Access Log Sampler"></a><figcaption>Access Log Sampler</figcaption></figure>
+ </li>
+ <li>Enter the IP address or hostname in <span class="code">Server</span></li>
+ <li>Enter the port in <span class="code">Port</span></li>
+ <li>If you want to download the images, set <span class="code">Parse images</span> to <span class="code">true</span>.</li>
+ <li>Select a file for <span class="code">Log File Location</span>
+ <figure><a href="../images/screenshots/example-access-log-sampler.png"><img src="../images/screenshots/example-access-log-sampler.png" width="703" height="315" alt="Filled in Access Log Sampler"></a><figcaption>Filled in Access Log Sampler</figcaption></figure>
+ </li>
+ <li>Select Aggregate Report</li>
+ <li>Enter <span class="code">results.jtl</span> for filename
+ <figure><a href="../images/screenshots/example-aggregate-report.png"><img src="../images/screenshots/example-aggregate-report.png" width="344" height="150" alt="Aggregate Report with filename"></a><figcaption>Aggregate Report with filename</figcaption></figure>
+ </li>
+</ol>
+
+<p>
+At this point, the test plan is ready. Start the test with
+ <span class="keycombo"><span class="keysym">Ctrl</span> + <span class="keysym">R</span></span>
+or from the menu
+ <span class="menuchoice"><span class="guimenuitem">Start</span> → <span class="guimenuitem">Run</span></span>.
+</p>
+
+</div>
+
+</div><ul class="pagelinks"><li><a href="junitsampler_tutorial.html">< Prev</a></li><li><a href="../index.html">Index</a></li><li><a href="jmeter_tutorial.html">Next ></a></li></ul><div class="share-links">
+ Share this page:
+ <ul><li class="fb"><a data-social-url="https://facebook.com/sharer/sharer.php?u=" title="Share on facebook"><i class="fa fa-facebook" aria-hidden="true"></i>share</a></li><li class="twitter"><a data-social-url="https://twitter.com/intent/tweet?url=" title="Tweet on twitter"><i class="fa fa-twitter" aria-hidden="true"></i>tweet</a></li><li class="gplus"><a data-social-url="https://plus.google.com/share?url=" title="Share on Google+"><i class="fa fa-google-plus" aria-hidden="true"></i>share</a></li></ul></div></div><div class="footer"><div class="copyright">
+ Copyright ©
+ 1999 –
+ 2017
+ , 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><script>(function(){
+ // fill in the current location into social links on this page.
+ "use strict";
+ var as = document.getElementsByTagName('a');
+ var loc = document.location.href;
+ if (!loc.toLowerCase().startsWith('http')) {
+ return;
+ }
+ for (var i=0; i<as.length; i++) {
+ var href = as[i].getAttribute('data-social-url');
+ if (href !== null) {
+ as[i].href = href + encodeURIComponent(loc);
+ }
+ }
+ })();</script></body></html>
\ No newline at end of file
Propchange: jmeter/trunk/docs/usermanual/jmeter_accesslog_sampler_step_by_step.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: jmeter/trunk/docs/usermanual/jmeter_distributed_testing_step_by_step.html
URL: http://svn.apache.org/viewvc/jmeter/trunk/docs/usermanual/jmeter_distributed_testing_step_by_step.html?rev=1789801&view=auto
==============================================================================
--- jmeter/trunk/docs/usermanual/jmeter_distributed_testing_step_by_step.html (added)
+++ jmeter/trunk/docs/usermanual/jmeter_distributed_testing_step_by_step.html Sat Apr 1 14:01:02 2017
@@ -0,0 +1,211 @@
+<!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
+ -
+ Apache JMeter Distributed Testing Step-by-step</title><meta name="author" value="JMeter developers"><meta name="email" value="dev@jmeter.apache.org"><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 href="https://maxcdn.bootstrapcdn.com/font-awesome/4.6.1/css/font-awesome.min.css" rel="stylesheet" type="text/css"><link rel="stylesheet" type="text/css" href="../css/new-style.css"><link rel="apple-touch-icon-precomposed" href="../images/apple-touch-icon.png"><link rel="icon" href="../images/favicon.png"><meta name="msapplication-TileColor" content="#ffffff"><meta name="msapplication-TileImage" content="../images/mstile-144x144.png"><meta name="theme-color" content="#ffffff"></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" class="asf-logo logo" src="../images/asf-logo.svg" alt="Logo ASF"></a></div><!--
+ PROJECT LOGO
+ --><div><a href="http://jmeter.apache.org/"><img class="logo" src="../images/logo.svg" alt="Apache JMeter"></a></div><div class="banner"><a href="http://www.apache.org/events/current-event.html"><img src="http://www.apache.org/events/current-event-234x60.png" alt="Current Apache event teaser"></a><div class="clear"></div></div></div><div class="nav"><ul class="menu"><li onClick="return true"><div class="menu-title">About</div><ul><li><a href="../index.html">Overview</a></li><li><a href="http://www.apache.org/licenses/">License</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><div class="menu-title">Download</div><ul><li><a href="../download_jmeter.cgi">Download Releases</a></li><li><a href="../changes.html">Release Notes</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><div class="menu-title">Documentation</div><ul><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="../usermanual/properties_reference.html">Properties Reference</a></li><li><a href="../changes_history.html">Change History</a></li><li><a href="../api/index.html">Javadocs</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 onClick="return true"><div class="menu-title">Tutorials</div><ul><li><a href="../usermanual/jmeter_distributed_testing_step_by_step.html">Distributed Testing</a></li><li><a href="../usermanual/jmeter_proxy_step_by_step.html">Recording Tests</a></li><li><a href="../usermanual/junitsampler_tutorial.html">JUnit Sampler</a></li><li><a href="../usermanual/jmeter_accesslog_sampler_step_by_step.html">Access Log
Sampler</a></li><li><a href="../usermanual/jmeter_tutorial.html">Extending JMeter</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><div class="menu-title">Community</div><ul><li><a href="../issues.html">Issue Tracking</a></li><li><a href="../mail.html">Mailing Lists</a></li><li><a href="../svnindex.html">Source Repositories</a></li><li><a href="../building.html">Building and Contributing</a></li><li><a href="https://projects.apache.org/project.html?jmeter">Project info at Apache</a></li><li><a href="http://wiki.apache.org/jmeter/JMeterCommitters">Contributors</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><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"><div class="social-media"><ul class="social-media-links"><li class="twitter"><a href="https://twitter.com/ApacheJMeter" title="Follow us on Twitter"><i class="fa fa-twitter" aria-hidden="true"></i>Twitter</a></li><li class="github"><a href="https://github.com/apache/jmeter" title="Fork us on github"><i class="fa fa-github" aria-hidden="true"></i>github</a></li></ul></div><ul class="pagelinks"><li><a href="../index.html">Index</a></li><li><a href="jmeter_proxy_step_by_step.html">Next ></a></li></ul><div class="section"><h1 id="distributed-testing">26. Apache JMeter Distributed Testing Step-by-step<a class="sectionlink" href="#distributed-testing" title="Link to here">¶</a></h1>
+
+<p>
+This short tutorial explains how to use multiple systems to perform stress testing. Before we start, there are a couple of things to check.
+</p>
+
+<ul>
+ <li>the firewalls on the systems are turned off or correct ports are opened.</li>
+ <li>all the clients are on the same subnet.</li>
+ <li>the server is in the same subnet, if <span class="code">192.x.x.x</span> or <span class="code">10.x.x.x</span> IP addresses are used.
+ If the server doesn't use <span class="code">192.xx</span> or <span class="code">10.xx</span> IP address, there shouldn't be any problems.</li>
+ <li>Make sure JMeter can access the server.</li>
+ <li>Make sure you use the same version of JMeter and Java on all the systems. Mixing versions will not work correctly.</li>
+</ul>
+
+<p>
+Once you've made sure the systems are ready, it's time to setup remote testing. The tutorial assumes you already
+have JMeter installed on all the systems. The way JMeter works is one master controller initiates the test on multiple slave systems.
+</p>
+
+<div class="clear"></div><div class="note">In this tutorial we use GUI Mode just for demonstration. In real life you should use NON GUI mode to start your load test</div><div class="clear"></div>
+
+<figure><a href="../images/screenshots/distributed-jmeter.svg"><img src="../images/screenshots/distributed-jmeter.svg" width="610" height="462" alt="One master controls multiple slaves"></a><figcaption>One master controls multiple slaves</figcaption></figure>
+
+<div class="subsection"><h2 id="terminology">26.1 Terminology<a class="sectionlink" href="#terminology" title="Link to here">¶</a></h2>
+
+<p>
+Before we dive into the step-by-step instructions, it's a good idea to define the terms and make sure the definition is clear.
+</p>
+
+<dl>
+ <dt>Master</dt><dd>the system running JMeter GUI, which controls the test</dd>
+ <dt>Slave</dt><dd>the system running <span class="code">jmeter-server</span>, which takes commands from
+ the GUI and send requests to the target system(s)</dd>
+ <dt>Target</dt><dd>the webserver we plan to stress test</dd>
+</dl>
+
+<figure><a href="../images/screenshots/distributed-names.svg"><img src="../images/screenshots/distributed-names.svg" width="602" height="360" alt="Categories of systems"></a><figcaption>Categories of systems</figcaption></figure>
+
+</div>
+
+<div class="subsection"><h2 id="step-by-step">26.2 Step-by-Step<a class="sectionlink" href="#step-by-step" title="Link to here">¶</a></h2>
+
+<ol>
+ <li>On the slave systems, go to <span class="code">jmeter/bin</span> directory and execute
+ <span class="code">jmeter-server.bat</span> (<span class="code">jmeter-server</span> on unix).
+ </li>
+ <li>On master system acting as the console, open windows explorer and go to
+ <span class="code">jmeter/bin</span> directory</li>
+ <li>Open <span class="code">jmeter.properties</span> in a text editor</li>
+ <li>Edit the line <span class="code">remote_hosts=127.0.0.1</span></li>
+ <li>Add the IP address. For example, if I have JMeter server running on <span class="code">192.168.0.10</span>,
+ …, <span class="code">192.168.0.15</span>, the entry would like like this:
+ <pre class="source">remote_hosts=192.168.0.10,192.168.0.11,192.168.0.12,192.168.0.13,192.168.0.14</pre>
+ </li>
+ <li>Start JMeter.</li>
+ <li>Open the test plan you want to use</li>
+</ol>
+
+<figure><a href="../images/screenshots/example-simple-plan.png"><img src="../images/screenshots/example-simple-plan.png" width="483" height="266" alt="Simple test plan"></a><figcaption>Simple test plan</figcaption></figure>
+
+</div>
+
+<div class="subsection"><h2 id="starting">26.2 Starting the Test<a class="sectionlink" href="#starting" title="Link to here">¶</a></h2>
+
+<p>
+At this point, you are ready to start load testing. If you want to double check
+the slave systems are working, open <span class="code">jmeter.log</span> in your editor. You should see the following in the log.
+</p>
+
+<pre class="source">
+Writing log file to: /XXXX/XXXXX/bin/jmeter-server.log
+Created remote object: UnicastServerRef [liveRef: [endpoint:[192.X.X.X:XXXXX](local),objID:[-6a665beb:15a2c8b9419:-7fff, 3180474504933847586]]]
+</pre>
+
+<p>
+If you do not see this message, it means <span class="code">jmeter-server</span> did not start correctly. For tips on
+debugging the issue, <a href="#tips">go to the tips section</a>. There are two ways to
+initiate the test: a single system and all systems.
+</p>
+
+</div>
+
+<div class="subsection"><h2 id="start-single-client">26.3 Start a single clients<a class="sectionlink" href="#start-single-client" title="Link to here">¶</a></h2>
+
+<ol>
+ <li>Click Run at the top</li>
+ <li>Select Remote Start</li>
+ <li>Select the IP address</li>
+</ol>
+
+<figure><a href="../images/screenshots/example-remote-start.png"><img src="../images/screenshots/example-remote-start.png" width="490" height="196" alt="Start a single slave"></a><figcaption>Start a single slave</figcaption></figure>
+
+</div>
+
+<div class="subsection"><h2 id="start-all-clients">26.4 Start all clients<a class="sectionlink" href="#start-all-clients" title="Link to here">¶</a></h2>
+
+<ol>
+ <li>Click Run at the top</li>
+ <li>Select Remote Start all or use <span class="keycombo"><span class="keysym">Ctrl</span> + <span class="keysym">Shift</span> + <span class="keysym">R</span></span></li>
+</ol>
+
+<figure><a href="../images/screenshots/example-remote-start-all.png"><img src="../images/screenshots/example-remote-start-all.png" width="410" height="155" alt="Start all slaves"></a><figcaption>Start all slaves</figcaption></figure>
+
+</div>
+
+<div class="subsection"><h2 id="limitations">26.5 Limitations<a class="sectionlink" href="#limitations" title="Link to here">¶</a></h2>
+
+<p>
+There are some basic limitations for distributed testing. Here's the list of the known items in no specific order.
+</p>
+
+<ol>
+ <li>RMI cannot communicate across subnets without a proxy; therefore neither can JMeter without a proxy.</li>
+ <li>Since version 2.9, JMeter sends all the test results stripping Response data to the controlling console, this allows
+ us to reduce impact on network IO. Ensure you monitor your network traffic so that this trafic does not incur contention</li>
+ <li>A single JMeter client running on a 2-3 GHz CPU (recent CPU) can handle 1000-2000 threads depending on the type of test.</li>
+</ol>
+
+</div>
+
+<div class="subsection"><h2 id="additional-resources">26.6 Additional resources<a class="sectionlink" href="#additional-resources" title="Link to here">¶</a></h2>
+
+<p>
+ <a href="http://wiki.apache.org/jmeter/JMeterFAQ#How_to_do_remote_testing_the_.27proper_way.27.3F">Wiki page on remote testing</a>
+</p>
+
+<p>
+ <a href="remote-test.html">Remote Testing in the user manual</a>
+</p>
+
+</div>
+
+<div class="subsection"><h2 id="tips">26.7 Tips<a class="sectionlink" href="#tips" title="Link to here">¶</a></h2>
+
+<p>
+In some cases, the firewall may still be blocking RMI traffic.
+</p>
+
+<h3>Anti Virus and Firewall</h3>
+
+<div class="clear"></div><div class="note">Antivirus should be stopped during a Load Test as it can drastically impact timings leading to wrong results.</div><div class="clear"></div>
+<p>
+Firewall needs to be stopped from windows services or at least some ports need to be opened.
+</p>
+
+<ol>
+ <li>Open control panel</li>
+ <li>Open administrative tools</li>
+ <li>Double click services</li>
+ <li>Go to down to Symantec anti virus, right click and select stop</li>
+</ol>
+
+<h3>Windows firewall</h3>
+
+<ol>
+ <li>Open network connections</li>
+ <li>Select the network connection</li>
+ <li>Right click and select properties</li>
+ <li>Select advanced tab</li>
+ <li>Uncheck internet connection firewall</li>
+</ol>
+
+<h3>Linux</h3>
+
+<p>
+On Linux, iptables might be turned on by default. For instructions, please refer to the
+ <a href="remote-test.html">Remote Testing in the user manual</a>
+</p>
+
+<p>
+On RedHat (or derivatives), iptables is turned on by default. Execute
+<pre class="source">service iptables stop</pre>
+to stop the Linux firewall or ensure you open the correct ports.
+</p>
+
+</div>
+
+</div><ul class="pagelinks"><li><a href="../index.html">Index</a></li><li><a href="jmeter_proxy_step_by_step.html">Next ></a></li></ul><div class="share-links">
+ Share this page:
+ <ul><li class="fb"><a data-social-url="https://facebook.com/sharer/sharer.php?u=" title="Share on facebook"><i class="fa fa-facebook" aria-hidden="true"></i>share</a></li><li class="twitter"><a data-social-url="https://twitter.com/intent/tweet?url=" title="Tweet on twitter"><i class="fa fa-twitter" aria-hidden="true"></i>tweet</a></li><li class="gplus"><a data-social-url="https://plus.google.com/share?url=" title="Share on Google+"><i class="fa fa-google-plus" aria-hidden="true"></i>share</a></li></ul></div></div><div class="footer"><div class="copyright">
+ Copyright ©
+ 1999 –
+ 2017
+ , 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><script>(function(){
+ // fill in the current location into social links on this page.
+ "use strict";
+ var as = document.getElementsByTagName('a');
+ var loc = document.location.href;
+ if (!loc.toLowerCase().startsWith('http')) {
+ return;
+ }
+ for (var i=0; i<as.length; i++) {
+ var href = as[i].getAttribute('data-social-url');
+ if (href !== null) {
+ as[i].href = href + encodeURIComponent(loc);
+ }
+ }
+ })();</script></body></html>
\ No newline at end of file
Propchange: jmeter/trunk/docs/usermanual/jmeter_distributed_testing_step_by_step.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: jmeter/trunk/docs/usermanual/jmeter_proxy_step_by_step.html
URL: http://svn.apache.org/viewvc/jmeter/trunk/docs/usermanual/jmeter_proxy_step_by_step.html?rev=1789801&view=auto
==============================================================================
--- jmeter/trunk/docs/usermanual/jmeter_proxy_step_by_step.html (added)
+++ jmeter/trunk/docs/usermanual/jmeter_proxy_step_by_step.html Sat Apr 1 14:01:02 2017
@@ -0,0 +1,227 @@
+<!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
+ -
+ Apache JMeter HTTP(S) Test Script Recorder</title><meta name="author" value="JMeter developers"><meta name="email" value="dev@jmeter.apache.org"><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 href="https://maxcdn.bootstrapcdn.com/font-awesome/4.6.1/css/font-awesome.min.css" rel="stylesheet" type="text/css"><link rel="stylesheet" type="text/css" href="../css/new-style.css"><link rel="apple-touch-icon-precomposed" href="../images/apple-touch-icon.png"><link rel="icon" href="../images/favicon.png"><meta name="msapplication-TileColor" content="#ffffff"><meta name="msapplication-TileImage" content="../images/mstile-144x144.png"><meta name="theme-color" content="#ffffff"></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" class="asf-logo logo" src="../images/asf-logo.svg" alt="Logo ASF"></a></div><!--
+ PROJECT LOGO
+ --><div><a href="http://jmeter.apache.org/"><img class="logo" src="../images/logo.svg" alt="Apache JMeter"></a></div><div class="banner"><a href="http://www.apache.org/events/current-event.html"><img src="http://www.apache.org/events/current-event-234x60.png" alt="Current Apache event teaser"></a><div class="clear"></div></div></div><div class="nav"><ul class="menu"><li onClick="return true"><div class="menu-title">About</div><ul><li><a href="../index.html">Overview</a></li><li><a href="http://www.apache.org/licenses/">License</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><div class="menu-title">Download</div><ul><li><a href="../download_jmeter.cgi">Download Releases</a></li><li><a href="../changes.html">Release Notes</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><div class="menu-title">Documentation</div><ul><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="../usermanual/properties_reference.html">Properties Reference</a></li><li><a href="../changes_history.html">Change History</a></li><li><a href="../api/index.html">Javadocs</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 onClick="return true"><div class="menu-title">Tutorials</div><ul><li><a href="../usermanual/jmeter_distributed_testing_step_by_step.html">Distributed Testing</a></li><li><a href="../usermanual/jmeter_proxy_step_by_step.html">Recording Tests</a></li><li><a href="../usermanual/junitsampler_tutorial.html">JUnit Sampler</a></li><li><a href="../usermanual/jmeter_accesslog_sampler_step_by_step.html">Access Log
Sampler</a></li><li><a href="../usermanual/jmeter_tutorial.html">Extending JMeter</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><div class="menu-title">Community</div><ul><li><a href="../issues.html">Issue Tracking</a></li><li><a href="../mail.html">Mailing Lists</a></li><li><a href="../svnindex.html">Source Repositories</a></li><li><a href="../building.html">Building and Contributing</a></li><li><a href="https://projects.apache.org/project.html?jmeter">Project info at Apache</a></li><li><a href="http://wiki.apache.org/jmeter/JMeterCommitters">Contributors</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><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"><div class="social-media"><ul class="social-media-links"><li class="twitter"><a href="https://twitter.com/ApacheJMeter" title="Follow us on Twitter"><i class="fa fa-twitter" aria-hidden="true"></i>Twitter</a></li><li class="github"><a href="https://github.com/apache/jmeter" title="Fork us on github"><i class="fa fa-github" aria-hidden="true"></i>github</a></li></ul></div><ul class="pagelinks"><li><a href="jmeter_distributed_testing_step_by_step.html">< Prev</a></li><li><a href="../index.html">Index</a></li><li><a href="junitsampler_tutorial.html">Next ></a></li></ul><div class="section"><h1 id="script-recorder">27. Apache JMeter HTTP(S) Test Script Recorder<a class="sectionlink" href="#script-recorder" title="Link to here">¶</a></h1>
+
+<p>
+This tutorial attempts to explain the exact steps for recording HTTP/HTTPS. For those new to JMeter, one easy way to create a test plan is to use the Recorder.
+</p>
+
+<div class="subsection"><h2 id="configuration">27.1 JMeter configuration<a class="sectionlink" href="#configuration" title="Link to here">¶</a></h2>
+
+<p>
+Since JMeter 2.10, recording has been improved to better handle embedded resources and creation of certificates on the fly.
+To enable these features, JMeter uses <span class="code">keytool</span> utility (available in JRE/JDK) so you need to ensure your
+configuration is correct, read <a href="https://wiki.apache.org/jmeter/TestRecording210">this wiki page before starting.</a>
+</p>
+
+</div>
+
+<div class="subsection"><h2 id="basic-instructions">27.2 Basic Instructions<a class="sectionlink" href="#basic-instructions" title="Link to here">¶</a></h2>
+
+<ol>
+ <li>Go to <span class="code">JMETER_HOME/bin</span> and start JMeter with <span class="code">jmeterw.cmd</span> on Windows
+ and <span class="code">jmeter</span> on Linux/Unix</li>
+ <li>Select <span class="code">Templates...</span> on the menu bar</li>
+ <figure><a href="../images/screenshots/Select-Templates-Icon.png"><img src="../images/screenshots/Select-Templates-Icon.png" width="" height="" alt=""></a><figcaption></figcaption></figure>
+ <li>Select <span class="code">Recording template</span> on the list</li>
+ <figure><a href="../images/screenshots/Select-Recording-Template.png"><img src="../images/screenshots/Select-Recording-Template.png" width="" height="" alt=""></a><figcaption></figcaption></figure>
+ <li>A complete <span class="code">Test Plan</span> is generated</li>
+ <figure><a href="../images/screenshots/Test_Generated.png"><img src="../images/screenshots/Test_Generated.png" width="" height="" alt=""></a><figcaption></figcaption></figure>
+ <li>In the <span class="code">HTTP Request Defaults</span> element:
+ <dl>
+ <dt><span class="code">Server name</span></dt><dd>enter <span class="code">example.com</span></dd>
+ <dt><span class="code">Path</span></dt><dd>leave blank</dd>
+ </dl>
+ <figure><a href="../images/screenshots/http-config/http-request-defaults.png"><img src="../images/screenshots/http-config/http-request-defaults.png" width="" height="" alt=""></a><figcaption></figcaption></figure>
+ </li>
+ <li>Return to <span class="code">HTTP(S) Test Script Recorder</span>, and click the <span class="code">Start</span> button at the top.</li>
+ <figure><a href="../images/screenshots/Proxy_Run.png"><img src="../images/screenshots/Proxy_Run.png" width="" height="" alt=""></a><figcaption></figcaption></figure>
+</ol>
+
+<p>
+This will start the JMeter proxy server which is used to intercept the browser requests.
+A file called <span class="code">ApacheJMeterTemporaryRootCA.crt</span> will be generated in <span class="code">jmeter/bin</span>
+folder. Install this certificate in your browser, if you don't know how to do it,
+read <a href="component_reference.html#HTTP%28S%29_Test_Script_Recorder">Installing the JMeter CA certificate for HTTPS recording</a>
+</p>
+
+</div>
+
+<div class="subsection"><h2 id="configue-browser">27.3 Configure your browser to use the JMeter Proxy<a class="sectionlink" href="#configue-browser" title="Link to here">¶</a></h2>
+
+<p>
+At this point, JMeter's proxy is running. For this exercise, we will use Iceweasel/Firefox
+to view some pages on the JMeter website.
+</p>
+
+<ol>
+ <li>Start Iceweasel/Firefox, but do not close JMeter.</li>
+ <li>From the tool bar, click
+ <span class="menuchoice"><span class="guimenuitem">Edit</span> → <span class="guimenuitem">Preferences</span></span> (or
+ <span class="menuchoice"><span class="guimenuitem">Tools</span> → <span class="guimenuitem">Preferences</span></span> or type <span class="code">about:preferences#advanced</span>
+ as URL). This should bring up the options.
+ <figure><a href="../images/screenshots/firefox-network-settings.png"><img src="../images/screenshots/firefox-network-settings.png" width="914" height="566" alt=""></a><figcaption></figcaption></figure>
+ </li>
+ <li>Select the <span class="code">Advanced</span> tab, and <span class="code">Network</span> tab</li>
+ <li>Click <span class="code">Settings</span> button near the top.</li>
+ <li>On the new pop-up, check <span class="code">Manual proxy configuration</span>. The address and
+ port fields should be enabled now.
+ <dl>
+ <dt><span class="code">Address</span></dt><dd>enter <span class="code">localhost</span> or the IP address of your system</dd>
+ <dt><span class="code">Port</span></dt><dd>enter <span class="code">8888</span>.</dd>
+ </dl>
+ <figure><a href="../images/screenshots/firefox-configure-proxy.png"><img src="../images/screenshots/firefox-configure-proxy.png" width="532" height="240" alt=""></a><figcaption></figcaption></figure>
+ </li>
+ <li>Check <span class="code">Use this proxy server for all protocols</span></li>
+ <li>Click <span class="code">OK</span> button. This should return you to the browser</li>
+</ol>
+
+</div>
+
+<div class="subsection"><h2 id="navigation-recording">27.4 Record your navigation<a class="sectionlink" href="#navigation-recording" title="Link to here">¶</a></h2>
+
+<ol>
+ <li>With your browser, in the <span class="code">Address</span> bar at the top, enter <span class="code">http://example.com/index.html</span> (replace <span class="code">example.com</span> with your websites address).
+ and hit the <span class="code">enter</span> key.</li>
+ <li>Click on a few links on your sites pages.</li>
+ <li>Close your browser and bring up the JMeter window.</li>
+</ol>
+
+<p>
+Expand the <span class="code">Thread Group</span> and there should be several samplers. At this point, the test plan can
+be saved as is.
+<div class="clear"></div><div class="note">If you forget to add default HTTP Request settings, you will have to manually
+delete the server name, and port.</div><div class="clear"></div>
+</p>
+
+<figure><a href="../images/screenshots/example-recording.png"><img src="../images/screenshots/example-recording.png" width="258" height="194" alt=""></a><figcaption></figcaption></figure>
+<p>
+In this sample, there aren't any default request parameters. If a particular request parameter
+is required by all pages, the request defaults is where one would add the entries.
+</p>
+
+<ol>
+ <li>Select <span class="code">Thread Group</span> and change a few defaults:
+ <dl>
+ <dt><span class="code">Number of Threads</span></dt><dd>enter <span class="code">5</span></dd>
+ <dt><span class="code">Ramp-Up Period</span></dt><dd>do not change</dd>
+ <dt><span class="code">Loop Count</span></dt><dd>enter <span class="code">100</span></dd>
+ </dl>
+ <figure><a href="../images/screenshots/example-thread-group.png"><img src="../images/screenshots/example-thread-group.png" width="357" height="288" alt=""></a><figcaption></figcaption></figure>
+ </li>
+</ol>
+
+</div>
+
+<div class="subsection"><h2 id="validate-script">27.5 Validate the script<a class="sectionlink" href="#validate-script" title="Link to here">¶</a></h2>
+
+<p>
+Now we need to validate the script before to run our test plan. Save the test plan.
+</p>
+<p>
+Right click on the <span class="code">Thread Group</span>
+ <span class="menuchoice"><span class="guimenuitem">Validate</span></span>
+ <figure><a href="../images/screenshots/Validate-Test-Plan.png"><img src="../images/screenshots/Validate-Test-Plan.png" width="" height="" alt=""></a><figcaption></figcaption></figure>
+</p>
+<p>
+Check with <span class="code">View Results Tree</span> element if all is ok.
+</p>
+</div>
+
+<div class="subsection"><h2 id="correlate-start">27.6 Variabilize and Correlate the script<a class="sectionlink" href="#correlate-start" title="Link to here">¶</a></h2>
+<p>
+In some scripts, we will need to:
+<ul>
+ <li>Variabilize some input (login, password, search words...)</li>
+ <li>Correlate some data (session variable...) between two requests</li>
+</ul>
+</p>
+<p>
+To variabilize, we can use:
+<ul>
+ <li><span class="code">CSV Data Set Config</span> to get input data from csv file</li>
+ <li>JMeter functions like <span class="code">__counter</span>, <span class="code">__time</span>...</li>
+ <li>etc.</li>
+</ul>
+</p>
+<p>
+To correlate, we can get data from a request with <span class="code">Post Processors</span> like <span class="code">JSON Extractor</span>, <span class="code">Regular Expression Extractor</span>... and inject it in another request.
+</p>
+<p>
+To find data to correlate, the easiest way to do it is to use the Search function in <span class="code">View Results Tree</span>.
+<figure><a href="../images/screenshots/Search-Correlation.png"><img src="../images/screenshots/Search-Correlation.png" width="" height="" alt=""></a><figcaption></figcaption></figure>
+</p>
+</div>
+
+<div class="subsection"><h2 id="test-start">27.7 Start the test<a class="sectionlink" href="#test-start" title="Link to here">¶</a></h2>
+
+<p>
+At this point, we are ready to run our test plan and see what happens. When you're
+ready to run the test, there are two ways:
+<ol>
+ <li>With the gui, but it's not recommended to big load test.</li>
+ <li>With the command line.</li>
+</ol>
+</p>
+
+
+<p>
+Solution 1, with the gui, but just during debug phase, use Non GUI for your load test.
+</p>
+<p>
+ <span class="menuchoice"><span class="guimenuitem">Run</span> → <span class="guimenuitem">Start</span></span>
+or use the keyboard and press <span class="keycombo"><span class="keysym">Ctrl</span> + <span class="keysym">R</span></span>
+</p>
+
+<p>
+ Before you start the test, add a <span class="code">Summary Report</span> element and select it. As the test runs, the statistics will change
+ until the test is done. At the end of the test, the summary report should look like this.
+ <figure><a href="../images/screenshots/example-summary-report.png"><img src="../images/screenshots/example-summary-report.png" width="984" height="220" alt=""></a><figcaption></figcaption></figure>
+</p>
+
+
+<p>
+ While the test is running, in the upper right-hand corner, there should be a green circle. When the test is done, the circle should be grey.
+ <figure><a href="../images/screenshots/example-running.png"><img src="../images/screenshots/example-running.png" width="132" height="39" alt=""></a><figcaption></figcaption></figure>
+</p>
+
+<p>
+Solution 2, in command line, use <span class="code">jmeter -n -t [jmx file] -l [results file] -e -o [Path to output folder]</span>
+</p>
+<p>
+At the end of the test, an HTML report will be generated and available in [Path to output folder] used in command line.
+</p>
+
+</div>
+
+</div><ul class="pagelinks"><li><a href="jmeter_distributed_testing_step_by_step.html">< Prev</a></li><li><a href="../index.html">Index</a></li><li><a href="junitsampler_tutorial.html">Next ></a></li></ul><div class="share-links">
+ Share this page:
+ <ul><li class="fb"><a data-social-url="https://facebook.com/sharer/sharer.php?u=" title="Share on facebook"><i class="fa fa-facebook" aria-hidden="true"></i>share</a></li><li class="twitter"><a data-social-url="https://twitter.com/intent/tweet?url=" title="Tweet on twitter"><i class="fa fa-twitter" aria-hidden="true"></i>tweet</a></li><li class="gplus"><a data-social-url="https://plus.google.com/share?url=" title="Share on Google+"><i class="fa fa-google-plus" aria-hidden="true"></i>share</a></li></ul></div></div><div class="footer"><div class="copyright">
+ Copyright ©
+ 1999 –
+ 2017
+ , 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><script>(function(){
+ // fill in the current location into social links on this page.
+ "use strict";
+ var as = document.getElementsByTagName('a');
+ var loc = document.location.href;
+ if (!loc.toLowerCase().startsWith('http')) {
+ return;
+ }
+ for (var i=0; i<as.length; i++) {
+ var href = as[i].getAttribute('data-social-url');
+ if (href !== null) {
+ as[i].href = href + encodeURIComponent(loc);
+ }
+ }
+ })();</script></body></html>
\ No newline at end of file
Propchange: jmeter/trunk/docs/usermanual/jmeter_proxy_step_by_step.html
------------------------------------------------------------------------------
svn:eol-style = native