Modified: jmeter/trunk/docs/usermanual/functions.html
URL: 
http://svn.apache.org/viewvc/jmeter/trunk/docs/usermanual/functions.html?rev=1789801&r1=1789800&r2=1789801&view=diff
==============================================================================
--- jmeter/trunk/docs/usermanual/functions.html (original)
+++ jmeter/trunk/docs/usermanual/functions.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="properties_reference.html">&lt; Prev</a></li><li><a 
href="../index.html">Index</a></li><li><a href="regular_expressions.html">Next 
&gt;</a></li></ul><div class="section"><h1 id="functions">21. Functions and 
Variables<a class="sectionlink" href="#functions" title="Link to 
here">&para;</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="properties_reference.html">&lt; Prev</a></li><li><a 
href="../index.html">Index</a></li><li><a href="regular_expressions.html">Next 
&gt;</a></li></ul><div class="section"><h1 id="functions">21. Functions and 
Variables<a class="sectionlink" href="#functions" title="Link to 
here">&para;</a></h1>
 <p>
 JMeter functions are special values that can populate fields of any Sampler or 
other
 element in a test tree.  A function call looks like this:</p>
@@ -88,7 +88,7 @@ Alternatively, just use <span class="cod
         <tr><td>Calculation</td><td> <a 
href="#__UUID">UUID</a></td><td>generate a random type 4 
UUID</td><td>2.9</td></tr>
         <tr><td>Scripting</td><td> <a href="#__groovy">groovy</a></td><td>run 
a Groovy script</td><td>3.1</td></tr>
         <tr><td>Scripting</td><td> <a 
href="#__BeanShell">BeanShell</a></td><td>run a BeanShell 
script</td><td>1.X</td></tr>
-        <tr><td>Scripting</td><td> <a 
href="#__javaScript">javaScript</a></td><td>process JavaScript (Mozilla 
Rhino)</td><td>1.9</td></tr>
+        <tr><td>Scripting</td><td> <a 
href="#__javaScript">javaScript</a></td><td>process JavaScript 
(Nashorn)</td><td>1.9</td></tr>
         <tr><td>Scripting</td><td> <a 
href="#__jexl2">jexl2</a></td><td>evaluate a Commons Jexl2 
expression</td><td>jexl2(2.1.1)</td></tr>
         <tr><td>Scripting</td><td> <a 
href="#__jexl3">jexl3</a></td><td>evaluate a Commons Jexl3 
expression</td><td>jexl3 (3.0)</td></tr>
         <tr><td>Properties</td><td> <a href="#__property">property</a> 
</td><td>read a property</td><td>2.0</td></tr>
@@ -492,13 +492,18 @@ The javaScript function executes a piece
 The JMeter Javascript function calls a standalone JavaScript interpreter.
 Javascript is used as a scripting language, so you can do calculations etc.</p>
 <p>
-For details of the language, please see <a 
href="http://www.mozilla.org/rhino/overview.html";>Mozilla Rhino Overview</a>
+<div class="clear"></div><div class="note">javaScript is not the best 
scripting language for performances in JMeter. If your plan requires a high 
number of threads
+it is advised to use <span class="code">__jexl3</span> or <span 
class="code">__groovy</span> functions.
+</div><div class="clear"></div>
+
+For Nashorn Engine, please see <a 
href="https://docs.oracle.com/javase/8/docs/technotes/guides/scripting/nashorn/";>Java
 Platform, Standard Edition Nashorn User's Guide</a>.<br>
+For Rhino engine, please see <a 
href="http://www.mozilla.org/rhino/overview.html";>Mozilla Rhino Overview</a>
 </p>
 <p>
 The following variables are made available to the script:
 </p>
 <ul>
-<li><span class="code">log</span> - the <a 
href="http://excalibur.apache.org/apidocs/org/apache/log/Logger.html";>Logger</a>
 for the function</li>
+<li><span class="code">log</span> - the <a 
href="https://www.slf4j.org/api/org/slf4j/Logger.html";>Logger</a> for the 
function</li>
 <li><span class="code">ctx</span> - <a 
href="../api/org/apache/jmeter/threads/JMeterContext.html">JMeterContext</a> 
object</li>
 <li><span class="code">vars</span> - <a 
href="../api/org/apache/jmeter/threads/JMeterVariables.html">JMeterVariables</a>
 object</li>
 <li><span class="code">threadName</span> - String containing the current 
thread name</li>
@@ -508,9 +513,9 @@ The following variables are made availab
 </ul>
 <p>
 Rhinoscript allows access to static methods via its Packages object.
-See the <a href="http://www.mozilla.org/rhino/ScriptingJava.html";>Scripting 
Java</a> documentation.
+See the <a 
href="https://wiki.openjdk.java.net/display/Nashorn/Rhino+Migration+Guide";>Scripting
 Java</a> documentation.
 For example one can access the JMeterContextService static methods thus:
-<span 
class="code">Packages.org.apache.jmeter.threads.JMeterContextService.getTotalThreads()</span>
+<span 
class="code">Java.type("org.apache.jmeter.threads.JMeterContextService").getTotalThreads()</span>
 </p>
 <div class="clear"></div><div class="note">
 JMeter is not a browser, and does not interpret the JavaScript in downloaded 
pages.
@@ -774,7 +779,7 @@ sample init file in the bin directory: <
 <p>
 The following variables are set before the script is executed:
 <ul>
-<li><span class="code">log</span> - the <a 
href="http://excalibur.apache.org/apidocs/org/apache/log/Logger.html";>Logger</a>
 for the BeanShell function (*)</li>
+<li><span class="code">log</span> - the <a 
href="https://www.slf4j.org/api/org/slf4j/Logger.html";>Logger</a> for the 
BeanShell function (*)</li>
 <li><span class="code">ctx</span> - <a 
href="../api/org/apache/jmeter/threads/JMeterContext.html">JMeterContext</a> 
object</li>
 <li><span class="code">vars</span> - <a 
href="../api/org/apache/jmeter/threads/JMeterVariables.html">JMeterVariables</a>
 object</li>
 <li><span class="code">props</span> - JMeterProperties (class <a 
href="https://docs.oracle.com/javase/8/docs/api/java/util/Properties.html";><span
 class="code">java.util.Properties</span></a>) object</li>
@@ -815,7 +820,7 @@ sample init file in the <span class="cod
 The following variables are set before the script is executed:
 </p>
 <ul>
-<li><span class="code">log</span> - the <a 
href="http://excalibur.apache.org/apidocs/org/apache/log/Logger.html";>Logger</a>
 for the groovy function (*)</li>
+<li><span class="code">log</span> - the <a 
href="https://www.slf4j.org/api/org/slf4j/Logger.html";>Logger</a> for the 
groovy function (*)</li>
 <li><span class="code">ctx</span> - <a 
href="../api/org/apache/jmeter/threads/JMeterContext.html">JMeterContext</a> 
object</li>
 <li><span class="code">vars</span> - <a 
href="../api/org/apache/jmeter/threads/JMeterVariables.html">JMeterVariables</a>
 object</li>
 <li><span class="code">props</span> - JMeterProperties (class <a 
href="https://docs.oracle.com/javase/8/docs/api/java/util/Properties.html";><span
 class="code">java.util.Properties</span></a>) object</li>
@@ -974,7 +979,7 @@ The following shorthand aliases are prov
 </div><p>
 The following variables are made available to the script:
 </p><ul>
-<li><span class="code">log</span> - the <a 
href="http://excalibur.apache.org/apidocs/org/apache/log/Logger.html";>Logger</a>
 for the function</li>
+<li><span class="code">log</span> - the <a 
href="https://www.slf4j.org/api/org/slf4j/Logger.html";>Logger</a> for the 
function</li>
 <li><span class="code">ctx</span> - <a 
href="../api/org/apache/jmeter/threads/JMeterContext.html">JMeterContext</a> 
object</li>
 <li><span class="code">vars</span> - <a 
href="../api/org/apache/jmeter/threads/JMeterVariables.html">JMeterVariables</a>
 object</li>
 <li><span class="code">props</span> - JMeterProperties (class <a 
href="https://docs.oracle.com/javase/8/docs/api/java/util/Properties.html";><span
 class="code">java.util.Properties</span></a>) object</li>
@@ -1018,7 +1023,7 @@ i.intValue(); // or use i.longValue()
 </div><p>
 The following variables are made available to the script:
 </p><ul>
-<li><span class="code">log</span> - the <a 
href="http://excalibur.apache.org/apidocs/org/apache/log/Logger.html";>Logger</a>
 for the function</li>
+<li><span class="code">log</span> - the <a 
href="https://www.slf4j.org/api/org/slf4j/Logger.html";>Logger</a> for the 
function</li>
 <li><span class="code">ctx</span> - <a 
href="../api/org/apache/jmeter/threads/JMeterContext.html">JMeterContext</a> 
object</li>
 <li><span class="code">vars</span> - <a 
href="../api/org/apache/jmeter/threads/JMeterVariables.html">JMeterVariables</a>
 object</li>
 <li><span class="code">props</span> - JMeterProperties (class <a 
href="https://docs.oracle.com/javase/8/docs/api/java/util/Properties.html";><span
 class="code">java.util.Properties</span></a>) object</li>
@@ -1341,7 +1346,7 @@ They are mainly intended for use in file
       <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 &copy;
             1999 &ndash;
-            2016
+            2017
             , Apache Software Foundation
           </div><div class="trademarks">Apache, Apache JMeter, JMeter, the 
Apache
             feather, and the Apache JMeter logo are

Modified: jmeter/trunk/docs/usermanual/generating-dashboard.html
URL: 
http://svn.apache.org/viewvc/jmeter/trunk/docs/usermanual/generating-dashboard.html?rev=1789801&r1=1789800&r2=1789801&view=diff
==============================================================================
--- jmeter/trunk/docs/usermanual/generating-dashboard.html (original)
+++ jmeter/trunk/docs/usermanual/generating-dashboard.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="remote-test.html">&lt; Prev</a></li><li><a 
href="../index.html">Index</a></li><li><a href="realtime-results.html">Next 
&gt;</a></li></ul><div class="section"><h1 id="generation">15. Generating 
Report Dashboard<a class="sectionlink" href="#generation" title="Link to 
here">&para;</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="remote-test.html">&lt; Prev</a></li><li><a 
href="../index.html">Index</a></li><li><a href="realtime-results.html">Next 
&gt;</a></li></ul><div class="section"><h1 id="generation">15. Generating 
Report Dashboard<a class="sectionlink" href="#generation" title="Link to 
here">&para;</a></h1>
             <p>JMeter supports dashboard report generation to get graphs and
             statistics from a test plan.<br>
             This chapter describes how to configure and use the generator.</p>
@@ -123,9 +123,11 @@ jmeter.save.saveservice.timestamp_format
                         <div class="property"><div class="name 
req-false">date_format</div><div class="description req-false">
                             Default date format from <a 
href="http://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html";>
                             SimpleDateFormat Java API</a> with 
Locale.ENGLISH.<br>
-                            Date format is <span 
class="code">yyyyMMddHHmmss</span><br>
-                            Useful when you would generate a report after the 
load test, and the results file contains timestamp in
-                            another time zone. In this case the date format 
must include the time zone (zzz).<br>
+                            Default Date format is <span 
class="code">yyyyMMddHHmmss</span><br>
+                            Useful when you would like to generate a report 
after the load test, and the results file contains timestamp in
+                            another time zone. In this case the date format 
must include the time zone (zzz).
+                            <div class="clear"></div><div class="note">If 
<span class="code">jmeter.save.saveservice.timestamp_format</span> does not 
contain year then use 1970 as year</div><div class="clear"></div>
+                            <br>
                             Example: <span class="code">dd/MM/yyyy HH:mm:ss 
zzz</span>
                         </div><div class="required req-false">No</div></div>
                         <div class="property"><div class="name 
req-false">start_date</div><div class="description req-false">
@@ -154,6 +156,21 @@ jmeter.save.saveservice.timestamp_format
                             (in ms).<br>
                             Default: <span class="code">1500</span>
                         </div><div class="required req-false">No</div></div>
+                        <div class="property"><div class="name 
req-false">jmeter.reportgenerator.apdex_per_transaction</div><div 
class="description req-false">
+                             Sets satisfaction and tolerance threshold to 
specific samples.<br>
+                             Use sample names or regular expression.<br> 
+                             Format is <span 
class="code">sample_name:satisfaction|tolerance[;]</span><br>
+                             Values are in milliseconds.
+                             <div class="clear"></div><div class="note">
+                             Notice the colon between sample name and values, 
the pipe between thresholds and the 
+                             semicolon at the end to separate different 
samples. Don't forget to escape after
+                             semicolon to span multiple lines.
+                             </div><div class="clear"></div>
+                             Example:
+                             <pre 
class="source">jmeter.reportgenerator.apdex_per_transaction=sample(\\d+):1000|2000;\
+                                                                               
samples12:3000|4000;\
+                                                                               
    scenar01-12:5000|6000</pre>
+                        </div><div class="required req-false">No</div></div>
                         <div class="property"><div class="name 
req-false">sample_filter</div><div class="description req-false">
                             Sets the filter of samples to keep for generating
                             graphs and statistics. An empty value deactivates 
the
@@ -283,7 +300,7 @@ jmeter.save.saveservice.timestamp_format
                                 Default: <span 
class="code">true</span></div><div class="required req-false">No</div></div>
                             <div class="property"><div class="name 
req-false">series_filter</div><div class="description req-false">Sets the filter
                                 of series. An empty value deactivates the 
filtering.
-                                If not empty, regex should end with <span 
class="code">(-success|-failure)?</span><br>
+                                If not empty, regex should end with <span 
class="code">(-success|-failure)?$</span><br>
                                 Format: regular expression.
                                 Default: ""
                             </div><div class="required 
req-false">No</div></div>
@@ -519,10 +536,10 @@ jmeter.reportgenerator.apdex_tolerated_t
 
 # Indicates which graph series are filtered (regular expression)
 # In the below example we filter on Search and Order samples
-# Note that the end of the pattern should always include (-success|-failure)? 
+# Note that the end of the pattern should always include (-success|-failure)?$
 # Transactions per second suffixes Transactions with "-success" or "-failure" 
depending 
 # on the result
-#jmeter.reportgenerator.exporter.html.series_filter=((^Search)|(^Order))(-success|-failure)?
+#jmeter.reportgenerator.exporter.html.series_filter=^(Search|Order)(-success|-failure)?$
 
 # Indicates whether series filter apply only on sample series
 jmeter.reportgenerator.exporter.html.filters_only_sample_series=true
@@ -700,7 +717,7 @@ jmeter.reportgenerator.exporter.html.fil
       <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 &copy;
             1999 &ndash;
-            2016
+            2017
             , Apache Software Foundation
           </div><div class="trademarks">Apache, Apache JMeter, JMeter, the 
Apache
             feather, and the Apache JMeter logo are

Modified: jmeter/trunk/docs/usermanual/get-started.html
URL: 
http://svn.apache.org/viewvc/jmeter/trunk/docs/usermanual/get-started.html?rev=1789801&r1=1789800&r2=1789801&view=diff
==============================================================================
--- jmeter/trunk/docs/usermanual/get-started.html (original)
+++ jmeter/trunk/docs/usermanual/get-started.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="build-test-plan.html">Next 
&gt;</a></li></ul><div class="section"><h1 id="get_started">1. Getting 
Started<a class="sectionlink" href="#get_started" title="Link to 
here">&para;</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="build-test-plan.html">Next 
&gt;</a></li></ul><div class="section"><h1 id="get_started">1. Getting 
Started<a class="sectionlink" href="#get_started" title="Link to 
here">&para;</a></h1>
 <div class="section"><h1 id="overview">1.0 Overview<a class="sectionlink" 
href="#overview" title="Link to here">&para;</a></h1>
 When using JMeter you will usually follow this process:
 <div class="subsection"><h2 id="test_plan_building">1.0.1 Test plan building<a 
class="sectionlink" href="#test_plan_building" title="Link to 
here">&para;</a></h2>
@@ -89,8 +89,8 @@ over your Test Plans.</p>
 <p>JMeter requires that your computing environment meets some minimum 
requirements.</p>
 
 <div class="subsection"><h2 id="java_versions">1.1.1 Java Version<a 
class="sectionlink" href="#java_versions" title="Link to here">&para;</a></h2>
-<div class="clear"></div><div class="note">JMeter requires a fully compliant 
JVM 7 or 8, we advise that you install latest minor version of those major 
versions.
-Java 9 is not tested completely as of JMeter 3.1.
+<div class="clear"></div><div class="note">JMeter requires a fully compliant 
JVM 8, we advise that you install latest minor version of those major versions.
+Java 9 is not tested completely as of JMeter 3.2.
 </div><div class="clear"></div>
 <p>Because JMeter uses only standard Java APIs, please do not file bug reports 
if your JRE fails to run
 JMeter because of JRE implementation issues.</p>
@@ -109,7 +109,7 @@ on JMeter wiki.</p>
 
 
 <div class="subsection"><h2 id="opt_compiler">1.2.1 Java Compiler<a 
class="sectionlink" href="#opt_compiler" title="Link to here">&para;</a></h2>
-<p>If you want to build the JMeter source or develop JMeter plugins, then you 
will need a fully compliant JDK 7 or higher.</p>
+<p>If you want to build the JMeter source or develop JMeter plugins, then you 
will need a fully compliant JDK 8 or higher.</p>
 </div>
 
 <div class="subsection"><h2 id="opt_sax">1.2.2 SAX XML Parser<a 
class="sectionlink" href="#opt_sax" title="Link to here">&para;</a></h2>
@@ -166,9 +166,6 @@ There may also be some information on th
 You will need to add the jar <span class="code">activemq-all-X.X.X.jar</span> 
to your classpath, e.g. by storing it in the <span class="code">lib/</span> 
directory.
 </p>
 <p>
-The other required jars (such as commons-logging) are already included with 
JMeter.
-</p>
-<p>
 See <a href="http://activemq.apache.org/initial-configuration.html";>ActiveMQ 
initial configuration page</a>
 for details.
 </p>
@@ -408,7 +405,7 @@ Normally this is not necessary.
 </div>
 
 <div class="subsection"><h2 id="override">1.4.6 Overriding Properties Via The 
Command Line<a class="sectionlink" href="#override" title="Link to 
here">&para;</a></h2>
-<p>Java system properties, JMeter properties, and logging properties can be 
overridden directly on the command line
+<p>Java system properties and JMeter properties can be overridden directly on 
the command lin
 (instead of modifying <span class="code">jmeter.properties</span>).
 To do so, use the following options:</p>
 <dl>
@@ -428,17 +425,179 @@ jmeter -Duser.dir=/home/mstover/jmeter_s
 <pre class="source">jmeter -LDEBUG</pre>
 <div class="clear"></div><div class="note">
     The command line properties are processed early in startup, but after the 
logging system has been set up.
-    Attempts to use the <span class="code">-J</span> flag to update <span 
class="code">log_level</span> or <span class="code">log_file</span> properties 
will have no effect.
-    </div><div class="clear"></div>
+</div><div class="clear"></div>
 </div>
 <div class="subsection"><h2 id="logging">1.4.7 Logging and error messages<a 
class="sectionlink" href="#logging" title="Link to here">&para;</a></h2>
     <div class="clear"></div><div class="note">
+    Since 3.2, JMeter logging is not configured through properties file(s) 
such as <span class="code">jmeter.properties</span> any more,
+    but it is configured through a <a 
href="http://logging.apache.org/log4j/2.x/"; target="_blank">Apache Log4j 2</a> 
configuration file
+    (<span class="code">log4j2.xml</span> in the directory from which JMeter 
was launched, by default) instead.
+    Also, every code including JMeter and plugins MUST use <a 
href="https://www.slf4j.org/"; target="_blank">SLF4J</a> library
+    to leave logs since 3.2.
+    </div><div class="clear"></div>
+    <p>
+        Here is an example <span class="code">log4j2.xml</span> file which 
defines two log appenders and loggers for each category.
+    </p>
+<pre class="source">&lt;Configuration status="WARN" 
packages="org.apache.jmeter.gui.logging"&gt;
+
+  &lt;Appenders&gt;
+
+    &lt;!-- The main log file appender to jmeter.log in the directory from 
which JMeter was launched, by default. --&gt;
+    &lt;File name="jmeter-log" fileName="${sys:jmeter.logfile:-jmeter.log}" 
append="false"&gt;
+      &lt;PatternLayout&gt;
+        &lt;pattern&gt;%d %p %c{1.}: %m%n&lt;/pattern&gt;
+      &lt;/PatternLayout&gt;
+    &lt;/File&gt;
+
+    &lt;!-- Log appender for GUI Log Viewer. See below. --&gt;
+    &lt;GuiLogEvent name="gui-log-event"&gt;
+      &lt;PatternLayout&gt;
+        &lt;pattern&gt;%d %p %c{1.}: %m%n&lt;/pattern&gt;
+      &lt;/PatternLayout&gt;
+    &lt;/GuiLogEvent&gt;
+
+  &lt;/Appenders&gt;
+
+  &lt;Loggers&gt;
+
+    &lt;!-- Root logger --&gt;
+    &lt;Root level="info"&gt;
+      &lt;AppenderRef ref="jmeter-log" /&gt;
+      &lt;AppenderRef ref="gui-log-event" /&gt;
+    &lt;/Root&gt;
+
+    &lt;!-- SNIP --&gt;
+
+    &lt;!--
+      # Apache HttpClient logging examples
+    --&gt;
+    &lt;!-- # Enable header wire + context logging - Best for Debugging --&gt;
+    &lt;!--
+    &lt;Logger name="org.apache.http" level="debug" /&gt;
+    &lt;Logger name="org.apache.http.wire" level="error" /&gt;
+    --&gt;
+
+    &lt;!-- SNIP --&gt;
+
+  &lt;/Loggers&gt;
+
+&lt;/Configuration&gt;</pre>
+    <p>
+        So, if you want to change the log level for <span 
class="code">org.apache.http</span> category to debug level for instance,
+        you can simply add (or uncomment) the following logger element in 
<span class="code">log4j2.xml</span> file before launching JMeter.
+    </p>
+<pre class="source">  &lt;Loggers&gt;
+    &lt;!-- SNIP --&gt;
+    &lt;Logger name="org.apache.http" level="debug" /&gt;
+    &lt;!-- SNIP --&gt;
+  &lt;/Loggers&gt;</pre>
+    <p>
+        For more detail on how to configure <span 
class="code">log4j2.xml</span> file,
+        please see <a 
href="http://logging.apache.org/log4j/2.x/manual/configuration.html"; 
target="_blank">Apache Log4j 2 Configuration</a> page.
+    </p>
+    <p>
+        Log level for specific categories or root logger can be overridden 
directly on the command line (instead of modifying <span 
class="code">log4j2.xml</span>) as well.
+        To do so, use the following options:
+    </p>
+    <dl>
+        <dt>
+            <span class="code">-L[category]=[priority]</span>
+        </dt>
+        <dd>
+            Overrides a logging setting, setting a particular category to the 
given priority level.
+            Since 3.2, it is recommended to use a full category name (e.g, 
<span class="code">org.apache.jmeter</span> or <span 
class="code">com.example.foo</span>),
+            but if the category name starts with either <span 
class="code">jmeter</span> or <span class="code">jorphan</span>, <span 
class="code">org.apache.</span>
+            will be prepended internally to the category name input to 
construct a full category name (i.e, <span 
class="code">org.apache.jmeter</span> or <span 
class="code">org.apache.jorphan</span>) for backward compatibility.
+        </dd>
+    </dl>
+    <p>
+        <b>Examples</b>:
+    </p>
+    <pre class="source">jmeter -Ljmeter.engine=DEBUG</pre>
+    <pre class="source">jmeter -Lorg.apache.jmeter.engine=DEBUG</pre>
+    <pre class="source">jmeter -Lcom.example.foo=DEBUG</pre>
+    <pre class="source">jmeter -LDEBUG</pre>
+
+    <p>
+        <b>Differences in Logging : Old vs New Practices</b>:
+    </p>
+    <p>
+      As JMeter uses SLF4J as logging API and Apache Log4j 2 as a logging 
framework since 3.2, not every log level
+      used before 3.2 can match exactly with one of the new available log 
levels provided by SLF4J/Log4j2.
+      Therefore, please keep the following differences and new suggested 
practices in mind
+      if you need to migrate any existing logging configruations and logging 
code.
+    </p>
+    <table>
+      <thead>
+        <tr>
+          <th>Category</th>
+          <th>Old Practices Before 3.2</th>
+          <th>New Practices Since 3.2</th>
+        </tr>
+      </thead>
+      <tbody>
+        <tr>
+          <td>
+            Logger Reference
+          </td>
+          <td>
+            Logger reference through <span class="code">LoggingManager</span>:
+            <pre class="source">LoggingManager.getLoggerFor(String category);
+LoggingManager.getLoggerForClass();</pre>
+          </td>
+          <td>
+            Use SLF4J API with either category or explicit class:
+            <pre class="source">LoggerFactory.getLogger(String category);
+LoggerFactory.getLogger(Foo.class);</pre>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            Log Levels in Configuration or Command Line Arguments
+          </td>
+          <td>
+            Old Log Levels:
+            <ul>
+              <li>DEBUG</li>
+              <li>INFO</li>
+              <li>WARN</li>
+              <li>ERROR</li>
+              <li>FATAL_ERROR</li>
+              <li>NONE</li>
+            </ul>
+          </td>
+          <td>
+            Mapping to New Levels through SLF4J/Log4j2:
+            <ul>
+              <li>DEBUG</li>
+              <li>INFO</li>
+              <li>WARN</li>
+              <li>ERROR</li>
+              <li>ERROR</li>
+              <li>NONE</li>
+            </ul>
+            <div>
+              <em><b>Note:</b></em>
+              Since 'FATAL_ERROR' is not supported by SLF4J API,
+              it is treated as 'ERROR' instead for existing code not to break.
+            </div>
+            <div>
+              <em><b>Note:</b></em>
+              'TRACE' level, which is less specific than 'DEBUG', is supported 
additionally since 3.2.
+              Look up SLF4J or Apache Log4J 2 documentations for details.
+            </div>
+          </td>
+        </tr>
+      </tbody>
+    </table>
+
+    <div class="clear"></div><div class="note">
     JMeter does not generally use pop-up dialog boxes for errors, as these 
would interfere with
     running tests. Nor does it report any error for a mis-spelt variable or 
function; instead the
     reference is just used as is. See <a href="functions.html">Functions and 
Variables for more information</a>.
     </div><div class="clear"></div>
     <p>If JMeter detects an error during a test, a message will be written to 
the log file.
-        The log file name is defined in the <span 
class="code">jmeter.properties</span> file (or using the <span 
class="code">-j</span> option, see below).
+        The log file name is defined in the <span 
class="code">log4j2.xml</span> file (or using the <span class="code">-j</span> 
option, see below).
         It defaults to <span class="code">jmeter.log</span>, and will be found 
in the directory from which JMeter was launched.
         </p>
         <p>
@@ -463,14 +622,14 @@ jmeter -Duser.dir=/home/mstover/jmeter_s
         </p>
         <p>As well as recording errors, the <span 
class="code">jmeter.log</span> file records some information about the test 
run. For example:</p>
 <pre class="source">
-10/17/2003 12:19:20 PM INFO  - jmeter.JMeter: Version 1.9.20031002 
-10/17/2003 12:19:45 PM INFO  - jmeter.gui.action.Load: Loading file: 
c:\mytestfiles\BSH.jmx 
-10/17/2003 12:19:52 PM INFO  - jmeter.engine.StandardJMeterEngine: Running the 
test! 
-10/17/2003 12:19:52 PM INFO  - jmeter.engine.StandardJMeterEngine: Starting 1 
threads for group BSH. Ramp up = 1. 
-10/17/2003 12:19:52 PM INFO  - jmeter.engine.StandardJMeterEngine: Continue on 
error 
-10/17/2003 12:19:52 PM INFO  - jmeter.threads.JMeterThread: Thread BSH1-1 
started 
-10/17/2003 12:19:52 PM INFO  - jmeter.threads.JMeterThread: Thread BSH1-1 is 
done 
-10/17/2003 12:19:52 PM INFO  - jmeter.engine.StandardJMeterEngine: Test has 
ended
+2017-03-01 12:19:20,314 INFO o.a.j.JMeter: Version 3.2.20170301
+2017-03-01 12:19:45,314 INFO o.a.j.g.a.Load: Loading file: 
c:\mytestfiles\BSH.jmx 
+2017-03-01 12:19:52,328 INFO o.a.j.e.StandardJMeterEngine: Running the test! 
+2017-03-01 12:19:52,384 INFO o.a.j.e.StandardJMeterEngine: Starting 1 threads 
for group BSH. Ramp up = 1. 
+2017-03-01 12:19:52,485 INFO o.a.j.e.StandardJMeterEngine: Continue on error 
+2017-03-01 12:19:52,589 INFO o.a.j.t.JMeterThread: Thread BSH1-1 started 
+2017-03-01 12:19:52,590 INFO o.a.j.t.JMeterThread: Thread BSH1-1 is done 
+2017-03-01 12:19:52,691 INFO o.a.j.e.StandardJMeterEngine: Test has ended
 </pre>
 <p>The log file can be helpful in determining the cause of an error,
     as JMeter does not interrupt a test to display an error dialogue.</p>
@@ -479,6 +638,8 @@ jmeter -Duser.dir=/home/mstover/jmeter_s
 <p>Invoking JMeter as "<span class="code">jmeter -?</span>" will print a list 
of all the command-line options. 
 These are shown below.</p>
 <pre class="source">
+    --?
+        print command line options and exit
     -h, --help
         print usage information and exit
     -v, --version
@@ -491,6 +652,8 @@ These are shown below.</p>
         the jmeter test(.jmx) file to run
     -l, --logfile &lt;argument&gt;
         the file to log samples to
+    -i, --jmeterlogconf &lt;argument&gt;
+        jmeter logging configuration file (log4j2.xml)
     -j, --jmeterlogfile &lt;argument&gt;
         jmeter run log file (jmeter.log)
     -n, --nongui
@@ -517,8 +680,10 @@ These are shown below.</p>
         Define additional system properties
     -S, --systemPropertyFile &lt;argument&gt;
         additional system property file(s)
+    -f, --forceDeleteResultFile
+        force delete existing results files before start the test
     -L, --loglevel &lt;argument&gt;=&lt;value&gt;
-        [category=]level e.g. jorphan=INFO or jmeter.util=DEBUG
+        [category=]level e.g. jorphan=INFO, jmeter.util=DEBUG or 
com.example.foo=WARN
     -r, --runremote
         Start remote servers (as defined in remote_hosts)
     -R, --remotestart &lt;argument&gt;
@@ -528,10 +693,10 @@ These are shown below.</p>
     -X, --remoteexit
         Exit the remote servers at end of test (non-GUI)
     -g, --reportonly &lt;argument&gt;
-        generate report dashboard only
+        generate report dashboard only, from a test results file
     -e, --reportatendofloadtests
         generate report dashboard after load test
-    -o, --reportoutputfolder
+    -o, --reportoutputfolder &lt;argument&gt;
         output folder for report dashboard
 </pre>
 <p>
@@ -667,7 +832,7 @@ See also the comments in the <span class
       <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 &copy;
             1999 &ndash;
-            2016
+            2017
             , Apache Software Foundation
           </div><div class="trademarks">Apache, Apache JMeter, JMeter, the 
Apache
             feather, and the Apache JMeter logo are

Modified: jmeter/trunk/docs/usermanual/glossary.html
URL: 
http://svn.apache.org/viewvc/jmeter/trunk/docs/usermanual/glossary.html?rev=1789801&r1=1789800&r2=1789801&view=diff
==============================================================================
--- jmeter/trunk/docs/usermanual/glossary.html (original)
+++ jmeter/trunk/docs/usermanual/glossary.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="hints_and_tips.html">&lt; Prev</a></li><li><a 
href="../index.html">Index</a></li><li><a href="history_future.html">Next 
&gt;</a></li></ul><div class="section"><h1 id="glossary">24. Glossary<a 
class="sectionlink" href="#glossary" title="Link to here">&para;</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="hints_and_tips.html">&lt; Prev</a></li><li><a 
href="../index.html">Index</a></li><li><a href="history_future.html">Next 
&gt;</a></li></ul><div class="section"><h1 id="glossary">24. Glossary<a 
class="sectionlink" href="#glossary" title="Link to here">&para;</a></h1>
 
 <p>
 <a name="Elapsed"><b>Elapsed time</b></a>. JMeter measures the elapsed time 
from just before sending the request to
@@ -87,7 +87,7 @@ The formula is: Throughput = (number of
       <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 &copy;
             1999 &ndash;
-            2016
+            2017
             , Apache Software Foundation
           </div><div class="trademarks">Apache, Apache JMeter, JMeter, the 
Apache
             feather, and the Apache JMeter logo are

Modified: jmeter/trunk/docs/usermanual/hints_and_tips.html
URL: 
http://svn.apache.org/viewvc/jmeter/trunk/docs/usermanual/hints_and_tips.html?rev=1789801&r1=1789800&r2=1789801&view=diff
==============================================================================
--- jmeter/trunk/docs/usermanual/hints_and_tips.html (original)
+++ jmeter/trunk/docs/usermanual/hints_and_tips.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="regular_expressions.html">&lt; Prev</a></li><li><a 
href="../index.html">Index</a></li><li><a href="glossary.html">Next 
&gt;</a></li></ul><div class="section"><h1 id="hints">23. Hints and Tips<a 
class="sectionlink" href="#hints" title="Link to here">&para;</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="regular_expressions.html">&lt; Prev</a></li><li><a 
href="../index.html">Index</a></li><li><a href="glossary.html">Next 
&gt;</a></li></ul><div class="section"><h1 id="hints">23. Hints and Tips<a 
class="sectionlink" href="#hints" title="Link to here">&para;</a></h1>
 <p>
 This section is a collection of various hints and tips that have been 
suggested by various questions on the JMeter User list.
 If you don't find what you are looking for here, please check the <a 
href="http://wiki.apache.org/jmeter";>JMeter Wiki</a>.
@@ -201,7 +201,7 @@ will match any component that contains t
       <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 &copy;
             1999 &ndash;
-            2016
+            2017
             , Apache Software Foundation
           </div><div class="trademarks">Apache, Apache JMeter, JMeter, the 
Apache
             feather, and the Apache JMeter logo are

Modified: jmeter/trunk/docs/usermanual/history_future.html
URL: 
http://svn.apache.org/viewvc/jmeter/trunk/docs/usermanual/history_future.html?rev=1789801&r1=1789800&r2=1789801&view=diff
==============================================================================
--- jmeter/trunk/docs/usermanual/history_future.html (original)
+++ jmeter/trunk/docs/usermanual/history_future.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="glossary.html">&lt; Prev</a></li><li><a 
href="../index.html">Index</a></li></ul><div class="section"><h1 
id="history_future">25. History and Future<a class="sectionlink" 
href="#history_future" title="Link to here">&para;</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="glossary.html">&lt; Prev</a></li><li><a 
href="../index.html">Index</a></li></ul><div class="section"><h1 
id="history_future">25. History and Future<a class="sectionlink" 
href="#history_future" title="Link to here">&para;</a></h1>
 <div class="subsection"><h2 id="history">25.1 History<a class="sectionlink" 
href="#history" title="Link to here">&para;</a></h2>
 <p>Stefano Mazzocchi of the Apache Software Foundation was the original 
developer of JMeter.
 He wrote it primarily to test the performance of Apache JServ (a project that 
has
@@ -21,13 +21,13 @@ and to add functional-testing capabiliti
 pluggable architecture. <br>
 The primary goal of further developments will be:
 <ul>
-<li>Addition of Websocket protocol</li>
-<li>Addition of FTPS and SFTP protocols</li>
-<li>Enhancements to Webservices protocols (SOAP Attachments)</li>
+<li>Support of HTTP/2 protocol</li>
+<li>Possible rework of core architecture to introduce a pool of threads or 
switch to async model allowing us to take advantage of async io</li>
+<li>Enhancements to Webservices protocols (REST / SOAP)</li>
 <li>Enhancements to JMS protocol implementation</li>
 <li>&hellip;</li>
 </ul>
-
+<div class="clear"></div><div class="note">You can help us by contributing to 
JMeter through any piece of work, read <a href="../building.html">this 
document</a></div><div class="clear"></div>
 </p>
 </div>
 </div><ul class="pagelinks"><li><a href="glossary.html">&lt; 
Prev</a></li><li><a href="../index.html">Index</a></li></ul><div 
class="share-links">
@@ -35,7 +35,7 @@ The primary goal of further developments
       <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 &copy;
             1999 &ndash;
-            2016
+            2017
             , Apache Software Foundation
           </div><div class="trademarks">Apache, Apache JMeter, JMeter, the 
Apache
             feather, and the Apache JMeter logo are


Reply via email to