From commits-return-4236-apmail-jmeter-commits-archive=jmeter.apache.org@jmeter.apache.org Sun Sep 20 11:44:34 2015
Return-Path:
X-Original-To: apmail-jmeter-commits-archive@minotaur.apache.org
Delivered-To: apmail-jmeter-commits-archive@minotaur.apache.org
Received: from mail.apache.org (hermes.apache.org [140.211.11.3])
by minotaur.apache.org (Postfix) with SMTP id 36F98180E5
for ; Sun, 20 Sep 2015 11:44:34 +0000 (UTC)
Received: (qmail 21971 invoked by uid 500); 20 Sep 2015 11:44:34 -0000
Delivered-To: apmail-jmeter-commits-archive@jmeter.apache.org
Received: (qmail 21942 invoked by uid 500); 20 Sep 2015 11:44:34 -0000
Mailing-List: contact commits-help@jmeter.apache.org; run by ezmlm
Precedence: bulk
List-Help:
List-Unsubscribe:
List-Post:
List-Id:
Reply-To: dev@jmeter.apache.org
Delivered-To: mailing list commits@jmeter.apache.org
Received: (qmail 21913 invoked by uid 99); 20 Sep 2015 11:44:34 -0000
Received: from Unknown (HELO spamd2-us-west.apache.org) (209.188.14.142)
by apache.org (qpsmtpd/0.29) with ESMTP; Sun, 20 Sep 2015 11:44:34 +0000
Received: from localhost (localhost [127.0.0.1])
by spamd2-us-west.apache.org (ASF Mail Server at spamd2-us-west.apache.org) with ESMTP id 8DB051A27AA
for ; Sun, 20 Sep 2015 11:44:33 +0000 (UTC)
X-Virus-Scanned: Debian amavisd-new at spamd2-us-west.apache.org
X-Spam-Flag: NO
X-Spam-Score: 3.5
X-Spam-Level: ***
X-Spam-Status: No, score=3.5 tagged_above=-999 required=6.31
tests=[KAM_LAZY_DOMAIN_SECURITY=1, RDNS_NONE=2.5] autolearn=disabled
Received: from mx1-us-west.apache.org ([10.40.0.8])
by localhost (spamd2-us-west.apache.org [10.40.0.9]) (amavisd-new, port 10024)
with ESMTP id avz5dGBobW_T for ;
Sun, 20 Sep 2015 11:44:25 +0000 (UTC)
Received: from mailrelay1-us-west.apache.org (unknown [209.188.14.139])
by mx1-us-west.apache.org (ASF Mail Server at mx1-us-west.apache.org) with ESMTP id 807A920F4B
for ; Sun, 20 Sep 2015 11:44:25 +0000 (UTC)
Received: from svn01-us-west.apache.org (svn.apache.org [10.41.0.6])
by mailrelay1-us-west.apache.org (ASF Mail Server at mailrelay1-us-west.apache.org) with ESMTP id 0B608E022D
for ; Sun, 20 Sep 2015 11:44:25 +0000 (UTC)
Received: from svn01-us-west.apache.org (localhost [127.0.0.1])
by svn01-us-west.apache.org (ASF Mail Server at svn01-us-west.apache.org) with ESMTP id D5B4A3A0423
for ; Sun, 20 Sep 2015 11:44:24 +0000 (UTC)
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Subject: svn commit: r1704122 - /jmeter/trunk/xdocs/usermanual/component_reference.xml
Date: Sun, 20 Sep 2015 11:44:24 -0000
To: commits@jmeter.apache.org
From: fschumacher@apache.org
X-Mailer: svnmailer-1.0.9
Message-Id: <20150920114424.D5B4A3A0423@svn01-us-west.apache.org>
Author: fschumacher
Date: Sun Sep 20 11:44:24 2015
New Revision: 1704122
URL: http://svn.apache.org/viewvc?rev=1704122&view=rev
Log:
Mostly markup changes. Usage of code, source and example tags.
Modified:
jmeter/trunk/xdocs/usermanual/component_reference.xml
Modified: jmeter/trunk/xdocs/usermanual/component_reference.xml
URL: http://svn.apache.org/viewvc/jmeter/trunk/xdocs/usermanual/component_reference.xml?rev=1704122&r1=1704121&r2=1704122&view=diff
==============================================================================
--- jmeter/trunk/xdocs/usermanual/component_reference.xml (original)
+++ jmeter/trunk/xdocs/usermanual/component_reference.xml Sun Sep 20 11:44:24 2015
@@ -6088,8 +6088,8 @@ The Test Plan is where the overall setti
Static variables can be defined for values that are repeated throughout a test, such as server names.
-For example the variable SERVER could be defined as www.example.com, and the rest of the test plan
-could refer to it as ${SERVER}. This simplifies changing the name later.
+For example the variable SERVER could be defined as www.example.com, and the rest of the test plan
+could refer to it as ${SERVER}. This simplifies changing the name later.
If the same variable name is reused on one of more
@@ -6108,7 +6108,7 @@ Selecting Functional Testing instructs J
- Response Data and Sampler Data - to all result files.
This increases the resources needed to run a test, and may adversely impact JMeter performance.
If more data is required for a particular sampler only, then add a Listener to it, and configure the fields as required.
-[The option does not affect CSV result files, which cannot currently store such information.]
+The option does not affect CSV result files, which cannot currently store such information.
Also, an option exists here to instruct JMeter to run the serially rather than in parallel.
Run tearDown Thread Groups after shutdown of main threads:
@@ -6119,13 +6119,13 @@ The tearDown threads won't be run if the
Test plan now provides an easy way to add classpath setting to a specific test plan.
The feature is additive, meaning that you can add jar files or directories,
but removing an entry requires restarting JMeter.
-Note that this cannot be used to add JMeter GUI plugins, because they are processed earlier.
+Note that this cannot be used to add JMeter GUI plugins, because they are processed earlier.
However it can be useful for utility jars such as JDBC drivers. The jars are only added to
the search path for the JMeter loader, not for the system class loader.
JMeter properties also provides an entry for loading additional classpaths.
-In jmeter.properties, edit "user.classpath" or "plugin_dependency_paths" to include additional libraries.
+In jmeter.properties, edit "user.classpath" or "plugin_dependency_paths" to include additional libraries.
See JMeter's Classpath and
Configuring JMeter for details.
@@ -6151,16 +6151,16 @@ JMeter does not interrupt samplers which
Determines what happens if a sampler error occurs, either because the sample itself failed or an assertion failed.
The possible choices are:
-
Continue - ignore the error and continue with the test
-
Start Next Loop - ignore the error, start next loop and continue with the test
-
Stop Thread - current thread exits
-
Stop Test - the entire test is stopped at the end of any current samples.
-
Stop Test Now - the entire test is stopped abruptly. Any current samplers are interrupted if possible.
+
Continue - ignore the error and continue with the test
+
Start Next Loop - ignore the error, start next loop and continue with the test
+
Stop Thread - current thread exits
+
Stop Test - the entire test is stopped at the end of any current samples.
+
Stop Test Now - the entire test is stopped abruptly. Any current samplers are interrupted if possible.
Number of users to simulate.How long JMeter should take to get all the threads started. If there are 10 threads and a ramp-up time of 100 seconds, then each thread will begin 10 seconds after the previous thread started, for a total time of 100 seconds to get the test fully up to speed.
- Number of times to perform the test case. Alternatively, "forever" can be selected causing the test to run until manually stopped.
+ Number of times to perform the test case. Alternatively, "forever" can be selected causing the test to run until manually stopped.
If selected, threads are created only when the appropriate proportion of the ramp-up time has elapsed.
This is most appropriate for tests with a ramp-up time that is significantly longer than the time to execute a single thread.
@@ -6171,18 +6171,18 @@ JMeter does not interrupt samplers which
If selected, enables the schedulerIf the scheduler checkbox is selected, one can choose an absolute start time. When you start your test, JMeter will wait until the specified start time to begin testing.
- Note: the Startup Delay field over-rides this - see below.
+ Note: the Startup Delay field over-rides this - see below.
If the scheduler checkbox is selected, one can choose an absolute end time. When you start your test, JMeter will wait until the specified start time to begin testing, and it will stop at the specified end time.
- Note: the Duration field over-rides this - see below.
+ Note: the Duration field over-rides this - see below.
If the scheduler checkbox is selected, one can choose a relative end time.
- JMeter will use this to calculate the End Time, and ignore the End Time value.
+ JMeter will use this to calculate the End Time, and ignore the End Time value.
If the scheduler checkbox is selected, one can choose a relative startup delay.
- JMeter will use this to calculate the Start Time, and ignore the Start Time value.
+ JMeter will use this to calculate the Start Time, and ignore the Start Time value.
@@ -6190,8 +6190,8 @@ JMeter does not interrupt samplers which
The WorkBench simply provides a place to temporarily store test elements while not in use, for copy/paste purposes, or any other purpose you desire.
-When you save your test plan, WorkBench items are not saved with it by default unless you check "Save Workbench" option.
-Your WorkBench can be saved independently, if you like (right-click on WorkBench and choose Save).
+When you save your test plan, WorkBench items are not saved with it by default unless you check "Save Workbench" option.
+Your WorkBench can be saved independently, if you like (right-click on WorkBench and choose Save).
Certain test elements are only available on the WorkBench:
@@ -6222,17 +6222,17 @@ Your WorkBench can be saved independentl
JDK).
- To select the client certificate, choose Options→SSL Manager from the menu bar.
+ To select the client certificate, choose Options→SSL Manager from the menu bar.
You will be presented with a file finder that looks for PKCS12 files by default.
- Your PKCS12 file must have the extension '.p12' for SSL Manager to recognize it
+ Your PKCS12 file must have the extension '.p12' for SSL Manager to recognize it
as a PKCS12 file. Any other file will be treated like an average JKS key store.
If JSSE is correctly installed, you will be prompted for the password. The text
- box does not hide the characters you type at this point--so make sure no one is
+ box does not hide the characters you type at this point -- so make sure no one is
looking over your shoulder. The current implementation assumes that the password
for the keystore is also the password for the private key of the client you want
to authenticate as.
-
Or you can set the appropriate System properties - see the system.properties file.
+
Or you can set the appropriate System properties - see the system.properties file.
The next time you run your test, the SSL Manager will examine your key store to
see if it has at least one key available to it. If there is only one key, SSL
@@ -6244,12 +6244,12 @@ Your WorkBench can be saved independentl
You must have your Certificate Authority (CA) certificate installed properly
if it is not signed by one of the five CA certificates that ships with your
JDK. One method to install it is to import your CA certificate into a JKS
- file, and name the JKS file "jssecacerts". Place the file in your JRE's
- lib/security folder. This file will be read before the "cacerts" file in
- the same directory. Keep in mind that as long as the "jssecacerts" file
- exists, the certificates installed in "cacerts" will not be used. This may
+ file, and name the JKS file "jssecacerts". Place the file in your JRE's
+ lib/security folder. This file will be read before the "cacerts" file in
+ the same directory. Keep in mind that as long as the "jssecacerts" file
+ exists, the certificates installed in "cacerts" will not be used. This may
cause problems for you. If you don't mind importing your CA certificate into
- the "cacerts" file, then you can authenticate against all of the CA certificates
+ the "cacerts" file, then you can authenticate against all of the CA certificates
installed.
@@ -6263,11 +6263,11 @@ Ensure you read this below for details.
-If necessary, you can force JMeter to regenerate the keystore (and the exported certificates - ApacheJMeterTemporaryRootCA[.usr|.crt]) by deleting the keystore file proxyserver.jks from the JMeter directory.
+If necessary, you can force JMeter to regenerate the keystore (and the exported certificates - ApacheJMeterTemporaryRootCA[.usr|.crt]) by deleting the keystore file proxyserver.jks from the JMeter directory.
With versions of JMeter up to 2.9, it used a single certificate for all target servers.
@@ -6325,17 +6325,17 @@ As a consequence:
The browser should display a dialogue asking if you want to accept the certificate or not. For example:
-1) The server's name "www.example.com" does not match the certificate's name
- "JMeter Proxy (DO NOT TRUST)". Somebody may be trying to eavesdrop on you.
-2) The certificate for "JMeter Proxy (DO NOT TRUST)" is signed by the unknown Certificate Authority
- "JMeter Proxy (DO NOT TRUST)". It is not possible to verify that this is a valid certificate.
+1) The server's name "www.example.com" does not match the certificate's name
+ "JMeter Proxy (DO NOT TRUST)". Somebody may be trying to eavesdrop on you.
+2) The certificate for "JMeter Proxy (DO NOT TRUST)" is signed by the unknown Certificate Authority
+ "JMeter Proxy (DO NOT TRUST)". It is not possible to verify that this is a valid certificate.
You will need to accept the certificate in order to allow the JMeter Proxy to intercept the SSL traffic in order to
record it.
However, do not accept this certificate permanently; it should only be accepted temporarily.
Browsers only prompt this dialogue for the certificate of the main url, not for the resources loaded in the page, such as images, css or javascript files hosted on a secured external CDN.
If you have such resources (gmail has for example), you'll have to first browse manually to these other domains in order to accept JMeter's certificate for them.
-Check in jmeter.log for secure domains that you need to register certificate for.
+Check in jmeter.log for secure domains that you need to register certificate for.
If the browser has already registered a validated certificate for this domain, the browser will detect JMeter as a security breach and will refuse to load the page. If so, you have to remove the trusted certificate from your browser's keystore.
@@ -6346,19 +6346,19 @@ Versions of JMeter from 2.10 onwards sti
The following properties can be used to change the certificate that is used:
-
proxy.cert.directory - the directory in which to find the certificate (default = JMeter bin/)
-
proxy.cert.file - name of the keystore file (default "proxyserver.jks")
-
proxy.cert.keystorepass - keystore password (default "password") [Ignored if using JMeter certificate]
-
proxy.cert.keypassword - certificate key password (default "password") [Ignored if using JMeter certificate]
-
proxy.cert.type - the certificate type (default "JKS") [Ignored if using JMeter certificate]
-
proxy.cert.factory - the factory (default "SunX509") [Ignored if using JMeter certificate]
-
proxy.cert.alias - the alias for the key to be used. If this is defined, JMeter does not attempt to generate its own certificate(s).
-
proxy.ssl.protocol - the protocol to be used (default "SSLv3")
+
proxy.cert.directory - the directory in which to find the certificate (default = JMeter bin/)
+
proxy.cert.file - name of the keystore file (default "proxyserver.jks")
+
proxy.cert.keystorepass - keystore password (default "password") [Ignored if using JMeter certificate]
+
proxy.cert.keypassword - certificate key password (default "password") [Ignored if using JMeter certificate]
+
proxy.cert.type - the certificate type (default "JKS") [Ignored if using JMeter certificate]
+
proxy.cert.factory - the factory (default "SunX509") [Ignored if using JMeter certificate]
+
proxy.cert.alias - the alias for the key to be used. If this is defined, JMeter does not attempt to generate its own certificate(s).
+
proxy.ssl.protocol - the protocol to be used (default "SSLv3")
If your browser currently uses a proxy (e.g. a company intranet may route all external requests via a proxy),
then you need to tell JMeter to use that proxy before starting JMeter,
-using the command-line options -H and -P.
+using the command-line options-H and -P.
This setting will also be needed when running the generated test plan.
@@ -6385,15 +6385,15 @@ Please ensure that only trusted users ha
Choose the following options:
-
Tools / Options
-
Advanced / Certificates
-
View Certificates
-
Authorities
-
Import …
-
Browse to the JMeter launch directory, and click on the file ApacheJMeterTemporaryRootCA.crt, press Open
-
Click View and check that the certificate details agree with the ones displayed by the JMeter Test Script Recorder
-
If OK, select "Trust this CA to identify web sites", and press OK
-
Close dialogs by pressing OK as necessary
+
Tools / Options
+
Advanced / Certificates
+
View Certificates
+
Authorities
+
Import …
+
Browse to the JMeter launch directory, and click on the file ApacheJMeterTemporaryRootCA.crt, press Open
+
Click View and check that the certificate details agree with the ones displayed by the JMeter Test Script Recorder
+
If OK, select "Trust this CA to identify web sites", and press OK
+
Close dialogs by pressing OK as necessary
Installing the certificate in Chrome or Internet Explorer
@@ -6401,14 +6401,14 @@ Both Chrome and Internet Explorer use th
Browse to the JMeter launch directory, and click on the file ApacheJMeterTemporaryRootCA.crt, and open it
-
Click on the "Details" tab and check that the certificate details agree with the ones displayed by the JMeter Test Script Recorder
-
If OK, go back to the "General" tab, and click on "Install Certificate …" and follow the Wizard prompts
+
Click on the "Details" tab and check that the certificate details agree with the ones displayed by the JMeter Test Script Recorder
+
If OK, go back to the "General" tab, and click on "Install Certificate …" and follow the Wizard prompts
Installing the certificate in Opera
-
Tools / Preferences / Advanced / Security
-
Manage Certificates …
-
Select "Intermediate" tab, click "Import …"
+
Tools / Preferences / Advanced / Security
+
Manage Certificates …
+
Select "Intermediate" tab, click "Import …"
Browse to the JMeter launch directory, and click on the file ApacheJMeterTemporaryRootCA.usr, and open it
@@ -6416,64 +6416,64 @@ Both Chrome and Internet Explorer use th
Descriptive name for this element that is shown in the tree.
- The port that the HTTP(S) Test Script Recorder listens to. 8080 is the default, but you can change it.
+ The port that the HTTP(S) Test Script Recorder listens to. 8080 is the default, but you can change it.List of domain (or host) names for HTTPS. Use this to pre-generate certificates for all servers you wish to record.
- For example, *.apache.org,*.incubator.apache.org
+ For example, *.apache.org,*.incubator.apache.org
Note that wildcard domains only apply to one level,
- i.e. podling.incubator.apache.org matches *.incubator.apache.org but not *.apache.org
+ i.e. podling.incubator.apache.org matches *.incubator.apache.org but not *.apache.orgThe controller where the proxy will store the generated samples. By default, it will look for a Recording Controller and store them there wherever it is.Whether to group samplers for requests from a single "click" (requests received without significant time separation), and how to represent that grouping in the recording:
-
Do not group samplers: store all recorded samplers sequentially, without any grouping.
-
Add separators between groups: add a controller named "--------------" to create a visual separation between the groups. Otherwise the samplers are all stored sequentially.
-
Put each group in a new controller: create a new for each group, and store all samplers for that group in it.
-
Store 1st sampler of each group only: only the first request in each group will be recorded. The "Follow Redirects" and "Retrieve All Embedded Resources …" flags will be turned on in those samplers.
-
Put each group in a new transaction controller: create a new for each group, and store all samplers for that group in it.
+
Do not group samplers - store all recorded samplers sequentially, without any grouping.
+
Add separators between groups - add a controller named "--------------" to create a visual separation between the groups. Otherwise the samplers are all stored sequentially.
+
Put each group in a new controller - create a new for each group, and store all samplers for that group in it.
+
Store 1st sampler of each group only - only the first request in each group will be recorded. The "Follow Redirects" and "Retrieve All Embedded Resources …" flags will be turned on in those samplers.
+
Put each group in a new transaction controller - create a new for each group, and store all samplers for that group in it.
- The property proxy.pause determines the minimum gap that JMeter needs between requests
- to treat them as separate "clicks". The default is 1000 (milliseconds) i.e. 1 second.
+ The property proxy.pause determines the minimum gap that JMeter needs between requests
+ to treat them as separate "clicks". The default is 1000 (milliseconds) i.e. 1 second.
If you are using grouping, please ensure that you leave the required gap between clicks.
Should headers be added to the plan?
If specified, a Header Manager will be added to each HTTP Sampler.
The Proxy server always removes Cookie and Authorization headers from the generated Header Managers.
- By default it also removes If-Modified-Since and If-None-Match headers.
+ By default it also removes If-Modified-Since and If-None-Match headers.
These are used to determine if the browser cache items are up to date;
when recording one normally wants to download all the content.
- To change which additional headers are removed, define the JMeter property proxy.headers.remove
+ To change which additional headers are removed, define the JMeter property proxy.headers.remove
as a comma-separated list of headers.
Add a blank assertion to each sampler?
- Use Regex Matching when replacing variables? If checked replacement will use word boundaries, i.e. it will only replace word matching values of variable, not part of a word. A word boundary follows Perl5 definition and is equivalent to \b. More information below in the paragraph about "User Defined Variable replacement".
+ Use Regex Matching when replacing variables? If checked replacement will use word boundaries, i.e. it will only replace word matching values of variable, not part of a word. A word boundary follows Perl5 definition and is equivalent to \b. More information below in the paragraph about "User Defined Variable replacement".Which type of sampler to generate (the Java default or HTTPClient)Set Redirect Automatically in the generated samplers?Set Follow Redirects in the generated samplers?
- Note: see "Recording and redirects" section below for important information.
+ Note: see "Recording and redirects" section below for important information.Set Use Keep-Alive in the generated samplers?Set Retrieve all Embedded Resources in the generated samplers?
- Filter the requests based on the content-type - e.g. "text/html [;charset=utf-8 ]".
- The fields are regular expressions which are checked to see if they are contained in the content-type.
+ Filter the requests based on the content-type - e.g. "text/html [;charset=utf-8 ]".
+ The fields are regular expressions which are checked to see if they are contained in the content-type.
[Does not have to match the entire field].
The include filter is checked first, then the exclude filter.
Samples which are filtered out will not be stored.
- Note: this filtering is applied to the content type of the response
+ Note: this filtering is applied to the content type of the responseRegular expressions that are matched against the full URL that is sampled. Allows filtering of requests that are recorded. All requests pass through, but only
- those that meet the requirements of the Include/Exclude fields are recorded. If both Include and Exclude are
+ those that meet the requirements of the Include/Exclude fields are recorded. If both Include and Exclude are
left empty, then everything is recorded (which can result in dozens of samples recorded for each page, as images, stylesheets,
- etc. are recorded). If there is at least one entry in the Include field, then only requests that match one or more Include patterns are
- recorded.
+ etc. are recorded). If there is at least one entry in the Include field, then only requests that match one or more Include patterns are
+ recorded.
Regular expressions that are matched against the URL that is sampled.
- Any requests that match one or more Exclude pattern are not recorded.
+ Any requests that match one or more Exclude pattern are not recorded.
Notify Child Listeners of filtered samplers
- Any response that match one or more Exclude pattern is not delivered to Child Listeners (View Results Tree).
- Start the proxy server. JMeter writes the following message to the console once the proxy server has started up and is ready to take requests: "Proxy up and running!".
+ Any response that match one or more Exclude pattern is not delivered to Child Listeners (View Results Tree).
+ Start the proxy server. JMeter writes the following message to the console once the proxy server has started up and is ready to take requests: "Proxy up and running!".Stop the proxy server.Stops and restarts the proxy server. This is
useful when you change/add/delete an include/exclude filter expression.
@@ -6484,8 +6484,8 @@ Both Chrome and Internet Explorer use th
During recording, the browser will follow a redirect response and generate an additional request.
The Proxy will record both the original request and the redirected request
(subject to whatever exclusions are configured).
-The generated samples have "Follow Redirects" selected by default, because that is generally better.
-[Redirects may depend on the original request, so repeating the originally recorded sample may not always work.]
+The generated samples have "Follow Redirects" selected by default, because that is generally better.
+Redirects may depend on the original request, so repeating the originally recorded sample may not always work.
Now if JMeter is set to follow the redirect during replay, it will issue the original request,
@@ -6500,13 +6500,13 @@ To disable the redirect detection, set t
Includes and Excludes
The include and exclude patterns are treated as regular expressions (using Jakarta ORO).
-They will be matched against the host name, port (actual or implied) path and query (if any) of each browser request.
+They will be matched against the host name, port (actual or implied), path and query (if any) of each browser request.
If the URL you are browsing is
-"http://jmeter.apache.org/jmeter/index.html?username=xxxx",
+"http://jmeter.apache.org/jmeter/index.html?username=xxxx",
then the regular expression will be tested against the string:
-"jmeter.apache.org:80/jmeter/index.html?username=xxxx".
-Thus, if you want to include all .html files, your regular expression might look like:
-".*\.html(\?.*)?" - or ".*\.html"
+"jmeter.apache.org:80/jmeter/index.html?username=xxxx".
+Thus, if you want to include all .html files, your regular expression might look like:
+".*\.html(\?.*)?" - or ".*\.html
if you know that there is no query string or you only want html pages without query strings.
@@ -6518,14 +6518,14 @@ Using a combination of includes and excl
you should be able to record what you are interested in and skip what you are not.
-
-N.B. the string that is matched by the regular expression must be the same as the whole host+path string. Thus "\.html" will not match j.a.o/index.html
-
+
+N.B. the string that is matched by the regular expression must be the same as the whole host+path string. Thus "\.html" will not match j.a.o/index.html
+
Capturing binary POST data
Versions of JMeter from 2.3.2 are able to capture binary POST data.
-To configure which content-types are treated as binary, update the JMeter property proxy.binary.types.
+To configure which content-types are treated as binary, update the JMeter property proxy.binary.types.
The default settings are as follows:
@@ -6542,18 +6542,18 @@ proxy.binary.filesuffix=.binary
do this, create a timer directly within the HTTP(S) Test Script Recorder component.
The proxy will place a copy of this timer into each sample it records, or into
the first sample of each group if you're using grouping. This copy will then be
-scanned for occurrences of variable ${T} in its properties, and any such
+scanned for occurrences of variable ${T} in its properties, and any such
occurrences will be replaced by the time gap from the previous sampler
recorded (in milliseconds).
-
When you are ready to begin, hit "start".
+
When you are ready to begin, hit "start".
You will need to edit the proxy settings of your browser to point at the
appropriate server and port, where the server is the machine JMeter is running on, and
the port # is from the Proxy Control Panel shown above.
Where Do Samples Get Recorded?
JMeter places the recorded samples in the Target Controller you choose. If you choose the default option
-"Use Recording Controller", they will be stored in the first Recording Controller found in the test object tree (so be
+"Use Recording Controller", they will be stored in the first Recording Controller found in the test object tree (so be
sure to add a Recording Controller before you start recording).
@@ -6562,10 +6562,10 @@ To check if this is the case, try stoppi
If the browser still downloads pages, then it was not sending requests via the proxy.
Double-check the browser options.
If you are trying to record from a server running on the same host,
-then check that the browser is not set to "Bypass proxy server for local addresses"
+then check that the browser is not set to "Bypass proxy server for local addresses"
(this example is from IE7, but there will be similar options for other browsers).
-If JMeter does not record browser URLs such as http://localhost/ or http://127.0.0.1/,
-try using the non-loopback hostname or IP address, e.g. http://myhost/ or http://192.168.0.2/.
+If JMeter does not record browser URLs such as http://localhost/ or http://127.0.0.1/,
+try using the non-loopback hostname or IP address, e.g. http://myhost/ or http://192.168.0.2/.
Handling of HTTP Request Defaults
@@ -6588,10 +6588,10 @@ place User Defined Variables directly wi
Replacement by Variables: by default, the Proxy server looks for all occurrences of UDV values.
If you define the variable WEB with the value www, for example,
the string www will be replaced by ${WEB} wherever it is found.
-To avoid this happening everywhere, set the "Regex Matching" check-box.
+To avoid this happening everywhere, set the "Regex Matching" check-box.
This tells the proxy server to treat values as Regexes (using the perl5 compatible regex matchers provided by ORO).
-
If "Regex Matching" is selected every variable will be compiled into a perl compatible regex enclosed in
+
If "Regex Matching" is selected every variable will be compiled into a perl compatible regex enclosed in
\b( and )\b. That way each match will start and end at a word boundary.
Note that the boundary characters are not part of the matching group, e.g. n.* to match name out
@@ -6613,7 +6613,7 @@ The parens are necessary, since the norm
If you want to match /images at the start of a string only, use the value (^/images).
Jakarta ORO also supports zero-width look-ahead, so one can match /images/…
-but retain the trailing / in the output by using (^/images(?=/))".
+but retain the trailing / in the output by using (^/images(?=/)).
Note that the current version of Jakara ORO does not support look-behind - i.e. (?<=…) or (?<!…).
@@ -6623,10 +6623,10 @@ Note that the current version of Jakara
regex will partly match a previous replaced variable, which will result in something like
${{regex}, which is most probably not the desired result.
-
If there are any problems interpreting any variables as patterns, these are reported in jmeter.log,
+
If there are any problems interpreting any variables as patterns, these are reported in jmeter.log,
so be sure to check this if UDVs are not working as expected.
-
When you are done recording your test samples, stop the proxy server (hit the "stop" button). Remember to reset
+
When you are done recording your test samples, stop the proxy server (hit the "stop" button). Remember to reset
your browser's proxy settings. Now, you may want to sort and re-order the test script, add timers, listeners, a
cookie manager, etc.
@@ -6640,7 +6640,7 @@ You can also add a Authentication" header, tries to compute the Auth Policy. If Authorization Manager was added to target
+controller manually, HTTP(S) Test Script Recorder will find it and add authorization (matching ones will be removed). Otherwise
Authorization Manager will be added to target controller with authorization object.
You may have to fix automatically computed values after recording.
@@ -6670,7 +6670,7 @@ either by copying the files there or by
You may have to record an HTTP protocol that is not handled by default by JMeter (Custom Binary Protocol, Adobe Flex, Microsoft Silverlight, … ).
Although JMeter does not provide a native proxy implementation to record these protocols, you have the ability to
-record these protocols by implementing a custom SamplerCreator. This Sampler Creator will translate the binary format into a HTTPSamplerBase subclass
+record these protocols by implementing a custom SamplerCreator. This Sampler Creator will translate the binary format into a HTTPSamplerBase subclass
that can be added to the JMeter Test Case.
For more details see "Extending JMeter".
@@ -6683,15 +6683,15 @@ The HTTP Mirror Server is a very simple
This is useful for checking the content of HTTP requests.
-It uses default port 8081 since 2.6.
+It uses default port 8081 since 2.6.
- Port on which Mirror server listens, defaults to 8081.
- If set to a value > 0, number of threads serving requests will be limited to the configured number, if set to a value <=0
- a new thread will be created to serve each incoming request. Defaults to 0
+ Port on which Mirror server listens, defaults to 8081.
+ If set to a value > 0, number of threads serving requests will be limited to the configured number, if set to a value <=0
+ a new thread will be created to serve each incoming request. Defaults to 0Size of queue used for holding tasks before they are executed by Thread Pool, when Thread pool is exceeded, incoming requests will
- be held in this queue and discarded when this queue is full. This parameter is only used if Max Number of Threads is greater than 0. Defaults to 25
+ be held in this queue and discarded when this queue is full. This parameter is only used if Max Number of Threads is greater than 0. Defaults to 25
Note that you can get more control over the responses by adding an HTTP Header Manager with the following name/value pairs:
@@ -6702,7 +6702,7 @@ Note that you can get more control over
Response status, see HTTP Status responses, example 200 OK, 500 Internal Server Error, ….Size of response, this trims the response to the requested size if that is less than the total sizePipe separated list of headers, example:
- headerA=valueA|headerB=valueB would set headerA to valueA and headerB to valueB.
+ headerA=valueA|headerB=valueB would set headerA to valueA and headerB to valueB.
@@ -6710,9 +6710,9 @@ You can also use the following query par
Generates a 302 (Temporary Redirect) with the provided location.
- e.g. ?redirect=/path
+ e.g. ?redirect=/path
- Overrides the default status return. e.g. ?status=404 Not Found
+ Overrides the default status return. e.g. ?status=404 Not FoundVerbose flag, writes some details to standard output. e.g. first line and redirect location if specified
@@ -6759,10 +6759,10 @@ The values can be seen in the Descriptive name for this element that is shown in the tree.
- Whether to show JMeter properties (default false).
- Whether to show JMeter variables (default false).
- Whether to show Sampler properties (default true).
- Whether to show System properties (default false).
+ Whether to show JMeter properties (default false).
+ Whether to show JMeter variables (default false).
+ Whether to show Sampler properties (default true).
+ Whether to show System properties (default false).
@@ -6801,7 +6801,7 @@ This is done by default since JMeter 2.1
Note that by default it won't run if Test is gracefully shutdown, if you want to make it run in this case,
-ensure you check option "Run tearDown Thread Groups after shutdown of main threads" on Test Plan element.
+ensure you check option "Run tearDown Thread Groups after shutdown of main threads" on Test Plan element.
If Test Plan is stopped, tearDown will not run even if option is checked.
Figure 1 - Run tearDown Thread Groups after shutdown of main threads