mstover1 01/08/01 18:42:19
Modified: docs changes.html running.html
docs/user_manual index.html
xdocs changes.xml
xdocs/user_manual index.xml
Added: docs/user_manual proxy_server.html
xdocs/user_manual proxy_server.xml
Log:
Proxy Server documentation.
Revision Changes Path
1.26 +3 -2 jakarta-jmeter/docs/changes.html
Index: changes.html
===================================================================
RCS file: /home/cvs/jakarta-jmeter/docs/changes.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -r1.25 -r1.26
--- changes.html 2001/07/23 21:00:05 1.25
+++ changes.html 2001/08/02 01:42:19 1.26
@@ -90,7 +90,7 @@
<li>AllTests bug fix ([EMAIL PROTECTED])</li>
<li>ClassFinder bug fix ([EMAIL PROTECTED])</li>
<li>New Loop Controller</li>
-<li>Proxy Server records HTTP samples from browser</li>
+<li>Proxy Server records HTTP samples from browser (and documented in the user
manual)</li>
<li>Multipart Form support</li>
<li>HTTP Header class for Header customization</li>
<li>Extracting HTTP Header information from responses (Jamie Davidson)</li>
@@ -100,7 +100,8 @@
<li>HTTPS and Authorization working together</li>
<li>New Http sampling that automatically parses HTML response for images to
download, and includes the downloading of
these images in total time for request (Neth [EMAIL PROTECTED]) </li>
-</ul>
+<li>HTTP responses from server can be parsed for links and forms, and dynamic data
can be extracted and added to test
+samples at run-time</li> </ul>
<h3>Version 1.6.1</h3>
<ul>
<li>Fixed saving and loading of test scripts (no more extra lines)</li>
1.17 +0 -0 jakarta-jmeter/docs/running.html
Index: running.html
===================================================================
RCS file: /home/cvs/jakarta-jmeter/docs/running.html,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -r1.16 -r1.17
--- running.html 2001/07/23 21:00:05 1.16
+++ running.html 2001/08/02 01:42:19 1.17
@@ -151,7 +151,7 @@
</blockquote>
<p align="center"><font
size="-1">Copyright (c) 1998-99 <a href="http://java.apache.org";>The Java Apache
Project</a>.<br />
-$Id: running.html,v 1.16 2001/07/23 21:00:05 mstover1 Exp $</font> <br />
+$Id: running.html,v 1.17 2001/08/02 01:42:19 mstover1 Exp $</font> <br />
<font size="-1">All rights reserved.</font></p>
</blockquote>
</td></tr>
1.4 +1 -0 jakarta-jmeter/docs/user_manual/index.html
Index: index.html
===================================================================
RCS file: /home/cvs/jakarta-jmeter/docs/user_manual/index.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- index.html 2001/04/11 12:45:04 1.3
+++ index.html 2001/08/02 01:42:19 1.4
@@ -87,6 +87,7 @@
<li><a HREF="running.html">Running the test script</a></li>
<li><a href="saving.html">Saving test script elements</a></li>
<li><a href="rmi.html">Running JMeter over RMI</a></li>
+ <li><a href="proxy_server.html">Recording browser activity with
JMeter</a></li>
</UL>
<p>
1.1 jakarta-jmeter/docs/user_manual/proxy_server.html
Index: proxy_server.html
===================================================================
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
<!-- Content Stylesheet for Site -->
<!-- start the processing -->
<!-- ====================================================================== -->
<!-- Main Page Section -->
<!-- ====================================================================== -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
<meta name="author"
value="Michael Stover, et al.">
<meta name="email" value="[EMAIL PROTECTED]">
<title>JMeter - HTTP Proxy Server</title>
</head>
<body bgcolor="#ffffff" text="#000000" link="#525D76">
<table border="0" width="100%" cellspacing="0">
<!-- TOP IMAGE -->
<tr>
<td colspan="2">
<a href="http://jakarta.apache.org";><img
src="http://jakarta.apache.org/images/jakarta-logo.gif"; align="left" 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 valign="top" nowrap="true">
<p><strong>About</strong></p>
<ul>
<li> <a href="../index.html">Overview</a>
</li>
<li> <a href="../user_manual/index.html">Usage</a>
</li>
<li> <a
href="http://jakarta.apache.org/builds/jakarta-jmeter/";>Download</a>
</li>
<li> <a href="../installing.html">Install</a>
</li>
<li> <a href="../running.html">Running</a>
</li>
<li> <a href="../extending/index.html">Extending</a>
</li>
<li> <a href="../changes.html">Changes</a>
</li>
<li> <a href="../bugs.html">Known Bugs</a>
</li>
<li> <a href="../license.html">License</a>
</li>
<li> <a href="../todo.html">TODO</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";>CVS Repositories</a>
</li>
</ul>
</td>
<td align="left" valign="top">
<table
border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
<strong>HTTP Proxy Server</strong>
</font>
</td></tr>
<tr><td>
<blockquote>
<h2>HTTP Proxy Server to record browser
requests</h2>
<p>To use the proxy server, create a
Threadgroup in your testplan or workbench.
In the Threadgroup, <i>add</i> the Proxy Server (it will be an option under Config
Elements).</p>
<p>
The Proxy Server allows JMeter to watch and record your actions while you browse
your web application
with your normal browser (such as Internet Explorer). JMeter will create test
sample objects and store them
directly into your test plan as you go (so you can view samples interactively while
you make them).</p>
<h3>Configuring the Proxy Server</h3>
<p>
There are a few simple options in the Proxy Server's configuration screen that give
you some control over the Proxy's
behavior. First, you can select the port that the Proxy Server listens to. 8080 is
the default, but you can change it
if that port is already in use on your machine.</p>
<p>
The Include and Exclude fields allow you to filter requests. If, for example, you
left both fields blank, then JMeter
would record every action of your browser. This can often result in 20+ test
samples being recorded for each web page
(it will record all image requests, CSS files, Javascript files, etc). This is
probably not desirable (there are better
ways to tell JMeter to download the images from a page). The Include/Exclude fields
give you some say over what gets
recorded. </p>
<p>
If the Include field is left empty, then all requests will "pass" the include test.
If the Exclude field is
left empty, then all request will "pass" the exclude test. Once the Include field
has at least one entry,
then only those requests that match at least one entry will "pass" ("pass" means "be
recorded"). </p>
<p>
If the Exclude field is left empty, then all requests (that have passed the Include
field check) will pass. If there are
entries in the Exclude field, then any request that matches at least one entry will
not be recorded.
</p>
<p>
To add an entry to the Include or Exclude field, type the entry into the text field,
and hit "Enter" when done.
The text will be added to the List box to the right of the text field. To clear the
text field, hit the "clear"
button. Currently, there is no way to individually select items and delete them.
</p>
<p>
These entries will be treated as Perl-type regular expressions. They will be
matched against the host name + the path of
each browser request. Thus, if the URL you are browsing is
http://jakarta.apache.org/jmeter/index.html?username=xxxx,
then the regular expression will be tested against the string:
"jakarta.apache.org/jmeter/index.html". Thus,
if you wanted to include all .html files, you're regular expression might look like:
".*\.html". Using a
combination of includes and excludes, you should be able to record what you are
interested in and skip what you are
not.</p>
<p>
When you are ready to begin, hit "start".</p>
<p>
Currently, the Proxy Server does not save these settings when saved to file.</p>
<h3>Where do the samples get
recorded to?</h3>
<p>
If you went ahead and tried out the Proxy Server, you might have noticed that
nothing was recorded. In order for samples
to be recorded, the Proxy Server needs to be able to find a Web Test Controller
somewhere in the tree. The Proxy Server
will record the samples under any appropriate Web Test Controller it finds. If you
add a Web Test Controller, and do
nothing more to it, all recorded samples will be recorded into it. If you enter a
domain name in the Web Test Controller,
only those samples that have a matching domain will be recorded into it. Same with
the Path field.
</p>
<h3>All Done</h3>
<p>
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. </p>
</blockquote>
</td></tr>
</table>
</td>
</tr>
<!-- FOOTER -->
<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-2001, Apache Software Foundation
</em></font></div>
</td></tr>
</table>
</body>
</html>
<!-- end the processing -->
1.6 +3 -2 jakarta-jmeter/xdocs/changes.xml
Index: changes.xml
===================================================================
RCS file: /home/cvs/jakarta-jmeter/xdocs/changes.xml,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- changes.xml 2001/07/23 21:00:06 1.5
+++ changes.xml 2001/08/02 01:42:19 1.6
@@ -21,7 +21,7 @@
<li>AllTests bug fix ([EMAIL PROTECTED])</li>
<li>ClassFinder bug fix ([EMAIL PROTECTED])</li>
<li>New Loop Controller</li>
-<li>Proxy Server records HTTP samples from browser</li>
+<li>Proxy Server records HTTP samples from browser (and documented in the user
manual)</li>
<li>Multipart Form support</li>
<li>HTTP Header class for Header customization</li>
<li>Extracting HTTP Header information from responses (Jamie Davidson)</li>
@@ -31,7 +31,8 @@
<li>HTTPS and Authorization working together</li>
<li>New Http sampling that automatically parses HTML response for images to
download, and includes the downloading of
these images in total time for request (Neth [EMAIL PROTECTED]) </li>
-</ul>
+<li>HTTP responses from server can be parsed for links and forms, and dynamic data
can be extracted and added to test
+samples at run-time</li> </ul>
<h3>Version 1.6.1</h3>
<ul>
1.6 +1 -0 jakarta-jmeter/xdocs/user_manual/index.xml
Index: index.xml
===================================================================
RCS file: /home/cvs/jakarta-jmeter/xdocs/user_manual/index.xml,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- index.xml 2001/04/11 12:45:11 1.5
+++ index.xml 2001/08/02 01:42:19 1.6
@@ -18,6 +18,7 @@
<li><a HREF="running.html">Running the test script</a></li>
<li><a href="saving.html">Saving test script elements</a></li>
<li><a href="rmi.html">Running JMeter over RMI</a></li>
+ <li><a href="proxy_server.html">Recording browser activity with
JMeter</a></li>
</UL>
1.1 jakarta-jmeter/xdocs/user_manual/proxy_server.xml
Index: proxy_server.xml
===================================================================
<?xml version="1.0"?>
<document>
<properties>
<author email="[EMAIL PROTECTED]">Michael Stover, et al.</author>
<title>HTTP Proxy Server</title>
</properties>
<body>
<section name="HTTP Proxy Server">
<h2>HTTP Proxy Server to record browser requests</h2>:
<p>To use the proxy server, create a Threadgroup in your testplan or workbench.
In the Threadgroup, <i>add</i> the Proxy Server (it will be an option under Config
Elements).</p>
<p>
The Proxy Server allows JMeter to watch and record your actions while you browse
your web application
with your normal browser (such as Internet Explorer). JMeter will create test
sample objects and store them
directly into your test plan as you go (so you can view samples interactively while
you make them).</p>
<h3>Configuring the Proxy Server</h3>
<p>
There are a few simple options in the Proxy Server's configuration screen that give
you some control over the Proxy's
behavior. First, you can select the port that the Proxy Server listens to. 8080 is
the default, but you can change it
if that port is already in use on your machine.</p>
<p>
The Include and Exclude fields allow you to filter requests. If, for example, you
left both fields blank, then JMeter
would record every action of your browser. This can often result in 20+ test
samples being recorded for each web page
(it will record all image requests, CSS files, Javascript files, etc). This is
probably not desirable (there are better
ways to tell JMeter to download the images from a page). The Include/Exclude fields
give you some say over what gets
recorded. </p>
<p>
If the Include field is left empty, then all requests will "pass" the
include test. If the Exclude field is
left empty, then all request will "pass" the exclude test. Once the
Include field has at least one entry,
then only those requests that match at least one entry will "pass"
("pass" means "be
recorded"). </p>
<p>
If the Exclude field is left empty, then all requests (that have passed the Include
field check) will pass. If there are
entries in the Exclude field, then any request that matches at least one entry will
not be recorded.
</p>
<p>
To add an entry to the Include or Exclude field, type the entry into the text field,
and hit "Enter" when done.
The text will be added to the List box to the right of the text field. To clear the
text field, hit the "clear"
button. Currently, there is no way to individually select items and delete them.
</p>
<p>
These entries will be treated as Perl-type regular expressions. They will be
matched against the host name + the path of
each browser request. Thus, if the URL you are browsing is
http://jakarta.apache.org/jmeter/index.html?username=xxxx,
then the regular expression will be tested against the string:
"jakarta.apache.org/jmeter/index.html". Thus,
if you wanted to include all .html files, you're regular expression might look like:
".*\.html". Using a
combination of includes and excludes, you should be able to record what you are
interested in and skip what you are
not.</p>
<p>
When you are ready to begin, hit "start".</p>
<p>
Currently, the Proxy Server does not save these settings when saved to file.</p>
<h3>Where do the samples get recorded to?</h3>
<p>
If you went ahead and tried out the Proxy Server, you might have noticed that
nothing was recorded. In order for samples
to be recorded, the Proxy Server needs to be able to find a Web Test Controller
somewhere in the tree. The Proxy Server
will record the samples under any appropriate Web Test Controller it finds. If you
add a Web Test Controller, and do
nothing more to it, all recorded samples will be recorded into it. If you enter a
domain name in the Web Test Controller,
only those samples that have a matching domain will be recorded into it. Same with
the Path field.
</p>
<h3>All Done</h3>
<p>
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. </p>
</section>
</body>
</document>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
![http://jakarta.apache.org/images/jakarta-logo.gif"](http://jakarta.apache.org/images/jakarta-logo.gif"){kind=link}
