You are viewing a plain text version of this content. The canonical link for it is here.
Posted to jmeter-dev@jakarta.apache.org by se...@apache.org on 2009/05/10 00:57:48 UTC
svn commit: r773282 [12/16] - in /jakarta/jmeter/trunk/docs: ./ localising/
usermanual/
Modified: jakarta/jmeter/trunk/docs/usermanual/get-started.html
URL: http://svn.apache.org/viewvc/jakarta/jmeter/trunk/docs/usermanual/get-started.html?rev=773282&r1=773281&r2=773282&view=diff
==============================================================================
--- jakarta/jmeter/trunk/docs/usermanual/get-started.html (original)
+++ jakarta/jmeter/trunk/docs/usermanual/get-started.html Sat May 9 22:57:45 2009
@@ -18,28 +18,28 @@
<!-- Content Stylesheet for Site -->
-
+
<!-- start the processing -->
- <!-- ====================================================================== -->
- <!-- Main Page Section -->
- <!-- ====================================================================== -->
- <html>
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
-
-
-
- <title>JMeter - User's Manual: Getting Started</title>
- </head>
-
- <body bgcolor="#ffffff" text="#000000" link="#525D76">
- <table border="0" cellspacing="0">
- <!-- TOP IMAGE -->
- <tr>
- <td>
+<!-- ====================================================================== -->
+<!-- Main Page Section -->
+<!-- ====================================================================== -->
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
+
+
+
+<title>JMeter - User's Manual: Getting Started</title>
+</head>
+
+<body bgcolor="#ffffff" text="#000000" link="#525D76">
+<table border="0" cellspacing="0">
+<!-- TOP IMAGE -->
+<tr>
+<td>
<!-- Need to specify height otherwise iframe seems to grab extra -->
<iframe src="http://www.apache.org/ads/halfbanner.html" height="102"
- style="border-width:0; float: left" frameborder="0" scrolling="no"></iframe>
+style="border-width:0; float: left" frameborder="0" scrolling="no"></iframe>
</td>
<td align="left">
<a href="http://jakarta.apache.org"><img width="505" height="48" src="../images/jakarta-logo.gif" alt="Jakarta" title="Jakarta" border="0"/></a>
@@ -47,612 +47,610 @@
<td align="right">
<a href="http://jakarta.apache.org/jmeter/"><img width="221" height="102" src="../images/logo.jpg" alt="JMeter" title="JMeter" border="0"/></a>
</td>
- </tr>
- </table>
- <table border="0" width="100%" cellspacing="4">
- <tr><td colspan="2">
- <hr noshade size="1"/>
- </td></tr>
-
- <tr>
- <!-- LEFT SIDE NAVIGATION -->
- <td width="20%" valign="top" nowrap="true">
- <p><strong>About</strong></p>
- <ul>
- <li> <a href="../index.html">Overview</a>
-</li>
- <li> <a href="../changes.html">Changes</a>
-</li>
- <li> <a href="../known_bugs.html">Known Bugs</a>
-</li>
- <li> <a href="../license.html">License</a>
-</li>
- <li> <a href="http://wiki.apache.org/jakarta-jmeter/JMeterCommitters">Contributors</a>
-</li>
- </ul>
- <p><strong>Download</strong></p>
- <ul>
- <li> <a href="http://jakarta.apache.org/site/downloads/downloads_jmeter.cgi">Download Releases</a>
-</li>
- <li> <a href="../nightly.html">Developer (Nightly) Builds</a>
-</li>
- </ul>
- <p><strong>Documentation</strong></p>
- <ul>
- <li> <a href="../usermanual/index.html">User Manual</a>
-</li>
- <li> <a href="../api/index.html">Javadocs</a>
-</li>
- <li> <a href="../localising/index.html">Localisation (Translator's Guide)</a>
-</li>
- <li> <a href="../building.html">Building JMeter and Add-Ons</a>
-</li>
- <li> <a href="http://wiki.apache.org/jakarta-jmeter">JMeter Wiki</a>
-</li>
- <li> <a href="http://wiki.apache.org/jakarta-jmeter/JMeterFAQ">FAQ (Wiki)</a>
-</li>
- </ul>
- <p><strong>Tutorials (PDF format)</strong></p>
- <ul>
- <li> <a href="../usermanual/jmeter_distributed_testing_step_by_step.pdf">Distributed Testing</a>
-</li>
- <li> <a href="../usermanual/jmeter_proxy_step_by_step.pdf">Recording Tests</a>
-</li>
- <li> <a href="../usermanual/junitsampler_tutorial.pdf">JUnit Sampler</a>
-</li>
- <li> <a href="../usermanual/jmeter_accesslog_sampler_step_by_step.pdf">Access Log Sampler</a>
-</li>
- <li> <a href="../extending/jmeter_tutorial.pdf">Extending JMeter</a>
-</li>
- </ul>
- <p><strong>Community</strong></p>
- <ul>
- <li> <a href="http://jakarta.apache.org/site/getinvolved.html">Get Involved</a>
-</li>
- <li> <a href="http://jakarta.apache.org/site/mail.html">Mailing Lists</a>
-</li>
- <li> <a href="http://jakarta.apache.org/site/cvsindex.html">SVN Repositories</a>
-</li>
- </ul>
- </td>
- <td width="80%" align="left" valign="top">
- <table>
- <tr>
- <td bgcolor="#525D76">
- <div align="right"><a href="index.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Index</font></a></div>
- </td>
- <td bgcolor="#525D76">
- <div align="right"><a href="build-test-plan.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Next</font></a></div>
- </td>
- <td bgcolor="#525D76">
- <div align="right"><a href="intro.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Prev</font></a></div>
- </td>
- </tr>
- </table>
- <br>
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#525D76">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="get_started"><strong>2. Getting Started</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
- The easiest way to begin using JMeter is to first
-
- <a href="http://jakarta.apache.org/site/downloads/index.html">
- download the latest production release
- </a>
- and install it.
+</tr>
+</table>
+<table border="0" width="100%" cellspacing="4">
+<tr><td colspan="2">
+<hr noshade size="1"/>
+</td></tr>
+<tr>
+<!-- LEFT SIDE NAVIGATION -->
+<td width="20%" valign="top" nowrap="true">
+<p><strong>About</strong></p>
+<ul>
+<li><a href="../index.html">Overview</a>
+</li>
+<li><a href="../changes.html">Changes</a>
+</li>
+<li><a href="../known_bugs.html">Known Bugs</a>
+</li>
+<li><a href="../license.html">License</a>
+</li>
+<li><a href="http://wiki.apache.org/jakarta-jmeter/JMeterCommitters">Contributors</a>
+</li>
+</ul>
+<p><strong>Download</strong></p>
+<ul>
+<li><a href="http://jakarta.apache.org/site/downloads/downloads_jmeter.cgi">Download Releases</a>
+</li>
+<li><a href="../nightly.html">Developer (Nightly) Builds</a>
+</li>
+</ul>
+<p><strong>Documentation</strong></p>
+<ul>
+<li><a href="../usermanual/index.html">User Manual</a>
+</li>
+<li><a href="../api/index.html">Javadocs</a>
+</li>
+<li><a href="../localising/index.html">Localisation (Translator's Guide)</a>
+</li>
+<li><a href="../building.html">Building JMeter and Add-Ons</a>
+</li>
+<li><a href="http://wiki.apache.org/jakarta-jmeter">JMeter Wiki</a>
+</li>
+<li><a href="http://wiki.apache.org/jakarta-jmeter/JMeterFAQ">FAQ (Wiki)</a>
+</li>
+</ul>
+<p><strong>Tutorials (PDF format)</strong></p>
+<ul>
+<li><a href="../usermanual/jmeter_distributed_testing_step_by_step.pdf">Distributed Testing</a>
+</li>
+<li><a href="../usermanual/jmeter_proxy_step_by_step.pdf">Recording Tests</a>
+</li>
+<li><a href="../usermanual/junitsampler_tutorial.pdf">JUnit Sampler</a>
+</li>
+<li><a href="../usermanual/jmeter_accesslog_sampler_step_by_step.pdf">Access Log Sampler</a>
+</li>
+<li><a href="../extending/jmeter_tutorial.pdf">Extending JMeter</a>
+</li>
+</ul>
+<p><strong>Community</strong></p>
+<ul>
+<li><a href="http://jakarta.apache.org/site/getinvolved.html">Get Involved</a>
+</li>
+<li><a href="http://jakarta.apache.org/site/mail.html">Mailing Lists</a>
+</li>
+<li><a href="http://jakarta.apache.org/site/cvsindex.html">SVN Repositories</a>
+</li>
+</ul>
+</td>
+<td width="80%" align="left" valign="top">
+<table>
+<tr>
+<td bgcolor="#525D76">
+<div align="right"><a href="index.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Index</font></a></div>
+</td>
+<td bgcolor="#525D76">
+<div align="right"><a href="build-test-plan.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Next</font></a></div>
+</td>
+<td bgcolor="#525D76">
+<div align="right"><a href="intro.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Prev</font></a></div>
+</td>
+</tr>
+</table>
+<br>
+<table border="0" cellspacing="0" cellpadding="2" width="100%">
+<tr><td bgcolor="#525D76">
+<font color="#ffffff" face="arial,helvetica,sanserif">
+<a name="get_started"><strong>2. Getting Started</strong></a>
+</font>
+</td></tr>
+<tr><td>
+<blockquote>
+<p>
+The easiest way to begin using JMeter is to first
+
+<a href="http://jakarta.apache.org/site/downloads/index.html">
+download the latest production release
+</a>
+ and install it.
The release contains all of the files you need to build and run most types of tests,
e.g. Web (HTTP/HTTPS), FTP, JDBC, LDAP, Java, and JUnit.
- </p>
- <p >
- If you want to perform JDBC testing,
+</p>
+<p>
+If you want to perform JDBC testing,
then you will, of course, need the appropriate JDBC driver from your vendor. JMeter does not come with
any JDBC drivers.
- </p>
- <p >
-
+</p>
+<p>
+
Other software that you may need to download:
- <ul >
-
+<ul>
+
+
+<li>
+<a href="http://www.beanshell.org/">
+BeanShell
+</a>
+ - needed for the BeanShell function and test elements
+</li>
+
+
+<li>
+<a href="http://java.sun.com/products/javabeans/glasgow/jaf.html">
+Java Activation Framework
+</a>
+ - needed for JavaMail
+</li>
+
+
+<li>
+<a href="http://java.sun.com/products/javamail/index.jsp">
+Java Mail
+</a>
+ - needed for Mail Visualiser, Mail Reader and WebService(SOAP) sampler
+</li>
+
+
+<li>
+<a href="http://java.sun.com/products/jms/docs.html">
+JMS
+</a>
+ - for JMS samplers
+</li>
- <li >
- <a href="http://www.beanshell.org/">
- BeanShell
- </a>
- - needed for the BeanShell function and test elements
- </li>
-
-
- <li >
- <a href="http://java.sun.com/products/javabeans/glasgow/jaf.html">
- Java Activation Framework
- </a>
- - needed for JavaMail
- </li>
-
-
- <li >
- <a href="http://java.sun.com/products/javamail/index.jsp">
- Java Mail
- </a>
- - needed for Mail Visualiser, Mail Reader and WebService(SOAP) sampler
- </li>
-
-
- <li >
- <a href="http://java.sun.com/products/jms/docs.html">
- JMS
- </a>
- - for JMS samplers
- </li>
-
-
- <li >
- <a href="http://java.sun.com/downloads/">
- General Java download page
- </a>
- </li>
-
-
- </ul>
-
-
- </p>
- <p><table border="1" bgcolor="#bbbb00" width="50%" cellspacing="0" cellpadding="2">
- <tr><td>
+
+</ul>
+
+
+</p>
+<p>
+<table border="1" bgcolor="#bbbb00" width="50%" cellspacing="0" cellpadding="2">
+<tr><td>
See the
- <a href="#classpath">
- JMeter Classpath
- </a>
- section for details on installing additional jars.
-
- </td></tr>
- </table></p>
- <p >
- Next, start JMeter and go through the
- <a href="build-test-plan.html">
- Building a Test Plan
- </a>
- section
+<a href="#classpath">
+JMeter Classpath
+</a>
+ section for details on installing additional jars.
+
+</td></tr>
+</table>
+</p>
+<p>
+Next, start JMeter and go through the
+<a href="build-test-plan.html">
+Building a Test Plan
+</a>
+ section
of the User Guide to familiarize yourself with JMeter basics (for example, adding and removing elements).
- </p>
- <p >
- Finally, go through the appropriate section on how to build a specific type of Test Plan.
+</p>
+<p>
+Finally, go through the appropriate section on how to build a specific type of Test Plan.
For example, if you are interested in testing a Web application, then see the section
- <a href="build-web-test-plan.html">
- Building a Web Test Plan
- </a>
- .
+<a href="build-web-test-plan.html">
+Building a Web Test Plan
+</a>
+.
The other specific Test Plan sections are:
- <ul >
-
+<ul>
+
+
+<li>
+<a href="build-adv-web-test-plan.html">
+Advanced Web Test Plan
+</a>
+</li>
+
+
+<li>
+<a href="build-db-test-plan.html">
+JDBC
+</a>
+</li>
+
+
+<li>
+<a href="build-ftp-test-plan.html">
+FTP
+</a>
+</li>
+
- <li >
- <a href="build-adv-web-test-plan.html">
- Advanced Web Test Plan
- </a>
- </li>
-
-
- <li >
- <a href="build-db-test-plan.html">
- JDBC
- </a>
- </li>
-
-
- <li >
- <a href="build-ftp-test-plan.html">
- FTP
- </a>
- </li>
-
-
- <li >
- <a href="build-jms-point-to-point-test-plan.html">
- JMS Point-to-Point
- </a>
- </li>
-
-
- <li >
- <a href="build-jms-topic-test-plan.html">
- JMS Topic
- </a>
- </li>
-
-
- <li >
- <a href="build-ldap-test-plan.html">
- LDAP
- </a>
- </li>
-
-
- <li >
- <a href="build-ldapext-test-plan.html">
- LDAP Extended
- </a>
- </li>
-
-
- <li >
- <a href="build-ws-test-plan.html">
- WebServices (SOAP)
- </a>
- </li>
-
-
- <li >
- </li>
-
-
- </ul>
-
-
- </p>
- <p >
- Once you are comfortable with building and running JMeter Test Plans, you can look into the
+<li>
+<a href="build-jms-point-to-point-test-plan.html">
+JMS Point-to-Point
+</a>
+</li>
+
+
+<li>
+<a href="build-jms-topic-test-plan.html">
+JMS Topic
+</a>
+</li>
+
+
+<li>
+<a href="build-ldap-test-plan.html">
+LDAP
+</a>
+</li>
+
+
+<li>
+<a href="build-ldapext-test-plan.html">
+LDAP Extended
+</a>
+</li>
+
+
+<li>
+<a href="build-ws-test-plan.html">
+WebServices (SOAP)
+</a>
+</li>
+
+
+<li>
+</li>
+
+
+</ul>
+
+
+</p>
+<p>
+Once you are comfortable with building and running JMeter Test Plans, you can look into the
various configuration elements (timers, listeners, assertions, and others) which give you more control
over your Test Plans.
- </p>
- </blockquote>
- </p>
- </td></tr>
- <tr><td><br></td></tr>
- </table>
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#525D76">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="requirements"><strong>2.1 Requirements</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
- JMeter requires your computing environment meets some minimum requirements.
- </p>
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="java_versions"><strong>2.1.1 Java Version</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p><table border="1" bgcolor="#bbbb00" width="50%" cellspacing="0" cellpadding="2">
- <tr><td> JMeter requires a fully compliant JVM 1.4 or higher.
-
- <br >
- </br>
-
+</p>
+</blockquote>
+</p>
+</td></tr>
+<tr><td><br></td></tr>
+</table>
+<table border="0" cellspacing="0" cellpadding="2" width="100%">
+<tr><td bgcolor="#525D76">
+<font color="#ffffff" face="arial,helvetica,sanserif">
+<a name="requirements"><strong>2.1 Requirements</strong></a>
+</font>
+</td></tr>
+<tr><td>
+<blockquote>
+<p>
+JMeter requires your computing environment meets some minimum requirements.
+</p>
+<table border="0" cellspacing="0" cellpadding="2" width="100%">
+<tr><td bgcolor="#828DA6">
+<font color="#ffffff" face="arial,helvetica,sanserif">
+<a name="java_versions"><strong>2.1.1 Java Version</strong></a>
+</font>
+</td></tr>
+<tr><td>
+<blockquote>
+<p>
+<table border="1" bgcolor="#bbbb00" width="50%" cellspacing="0" cellpadding="2">
+<tr><td>JMeter requires a fully compliant JVM 1.4 or higher.
+
+<br>
+</br>
+
Version 2.2 and later no longer support Java 1.3.
- </td></tr>
- </table></p>
- <p >
- Because JMeter uses only standard Java APIs, please do not file bug reports if your JRE fails to run
+</td></tr>
+</table>
+</p>
+<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>
- </blockquote>
- </td></tr>
- <tr><td><br></td></tr>
- </table>
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="os"><strong>2.1.2 Operating Systems</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
- JMeter is a 100% Java application and should run correctly on any system
+</p>
+</blockquote>
+</td></tr>
+<tr><td><br></td></tr>
+</table>
+<table border="0" cellspacing="0" cellpadding="2" width="100%">
+<tr><td bgcolor="#828DA6">
+<font color="#ffffff" face="arial,helvetica,sanserif">
+<a name="os"><strong>2.1.2 Operating Systems</strong></a>
+</font>
+</td></tr>
+<tr><td>
+<blockquote>
+<p>
+JMeter is a 100% Java application and should run correctly on any system
that has a compliant Java implementation.
- <br >
- </br>
-
+<br>
+</br>
+
JMeter has been tested and works under:
- </p>
- <ul >
-
-
- <li >
- Unix (Solaris, Linux, etc)
- </li>
-
-
- <li >
- Windows (98, NT, XP, etc)
- </li>
-
-
- <li >
- OpenVMS Alpha 7.3+
- </li>
-
-
- </ul>
- </blockquote>
- </td></tr>
- <tr><td><br></td></tr>
- </table>
- </blockquote>
- </p>
- </td></tr>
- <tr><td><br></td></tr>
- </table>
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#525D76">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="optional"><strong>2.2 Optional</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
- If you plan on doing JMeter development or want to use Sun's Java Standard Extension packages, then you will need one or more optional packages listed below.
- </p>
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="opt_compiler"><strong>2.2.1 Java Compiler</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
- If you want to build the JMeter source or develop JMeter plugins, then you will need a fully compliant JDK 1.4 or higher.
- </p>
- </blockquote>
- </td></tr>
- <tr><td><br></td></tr>
- </table>
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="opt_sax"><strong>2.2.2 SAX XML Parser</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
- JMeter comes with Apache's
- <a href="http://xml.apache.org/">
- Xerces XML parser
- </a>
- . You have the option of telling JMeter
+</p>
+<ul>
+
+
+<li>
+Unix (Solaris, Linux, etc)
+</li>
+
+
+<li>
+Windows (98, NT, XP, etc)
+</li>
+
+
+<li>
+OpenVMS Alpha 7.3+
+</li>
+
+
+</ul>
+</blockquote>
+</td></tr>
+<tr><td><br></td></tr>
+</table>
+</blockquote>
+</p>
+</td></tr>
+<tr><td><br></td></tr>
+</table>
+<table border="0" cellspacing="0" cellpadding="2" width="100%">
+<tr><td bgcolor="#525D76">
+<font color="#ffffff" face="arial,helvetica,sanserif">
+<a name="optional"><strong>2.2 Optional</strong></a>
+</font>
+</td></tr>
+<tr><td>
+<blockquote>
+<p>
+If you plan on doing JMeter development, then you will need one or more optional packages listed below.
+</p>
+<table border="0" cellspacing="0" cellpadding="2" width="100%">
+<tr><td bgcolor="#828DA6">
+<font color="#ffffff" face="arial,helvetica,sanserif">
+<a name="opt_compiler"><strong>2.2.1 Java Compiler</strong></a>
+</font>
+</td></tr>
+<tr><td>
+<blockquote>
+<p>
+If you want to build the JMeter source or develop JMeter plugins, then you will need a fully compliant JDK 1.4 or higher.
+</p>
+</blockquote>
+</td></tr>
+<tr><td><br></td></tr>
+</table>
+<table border="0" cellspacing="0" cellpadding="2" width="100%">
+<tr><td bgcolor="#828DA6">
+<font color="#ffffff" face="arial,helvetica,sanserif">
+<a name="opt_sax"><strong>2.2.2 SAX XML Parser</strong></a>
+</font>
+</td></tr>
+<tr><td>
+<blockquote>
+<p>
+JMeter comes with Apache's
+<a href="http://xml.apache.org/">
+Xerces XML parser
+</a>
+. You have the option of telling JMeter
to use a different XML parser. To do so, include the classes for the third-party parser in JMeter's
- <a href="#classpath">
- classpath
- </a>
- ,
+<a href="#classpath">
+classpath
+</a>
+,
and update the
- <a href="#configuring_jmeter">
- jmeter.properties
- </a>
- file with the full classname of the parser
+<a href="#configuring_jmeter">
+jmeter.properties
+</a>
+ file with the full classname of the parser
implementation.
- </p>
- </blockquote>
- </td></tr>
- <tr><td><br></td></tr>
- </table>
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="opt_email"><strong>2.2.3 Email Support</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
- JMeter has limited Email capabilities. It can send email based on test results, and has a POP/IMAP sampler.
+</p>
+</blockquote>
+</td></tr>
+<tr><td><br></td></tr>
+</table>
+<table border="0" cellspacing="0" cellpadding="2" width="100%">
+<tr><td bgcolor="#828DA6">
+<font color="#ffffff" face="arial,helvetica,sanserif">
+<a name="opt_email"><strong>2.2.3 Email Support</strong></a>
+</font>
+</td></tr>
+<tr><td>
+<blockquote>
+<p>
+JMeter has limited Email capabilities. It can send email based on test results, and has a POP3(S)/IMAP(S) sampler.
It does not currently support SMTP sampling.
To enable Email support, add Sun's JavaMail packages and the activation packages to JMeter's
- <a href="#classpath">
- classpath
- </a>
- .
- </p>
- </blockquote>
- </td></tr>
- <tr><td><br></td></tr>
- </table>
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="opt_ssl"><strong>2.2.4 SSL Encryption</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
- To test a web server using SSL encryption (HTTPS), JMeter requires that an
+<a href="#classpath">
+classpath
+</a>
+.
+</p>
+</blockquote>
+</td></tr>
+<tr><td><br></td></tr>
+</table>
+<table border="0" cellspacing="0" cellpadding="2" width="100%">
+<tr><td bgcolor="#828DA6">
+<font color="#ffffff" face="arial,helvetica,sanserif">
+<a name="opt_ssl"><strong>2.2.4 SSL Encryption</strong></a>
+</font>
+</td></tr>
+<tr><td>
+<blockquote>
+<p>
+To test a web server using SSL encryption (HTTPS), JMeter requires that an
implementation of SSL be provided, as is the case with Sun Java 1.4 and above.
If your version of Java does not include SSL support, then it is possible to add an external implementation.
Include the necessary encryption packages in JMeter's
- <a href="#classpath">
- classpath
- </a>
- .
+<a href="#classpath">
+classpath
+</a>
+.
Also, update
- <a href="#configuring_jmeter">
- system.properties
- </a>
- to register the SSL Provider.
- </p>
- <p >
-
+<a href="#configuring_jmeter">
+system.properties
+</a>
+ to register the SSL Provider.
+</p>
+<p>
+
JMeter defaults to protocol level TLS. This can be changed by editting the JMeter property
"https.default.protocol" in jmeter.properties or user.properties.
- </p>
- <p >
- <b >
- JMeter is configured to accept all certificates,
+</p>
+<p>
+<b>
+JMeter is configured to accept all certificates,
whether trusted or not, regardless of validity periods etc.
- </b>
-
+</b>
+
This is to allow the maximum flexibility in testing servers.
- </p>
- <p >
- If the server requires a client certificate, this can be provided.
- </p>
- <p >
- There is also the
- <a href="../usermanual/component_reference.html#SSL_Manager">SSL Manager</a>
- , for greater control of certificates.
- </p>
- <p><table border="1" bgcolor="#bbbb00" width="50%" cellspacing="0" cellpadding="2">
- <tr><td> The JMeter proxy server (see below) does not support recording SSL (https).
- </td></tr>
- </table></p>
- </blockquote>
- </td></tr>
- <tr><td><br></td></tr>
- </table>
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="opt_jdbc"><strong>2.2.5 JDBC Driver</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
- You will need to add your database vendor's JDBC driver to the
- <a href="#classpath">
- classpath
- </a>
- if you want to do JDBC testing.
+</p>
+<p>
+If the server requires a client certificate, this can be provided.
+</p>
+<p>
+There is also the
+<a href="../usermanual/component_reference.html#SSL_Manager">SSL Manager</a>
+, for greater control of certificates.
+</p>
+<p>
+<table border="1" bgcolor="#bbbb00" width="50%" cellspacing="0" cellpadding="2">
+<tr><td>The JMeter proxy server (see below) does not support recording SSL (https).
+</td></tr>
+</table>
+</p>
+</blockquote>
+</td></tr>
+<tr><td><br></td></tr>
+</table>
+<table border="0" cellspacing="0" cellpadding="2" width="100%">
+<tr><td bgcolor="#828DA6">
+<font color="#ffffff" face="arial,helvetica,sanserif">
+<a name="opt_jdbc"><strong>2.2.5 JDBC Driver</strong></a>
+</font>
+</td></tr>
+<tr><td>
+<blockquote>
+<p>
+You will need to add your database vendor's JDBC driver to the
+<a href="#classpath">
+classpath
+</a>
+ if you want to do JDBC testing.
Make sure the file is a jar file, not a zip.
- </p>
- </blockquote>
- </td></tr>
- <tr><td><br></td></tr>
- </table>
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="opt_soap"><strong>2.2.6 Apache SOAP</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
- Apache SOAP requires mail.jar and activation.jar. You need to download and copy these two jar files to your
- <b >
- jmeter/lib
- </b>
- directory. Once the files are in there, JMeter will automatically pick them up.
- </p>
- </blockquote>
- </td></tr>
- <tr><td><br></td></tr>
- </table>
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="opt_beanshell"><strong>2.2.7 BeanShell</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
- To run the BeanShell function or any of the BeanShell test elements (sampler, timer etc),
+</p>
+</blockquote>
+</td></tr>
+<tr><td><br></td></tr>
+</table>
+<table border="0" cellspacing="0" cellpadding="2" width="100%">
+<tr><td bgcolor="#828DA6">
+<font color="#ffffff" face="arial,helvetica,sanserif">
+<a name="opt_soap"><strong>2.2.6 Apache SOAP</strong></a>
+</font>
+</td></tr>
+<tr><td>
+<blockquote>
+<p>
+Apache SOAP requires mail.jar and activation.jar. You need to download and copy these two jar files to your
+<b>
+jmeter/lib
+</b>
+ directory. Once the files are in there, JMeter will automatically pick them up.
+</p>
+</blockquote>
+</td></tr>
+<tr><td><br></td></tr>
+</table>
+<table border="0" cellspacing="0" cellpadding="2" width="100%">
+<tr><td bgcolor="#828DA6">
+<font color="#ffffff" face="arial,helvetica,sanserif">
+<a name="opt_beanshell"><strong>2.2.7 BeanShell</strong></a>
+</font>
+</td></tr>
+<tr><td>
+<blockquote>
+<p>
+To run the BeanShell function or any of the BeanShell test elements (sampler, timer etc),
you need to download the beanshell jar from
- <a href="http://www.beanshell.org/">
- http://www.beanshell.org/
- </a>
- and copy the jar file to the
- <b >
- jmeter/lib directory
- </b>
- , where JMeter will automatically pick it up.
- </p>
- </blockquote>
- </td></tr>
- <tr><td><br></td></tr>
- </table>
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="libraries_activemq"><strong>2.2.7 Libraries for ActiveMQ 3.0</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
- See
- <a href="http://activemq.apache.org/initial-configuration.html">
- http://activemq.apache.org/initial-configuration.html
- </a>
-
+<a href="http://www.beanshell.org/">
+http://www.beanshell.org/
+</a>
+ and copy the jar file to the
+<b>
+jmeter/lib directory
+</b>
+, where JMeter will automatically pick it up.
+</p>
+</blockquote>
+</td></tr>
+<tr><td><br></td></tr>
+</table>
+<table border="0" cellspacing="0" cellpadding="2" width="100%">
+<tr><td bgcolor="#828DA6">
+<font color="#ffffff" face="arial,helvetica,sanserif">
+<a name="libraries_activemq"><strong>2.2.8 Libraries for ActiveMQ 3.0</strong></a>
+</font>
+</td></tr>
+<tr><td>
+<blockquote>
+<p>
+See
+<a href="http://activemq.apache.org/initial-configuration.html">
+http://activemq.apache.org/initial-configuration.html
+</a>
+
for details.
- </p>
- </blockquote>
- </td></tr>
- <tr><td><br></td></tr>
- </table>
- <p><table border="1" bgcolor="#bbbb00" width="50%" cellspacing="0" cellpadding="2">
- <tr><td>
+</p>
+</blockquote>
+</td></tr>
+<tr><td><br></td></tr>
+</table>
+<p>
+<table border="1" bgcolor="#bbbb00" width="50%" cellspacing="0" cellpadding="2">
+<tr><td>
See the
- <a href="#classpath">
- JMeter Classpath
- </a>
- section for more details on installing additional jars.
-
- </td></tr>
- </table></p>
- </blockquote>
- </p>
- </td></tr>
- <tr><td><br></td></tr>
- </table>
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#525D76">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="install"><strong>2.3 Installation</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p><table border="1" bgcolor="#bbbb00" width="50%" cellspacing="0" cellpadding="2">
- <tr><td>
-Note: avoid installing JMeter in a path with spaces in the name.
-This causes problems for remote testing.
-
- </td></tr>
- </table></p>
- <p >
- We recommend that most users run the
- <a href="http://jakarta.apache.org/site/downloads/index.html">
- latest release
- </a>
- .
- </p>
- <p >
- To install a release build, simply unzip the zip/tar file into the directory
+<a href="#classpath">
+JMeter Classpath
+</a>
+ section for more details on installing additional jars.
+
+</td></tr>
+</table>
+</p>
+</blockquote>
+</p>
+</td></tr>
+<tr><td><br></td></tr>
+</table>
+<table border="0" cellspacing="0" cellpadding="2" width="100%">
+<tr><td bgcolor="#525D76">
+<font color="#ffffff" face="arial,helvetica,sanserif">
+<a name="install"><strong>2.3 Installation</strong></a>
+</font>
+</td></tr>
+<tr><td>
+<blockquote>
+<p>
+We recommend that most users run the
+<a href="http://jakarta.apache.org/site/downloads/index.html">
+latest release
+</a>
+.
+</p>
+<p>
+To install a release build, simply unzip the zip/tar file into the directory
where you want JMeter to be installed. Provided that you have a JRE/JDK correctly installed
and the JAVA_HOME environment variable set, there is nothing more for you to do.
- </p>
- <p >
-
+</p>
+<p>
+
+Note: there can be problems (especially with client-server mode) if the directory path contains any spaces.
+
+</p>
+<p>
+
The installation directory structure should look something like this (for version 2.3.1):
- <pre >
-
+<pre>
+
jakarta-jmeter-2.3.1
jakarta-jmeter-2.3.1/bin
jakarta-jmeter-2.3.1/docs
@@ -662,329 +660,363 @@
jakarta-jmeter-2.3.1/lib/junit
jakarta-jmeter-2.3.1/printable_docs
- </pre>
-
-You can rename the parent directory (e.g. jakarta-jmeter-2.3.1) if you want, but do not change any of the sub-directory names.
-The path to the parent directory should not contain any spaces; if it does, then you may have problems running client-server mode.
-
- </p>
- </blockquote>
- </p>
- </td></tr>
- <tr><td><br></td></tr>
- </table>
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#525D76">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="running"><strong>2.4 Running JMeter</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <br >
- </br>
- <p >
- To run JMeter, run the jmeter.bat (for Windows) or jmeter (for Unix) file.
+</pre>
+
+You can rename the parent directory (i.e. jakarta-jmeter-2.3.1) if you want, but do not change any of the sub-directory names.
+
+</p>
+</blockquote>
+</p>
+</td></tr>
+<tr><td><br></td></tr>
+</table>
+<table border="0" cellspacing="0" cellpadding="2" width="100%">
+<tr><td bgcolor="#525D76">
+<font color="#ffffff" face="arial,helvetica,sanserif">
+<a name="running"><strong>2.4 Running JMeter</strong></a>
+</font>
+</td></tr>
+<tr><td>
+<blockquote>
+<br>
+</br>
+<p>
+To run JMeter, run the jmeter.bat (for Windows) or jmeter (for Unix) file.
These files are found in the bin directory.
After a short pause, the JMeter GUI should appear.
- </p>
- <p >
-
+</p>
+<p>
+
There are some additional scripts in the bin directory that you may find useful.
Windows script files (the .CMD files require Win2K or later):
- <ul >
-
+<ul>
+
+
+<li>
+jmeter.bat - run JMeter (in GUI mode by default)
+</li>
+
+
+<li>
+jmeter-n.cmd - drop a JMX file on this to run a non-GUI test
+</li>
+
+
+<li>
+jmeter-n-r.cmd - drop a JMX file on this to run a non-GUI test remotely
+</li>
+
+
+<li>
+jmeter-t.cmd - drop a JMX file on this to load it in GUI mode
+</li>
+
+
+<li>
+jmeter-server.bat - start JMeter in server mode
+</li>
+
- <li >
- jmeter.bat - run JMeter (in GUI mode by default)
- </li>
-
-
- <li >
- jmeter-n.cmd - drop a JMX file on this to run a non-GUI test
- </li>
-
-
- <li >
- jmeter-n-r.cmd - drop a JMX file on this to run a non-GUI test remotely
- </li>
-
-
- <li >
- jmeter-t.cmd - drop a JMX file on this to load it in GUI mode
- </li>
-
-
- <li >
- jmeter-server.bat - start JMeter in server mode
- </li>
-
+</ul>
- </ul>
-
Note: the special name LAST can be used with jmeter-n.cmd, jmeter-t.cmd and jmeter-n-r.cmd
and means the last test plan that was run interactively.
- </p>
- <p >
-
-Un*x script files; should work on most Linux/Unix systems.
-
- <ul >
-
-
- <li >
- jmeter - run JMeter (in GUI mode by default)
- </li>
-
-
- <li >
- jmeter-server - start JMeter in server mode
- </li>
-
-
- </ul>
-
-
- </p>
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="classpath"><strong>2.4.1 JMeter's Classpath</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
- JMeter automatically finds classes from jars in the following directories:
- </p>
- <ul >
-
-
- <li >
- JMETER_HOME/lib - used for utility jars
- </li>
-
-
- <li >
- JMETER_HOME/lib/ext - used for JMeter components and add-ons
- </li>
-
-
- </ul>
- <p >
- If you have developed new JMeter components,
+</p>
+<p>
+
+The environment variable JVM_ARGS can be used to override JVM settings in the jmeter.bat script.
+For example:
+
+<pre>
+
+set JVM_ARGS="-Xms1024m -Xmx1024m -Dpropname=propvalue"
+jmeter -t test.jmx ...
+
+</pre>
+
+
+</p>
+<p>
+
+Un*x script files; should work on most Linux/Unix systems:
+
+<ul>
+
+
+<li>
+jmeter - run JMeter (in GUI mode by default). Defines some JVM settings which may not work for all JVMs.
+</li>
+
+
+<li>
+jmeter-server - start JMeter in server mode (calls jmeter script with appropriate parameters)
+</li>
+
+
+<li>
+jmeter.sh - very basic JMeter script with no JVM options specified.
+</li>
+
+
+</ul>
+
+
+</p>
+<p>
+
+It may be necessary to edit the jmeter shell script if some of the JVM options are not supported.
+The JVM_ARGS environment variable can be used to override or set additional JVM options, for example:
+
+<pre>
+
+JVM_ARGS="-Xms1024m -Xmx1024m" jmeter -t test.jmx [etc.]
+
+</pre>
+
+will override the HEAP settings in the script.
+
+</p>
+<table border="0" cellspacing="0" cellpadding="2" width="100%">
+<tr><td bgcolor="#828DA6">
+<font color="#ffffff" face="arial,helvetica,sanserif">
+<a name="classpath"><strong>2.4.1 JMeter's Classpath</strong></a>
+</font>
+</td></tr>
+<tr><td>
+<blockquote>
+<p>
+JMeter automatically finds classes from jars in the following directories:
+</p>
+<ul>
+
+
+<li>
+JMETER_HOME/lib - used for utility jars
+</li>
+
+
+<li>
+JMETER_HOME/lib/ext - used for JMeter components and add-ons
+</li>
+
+
+</ul>
+<p>
+If you have developed new JMeter components,
then you should jar them and copy the jar into JMeter's
- <b >
- lib/ext
- </b>
- directory.
+<b>
+lib/ext
+</b>
+ directory.
JMeter will automatically find JMeter components in any jars found here.
- </p>
- <p >
- Support jars (libraries etc) should be placed in the
- <b >
- lib
- </b>
- directory.
- </p>
- <p >
- If you don't want to put the extension jars in the
- <b >
- lib/ext
- </b>
- directory,
+</p>
+<p>
+Support jars (libraries etc) should be placed in the
+<b>
+lib
+</b>
+ directory.
+</p>
+<p>
+If you don't want to put JMeter extension jars in the
+<b>
+lib/ext
+</b>
+ directory,
then define the property
- <b >
- search_paths
- </b>
- in jmeter.properties.
+<b>
+search_paths
+</b>
+ in jmeter.properties.
Do not use lib/ext for utility jars; it is only intended for JMeter components.
- </p>
- <p >
-
+</p>
+<p>
+
Other jars (such as JDBC, JavaMail, Beanshell and any other support libaries needed by the JMeter code)
should be placed in the
- <b >
- lib
- </b>
- directory - not the
- <b >
- lib/ext
- </b>
- directory
- </p>
- <p >
- Note: JMeter will only find .jar files, not .zip.
- </p>
- <p >
- You can also install utility Jar files in $JAVA_HOME/jre/lib/ext, or (since 2.1.1) you can set the property
- <b >
- user.classpath
- </b>
- in jmeter.properties
- </p>
- <p >
- Note that setting the CLASSPATH environment variable will have no effect.
+<b>
+lib
+</b>
+ directory - not the
+<b>
+lib/ext
+</b>
+ directory
+</p>
+<p>
+Note: JMeter will only find .jar files, not .zip.
+</p>
+<p>
+You can also install utility Jar files in $JAVA_HOME/jre/lib/ext, or (since 2.1.1) you can set the property
+<b>
+user.classpath
+</b>
+ in jmeter.properties
+</p>
+<p>
+Note that setting the CLASSPATH environment variable will have no effect.
This is because JMeter is started with "java -jar",
and the java command silently ignores the CLASSPATH variable, and the -classpath/-cp options when -jar is used.
[This occurs with all Java programs, not just JMeter.]
- </p>
- </blockquote>
- </td></tr>
- <tr><td><br></td></tr>
- </table>
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="proxy_server"><strong>2.4.2 Using a Proxy Server</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
- If you are testing from behind a firewall/proxy server, you may need to provide JMeter with
+</p>
+</blockquote>
+</td></tr>
+<tr><td><br></td></tr>
+</table>
+<table border="0" cellspacing="0" cellpadding="2" width="100%">
+<tr><td bgcolor="#828DA6">
+<font color="#ffffff" face="arial,helvetica,sanserif">
+<a name="proxy_server"><strong>2.4.2 Using a Proxy Server</strong></a>
+</font>
+</td></tr>
+<tr><td>
+<blockquote>
+<p>
+If you are testing from behind a firewall/proxy server, you may need to provide JMeter with
the firewall/proxy server hostname and port number. To do so, run the jmeter.bat/jmeter file
from a command line with the following parameters:
- </p>
- <p >
-
+</p>
+<p>
+
-H [proxy server hostname or ip address]
- <br >
- </br>
-
+<br>
+</br>
+
-P [proxy server port]
- <br >
- </br>
-
+<br>
+</br>
+
-N [nonproxy hosts] (e.g. *.apache.org|localhost)
- <br >
- </br>
-
+<br>
+</br>
+
-u [username for proxy authentication - if required]
- <br >
- </br>
-
+<br>
+</br>
+
-a [password for proxy authentication - if required]
- <br >
- </br>
-
-
- </p>
- <p >
- <b >
- Example
- </b>
- : jmeter -H my.proxy.server -P 8000 -u username -a password -N localhost
- </p>
- <p >
- Alternatively, you can use --proxyHost, --proxyPort, --username, and --password
- </p>
- <p><table border="1" bgcolor="#bbbb00" width="50%" cellspacing="0" cellpadding="2">
- <tr><td> JMeter also has its own in-built
- <a href="../usermanual/component_reference.html#HTTP_Proxy_Server">HTTP Proxy Server</a>
- ,
+<br>
+</br>
+
+
+</p>
+<p>
+<b>
+Example
+</b>
+: jmeter -H my.proxy.server -P 8000 -u username -a password -N localhost
+</p>
+<p>
+Alternatively, you can use --proxyHost, --proxyPort, --username, and --password
+</p>
+<p>
+<table border="1" bgcolor="#bbbb00" width="50%" cellspacing="0" cellpadding="2">
+<tr><td>JMeter also has its own in-built
+<a href="../usermanual/component_reference.html#HTTP_Proxy_Server">HTTP Proxy Server</a>
+,
which can be used for recording HTTP (but not HTTPS) browser sessions.
This is not to be confused with the proxy settings described above, which are used when JMeter makes HTTP or HTTPS requests itself.
- </td></tr>
- </table></p>
- </blockquote>
- </td></tr>
- <tr><td><br></td></tr>
- </table>
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="non_gui"><strong>2.4.3 Non-GUI Mode (Command Line mode)</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
- For non-interactive testing, you may choose to run JMeter without the GUI. To do so, use
+</td></tr>
+</table>
+</p>
+</blockquote>
+</td></tr>
+<tr><td><br></td></tr>
+</table>
+<table border="0" cellspacing="0" cellpadding="2" width="100%">
+<tr><td bgcolor="#828DA6">
+<font color="#ffffff" face="arial,helvetica,sanserif">
+<a name="non_gui"><strong>2.4.3 Non-GUI Mode (Command Line mode)</strong></a>
+</font>
+</td></tr>
+<tr><td>
+<blockquote>
+<p>
+For non-interactive testing, you may choose to run JMeter without the GUI. To do so, use
the following command options
- </p>
- <p >
- -n This specifies JMeter is to run in non-gui mode
- </p>
- <p >
- -t [name of JMX file that contains the Test Plan].
- </p>
- <p >
- -l [name of JTL file to log sample results to].
- </p>
- <p >
- -r Run the test in the servers specified by the JMeter property "remote_hosts"
- </p>
- <p >
- -R [list of remote servers] Run the test in the specified remote servers
- </p>
- <p >
- The script also lets you specify the optional firewall/proxy server information:
- </p>
- <p >
- -H [proxy server hostname or ip address]
- <br >
- </br>
-
+</p>
+<p>
+-n This specifies JMeter is to run in non-gui mode
+</p>
+<p>
+-t [name of JMX file that contains the Test Plan].
+</p>
+<p>
+-l [name of JTL file to log sample results to].
+</p>
+<p>
+-r Run the test in the servers specified by the JMeter property "remote_hosts"
+</p>
+<p>
+-R [list of remote servers] Run the test in the specified remote servers
+</p>
+<p>
+The script also lets you specify the optional firewall/proxy server information:
+</p>
+<p>
+-H [proxy server hostname or ip address]
+<br>
+</br>
+
-P [proxy server port]
- </p>
- <p >
- <b >
- Example
- </b>
- : jmeter -n -t my_test.jmx -l log.jtl -H my.proxy.server -P 8000
- </p>
- </blockquote>
- </td></tr>
- <tr><td><br></td></tr>
- </table>
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="server"><strong>2.4.4 Server Mode</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
- For
- <a href="remote-test.html">
- distributed testing
- </a>
- , run JMeter in server mode on the remote node(s), and then control the server(s) from the GUI.
+</p>
+<p>
+<b>
+Example
+</b>
+: jmeter -n -t my_test.jmx -l log.jtl -H my.proxy.server -P 8000
+</p>
+</blockquote>
+</td></tr>
+<tr><td><br></td></tr>
+</table>
+<table border="0" cellspacing="0" cellpadding="2" width="100%">
+<tr><td bgcolor="#828DA6">
+<font color="#ffffff" face="arial,helvetica,sanserif">
+<a name="server"><strong>2.4.4 Server Mode</strong></a>
+</font>
+</td></tr>
+<tr><td>
+<blockquote>
+<p>
+For
+<a href="remote-test.html">
+distributed testing
+</a>
+, run JMeter in server mode on the remote node(s), and then control the server(s) from the GUI.
You can also use non-GUI mode to run remote tests.
To start the server(s), run jmeter-server/jmeter-server.bat on each server host.
- </p>
- <p >
- The script also lets you specify the optional firewall/proxy server information:
- </p>
- <p >
- -H [proxy server hostname or ip address]
- <br >
- </br>
-
+</p>
+<p>
+The script also lets you specify the optional firewall/proxy server information:
+</p>
+<p>
+-H [proxy server hostname or ip address]
+<br>
+</br>
+
-P [proxy server port]
- </p>
- <p >
- <b >
- Example
- </b>
- : jmeter-server -H my.proxy.server -P 8000
- </p>
- <p >
- If you want the server to exit after a single test has been run, then define the JMeter property server.exitaftertest=true.
-
- </p>
- <p >
- To run the test from the client in non-GUI mode, use the following command:
- </p>
- <pre >
-
+</p>
+<p>
+<b>
+Example
+</b>
+: jmeter-server -H my.proxy.server -P 8000
+</p>
+<p>
+If you want the server to exit after a single test has been run, then define the JMeter property server.exitaftertest=true.
+
+</p>
+<p>
+To run the test from the client in non-GUI mode, use the following command:
+</p>
+<pre>
+
jmeter -n -t testplan.jmx -r [-Gprop=val] [-Z]
where:
-G is used to define JMeter properties to be set in the servers
@@ -992,105 +1024,106 @@
-Rserver1,server2 - can be used instead of -r to provide a list of servers to start
Overrides remote_hosts, but does not define the property.
- </pre>
- </blockquote>
- </td></tr>
- <tr><td><br></td></tr>
- </table>
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="override"><strong>2.4.5 Overriding Properties Via The Command Line</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
- Java system properties, JMeter properties, and logging properties can be overriden directly on the command line (instead of modifying jmeter.properties).
+</pre>
+</blockquote>
+</td></tr>
+<tr><td><br></td></tr>
+</table>
+<table border="0" cellspacing="0" cellpadding="2" width="100%">
+<tr><td bgcolor="#828DA6">
+<font color="#ffffff" face="arial,helvetica,sanserif">
+<a name="override"><strong>2.4.5 Overriding Properties Via The Command Line</strong></a>
+</font>
+</td></tr>
+<tr><td>
+<blockquote>
+<p>
+Java system properties, JMeter properties, and logging properties can be overriden directly on the command line (instead of modifying jmeter.properties).
To do so, use the following options:
- </p>
- <p >
- -D[prop_name]=[value] - defines a java system property value.
- </p>
- <p >
- -J[prop name]=[value] - defines a local JMeter property.
- </p>
- <p >
- -G[prop name]=[value] - defines a JMeter property to be sent to all remote servers.
- </p>
- <p >
- -L[category]=[priority] - overrides a logging setting, setting a particular category to the given priority level.
- </p>
- <p >
- The -L flag can also be used without the category name to set the root logging level.
- </p>
- <p >
- <b >
- Examples
- </b>
- :
+</p>
+<p>
+-D[prop_name]=[value] - defines a java system property value.
+</p>
+<p>
+-J[prop name]=[value] - defines a local JMeter property.
+</p>
+<p>
+-G[prop name]=[value] - defines a JMeter property to be sent to all remote servers.
+</p>
+<p>
+-L[category]=[priority] - overrides a logging setting, setting a particular category to the given priority level.
+</p>
+<p>
+The -L flag can also be used without the category name to set the root logging level.
+</p>
+<p>
+<b>
+Examples
+</b>
+:
+
+<pre>
- <pre >
-
jmeter -Duser.dir=/home/mstover/jmeter_stuff \
-Jremote_hosts=127.0.0.1 -Ljmeter.engine=DEBUG
jmeter -LDEBUG
- </pre>
-
+</pre>
+
+
+</p>
+<p>
+
+
+<b>
+N.B.
+<br>
+</br>
- </p>
- <p >
-
-
- <b >
- N.B.
- <br >
- </br>
-
The command line properties are processed early in startup, but after the logging system has been set up.
Attempts to use the -J flag to update log_level or log_file properties will have no effect.
- </b>
-
+</b>
+
- </p>
- </blockquote>
- </td></tr>
- <tr><td><br></td></tr>
- </table>
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="logging"><strong>2.4.6 Logging and error messages</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p><table border="1" bgcolor="#bbbb00" width="50%" cellspacing="0" cellpadding="2">
- <tr><td>
+</p>
+</blockquote>
+</td></tr>
+<tr><td><br></td></tr>
+</table>
+<table border="0" cellspacing="0" cellpadding="2" width="100%">
+<tr><td bgcolor="#828DA6">
+<font color="#ffffff" face="arial,helvetica,sanserif">
+<a name="logging"><strong>2.4.6 Logging and error messages</strong></a>
+</font>
+</td></tr>
+<tr><td>
+<blockquote>
+<p>
+<table border="1" bgcolor="#bbbb00" width="50%" cellspacing="0" cellpadding="2">
+<tr><td>
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>
- .
+<a href="functions.html">
+Functions and Variables for more information
+</a>
+.
- </td></tr>
- </table></p>
- <p >
- If JMeter detects an error during a test, a message will be written to the log file.
+</td></tr>
+</table>
+</p>
+<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 jmeter.properties file (or using the -j option, see below).
It defaults to
- <b >
- jmeter.log
- </b>
- , and will be found in the directory from which JMeter was launched.
- [in JMeter 2.2 and earlier, this was forced to be the JMeter bin directory.]
+<b>
+jmeter.log
+</b>
+, and will be found in the directory from which JMeter was launched.
- </p>
- <p >
-
+</p>
+<p>
+
JMeter versions after 2.2 added a new command-line option, -j jmeterlogfile.
This is processed after the initial properties file is read,
and before any further properties are processed.
@@ -1099,24 +1132,24 @@
to define the log file using the test plan name,
e.g. for the test plan Test27.jmx the log file is set to Test27.log.
- </p>
- <p >
- When running on Windows, the file may appear as just
- <b >
- jmeter
- </b>
- unless you have set Windows to show file extensions.
+</p>
+<p>
+When running on Windows, the file may appear as just
+<b>
+jmeter
+</b>
+ unless you have set Windows to show file extensions.
[Which you should do anyway, to make it easier to detect viruses and other nasties that pretend to be text files...]
- </p>
- <p >
- As well as recording errors, the jmeter.log file records some information about the test run. For example:
- </p>
- <div overflow="scroll">
-
+</p>
+<p>
+As well as recording errors, the jmeter.log file records some information about the test run. For example:
+</p>
+<div overflow="scroll">
+
+
+<pre>
- <pre >
-
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!
@@ -1126,32 +1159,32 @@
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
- </pre>
-
+</pre>
- </div>
- <p >
- The log file can be helpful in determining the cause of an error,
+
+</div>
+<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>
- </blockquote>
- </td></tr>
- <tr><td><br></td></tr>
- </table>
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="options"><strong>2.4.7 Full list of command-line options</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
- Invoking JMeter as "jmeter -?" will print a list of all the command-line options.
+</p>
+</blockquote>
+</td></tr>
+<tr><td><br></td></tr>
+</table>
+<table border="0" cellspacing="0" cellpadding="2" width="100%">
+<tr><td bgcolor="#828DA6">
+<font color="#ffffff" face="arial,helvetica,sanserif">
+<a name="options"><strong>2.4.7 Full list of command-line options</strong></a>
+</font>
+</td></tr>
+<tr><td>
+<blockquote>
+<p>
+Invoking JMeter as "jmeter -?" will print a list of all the command-line options.
These are shown below.
- </p>
- <pre >
-
+</p>
+<pre>
+
-h, --help
print usage information and exit
-v, --version
@@ -1200,197 +1233,244 @@
-X, --remoteexit
Exit the remote servers at end of test (non-GUI)
- </pre>
- <p >
-
+</pre>
+<p>
+
Note: the JMeter log file name is formatted as a SimpleDateFormat (applied to the current date)
if it contains paired single-quotes, .e.g. 'jmeter_'yyyyMMddHHmmss'.log'
- </p>
- <p >
-
+</p>
+<p>
+
If the special name LAST is used for the -t, -j or -l flags, then JMeter takes that to mean the last test plan
that was run in interactive mode.
- </p>
- </blockquote>
- </td></tr>
- <tr><td><br></td></tr>
- </table>
- </blockquote>
- </p>
- </td></tr>
- <tr><td><br></td></tr>
- </table>
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#525D76">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="configuring_jmeter"><strong>2.5 Configuring JMeter</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
- If you wish to modify the properties with which JMeter runs you need to
+</p>
+</blockquote>
+</td></tr>
+<tr><td><br></td></tr>
+</table>
+</blockquote>
+</p>
+</td></tr>
+<tr><td><br></td></tr>
+</table>
+<table border="0" cellspacing="0" cellpadding="2" width="100%">
+<tr><td bgcolor="#525D76">
+<font color="#ffffff" face="arial,helvetica,sanserif">
+<a name="configuring_jmeter"><strong>2.5 Configuring JMeter</strong></a>
+</font>
+</td></tr>
+<tr><td>
+<blockquote>
+<p>
+If you wish to modify the properties with which JMeter runs you need to
either modify the jmeter.properties in the /bin directory or create
your own copy of the jmeter.properties and specify it in the command line.
- </p>
- <p><table border="1" bgcolor="#bbbb00" width="50%" cellspacing="0" cellpadding="2">
- <tr><td>
+</p>
+<p>
+<table border="1" bgcolor="#bbbb00" width="50%" cellspacing="0" cellpadding="2">
+<tr><td>
Note: since 2.2, you can define additional JMeter properties in the file defined by the
JMeter property
- <b >
- user.properties
- </b>
- which has the default value
- <b >
- user.properties
- </b>
- .
+<b>
+user.properties
+</b>
+ which has the default value
+<b>
+user.properties
+</b>
+.
The file will be automatically loaded if it is found in the current directory
or if it is found in the JMeter bin directory.
Similarly,
- <b >
- system.properties
- </b>
- is used to update system properties.
+<b>
+system.properties
+</b>
+ is used to update system properties.
- </td></tr>
- </table></p>
- <p>
- <b>Parameters</b>
- <table border="1" cellspacing="0" cellpadding="2">
- <tr><th>Attribute</th><th>Description</th><th>Required</th></tr>
- <tr>
- <td>ssl.provider</td>
- <td> You can specify the class for your SSL
+</td></tr>
+</table>
+</p>
+<p>
+<b>Parameters</b>
+<table border="1" cellspacing="0" cellpadding="2">
+<tr><th>Attribute</th><th>Description</th><th>Required</th></tr>
+<tr>
+<td>ssl.provider</td>
+<td>You can specify the class for your SSL
implementation if you don't want to use the built-in Java implementation.
- </td>
- <td>
- No
- </td>
- </tr>
- <tr>
- <td>xml.parser</td>
- <td> You can specify an implementation as your XML
+</td>
+<td>
+$items.getAttributeValue("required")
+</td>
+</tr>
+<tr>
+<td>xml.parser</td>
+<td>You can specify an implementation as your XML
parser. The default value is: org.apache.xerces.parsers.SAXParser
- </td>
- <td>
- No
- </td>
- </tr>
- <tr>
- <td>remote_hosts</td>
- <td> Comma-delimited list of remote JMeter hosts (or host:port if required).
+</td>
+<td>
+$items.getAttributeValue("required")
+</td>
+</tr>
+<tr>
+<td>remote_hosts</td>
+<td>Comma-delimited list of remote JMeter hosts (or host:port if required).
If you are running JMeter in a distributed environment, list the machines where
you have JMeter remote servers running. This will allow you to control those
servers from this machine's GUI
- </td>
- <td>
- No
- </td>
- </tr>
- <tr>
- <td>not_in_menu</td>
- <td> A list of components you do not want to see in
+</td>
+<td>
+$items.getAttributeValue("required")
+</td>
+</tr>
+<tr>
+<td>not_in_menu</td>
+<td>A list of components you do not want to see in
JMeter's menus. As JMeter has more and more components added, you may wish to
customize your JMeter to show only those components you are interested in.
You may list their classname or their class label (the string that appears
in JMeter's UI) here, and they will no longer appear in the menus.
- </td>
- <td>
- No
- </td>
- </tr>
- <tr>
- <td>search_paths</td>
- <td>
+</td>
+<td>
+$items.getAttributeValue("required")
+</td>
+</tr>
+<tr>
+<td>search_paths</td>
+<td>
List of paths (separated by ;) that JMeter will search for JMeter add-on classes;
for example additional samplers.
This is in addition to any jars found in the lib/ext directory.
- </td>
- <td>
- No
- </td>
- </tr>
- <tr>
- <td>user.classpath</td>
- <td>
+</td>
+<td>
+$items.getAttributeValue("required")
+</td>
+</tr>
+<tr>
+<td>user.classpath</td>
+<td>
List of paths that JMeter will search for utility classes.
This is in addition to any jars found in the lib directory.
- </td>
- <td>
- No
- </td>
- </tr>
- <tr>
- <td>user.properties</td>
- <td>
+</td>
+<td>
+$items.getAttributeValue("required")
+</td>
+</tr>
+<tr>
+<td>user.properties</td>
+<td>
Name of file containing additional JMeter properties.
These are added after the initial property file, but before the -q and -J options are processed.
- </td>
- <td>
- No
- </td>
- </tr>
- <tr>
- <td>system.properties</td>
- <td>
+</td>
+<td>
+$items.getAttributeValue("required")
+</td>
+</tr>
+<tr>
+<td>system.properties</td>
+<td>
Name of file containing additional system properties.
These are added before the -S and -D options are processed.
- </td>
- <td>
- No
- </td>
- </tr>
- </table>
- </p>
- <p >
- <b >
-
+</td>
+<td>
+$items.getAttributeValue("required")
+</td>
+</tr>
+</table>
+</p>
+<p>
+
+ The command line options and properties files are processed in the following order:
+
+<ul>
+
+
+<li>
+-p propfile
+</li>
+
+
+<li>
+jmeter.properties (or the file from the -p option) is then loaded
+</li>
+
+
+<li>
+-j logfile
+</li>
+
+
+<li>
+Logging is initialised
+</li>
+
+
+<li>
+user.properties is loaded
+</li>
+
+
+<li>
+system.properties is loaded
+</li>
+
+
+<li>
+all other command-line options are processed
+</li>
+
+
+</ul>
+
+
+</p>
+<p>
+<b>
+
See also the comments in the jmeter.properties, user.properties and system.properties files for further information on other settings you can change.
- </b>
- </p>
- </blockquote>
- </p>
- </td></tr>
- <tr><td><br></td></tr>
- </table>
- <table>
- <tr>
- <td bgcolor="#525D76">
- <div align="right"><a href="index.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Index</font></a></div>
- </td>
- <td bgcolor="#525D76">
- <div align="right"><a href="build-test-plan.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Next</font></a></div>
- </td>
- <td bgcolor="#525D76">
- <div align="right"><a href="intro.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Prev</font></a></div>
- </td>
- </tr>
- </table>
- <br>
- </td>
- </tr>
-
- <tr><td colspan="2">
- <hr noshade size="1"/>
- </td></tr>
- <tr><td colspan="2">
- <div align="center"><font color="#525D76" size="-1"><em>
- Copyright © 1999-2008, Apache Software Foundation
- </em></font></div>
- </td></tr>
- </table>
- </body>
- </html>
+</b>
+</p>
+</blockquote>
+</p>
+</td></tr>
+<tr><td><br></td></tr>
+</table>
+<table>
+<tr>
+<td bgcolor="#525D76">
+<div align="right"><a href="index.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Index</font></a></div>
+</td>
+<td bgcolor="#525D76">
+<div align="right"><a href="build-test-plan.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Next</font></a></div>
+</td>
+<td bgcolor="#525D76">
+<div align="right"><a href="intro.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Prev</font></a></div>
+</td>
+</tr>
+</table>
+<br>
+</td>
+</tr>
+<tr><td colspan="2">
+<hr noshade size="1"/>
+</td></tr>
+<tr><td colspan="2">
+<div align="center"><font color="#525D76" size="-1"><em>
+Copyright © 1999-2009, Apache Software Foundation
+</em></font></div>
+</td></tr>
+</table>
+</body>
+</html>
<!-- end the processing -->
Modified: jakarta/jmeter/trunk/docs/usermanual/glossary.html
URL: http://svn.apache.org/viewvc/jakarta/jmeter/trunk/docs/usermanual/glossary.html?rev=773282&r1=773281&r2=773282&view=diff
==============================================================================
--- jakarta/jmeter/trunk/docs/usermanual/glossary.html (original)
+++ jakarta/jmeter/trunk/docs/usermanual/glossary.html Sat May 9 22:57:45 2009
@@ -18,28 +18,28 @@
<!-- Content Stylesheet for Site -->
-
+
<!-- start the processing -->
- <!-- ====================================================================== -->
- <!-- Main Page Section -->
- <!-- ====================================================================== -->
- <html>
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
-
-
-
- <title>JMeter - User's Manual: Glossary</title>
- </head>
-
- <body bgcolor="#ffffff" text="#000000" link="#525D76">
- <table border="0" cellspacing="0">
- <!-- TOP IMAGE -->
- <tr>
- <td>
+<!-- ====================================================================== -->
+<!-- Main Page Section -->
+<!-- ====================================================================== -->
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
+
+
+
+<title>JMeter - User's Manual: Glossary</title>
+</head>
+
+<body bgcolor="#ffffff" text="#000000" link="#525D76">
+<table border="0" cellspacing="0">
+<!-- TOP IMAGE -->
+<tr>
+<td>
<!-- Need to specify height otherwise iframe seems to grab extra -->
<iframe src="http://www.apache.org/ads/halfbanner.html" height="102"
- style="border-width:0; float: left" frameborder="0" scrolling="no"></iframe>
+style="border-width:0; float: left" frameborder="0" scrolling="no"></iframe>
</td>
<td align="left">
<a href="http://jakarta.apache.org"><img width="505" height="48" src="../images/jakarta-logo.gif" alt="Jakarta" title="Jakarta" border="0"/></a>
@@ -47,201 +47,274 @@
<td align="right">
<a href="http://jakarta.apache.org/jmeter/"><img width="221" height="102" src="../images/logo.jpg" alt="JMeter" title="JMeter" border="0"/></a>
</td>
- </tr>
- </table>
- <table border="0" width="100%" cellspacing="4">
- <tr><td colspan="2">
- <hr noshade size="1"/>
- </td></tr>
-
- <tr>
- <!-- LEFT SIDE NAVIGATION -->
- <td width="20%" valign="top" nowrap="true">
- <p><strong>About</strong></p>
- <ul>
- <li> <a href="../index.html">Overview</a>
-</li>
- <li> <a href="../changes.html">Changes</a>
-</li>
- <li> <a href="../known_bugs.html">Known Bugs</a>
-</li>
- <li> <a href="../license.html">License</a>
-</li>
- <li> <a href="http://wiki.apache.org/jakarta-jmeter/JMeterCommitters">Contributors</a>
-</li>
- </ul>
- <p><strong>Download</strong></p>
- <ul>
- <li> <a href="http://jakarta.apache.org/site/downloads/downloads_jmeter.cgi">Download Releases</a>
-</li>
- <li> <a href="../nightly.html">Developer (Nightly) Builds</a>
-</li>
- </ul>
- <p><strong>Documentation</strong></p>
- <ul>
- <li> <a href="../usermanual/index.html">User Manual</a>
-</li>
- <li> <a href="../api/index.html">Javadocs</a>
-</li>
- <li> <a href="../localising/index.html">Localisation (Translator's Guide)</a>
-</li>
- <li> <a href="../building.html">Building JMeter and Add-Ons</a>
-</li>
- <li> <a href="http://wiki.apache.org/jakarta-jmeter">JMeter Wiki</a>
-</li>
- <li> <a href="http://wiki.apache.org/jakarta-jmeter/JMeterFAQ">FAQ (Wiki)</a>
-</li>
- </ul>
- <p><strong>Tutorials (PDF format)</strong></p>
- <ul>
- <li> <a href="../usermanual/jmeter_distributed_testing_step_by_step.pdf">Distributed Testing</a>
-</li>
- <li> <a href="../usermanual/jmeter_proxy_step_by_step.pdf">Recording Tests</a>
-</li>
- <li> <a href="../usermanual/junitsampler_tutorial.pdf">JUnit Sampler</a>
-</li>
- <li> <a href="../usermanual/jmeter_accesslog_sampler_step_by_step.pdf">Access Log Sampler</a>
-</li>
- <li> <a href="../extending/jmeter_tutorial.pdf">Extending JMeter</a>
-</li>
- </ul>
- <p><strong>Community</strong></p>
- <ul>
- <li> <a href="http://jakarta.apache.org/site/getinvolved.html">Get Involved</a>
-</li>
- <li> <a href="http://jakarta.apache.org/site/mail.html">Mailing Lists</a>
-</li>
- <li> <a href="http://jakarta.apache.org/site/cvsindex.html">SVN Repositories</a>
-</li>
- </ul>
- </td>
- <td width="80%" align="left" valign="top">
- <table>
- <tr>
- <td bgcolor="#525D76">
- <div align="right"><a href="index.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Index</font></a></div>
- </td>
- <td bgcolor="#525D76">
- <div align="right"><a href="regular_expressions.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Prev</font></a></div>
- </td>
- </tr>
- </table>
- <br>
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#525D76">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="glossary"><strong>21. Glossary</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
-
-
- <a name="Latency">
- <b >
- Latency
- </b>
- </a>
- . JMeter measures the latency from just before sending the request to
+</tr>
+</table>
+<table border="0" width="100%" cellspacing="4">
+<tr><td colspan="2">
+<hr noshade size="1"/>
+</td></tr>
+<tr>
+<!-- LEFT SIDE NAVIGATION -->
+<td width="20%" valign="top" nowrap="true">
+<p><strong>About</strong></p>
+<ul>
+<li><a href="../index.html">Overview</a>
+</li>
+<li><a href="../changes.html">Changes</a>
+</li>
+<li><a href="../known_bugs.html">Known Bugs</a>
+</li>
+<li><a href="../license.html">License</a>
+</li>
+<li><a href="http://wiki.apache.org/jakarta-jmeter/JMeterCommitters">Contributors</a>
+</li>
+</ul>
+<p><strong>Download</strong></p>
+<ul>
+<li><a href="http://jakarta.apache.org/site/downloads/downloads_jmeter.cgi">Download Releases</a>
+</li>
+<li><a href="../nightly.html">Developer (Nightly) Builds</a>
+</li>
+</ul>
+<p><strong>Documentation</strong></p>
+<ul>
+<li><a href="../usermanual/index.html">User Manual</a>
+</li>
+<li><a href="../api/index.html">Javadocs</a>
+</li>
+<li><a href="../localising/index.html">Localisation (Translator's Guide)</a>
+</li>
+<li><a href="../building.html">Building JMeter and Add-Ons</a>
+</li>
+<li><a href="http://wiki.apache.org/jakarta-jmeter">JMeter Wiki</a>
+</li>
+<li><a href="http://wiki.apache.org/jakarta-jmeter/JMeterFAQ">FAQ (Wiki)</a>
+</li>
+</ul>
+<p><strong>Tutorials (PDF format)</strong></p>
+<ul>
+<li><a href="../usermanual/jmeter_distributed_testing_step_by_step.pdf">Distributed Testing</a>
+</li>
+<li><a href="../usermanual/jmeter_proxy_step_by_step.pdf">Recording Tests</a>
+</li>
+<li><a href="../usermanual/junitsampler_tutorial.pdf">JUnit Sampler</a>
+</li>
+<li><a href="../usermanual/jmeter_accesslog_sampler_step_by_step.pdf">Access Log Sampler</a>
+</li>
+<li><a href="../extending/jmeter_tutorial.pdf">Extending JMeter</a>
+</li>
+</ul>
+<p><strong>Community</strong></p>
+<ul>
+<li><a href="http://jakarta.apache.org/site/getinvolved.html">Get Involved</a>
+</li>
+<li><a href="http://jakarta.apache.org/site/mail.html">Mailing Lists</a>
+</li>
+<li><a href="http://jakarta.apache.org/site/cvsindex.html">SVN Repositories</a>
+</li>
+</ul>
+</td>
+<td width="80%" align="left" valign="top">
+<table>
+<tr>
+<td bgcolor="#525D76">
+<div align="right"><a href="index.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Index</font></a></div>
+</td>
+<td bgcolor="#525D76">
+<div align="right"><a href="$next"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Next</font></a></div>
+</td>
+<td bgcolor="#525D76">
+<div align="right"><a href="regular_expressions.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Prev</font></a></div>
+</td>
+</tr>
+</table>
+<br>
+<table border="0" cellspacing="0" cellpadding="2" width="100%">
+<tr><td bgcolor="#525D76">
+<font color="#ffffff" face="arial,helvetica,sanserif">
+<a name="glossary"><strong>21. Glossary</strong></a>
+</font>
+</td></tr>
+<tr><td>
+<blockquote>
+<p>
+
+
+<a name="Elapsed">
+<b>
+Elapsed time
+</b>
+</a>
+. JMeter measures the elapsed time from just before sending the request to
+just after the last response has been received.
+JMeter does not include the time needed to render the response, nor does JMeter process any client code, for example
+Javascript.
+
+</p>
+<p>
+
+
+<a name="Latency">
+<b>
+Latency
+</b>
+</a>
+. JMeter measures the latency from just before sending the request to
just after the first response has been received. Thus the time
includes all the processing needed to assemble the request as well as
-assembling the response, which in general will be longer than one
+assembling the first part of the response, which in general will be longer than one
byte.
Protocol analysers (such as Wireshark) measure the time when bytes are actually sent/received over the interface.
The JMeter time should be closer to that which is experienced by a
browser or other application client.
- </p>
- <p >
-
-
- <a name="Median">
- <b >
- Median
- </b>
- </a>
- is a number which divides the samples into two equal halves.
+</p>
+<p>
+
+
+<a name="Median">
+<b>
+Median
+</b>
+</a>
+ is a number which divides the samples into two equal halves.
Half of the samples are smaller than the median, and half are larger.
[Some samples may equal the median.]
This is a standard statistical measure.
See, for example:
- <a href="http://en.wikipedia.org/wiki/Median">
- Median
- </a>
- entry at Wikipedia.
+<a href="http://en.wikipedia.org/wiki/Median">
+Median
+</a>
+ entry at Wikipedia.
The Median is the same as the 50
- <sup >
- th
- </sup>
- Percentile
-
- </p>
- <p >
-
-
- <a name="Percentile">
- <b >
- 90% Line (90
- <sup >
- th
- </sup>
- Percentile)
- </b>
- </a>
- is the value below which 90% of the samples fall.
+<sup>
+th
+</sup>
+ Percentile
+
+</p>
+<p>
+
+
+<a name="Percentile">
+<b>
+90% Line (90
+<sup>
+th
+</sup>
+ Percentile)
+</b>
+</a>
+ is the value below which 90% of the samples fall.
The remaining samples too at least as long as the value.
This is a standard statistical measure.
See, for example:
- <a href="http://en.wikipedia.org/wiki/Percentile">
- Percentile
- </a>
- entry at Wikipedia.
-
- </p>
- <p >
-
-
- <a name="Throughput">
- <b >
- Throughput
- </b>
- </a>
- is calculated as requests/unit of time.
+<a href="http://en.wikipedia.org/wiki/Percentile">
+Percentile
+</a>
+ entry at Wikipedia.
+
+</p>
+<p>
+
+
+<a name="ThreadName">
+The
+<b>
+Thread Name
+</b>
+</a>
+ as it appears in Listeners and logfiles
+is derived from the Thread Group name and the thread within the group.
+<br>
+</br>
+
+The name has the format
+
+<code>
+groupName + " " + groupIndex + "-" + threadIndex
+</code>
+
+where:
+
+<ul>
+
+
+<li>
+groupName - name of the Thread Group element
+</li>
+
+
+<li>
+groupIndex - number of the Thread Group in the Test Plan, starting from 1
+</li>
+
+
+<li>
+threadIndex - number of the thread within the Thread Group, starting from 1
+</li>
+
+
+</ul>
+
+A test plan with two Thread Groups each with two threads would use the names:
+
+<pre>
+
+Thread Group 1-1
+Thread Group 1-2
+Thread Group 2-1
+Thread Group 2-2
+
+</pre>
+
+
+</p>
+<p>
+
+
+<a name="Throughput">
+<b>
+Throughput
+</b>
+</a>
+ is calculated as requests/unit of time.
The time is calculated from the start of the first sample to the end of the last sample.
This includes any intervals between samples.
- </p>
- </blockquote>
- </p>
- </td></tr>
- <tr><td><br></td></tr>
- </table>
- <table>
- <tr>
- <td bgcolor="#525D76">
- <div align="right"><a href="index.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Index</font></a></div>
- </td>
- <td bgcolor="#525D76">
- <div align="right"><a href="regular_expressions.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Prev</font></a></div>
- </td>
- </tr>
- </table>
- <br>
- </td>
- </tr>
-
- <tr><td colspan="2">
- <hr noshade size="1"/>
- </td></tr>
- <tr><td colspan="2">
- <div align="center"><font color="#525D76" size="-1"><em>
- Copyright © 1999-2008, Apache Software Foundation
- </em></font></div>
- </td></tr>
- </table>
- </body>
- </html>
+</p>
+</blockquote>
+</p>
+</td></tr>
+<tr><td><br></td></tr>
+</table>
+<table>
+<tr>
+<td bgcolor="#525D76">
+<div align="right"><a href="index.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Index</font></a></div>
+</td>
+<td bgcolor="#525D76">
+<div align="right"><a href="$next"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Next</font></a></div>
+</td>
+<td bgcolor="#525D76">
+<div align="right"><a href="regular_expressions.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Prev</font></a></div>
+</td>
+</tr>
+</table>
+<br>
+</td>
+</tr>
+<tr><td colspan="2">
+<hr noshade size="1"/>
+</td></tr>
+<tr><td colspan="2">
+<div align="center"><font color="#525D76" size="-1"><em>
+Copyright © 1999-2009, Apache Software Foundation
+</em></font></div>
+</td></tr>
+</table>
+</body>
+</html>
<!-- end the processing -->
---------------------------------------------------------------------
To unsubscribe, e-mail: jmeter-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: jmeter-dev-help@jakarta.apache.org