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 2008/05/27 20:06:01 UTC
svn commit: r660629 [7/18] - in /jakarta/jmeter/trunk/docs: ./ localising/
usermanual/
Modified: jakarta/jmeter/trunk/docs/usermanual/build-ldapext-test-plan.html
URL: http://svn.apache.org/viewvc/jakarta/jmeter/trunk/docs/usermanual/build-ldapext-test-plan.html?rev=660629&r1=660628&r2=660629&view=diff
==============================================================================
--- jakarta/jmeter/trunk/docs/usermanual/build-ldapext-test-plan.html (original)
+++ jakarta/jmeter/trunk/docs/usermanual/build-ldapext-test-plan.html Tue May 27 11:05:49 2008
@@ -1,205 +1,205 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
-<!--
- Licensed to the Apache Software Foundation (ASF) under one or more
- contributor license agreements. See the NOTICE file distributed with
- this work for additional information regarding copyright ownership.
- The ASF licenses this file to You under the Apache License, Version 2.0
- (the "License"); you may not use this file except in compliance with
- the License. You may obtain a copy of the License at
-
- http://www.apache.org/licenses/LICENSE-2.0
-
- Unless required by applicable law or agreed to in writing, software
- distributed under the License is distributed on an "AS IS" BASIS,
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- See the License for the specific language governing permissions and
- limitations under the License.
--->
-
-<!-- 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: Building an Extended LDAP Test Plan</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>
-</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>
-</td>
-<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-ws-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="build-ldap-test-plan.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="ldapexttest"><strong>9b. Building an Extended LDAP Test Plan</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+<!-- 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: Building an Extended LDAP Test Plan</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>
+</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>
+</td>
+<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-ws-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="build-ldap-test-plan.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="ldapexttest"><strong>9b. Building an Extended LDAP Test Plan</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <p >
In this section, you will learn how to create a basic Test Plan to test an LDAP
-server.
- </p>
- <p >
+server.
+ </p>
+ <p >
As the Extended LDAP Sampler is highly configurable, this also means that it takes
some time to build a correct testplan. You can however tune it exactly up to your
needs.
-
- </p>
- <p >
+
+ </p>
+ <p >
You will create four users that send requests for four tests on the LDAP server.Also, you will tell
the users to run their tests twice. So, the total number of requests is (4 users) x (4 requests) x
-repeat 2 times) = 32 LDAP requests. To construct the Test Plan, you will use the following elements:
- <br >
- </br>
-
-
- <a href="test_plan.html#thread_group">
- Thread Group
- </a>
- ,
- <br >
- </br>
-
-
- <a href="../usermanual/component_reference.html#Adding_LDAP_Extended_Request_Defaults">Adding LDAP Extended Request Defaults</a>
- ,
- <br >
- </br>
-
-
- <a href="../usermanual/component_reference.html#Adding_LDAP_Requests">Adding LDAP Requests</a>
- , and
- <br >
- </br>
-
-
- <a href="../usermanual/component_reference.html#Adding_a_Listener_to_View/Store_the_Test_Results">Adding a Listener to View/Store the Test Results</a>
-
-
- </p>
- <p >
+repeat 2 times) = 32 LDAP requests. To construct the Test Plan, you will use the following elements:
+ <br >
+ </br>
+
+
+ <a href="test_plan.html#thread_group">
+ Thread Group
+ </a>
+ ,
+ <br >
+ </br>
+
+
+ <a href="../usermanual/component_reference.html#Adding_LDAP_Extended_Request_Defaults">Adding LDAP Extended Request Defaults</a>
+ ,
+ <br >
+ </br>
+
+
+ <a href="../usermanual/component_reference.html#Adding_LDAP_Requests">Adding LDAP Requests</a>
+ , and
+ <br >
+ </br>
+
+
+ <a href="../usermanual/component_reference.html#Adding_a_Listener_to_View/Store_the_Test_Results">Adding a Listener to View/Store the Test Results</a>
+
+
+ </p>
+ <p >
This example assumes that the LDAP Server is installed in your Local machine.
-
- </p>
- <p >
+
+ </p>
+ <p >
-For the less experienced LDAP users, I build a
- <a href="ldapops_tutor.html">
+For the less experienced LDAP users, I build a
+ <a href="ldapops_tutor.html">
small
-LDAP tutorial
- </a>
+LDAP tutorial
+ </a>
which shortly explains
the several LDAP operations that can be used in building a complex testplan.
-
- </p>
- <p >
+
+ </p>
+ <p >
Take care when using LDAP special characters in the distinghuished name, in that case (eg, you want to use a + sign in a
distinghuished name) you need to escape the character by adding an "\" sign before that character.
@@ -208,1027 +208,1027 @@
cn=dolf\+smits to add/search an entry with the name like cn=dolf+smits
cn=dolf \\ smits to search an entry with the name cn=dolf \ smits
cn=c:\\\\log.txt to add an entry with a name like cn=c:\log.txt
-
- </p>
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="ext_adding_users"><strong>9b.1 Adding Users</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
+
+ </p>
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#828DA6">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="ext_adding_users"><strong>9b.1 Adding Users</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <p >
The first step you want to do with every JMeter Test Plan is to add a Thread Group element.
The Thread Group tells JMeter the number of users you want to simulate, how often the users should send
requests, and the how many requests they should send.
-
- </p>
- <p >
+
+ </p>
+ <p >
Go ahead and add the ThreadGroup element by first selecting the Test Plan, clicking your
right mouse button to get the Add menu, and then select Add-->ThreadGroup. You should now see the
Thread Group element under Test Plan. If you do not see the element, then "expand" the Test Plan tree by
clicking on the Test Plan element.
-
- </p>
- <p >
+
+ </p>
+ <p >
-
- <p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/ldaptest/extthreadgroup.png"><br>
+
+ <p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/ldaptest/extthreadgroup.png"><br>
<font size="-1">
-Figure 9b.1. Thread Group with Default Values
- </font></td></tr></table></p>
+Figure 9b.1. Thread Group with Default Values
+ </font></td></tr></table></p>
-
- </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="add_ldapext_defaults"><strong>9b.2 Adding LDAP Extended Request Defaults</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
+
+ </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="add_ldapext_defaults"><strong>9b.2 Adding LDAP Extended Request Defaults</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <p >
Begin by selecting the Thread Group element. Click your right mouse button
to get the Add menu, and then select Add --> Config Element -->LDAP Extended Request Defaults. Then,
select this new element to view its Control Panel.
-
- </p>
- <p >
+
+ </p>
+ <p >
Like most JMeter elements, the LDAP Extended Request Defaults Control Panel has a name
field that you can modify. In this example, leave this field with the default value.
-
- </p>
- <p >
- <p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/ldaptest/extrequestdefaults.png"><br>
- <font size="-1"> <br >
- </br>
+
+ </p>
+ <p >
+ <p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/ldaptest/extrequestdefaults.png"><br>
+ <font size="-1"> <br >
+ </br>
- Figure 9b.2 LDAP Defaults for our Test Plan
- </font></td></tr></table></p>
+ Figure 9b.2 LDAP Defaults for our Test Plan
+ </font></td></tr></table></p>
-
- </p>
- <p >
+
+ </p>
+ <p >
For each of the different operations, some default values can be filled in.
In All cases, when a default is filled in, this is used for the LDAP extended requests.
For each requst, you can override the defaults by filling in the values in the LDAP extended request sampler.
When no valueis entered which is necesarry for a test, the test will fail in an unpredictable way!
-
- </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="add_extrequests"><strong>9b.3 Adding LDAP Requests</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
+
+ </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="add_extrequests"><strong>9b.3 Adding LDAP Requests</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <p >
In our Test Plan, we want to use all 8 LDAP requests.
-
- </p>
- <ol >
+
+ </p>
+ <ol >
-
- <li >
+
+ <li >
Thread bind
-
- </li>
+
+ </li>
-
- <li >
+
+ <li >
Search Test
-
- </li>
+
+ </li>
-
- <li >
+
+ <li >
Compare Test
-
- </li>
+
+ </li>
-
- <li >
+
+ <li >
Single bind/unbind Test
-
- </li>
+
+ </li>
-
- <li >
+
+ <li >
Add Test
-
- </li>
+
+ </li>
-
- <li >
+
+ <li >
Modify Test
-
- </li>
+
+ </li>
-
- <li >
+
+ <li >
Delete Test
-
- </li>
+
+ </li>
-
- <li >
+
+ <li >
Rename entry (moddn)
-
- </li>
+
+ </li>
-
- <li >
+
+ <li >
Thread unbind
-
- </li>
+
+ </li>
-
- </ol>
- <p >
+
+ </ol>
+ <p >
JMeter sends requests in the order that you add them to the tree.
-
- </p>
- <p >
-
-Adding a requests always start by:
- <br >
- </br>
+
+ </p>
+ <p >
+
+Adding a requests always start by:
+ <br >
+ </br>
Adding the LDAP Extended Request to the Thread Group element (Add -->
Sampler --> LDAP Ext Request). Then, select the LDAP Ext Request element in the tree
-and edit the following properties.
- </p>
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="add_threadbind"><strong>9b.3.1 Adding a Thread bind Request</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
+and edit the following properties.
+ </p>
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#828DA6">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="add_threadbind"><strong>9b.3.1 Adding a Thread bind Request</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <p >
-
- <ol >
+
+ <ol >
-
- <li >
+
+ <li >
Select the "Thread bind" button.
-
- </li>
+
+ </li>
-
- <li >
+
+ <li >
enter the hostname value from the LDAP server in the Servername field
-
- </li>
+
+ </li>
-
- <li >
+
+ <li >
Enter the portnumber from the LDAP server (389) in the port field
-
- </li>
+
+ </li>
-
- <li >
+
+ <li >
-(optional) enter the baseDN in the DN field, this baseDN will be used as thestarting point for searches, add, deletes etc.
- <br >
- </br>
-
-take care that this must be the uppermost shared level for all your request, eg When all information is stored under ou=people, dc=siemens, dc=com, you can use this value in the basedn.
- <br >
- </br>
-
-You cannot search or rename anymore in the subtree ou=users,dc=siemens,dc=com!
- <br >
- </br>
+(optional) enter the baseDN in the DN field, this baseDN will be used as thestarting point for searches, add, deletes etc.
+ <br >
+ </br>
+
+take care that this must be the uppermost shared level for all your request, eg When all information is stored under ou=people, dc=siemens, dc=com, you can use this value in the basedn.
+ <br >
+ </br>
+
+You cannot search or rename anymore in the subtree ou=users,dc=siemens,dc=com!
+ <br >
+ </br>
If you need to search or rename objects in both subtrees, use the common denominator (dc=siemens,dc=com) as the baseDN.
-
- </li>
+
+ </li>
-
- <li >
+
+ <li >
(Optional) enter the distinghuised name from the user you want to use for authentication.
When this field is kept empty, an anonymous bind will be established.
-
- </li>
+
+ </li>
-
- <li >
+
+ <li >
(optional) Enter the password for the user you want to authenticate with, an empty password will also lead to an anonymous bind.
-
- </li>
+
+ </li>
-
- </ol>
+
+ </ol>
-
- </p>
- <p >
+
+ </p>
+ <p >
-
- <p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/ldaptest/extthreadbind.png"><br>
+
+ <p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/ldaptest/extthreadbind.png"><br>
<font size="-1">
-Figure 9b.3.1. Thread Bind example
- </font></td></tr></table></p>
+Figure 9b.3.1. Thread Bind example
+ </font></td></tr></table></p>
-
- </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="add_searchreq"><strong>9b.3.2 Adding a search Request</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
+
+ </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="add_searchreq"><strong>9b.3.2 Adding a search Request</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <p >
-
- <ol >
+
+ <ol >
-
- <li >
+
+ <li >
Select the "Search Test" button.
-
- </li>
+
+ </li>
-
- <li >
+
+ <li >
-(Optional) enter the searchbase under which you want to perform the search, relative to the basedn, used in the thread bind request.
- <br >
- </br>
+(Optional) enter the searchbase under which you want to perform the search, relative to the basedn, used in the thread bind request.
+ <br >
+ </br>
When left empty, the basedn is used as a search base, this files is important if you want to use a "base-entry" or "one-level" search (see below)
-
- </li>
+
+ </li>
-
- <li >
+
+ <li >
Enter the searchfilter, any decent LDAP serach filter will do, but for now, use something simple, like cn=john doe
-
- </li>
+
+ </li>
-
- <li >
+
+ <li >
(optional) enter the scope in the scope field, it has three options:
-
- <ol >
+
+ <ol >
-
- <li >
- Base level, Enter the value 0
- <br >
- </br>
+
+ <li >
+ Base level, Enter the value 0
+ <br >
+ </br>
only the given searchbase is used, only for checking attributes or existence.
-
- </li>
+
+ </li>
-
- <li >
- One level, Enter the value 1
- <br >
- </br>
+
+ <li >
+ One level, Enter the value 1
+ <br >
+ </br>
Only search in one level below given searchbase is used
-
- </li>
+
+ </li>
-
- <li >
- Subtree, Enter the value 2
- <br >
- </br>
+
+ <li >
+ Subtree, Enter the value 2
+ <br >
+ </br>
Searches for object at any point below the given basedn
-
- </li>
- </ol>
+
+ </li>
+ </ol>
-
- </li>
+
+ </li>
-
- <li >
+
+ <li >
(Optional) Sizelimit, specifies the maximun number of returned entries,
-
- </li>
+
+ </li>
-
- <li >
+
+ <li >
-(optional) Timelimit, psecifies the maximum number of miliseconds, the SERVER can use for performing the search. it is NOT the maximun time the application will wait!
- <br >
- </br>
+(optional) Timelimit, psecifies the maximum number of miliseconds, the SERVER can use for performing the search. it is NOT the maximun time the application will wait!
+ <br >
+ </br>
When a very large returnset is returned, from a very fast server, over a very slow line, you may have to wait for ages for the completion of the search request, but this parameter will not influence this.
-
- </li>
+
+ </li>
-
- <li >
+
+ <li >
(Optional) Attributes you want in the search answer. This can be used to limit the size of the answer, especially when an onject has very large attributes (like jpegPhoto). There are three possibilities:
-
- <ol >
- <li >
+
+ <ol >
+ <li >
Leave empty (the default setting must also be empty) This will return all attributes.
-
- </li>
+
+ </li>
-
- <li >
+
+ <li >
Put in one empty value (""), it will request a non-existent attributes, so in reality it returns no attributes
-
- </li>
+
+ </li>
-
- <li >
+
+ <li >
Put in the attributes, seperated by a semi-colon. It will return only the requested attributes
-
- </li>
- </ol>
- </li>
-
-
- <li >
-
-(Optional) Return object, possible values are "true" and "false". True will return all java-object attributes, it will add these to the requested attributes, as specified above.
- <br >
- </br>
+
+ </li>
+ </ol>
+ </li>
+
+
+ <li >
+
+(Optional) Return object, possible values are "true" and "false". True will return all java-object attributes, it will add these to the requested attributes, as specified above.
+ <br >
+ </br>
false will mean no java-object attributes will be returned.
-
- </li>
+
+ </li>
-
- <li >
+
+ <li >
(Optional) Dereference aliases. possible values "true" and "false". True will mean it will follow references, false says it will not.
-
- </li>
+
+ </li>
-
- </ol>
+
+ </ol>
-
- </p>
- <p >
+
+ </p>
+ <p >
-
- <p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/ldaptest/extsearch.png"><br>
+
+ <p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/ldaptest/extsearch.png"><br>
<font size="-1">
-Figure 9b.3.2. search request example
- </font></td></tr></table></p>
+Figure 9b.3.2. search request example
+ </font></td></tr></table></p>
-
- </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="add_comparereq"><strong>9b.3.3 Adding a Compare Request</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
+
+ </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="add_comparereq"><strong>9b.3.3 Adding a Compare Request</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <p >
-
- <ol >
+
+ <ol >
-
- <li >
+
+ <li >
Select the "Compare" button.
-
- </li>
+
+ </li>
-
- <li >
+
+ <li >
enter the entryname form the object on which you want the compare operation to work, relative to the basedn, eg "cn=john doe,ou=people"
-
- </li>
+
+ </li>
-
- <li >
+
+ <li >
Enter the compare filter, this must be in the form "attribute=value", eg "mail=John.doe@siemens.com"
-
- </li>
+
+ </li>
-
- </ol>
+
+ </ol>
-
- </p>
- <p >
+
+ </p>
+ <p >
-
- <p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/ldaptest/extcompare.png"><br>
+
+ <p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/ldaptest/extcompare.png"><br>
<font size="-1">
-Figure 9b.3.3. Compare example
- </font></td></tr></table></p>
+Figure 9b.3.3. Compare example
+ </font></td></tr></table></p>
-
- </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="add_sbind"><strong>9b.3.4 Adding a Single bind/unbind</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
+
+ </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="add_sbind"><strong>9b.3.4 Adding a Single bind/unbind</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <p >
-
- <ol >
+
+ <ol >
-
- <li >
+
+ <li >
Select the "Single bind/unbind" button.
-
- </li>
+
+ </li>
-
- <li >
+
+ <li >
-Enter the FULL distinghuised name from the user you want to use for authentication.
- <br >
- </br>
+Enter the FULL distinghuised name from the user you want to use for authentication.
+ <br >
+ </br>
eg. cn=john doe,ou=people,dc=siemens,dc=com
When this field is kept empty, an anonymous bind will be established.
-
- </li>
+
+ </li>
-
- <li >
+
+ <li >
Enter the password for the user you want to authenticate with, an empty password will also lead to an anonymous bind.
-
- </li>
+
+ </li>
-
- <li >
+
+ <li >
Take care: This single bind/unbind is in reality two seperate operations but cannot easily be split!
-
- </li>
+
+ </li>
-
- </ol>
+
+ </ol>
-
- </p>
- <p >
+
+ </p>
+ <p >
-
- <p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/ldaptest/extsbind.png"><br>
+
+ <p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/ldaptest/extsbind.png"><br>
<font size="-1">
-Figure 9b.3.4. Single bind/unbind example
- </font></td></tr></table></p>
+Figure 9b.3.4. Single bind/unbind example
+ </font></td></tr></table></p>
-
- </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="add_addreq"><strong>9b.3.5 Adding an Add Request</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
+
+ </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="add_addreq"><strong>9b.3.5 Adding an Add Request</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <p >
-
- <ol >
+
+ <ol >
-
- <li >
+
+ <li >
Select the "Add" button.
-
- </li>
+
+ </li>
-
- <li >
+
+ <li >
Enter the distinghuised name for the object to add, relative to the basedn.
-
- </li>
+
+ </li>
-
- <li >
+
+ <li >
-Add a line in the "add test" table, fill in the attribute and value.
- <br >
- </br>
-
-When you need the same attribute more than once, just add a new line, add the attribute again, and a different value.
- <br >
- </br>
-
-All necessary attributes and values must be specified to pass the test, see picture!
- <br >
- </br>
+Add a line in the "add test" table, fill in the attribute and value.
+ <br >
+ </br>
+
+When you need the same attribute more than once, just add a new line, add the attribute again, and a different value.
+ <br >
+ </br>
+
+All necessary attributes and values must be specified to pass the test, see picture!
+ <br >
+ </br>
(sometimes the server adds the attribute "objectClass=top", this might give a problem.
-
- </li>
+
+ </li>
-
- </ol>
+
+ </ol>
-
- </p>
- <p >
+
+ </p>
+ <p >
-
- <p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/ldaptest/extadd.png"><br>
+
+ <p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/ldaptest/extadd.png"><br>
<font size="-1">
-Figure 9b.3.5. Add request example
- </font></td></tr></table></p>
+Figure 9b.3.5. Add request example
+ </font></td></tr></table></p>
-
- </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="add_modreq"><strong>9b.3.6 Adding a Modify Request</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
+
+ </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="add_modreq"><strong>9b.3.6 Adding a Modify Request</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <p >
-
- <ol >
+
+ <ol >
-
- <li >
+
+ <li >
Select the "Modify test" button.
-
- </li>
+
+ </li>
-
- <li >
+
+ <li >
Enter the distinghuised name for the object to modify, relative to the basedn.
-
- </li>
+
+ </li>
-
- <li >
+
+ <li >
Add a line in the "modify test" table, with the "add" button.
-
- </li>
+
+ </li>
-
- <li >
+
+ <li >
You need to enter the attribute you want to modify, (optional) a value, and the opcode. The meaning of this opcode:
-
- <ol >
- <li >
- add
- <br >
- </br>
- this will mean that the attribute value (not optional in this case) willbe added to the attribute.
- <br >
- </br>
-
-When the attribute is not existing, it will be created and the value added
- <br >
- </br>
-
-When it is existing, and defined multi-valued, the new value is added.
- <br >
- </br>
-
-when it is existing, but single valued, it will fail.
- </li>
-
-
- <li >
- replace
- <br >
- </br>
-
-This will overwrite the attribute with the given new value (not optional here)
- <br >
- </br>
-
-When the attribute is not existing, it will be created and the value added
- <br >
- </br>
-
-When it is existing, old values are removed, the new value is added.
- </li>
-
-
- <li >
- delete
- <br >
- </br>
-
-When no value is given, all values will be removed
- <br >
- </br>
-
-When a value is given, only that value will be removed
- <br >
- </br>
+
+ <ol >
+ <li >
+ add
+ <br >
+ </br>
+ this will mean that the attribute value (not optional in this case) willbe added to the attribute.
+ <br >
+ </br>
+
+When the attribute is not existing, it will be created and the value added
+ <br >
+ </br>
+
+When it is existing, and defined multi-valued, the new value is added.
+ <br >
+ </br>
+
+when it is existing, but single valued, it will fail.
+ </li>
+
+
+ <li >
+ replace
+ <br >
+ </br>
+
+This will overwrite the attribute with the given new value (not optional here)
+ <br >
+ </br>
+
+When the attribute is not existing, it will be created and the value added
+ <br >
+ </br>
+
+When it is existing, old values are removed, the new value is added.
+ </li>
+
+
+ <li >
+ delete
+ <br >
+ </br>
+
+When no value is given, all values will be removed
+ <br >
+ </br>
+
+When a value is given, only that value will be removed
+ <br >
+ </br>
when the given value is not existing, the test will fail
-
- </li>
- </ol>
-
-
- </li>
-
-
- <li >
-
-(Optional) Add more modifications in the "modify test" table.
- <br >
- </br>
+
+ </li>
+ </ol>
+
+
+ </li>
+
+
+ <li >
+
+(Optional) Add more modifications in the "modify test" table.
+ <br >
+ </br>
All modifications which are specified must succeed, to let the modification test pass. When one modification fails, NO modifications at all will be made and the entry will remain unchanged.
-
- </li>
+
+ </li>
-
- </ol>
+
+ </ol>
-
- </p>
- <p >
+
+ </p>
+ <p >
-
- <p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/ldaptest/extmod.png"><br>
+
+ <p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/ldaptest/extmod.png"><br>
<font size="-1">
-Figure 9b.3.6. Modify example
- </font></td></tr></table></p>
+Figure 9b.3.6. Modify example
+ </font></td></tr></table></p>
-
- </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="add_delreq"><strong>9b.3.7 Adding a Delete Request</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
+
+ </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="add_delreq"><strong>9b.3.7 Adding a Delete Request</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <p >
-
- <ol >
+
+ <ol >
-
- <li >
+
+ <li >
Select the "Delete" button.
-
- </li>
+
+ </li>
-
- <li >
+
+ <li >
-enter the name of the entry, relative to the baseDN, in the Delete-Field.
- <br >
- </br>
+enter the name of the entry, relative to the baseDN, in the Delete-Field.
+ <br >
+ </br>
that is, if you want to remove "cn=john doe,ou=people,dc=siemens,dc=com", and you set the baseDN to "dc=siemens,dc=com",
you need to enter "cn=john doe,ou=people" in the Delete-field.
-
- </li>
+
+ </li>
-
- </ol>
+
+ </ol>
-
- </p>
- <p >
+
+ </p>
+ <p >
-
- <p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/ldaptest/extdel.png"><br>
+
+ <p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/ldaptest/extdel.png"><br>
<font size="-1">
-Figure 9b.3.7. Delete example
- </font></td></tr></table></p>
+Figure 9b.3.7. Delete example
+ </font></td></tr></table></p>
-
- </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="add_moddn"><strong>9b.3.8 Adding a Rename Request (moddn)</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
+
+ </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="add_moddn"><strong>9b.3.8 Adding a Rename Request (moddn)</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <p >
-
- <ol >
+
+ <ol >
-
- <li >
+
+ <li >
Select the "Rename Entry" button.
-
- </li>
+
+ </li>
-
- <li >
+
+ <li >
-enter the name of the entry, relative to the baseDN, in the "old entry name-Field".
- <br >
- </br>
+enter the name of the entry, relative to the baseDN, in the "old entry name-Field".
+ <br >
+ </br>
that is, if you want to rename "cn=john doe,ou=people,dc=siemens,dc=com", and you set the baseDN to "dc=siemens,dc=com",
you need to enter "cn=john doe,ou=people" in the old entry name-field.
-
- </li>
+
+ </li>
-
- <li >
+
+ <li >
-enter the new name of the entry, relative to the baseDN, in the "new distinghuised name-Field".
- <br >
- </br>
-
-whne you only change the RDN, it will simply rename the entry
- <br >
- </br>
+enter the new name of the entry, relative to the baseDN, in the "new distinghuised name-Field".
+ <br >
+ </br>
+
+whne you only change the RDN, it will simply rename the entry
+ <br >
+ </br>
when you also add a differten subtree, eg you change from cn=john doe,ou=people to cn=john doe,ou=users, it will move the entry.
You can also move a complete subtree (If your LDAP server supports this!!!!), eg ou=people,ou=retired, to ou=oldusers,ou=users, this will move the complete subtee, plus all retired people in the subtree to the new place in the tree.
-
- </li>
+
+ </li>
-
- </ol>
+
+ </ol>
-
- </p>
- <p >
+
+ </p>
+ <p >
-
- <p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/ldaptest/extmoddn.png"><br>
+
+ <p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/ldaptest/extmoddn.png"><br>
<font size="-1">
-Figure 9b.3.8. Rename example
- </font></td></tr></table></p>
+Figure 9b.3.8. Rename example
+ </font></td></tr></table></p>
-
- </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="add_unbind"><strong>9b.3.9 Adding an unbind Request</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
+
+ </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="add_unbind"><strong>9b.3.9 Adding an unbind Request</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <p >
-
- <ol >
+
+ <ol >
-
- <li >
+
+ <li >
Select the "Thread unbind" button.
This will be enough as it just closes the current connection.
The information which is needed is already known by the system
-
- </li>
- </ol>
-
-
- </p>
- <p >
+
+ </li>
+ </ol>
+
+
+ </p>
+ <p >
-
- <p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/ldaptest/extthreadunbind.png"><br>
+
+ <p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/ldaptest/extthreadunbind.png"><br>
<font size="-1">
-Figure 9b.3.9. Unbind example
- </font></td></tr></table></p>
+Figure 9b.3.9. Unbind example
+ </font></td></tr></table></p>
-
- </p>
- </blockquote>
- </td></tr>
- <tr><td><br></td></tr>
- </table>
- </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="add_ldapext_listener"><strong>9b.4 Adding a Listener to View/Store the Test Results</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
+
+ </p>
+ </blockquote>
+ </td></tr>
+ <tr><td><br></td></tr>
+ </table>
+ </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="add_ldapext_listener"><strong>9b.4 Adding a Listener to View/Store the Test Results</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <p >
The final element you need to add to your Test Plan is a Listener.
This element is responsible for storing all of the results of your LDAP
requests in a file and presenting a visual model of the data.Select the Thread group
element and add a View Results Tree (Add --> Listener -->View Results Tree)
-
- </p>
- <p >
+
+ </p>
+ <p >
-
- <p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/ldaptest/extviewtree.png"><br>
+
+ <p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/ldaptest/extviewtree.png"><br>
<font size="-1">
-Figure 9b.4. View result Tree Listener
- </font></td></tr></table></p>
+Figure 9b.4. View result Tree Listener
+ </font></td></tr></table></p>
-
- </p>
- <p >
+
+ </p>
+ <p >
In this listener you have three tabs to view, the sampler result, the request and the response data.
-
- <ol >
+
+ <ol >
-
- <li >
+
+ <li >
The sampler result just contains the response time, the returncode and return message
-
- </li>
+
+ </li>
-
- <li >
+
+ <li >
The request gives a short description of the request that was made, in practice no relevant information
is contained here.
-
- </li>
+
+ </li>
-
- <li >
+
+ <li >
The response data contains the full details of the sent request, as well the full details of the received answer,
this is given in a (self defined) xml-style.
-
- <a href="ldapanswer_xml.html">
- The full description can be found here.
- </a>
-
-
- </li>
-
-
- </ol>
-
-
- </p>
- </blockquote>
- </td></tr>
- <tr><td><br></td></tr>
- </table>
- </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-ws-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="build-ldap-test-plan.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>
-<!-- end the processing -->
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+ <a href="ldapanswer_xml.html">
+ The full description can be found here.
+ </a>
+
+
+ </li>
+
+
+ </ol>
+
+
+ </p>
+ </blockquote>
+ </td></tr>
+ <tr><td><br></td></tr>
+ </table>
+ </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-ws-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="build-ldap-test-plan.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>
+<!-- end the processing -->
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
Propchange: jakarta/jmeter/trunk/docs/usermanual/build-ldapext-test-plan.html
------------------------------------------------------------------------------
svn:eol-style = native
Modified: jakarta/jmeter/trunk/docs/usermanual/build-monitor-test-plan.html
URL: http://svn.apache.org/viewvc/jakarta/jmeter/trunk/docs/usermanual/build-monitor-test-plan.html?rev=660629&r1=660628&r2=660629&view=diff
==============================================================================
--- jakarta/jmeter/trunk/docs/usermanual/build-monitor-test-plan.html (original)
+++ jakarta/jmeter/trunk/docs/usermanual/build-monitor-test-plan.html Tue May 27 11:05:49 2008
@@ -1,149 +1,149 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
-<!--
- Licensed to the Apache Software Foundation (ASF) under one or more
- contributor license agreements. See the NOTICE file distributed with
- this work for additional information regarding copyright ownership.
- The ASF licenses this file to You under the Apache License, Version 2.0
- (the "License"); you may not use this file except in compliance with
- the License. You may obtain a copy of the License at
-
- http://www.apache.org/licenses/LICENSE-2.0
-
- Unless required by applicable law or agreed to in writing, software
- distributed under the License is distributed on an "AS IS" BASIS,
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- See the License for the specific language governing permissions and
- limitations under the License.
--->
-
-<!-- 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: Building a Monitor Test Plan</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>
-</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>
-</td>
-<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="listeners.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Next</font></a></div>
- </td>
- <td bgcolor="#525D76">
- <div align="right"><a href="build-jms-topic-test-plan.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="building"><strong>13. Building a Monitor Test Plan</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+<!-- 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: Building a Monitor Test Plan</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>
+</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>
+</td>
+<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="listeners.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Next</font></a></div>
+ </td>
+ <td bgcolor="#525D76">
+ <div align="right"><a href="build-jms-topic-test-plan.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="building"><strong>13. Building a Monitor Test Plan</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <p >
In this section, you will learn how to create a
-
- <a href="build-test-plan.html">
- Test Plan
- </a>
+
+ <a href="build-test-plan.html">
+ Test Plan
+ </a>
to monitor webservers. Monitors
are useful for a stress testing and system management. Used with stress
testing, the monitor provides additional information about server performance.
@@ -152,316 +152,316 @@
monitor provides an easy way to monitor multiple servers from one console.
The monitor was designed to work with the status servlet in Tomcat 5. In
theory, any servlet container that supports JMX (Java Management Extension)
-can port the status servlet to provide the same information.
- </p>
- <p >
+can port the status servlet to provide the same information.
+ </p>
+ <p >
For those who want to use the monitor with other servlet or EJB containers,
Tomcat's status servlet should work with other containers for the memory
statistics without any modifications. To get thread information, you will
-need to change the MBeanServer lookup to retrieve the correct MBeans.
- </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="adding_server"><strong>13.1 Adding A Server</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
- The first step is to add a
- <a href="test_plan.html#thread_group">
- Thread Group
- </a>
+need to change the MBeanServer lookup to retrieve the correct MBeans.
+ </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="adding_server"><strong>13.1 Adding A Server</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <p >
+ The first step is to add a
+ <a href="test_plan.html#thread_group">
+ Thread Group
+ </a>
element. The Thread Group tells JMeter the number of threads you want. Always use
1, since we are using JMeter as a monitor. This is very important for those not
familiar with server monitors. As a general rule, using multiple threads for a
single server is bad and can create significant stress.
-
- </p>
- <p >
+
+ </p>
+ <p >
Go ahead and add the ThreadGroup element by first selecting the Test Plan,
clicking your right mouse button to get the Add menu, and then select
-Add --> ThreadGroup.
- </p>
- <p >
+Add --> ThreadGroup.
+ </p>
+ <p >
You should now see the Thread Group element under Test Plan. If you do not
-see the element, "expand" the Test Plan tree by clicking on the Test Plan element.
- </p>
- <p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/webtest/threadgroup.png"><br>
+see the element, "expand" the Test Plan tree by clicking on the Test Plan element.
+ </p>
+ <p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/webtest/threadgroup.png"><br>
<font size="-1">
-Figure 10.1. Thread Group with Default Values
- </font></td></tr></table></p>
- <p >
- Change the loop count to forever (or some large number) so that enough samples are generated.
- </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="adding_auth"><strong>13.2 HTTP Auth Manager</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
- Add the
- <a href="../usermanual/component_reference.html#HTTP_Authorization_Manager">HTTP Authorization Manager</a>
+Figure 10.1. Thread Group with Default Values
+ </font></td></tr></table></p>
+ <p >
+ Change the loop count to forever (or some large number) so that enough samples are generated.
+ </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="adding_auth"><strong>13.2 HTTP Auth Manager</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <p >
+ Add the
+ <a href="../usermanual/component_reference.html#HTTP_Authorization_Manager">HTTP Authorization Manager</a>
to the Thread Group element
(Add --> Config element --> HTTP Authorization Manager). Enter the username
and password for your webserver. Important note: the monitor only works with
Tomcat5 build 5.0.19 and newer. For instructions on how to setup Tomcat, please
-refer to tomcat 5 documentation.
- </p>
- <ol >
+refer to tomcat 5 documentation.
+ </p>
+ <ol >
-
- <li >
- leave the base URL blank
- </li>
-
-
- <li >
- enter the username
- </li>
-
-
- <li >
- enter the password
- </li>
-
-
- </ol>
- </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="adding_request"><strong>13.3 Adding HTTP Request</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
- Add the
- <a href="../usermanual/component_reference.html#HTTP_Request">HTTP Request</a>
+
+ <li >
+ leave the base URL blank
+ </li>
+
+
+ <li >
+ enter the username
+ </li>
+
+
+ <li >
+ enter the password
+ </li>
+
+
+ </ol>
+ </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="adding_request"><strong>13.3 Adding HTTP Request</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <p >
+ Add the
+ <a href="../usermanual/component_reference.html#HTTP_Request">HTTP Request</a>
to the Thread Group element
(Add --> Sampler --> HTTP Request). Then, select the HTTP Request element
in the tree and edit the following properties):
-
- <ol >
+
+ <ol >
-
- <li >
- Change the Name field to "Server Status".
- </li>
-
-
- <li >
- Enter the IP address or Hostname
- </li>
-
-
- <li >
- Enter the port number
- </li>
-
-
- <li >
- Set the Path field to "/manager/status" if you're using Tomcat.
- </li>
+
+ <li >
+ Change the Name field to "Server Status".
+ </li>
+
+
+ <li >
+ Enter the IP address or Hostname
+ </li>
+
+
+ <li >
+ Enter the port number
+ </li>
+
+
+ <li >
+ Set the Path field to "/manager/status" if you're using Tomcat.
+ </li>
-
- <li >
+
+ <li >
Add a request parameter named "XML" in uppercase. Give it a value of
-"true" in lowercase.
- </li>
+"true" in lowercase.
+ </li>
-
- <li >
- Check "Use as Monitor" at the bottom of the sampler
- </li>
-
-
- </ol>
-
-
- </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="adding_timer"><strong>13.4 Adding Constant Timer</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
+
+ <li >
+ Check "Use as Monitor" at the bottom of the sampler
+ </li>
+
+
+ </ol>
+
+
+ </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="adding_timer"><strong>13.4 Adding Constant Timer</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <p >
Add a timer to this thread group (Add --> Timer --> Constant Timer).
Enter 5000 milliseconds in the "Thread Delay" box. In general, using intervals shorter
than 5 seconds will add stress to your server. Find out what is an acceptable interval
-before you deploy the monitor in your production environment.
- </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="adding_listener"><strong>13.5 Adding a Listener to Store the Results</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
+before you deploy the monitor in your production environment.
+ </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="adding_listener"><strong>13.5 Adding a Listener to Store the Results</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <p >
If you want to save the raw results from the server, add a simple data
-
- <a href="component_reference.html#listeners">
- Listener
- </a>
+
+ <a href="component_reference.html#listeners">
+ Listener
+ </a>
. If you want to save the
calculated statistics, enter a filename in the listener. If you want to save both
- the raw data and statistics, make sure you use different filenames.
- </p>
- <p >
- Select the thread group element and add a
- <a href="../usermanual/component_reference.html#Simple_Data_Writer">Simple Data Writer</a>
+ the raw data and statistics, make sure you use different filenames.
+ </p>
+ <p >
+ Select the thread group element and add a
+ <a href="../usermanual/component_reference.html#Simple_Data_Writer">Simple Data Writer</a>
listener
(Add --> Listener --> Simple Data Writer). Next, you need to specify a directory
and filename of the output file. You can either type it into the filename field, or
-select the Browse button and browse to a directory and then enter a filename.
- </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="add_monitor_listener"><strong>13.6 Adding Monitor Results</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p >
- Add the
- <a href="component_reference.html#listeners">
- Listener
- </a>
+select the Browse button and browse to a directory and then enter a filename.
+ </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="add_monitor_listener"><strong>13.6 Adding Monitor Results</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <p >
+ Add the
+ <a href="component_reference.html#listeners">
+ Listener
+ </a>
by selecting the
test plan element (Add --> Listener -- > Monitor Results). There are two tabs in
the monitor results listener. The first is the "Health", which displays the status of
the last sample the monitor received. The second tab is "Performance", which shows a
historical view of the server's performance.
-
- </p>
- <p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/monitor_health.png"><br>
- <font size="-1"> </font></td></tr></table></p>
- <p >
+
+ </p>
+ <p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/monitor_health.png"><br>
+ <font size="-1"> </font></td></tr></table></p>
+ <p >
A quick note about how health is calculated. Typically, a server will crash if
it runs out of memory, or reached the maximum number of threads. In the case of
Tomcat 5, once the threads are maxed out, requests are placed in a queue until a
thread is available. The relative importance of threads vary between containers, so
the current implementation uses 50/50 to be conservative. A container that is more
efficient with thread management might not see any performance degradation, but
-the used memory definitely will show an impact.
- </p>
- <p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/monitor_screencap.png"><br>
- <font size="-1"> </font></td></tr></table></p>
- <p >
+the used memory definitely will show an impact.
+ </p>
+ <p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/monitor_screencap.png"><br>
+ <font size="-1"> </font></td></tr></table></p>
+ <p >
The performance graph shows for different lines. The free memory line shows how
much free memory is left in the current allocated block. Tomcat 5 returns the maximum
memory, but it is not graphed. In a well tuned environment, the server should never
-reach the maximum memory.
- </p>
- <p >
+reach the maximum memory.
+ </p>
+ <p >
Note the graph has captions on both sides of the graph. On the left is percent and
the right is dead/healthy. If the memory line spikes up and down rapidly, it could
indicate memory thrashing. In those situations, it is a good idea to profile the
application with Borland OptimizeIt or JProbe. What you want to see is a regular
pattern for load, memory and threads. Any erratic behavior usually indicates poor
-performance or a bug of some sort.
- </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="listeners.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Next</font></a></div>
- </td>
- <td bgcolor="#525D76">
- <div align="right"><a href="build-jms-topic-test-plan.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>
-<!-- end the processing -->
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+performance or a bug of some sort.
+ </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="listeners.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Next</font></a></div>
+ </td>
+ <td bgcolor="#525D76">
+ <div align="right"><a href="build-jms-topic-test-plan.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>
+<!-- end the processing -->
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
Propchange: jakarta/jmeter/trunk/docs/usermanual/build-monitor-test-plan.html
------------------------------------------------------------------------------
svn:eol-style = native
---------------------------------------------------------------------
To unsubscribe, e-mail: jmeter-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: jmeter-dev-help@jakarta.apache.org