Modified: jmeter/trunk/docs/usermanual/build-jms-topic-test-plan.html URL: http://svn.apache.org/viewvc/jmeter/trunk/docs/usermanual/build-jms-topic-test-plan.html?rev=1739469&r1=1739468&r2=1739469&view=diff ============================================================================== --- jmeter/trunk/docs/usermanual/build-jms-topic-test-plan.html (original) +++ jmeter/trunk/docs/usermanual/build-jms-topic-test-plan.html Sat Apr 16 14:36:00 2016 @@ -1,23 +1,12 @@ <!DOCTYPE html SYSTEM "about:legacy-compat"> <html lang="en"><head><META http-equiv="Content-Type" content="text/html; charset=iso-8859-15"><title>Apache JMeter - - User's Manual: Building a JMS (Java Messaging Service) Test Plan</title><meta name="viewport" content="width=device-width, initial-scale=1"><link href="http://fonts.googleapis.com/css?family=Merriweather:400normal"; rel="stylesheet" type="text/css"><link rel="stylesheet" type="text/css" href="../css/new-style.css"></head><body role="document"><a href="#content" class="hidden">Main content</a><div class="header"><!-- + User's Manual: Building a JMS (Java Messaging Service) Test Plan</title><meta name="viewport" content="width=device-width, initial-scale=1"><link href="http://fonts.googleapis.com/css?family=Merriweather:400normal"; rel="stylesheet" type="text/css"><link rel="stylesheet" type="text/css" href="../css/new-style.css"><link rel="apple-touch-icon-precomposed" href="../images/apple-touch-icon.png"><link rel="icon" href="../images/favicon.png"><meta name="msapplication-TileColor" content="#ffffff"><meta name="msapplication-TileImage" content="../images/mstile-144x144.png"><meta name="theme-color" content="#ffffff"></head><body role="document"><a href="#content" class="hidden">Main content</a><div class="header"><!-- APACHE LOGO - --><div><a href="http://www.apache.org";><img title="Apache Software Foundation" width="290" height="75" src="../images/asf-logo.png" alt="Logo ASF"></a></div><!-- + --><div><a href="http://www.apache.org";><img title="Apache Software Foundation" class="logo" src="../images/asf-logo.svg" alt="Logo ASF"></a></div><!-- PROJECT LOGO - --><div><a href="http://jmeter.apache.org/";><img src="../images/logo.jpg" alt="Apache JMeter"></a></div><div class="twitter"><div><a href="https://twitter.com/share"; class="twitter-share-button" data-text="Powerful Load Testing with Apache #JMeter" data-via="ApacheJMeter" data-lang="en-gb" data-size="large">Tweet</a><script> - (function(d,s,id){ - var js, - fjs=d.getElementsByTagName(s)[0], - p=/^http:/.test(d.location)?'http':'https'; - if (!d.getElementById(id)) { - js=d.createElement(s); - js.id=id; - js.src=p+'://platform.twitter.com/widgets.js'; - fjs.parentNode.insertBefore(js,fjs); - } - })(document, 'script', 'twitter-wjs'); - </script></div><div><a href="https://twitter.com/ApacheJMeter"; class="twitter-follow-button" data-show-count="false" data-lang="en-gb" data-size="large">Follow</a><script>(function(d,s,id){ + --><div><a href="http://jmeter.apache.org/";><img class="logo" src="../images/logo.svg" alt="Apache JMeter"></a></div><div class="banner"><iframe src="http://www.apache.org/ads/bannerbar.html"; style="border-width:0;" frameborder="0" scrolling="no"></iframe><div class="clear"></div></div></div><div class="nav"><div class="social menu"><div><a href="https://twitter.com/share"; class="twitter-share-button" data-text="Powerful Load Testing with Apache #JMeter" data-via="ApacheJMeter" data-lang="en-gb" data-size="large">Tweet</a><script> + (function(d,s,id){ var js, fjs=d.getElementsByTagName(s)[0], p=/^http:/.test(d.location)?'http':'https'; @@ -27,8 +16,19 @@ js.src=p+'://platform.twitter.com/widgets.js'; fjs.parentNode.insertBefore(js,fjs); } - })(document, 'script', 'twitter-wjs'); - </script></div></div><div class="banner"><iframe src="http://www.apache.org/ads/bannerbar.html"; style="border-width:0;" frameborder="0" scrolling="no"></iframe><div class="clear"></div></div></div><div class="nav"><ul class="menu"><li><div class="menu-title">About</div><ul><li><a href="../index.html">Overview</a></li><li><a href="http://twitter.com/ApacheJMeter";>JMeter on Twitter<img src="../images/twitter.png" alt="Icon for JMeter on Twitter"></a></li><li><a href="../issues.html">Issue Tracking</a></li><li><a href="http://projects.apache.org/feeds/rss/jmeter.xml";>Subscribe to What's New</a></li><li><a href="http://www.apache.org/licenses/";>License</a></li></ul></li></ul><ul class="menu"><li><div class="menu-title">Download</div><ul><li><a href="../download_jmeter.cgi">Download Releases</a></li><li><a href="../nightly.html">Developer (Nightly) Builds</a></li></ul></li></ul><ul class="menu"><li><div class="menu-title">Documentation</div><ul><li><a href="../changes.html" >Changes per version</a></li><li><a href="../usermanual/get-started.html">Get >Started</a></li><li><a href="../usermanual/index.html">User >Manual</a></li><li><a href="../usermanual/best-practices.html">Best >Practices</a></li><li><a >href="../usermanual/component_reference.html">Component >Reference</a></li><li><a href="../usermanual/functions.html">Functions >Reference</a></li><li><a href="../api/index.html">Javadocs</a></li><li><a >href="../building.html">Building JMeter and Add-Ons</a></li><li><a >href="http://wiki.apache.org/jmeter";>JMeter Wiki</a></li><li><a >href="http://wiki.apache.org/jmeter/JMeterFAQ";>FAQ >(Wiki)</a></li></ul></li></ul><ul class="menu"><li><div >class="menu-title">Tutorials (PDF format)</div><ul><li><a >href="../usermanual/jmeter_distributed_testing_step_by_step.pdf">Distributed >Testing</a></li><li><a >href="../usermanual/jmeter_proxy_step_by_step.pdf">Recording >Tests</a></li><li><a href="../usermanual/junitsampler_tutorial.pdf">JUnit >Sampler</a></li><li><a href="../us ermanual/jmeter_accesslog_sampler_step_by_step.pdf">Access Log Sampler</a></li><li><a href="../extending/jmeter_tutorial.pdf">Extending JMeter</a></li></ul></li></ul><ul class="menu"><li><div class="menu-title">Community</div><ul><li><a href="http://wiki.apache.org/jmeter/JMeterCommitters";>Contributors</a></li><li><a href="../mail.html">Mailing Lists</a></li><li><a href="../svnindex.html">SVN Repositories</a></li></ul></li></ul><ul class="menu"><li><div class="menu-title">Foundation</div><ul><li><a href="http://www.apache.org/";>ASF</a></li><li><a href="http://www.apache.org/foundation/getinvolved.html";>Get Involved in the ASF</a></li><li><a href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a></li><li><a href="http://www.apache.org/foundation/thanks.html";>Thanks</a></li></ul></li></ul></div><div class="main" id="content"><ul class="pagelinks"><li><a href="build-jms-point-to-point-test-plan.html">< Prev</a></li><li><a href="../index.html">Index</a></li><li><a hr ef="build-monitor-test-plan.html">Next ></a></li></ul><div class="section"><h1 id="building">12. Building a JMS Topic Test Plan<a class="sectionlink" href="#building" title="Link to here">¶</a></h1> + })(document, 'script', 'twitter-wjs'); + </script></div><div><a href="https://twitter.com/ApacheJMeter"; class="twitter-follow-button" data-show-count="false" data-lang="en-gb" data-size="large">Follow</a><script>(function(d,s,id){ + var js, + fjs=d.getElementsByTagName(s)[0], + p=/^http:/.test(d.location)?'http':'https'; + if (!d.getElementById(id)) { + js=d.createElement(s); + js.id=id; + js.src=p+'://platform.twitter.com/widgets.js'; + fjs.parentNode.insertBefore(js,fjs); + } + })(document, 'script', 'twitter-wjs'); + </script></div><div><a href="https://github.com/apache/jmeter";><img alt="star this repo" src="http://githubbadges.com/star.svg?user=apache&repo=jmeter&style=default";></a></div><div><a href="https://github.com/apache/jmeter/fork";><img alt="fork this repo" src="http://githubbadges.com/fork.svg?user=apache&repo=jmeter&style=default";></a></div><div><a href="https://maven-badges.herokuapp.com/maven-central/org.apache.jmeter/ApacheJMeter";><img alt="Maven Central" src="https://maven-badges.herokuapp.com/maven-central/org.apache.jmeter/ApacheJMeter/badge.png";></a></div></div><ul class="menu"><li onClick="return true"><div class="menu-title">About</div><ul><li><a href="../index.html">Overview</a></li><li><a href="http://www.apache.org/licenses/";>License</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><div class="menu-title">Download</div><ul><li><a href="../download_jmeter.cgi">Download Releases</a></li><li><a href="../nightly.html">Developer (Nightly) Builds</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><div class="menu-title">Documentation</div><ul><li><a href="../changes.html">Changes per version</a></li><li><a href="../usermanual/get-started.html">Get Started</a></li><li><a href="../usermanual/index.html">User Manual</a></li><li><a href="../usermanual/best-practices.html">Best Practices</a></li><li><a href="../usermanual/component_reference.html">Component Reference</a></li><li><a href="../usermanual/functions.html">Functions Reference</a></li><li><a href="../api/index.html">Javadocs</a></li><li><a href="../building.html">Building JMeter and Add-Ons</a></li><li><a href="http://wiki.apache.org/jmeter";>JMeter Wiki</a></li><li><a href="http://wiki.apache.org/jmeter/JMeterFAQ";>FAQ (Wiki)</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><div class="menu-title">Tutorials (PDF format)</div><ul><li><a href="../usermanual/jmeter_distributed_testing_step_by_step.pdf">Distributed Testing</a ></li><li><a href="../usermanual/jmeter_proxy_step_by_step.pdf">Recording >Tests</a></li><li><a href="../usermanual/junitsampler_tutorial.pdf">JUnit >Sampler</a></li><li><a >href="../usermanual/jmeter_accesslog_sampler_step_by_step.pdf">Access Log >Sampler</a></li><li><a href="../extending/jmeter_tutorial.pdf">Extending >JMeter</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><div >class="menu-title">Community</div><ul><li><a href="../issues.html">Issue >Tracking</a></li><li><a href="../mail.html">Mailing Lists</a></li><li><a >href="../svnindex.html">Source Repositories</a></li><li><a >href="../building.html">Building and Contributing</a></li><li><a >href="https://projects.apache.org/project.html?jmeter";>Project info at >Apache</a></li><li><a >href="http://wiki.apache.org/jmeter/JMeterCommitters";>Contributors</a></li></ul></li></ul><ul > class="menu"><li onClick="return true"><div >class="menu-title">Foundation</div><ul><li><a >href="http://www.apache.org/";>ASF</a></li><li><a href= "http://www.apache.org/foundation/getinvolved.html";>Get Involved in the ASF</a></li><li><a href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a></li><li><a href="http://www.apache.org/foundation/thanks.html";>Thanks</a></li></ul></li></ul></div><div class="main" id="content"><ul class="pagelinks"><li><a href="build-jms-point-to-point-test-plan.html">< Prev</a></li><li><a href="../index.html">Index</a></li><li><a href="build-monitor-test-plan.html">Next ></a></li></ul><div class="section"><h1 id="building">12. Building a JMS Topic Test Plan<a class="sectionlink" href="#building" title="Link to here">¶</a></h1> <div class="clear"></div><div class="note"> JMS requires some optional jars to be downloaded. Please refer to <a href="get-started.html">Getting Started</a> for full details. </div><div class="clear"></div> @@ -49,9 +49,9 @@ Topic messaging is generally used in cas consumed by multiple subscribers. Queue messaging is generally used for transactions where the sender expects a response. Messaging systems are quite different from normal HTTP requests. In HTTP, a single user sends a request and gets a response. -Messaging system can work in sychronous and asynchronous mode. A JMS sampler needs +Messaging system can work in synchronous and asynchronous mode. A JMS sampler needs the JMS implementation jar files; for example, from Apache ActiveMQ. -See <a href="#libraries_activemq">here</a> for the list of jars provided by ActiveMQ 3.0.</p> +See <a href="get-started.html#libraries_activemq">here</a> for the list of jars provided by ActiveMQ.</p> </div><div class="section"><h1 id="adding_users">12.1 Adding Users<a class="sectionlink" href="#adding_users" title="Link to here">¶</a></h1> <p>The first step is add a <a href="test_plan.html#thread_group">Thread Group</a> @@ -60,8 +60,8 @@ See <a href="#libraries_activemq">here</ send.</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> +clicking your right mouse button to get the <span class="menuchoice"><span class="guimenuitem">Add</span></span> menu, and then select +<span class="menuchoice"><span class="guimenuitem">Add</span> → <span class="guimenuitem">ThreadGroup</span></span>.</p> <p>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 @@ -77,11 +77,11 @@ Figure 12.1. Thread Group with Default V Figure 12.1. Thread Group with Default Values</figcaption></figure> <p>Start by providing a more descriptive name for our Thread Group. In the name -field, enter Subscribers.</p> +field, enter <span class="code">Subscribers</span>.</p> -<p>Next, increase the number of users (called threads) to 5.</p> +<p>Next, increase the number of users (called threads) to <span class="code">5</span>.</p> -<p>In the next field, the Ramp-Up Period, set the value to 0 +<p>In the next field, the Ramp-Up Period, set the value to <span class="code">0</span> seconds. This property tells JMeter how long to delay between starting each user. For example, if you enter a Ramp-Up Period of 5 seconds, JMeter will finish starting all of your users by the end of the 5 seconds. So, if we have @@ -89,15 +89,15 @@ finish starting all of your users by the would be 1 second (5 users / 5 seconds = 1 user per second). If you set the value to 0, JMeter will immediately start all users.</p> -<p>Clear the checkbox labeled "Forever", and enter a value of 10 in the Loop +<p>Clear the checkbox labeled "<span class="code">Forever</span>", and enter a value of <span class="code">10</span> in the Loop Count field. This property tells JMeter how many times to repeat your test. -If you enter a loop count value of 0, then JMeter will run your test only -once. To have JMeter repeatedly run your Test Plan, select the Forever +If you enter a loop count value of <span class="code">0</span>, then JMeter will run your test only +once. To have JMeter repeatedly run your Test Plan, select the <span class="code">Forever</span> checkbox.</p> <p>Repeat the process and add another thread group. For the second thread -group, enter "Publisher" in the name field, set the number of threads to 1, -and set the iteration to 10. +group, enter "<span class="code">Publisher</span>" in the name field, set the number of threads to <span class="code">1</span>, +and set the iteration to <span class="code">10</span>. </p> <div class="clear"></div><div class="note">In most applications, you have to manually accept @@ -109,28 +109,30 @@ leave the Control Panel (for example, wh </div><div class="section"><h1 id="adding_subscriber_publisher">12.2 Adding JMS Subscriber and Publisher<a class="sectionlink" href="#adding_subscriber_publisher" title="Link to here">¶</a></h1> -<p>Make sure the required jar files are in JMeter's lib directory. If they are +<p>Make sure the required jar files are in JMeter's <span class="code">lib</span> directory. If they are not, shutdown JMeter, copy the jar files over and restart JMeter.</p> <p>Start by adding the sampler <a href="../usermanual/component_reference.html#JMS_Subscriber">JMS Subscriber</a> -to the Subscribers element (Add --> Sampler --> JMS Subscriber). +to the Subscribers element +(<span class="menuchoice"><span class="guimenuitem">Add</span> → <span class="guimenuitem">Sampler</span> → <span class="guimenuitem">JMS Subscriber</span></span>). Then, select the JMS Subscriber element in the tree and edit the following properties: <ol> -<li>Change the Name field to "Sample Subscriber"</li> -<li>If the JMS provider uses the jndi.properties file, check the box</li> -<li>Enter the name of the InitialContextFactory class. For example, with ActiveMQ 5.4, the value is "org.apache.activemq.jndi.ActiveMQInitialContextFactory"</li> -<li>Enter the provider URL. This is the URL for the JNDI server, if there is one. For example, with ActiveMQ 5.4 on local machine with default port, the value is "tcp://localhost:61616"</li> +<li>Change the Name field to "<span class="code">Sample Subscriber</span>"</li> +<li>If the JMS provider uses the <span class="code">jndi.properties</span> file, check the box</li> +<li>Enter the name of the InitialContextFactory class. For example, with ActiveMQ 5.4, the value is "<span class="code">org.apache.activemq.jndi.ActiveMQInitialContextFactory</span>"</li> +<li>Enter the provider URL. This is the URL for the JNDI server, if there is one. For example, with ActiveMQ 5.4 on local machine with default port, the value is "<span class="code">tcp://localhost:61616</span>"</li> <li>Enter the name of the connection factory. Please refer to the documentation -of the JMS provider for the information. For ActiveMQ, the default is "ConnectionFactory"</li> -<li>Enter the name of the message topic. For ActiveMQ Dynamic Topics (create topics dynamically), example value is "dynamicTopics/MyStaticTopic1" -Note: Setup at startup mean that JMeter starting to listen on the Destination at beginning of test without name change possibility. +of the JMS provider for the information. For ActiveMQ, the default is "<span class="code">ConnectionFactory</span>"</li> +<li>Enter the name of the message topic. For ActiveMQ Dynamic Topics (create topics dynamically), example value is "<span class="code">dynamicTopics/MyStaticTopic1</span>" +<div class="clear"></div><div class="note">Note: Setup at startup mean that JMeter starting to listen on the Destination at beginning of test without name change possibility. Setup on Each sample mean that JMeter (re)starting to listen before run each JMS Subscriber sample, -this last option permit to have Destination name with some JMeter variables</li> -<li>If the JMS provider requires authentication, check "required" and enter the +this last option permit to have Destination name with some JMeter variables +</div><div class="clear"></div></li> +<li>If the JMS provider requires authentication, check "<span class="code">required</span>" and enter the username and password. For example, Orion JMS requires authentication, while ActiveMQ and MQSeries does not</li> -<li>Enter 10 in "Number of samples to aggregate". For performance reasons, the sampler +<li>Enter <span class="code">10</span> in "<span class="code">Number of samples to aggregate</span>". For performance reasons, the sampler will aggregate messages, since small messages will arrive very quickly. If the sampler didn't aggregate the messages, JMeter wouldn't be able to keep up.</li> <li>If you want to read the response, check the box</li> @@ -144,25 +146,27 @@ Figure 12.2. JMS Subscriber"></a><figcap Figure 12.2. JMS Subscriber</figcaption></figure> <p>Next add the sampler <a href="../usermanual/component_reference.html#JMS_Publisher">JMS Publisher</a> -to the Publisher element (Add --> Sampler --> JMS Subscriber). +to the Publisher element +(<span class="menuchoice"><span class="guimenuitem">Add</span> → <span class="guimenuitem">Sampler</span> → <span class="guimenuitem">JMS Subscriber</span></span>). Then, select the JMS Publisher element in the tree and edit the following properties: </p> <ol> -<li>Change the Name field to "Sample Publisher".</li> -<li>If the JMS provider uses the jndi.properties file, check the box</li> -<li>Enter the name of the InitialContextFactory class. For example, with ActiveMQ 5.4, the value is "org.apache.activemq.jndi.ActiveMQInitialContextFactory"</li> -<li>Enter the provider URL. This is the URL for the JNDI server, if there is one. For example, with ActiveMQ 5.4 on local machine with default port, the value is "tcp://localhost:61616"</li> +<li>Change the Name field to "<span class="code">Sample Publisher</span>".</li> +<li>If the JMS provider uses the <span class="code">jndi.properties</span> file, check the box</li> +<li>Enter the name of the InitialContextFactory class. For example, with ActiveMQ 5.4, the value is "<span class="code">org.apache.activemq.jndi.ActiveMQInitialContextFactory</span>"</li> +<li>Enter the provider URL. This is the URL for the JNDI server, if there is one. For example, with ActiveMQ 5.4 on local machine with default port, the value is "<span class="code">tcp://localhost:61616</span>"</li> <li>Enter the name of the connection factory. Please refer to the documentation -of the JMS provider for the information. For ActiveMQ, the default is "ConnectionFactory"</li> -<li>Enter the name of the message topic. For ActiveMQ Dynamic Topics (create topics dynamically), example value is "dynamicTopics/MyStaticTopic1". -Note: Setup at startup mean that JMeter starting connection with the Destination at beginning of test without name change possibility. +of the JMS provider for the information. For ActiveMQ, the default is "<span class="code">ConnectionFactory</span>"</li> +<li>Enter the name of the message topic. For ActiveMQ Dynamic Topics (create topics dynamically), example value is "<span class="code">dynamicTopics/MyStaticTopic1</span>". +<div class="clear"></div><div class="note">Note: Setup at startup mean that JMeter starting connection with the Destination at beginning of test without name change possibility. Setup on Each sample mean that JMeter (re)starting the connection before run each JMS Publisher sample, -this last option permit to have Destination name with some JMeter variables</li> -<li>If the JMS provider requires authentication, check "required" and enter the +this last option permit to have Destination name with some JMeter variables +</div><div class="clear"></div></li> +<li>If the JMS provider requires authentication, check "<span class="code">required</span>" and enter the username and password. For example, Orion JMS requires authentication, while ActiveMQ and MQSeries does not</li> -<li>Enter 10 in "Number of samples to aggregate". For performance reasons, the sampler +<li>Enter <span class="code">10</span> in "<span class="code">Number of samples to aggregate</span>". For performance reasons, the sampler will aggregate messages, since small messages will arrive very quickly. If the sampler didn't aggregate the messages, JMeter wouldn't be able to keep up.</li> <li>Select the appropriate configuration for getting the message to publish. If you @@ -183,8 +187,8 @@ Figure 12.3. JMS Publisher</figcaption>< responsible for storing all of the results of your HTTP requests in a file and presenting a visual model of the data.</p> -<p>Select the Test Plan element and add a <a href="../usermanual/component_reference.html#Graph_Results">Graph Results</a> listener (Add --> Listener ---> Graph Results). Next, you need to specify a directory and filename of the +<p>Select the Test Plan element and add a <a href="../usermanual/component_reference.html#Graph_Results">Graph Results</a> listener +(<span class="menuchoice"><span class="guimenuitem">Add</span> → <span class="guimenuitem">Listener</span> → <span class="guimenuitem">Graph Results</span></span>). 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> @@ -195,7 +199,7 @@ Figure 12.4. Graph Results Listener</fig </div><ul class="pagelinks"><li><a href="build-jms-point-to-point-test-plan.html">< Prev</a></li><li><a href="../index.html">Index</a></li><li><a href="build-monitor-test-plan.html">Next ></a></li></ul></div><div class="footer"><div class="copyright"> Copyright © 1999 – - 2015 + 2016 , Apache Software Foundation </div><div class="trademarks">Apache, Apache JMeter, JMeter, the Apache feather, and the Apache JMeter logo are
Modified: jmeter/trunk/docs/usermanual/build-ldap-test-plan.html URL: http://svn.apache.org/viewvc/jmeter/trunk/docs/usermanual/build-ldap-test-plan.html?rev=1739469&r1=1739468&r2=1739469&view=diff ============================================================================== --- jmeter/trunk/docs/usermanual/build-ldap-test-plan.html (original) +++ jmeter/trunk/docs/usermanual/build-ldap-test-plan.html Sat Apr 16 14:36:00 2016 @@ -1,23 +1,12 @@ <!DOCTYPE html SYSTEM "about:legacy-compat"> <html lang="en"><head><META http-equiv="Content-Type" content="text/html; charset=iso-8859-15"><title>Apache JMeter - - User's Manual: Building an LDAP Test Plan</title><meta name="viewport" content="width=device-width, initial-scale=1"><link href="http://fonts.googleapis.com/css?family=Merriweather:400normal"; rel="stylesheet" type="text/css"><link rel="stylesheet" type="text/css" href="../css/new-style.css"></head><body role="document"><a href="#content" class="hidden">Main content</a><div class="header"><!-- + User's Manual: Building an LDAP Test Plan</title><meta name="viewport" content="width=device-width, initial-scale=1"><link href="http://fonts.googleapis.com/css?family=Merriweather:400normal"; rel="stylesheet" type="text/css"><link rel="stylesheet" type="text/css" href="../css/new-style.css"><link rel="apple-touch-icon-precomposed" href="../images/apple-touch-icon.png"><link rel="icon" href="../images/favicon.png"><meta name="msapplication-TileColor" content="#ffffff"><meta name="msapplication-TileImage" content="../images/mstile-144x144.png"><meta name="theme-color" content="#ffffff"></head><body role="document"><a href="#content" class="hidden">Main content</a><div class="header"><!-- APACHE LOGO - --><div><a href="http://www.apache.org";><img title="Apache Software Foundation" width="290" height="75" src="../images/asf-logo.png" alt="Logo ASF"></a></div><!-- + --><div><a href="http://www.apache.org";><img title="Apache Software Foundation" class="logo" src="../images/asf-logo.svg" alt="Logo ASF"></a></div><!-- PROJECT LOGO - --><div><a href="http://jmeter.apache.org/";><img src="../images/logo.jpg" alt="Apache JMeter"></a></div><div class="twitter"><div><a href="https://twitter.com/share"; class="twitter-share-button" data-text="Powerful Load Testing with Apache #JMeter" data-via="ApacheJMeter" data-lang="en-gb" data-size="large">Tweet</a><script> - (function(d,s,id){ - var js, - fjs=d.getElementsByTagName(s)[0], - p=/^http:/.test(d.location)?'http':'https'; - if (!d.getElementById(id)) { - js=d.createElement(s); - js.id=id; - js.src=p+'://platform.twitter.com/widgets.js'; - fjs.parentNode.insertBefore(js,fjs); - } - })(document, 'script', 'twitter-wjs'); - </script></div><div><a href="https://twitter.com/ApacheJMeter"; class="twitter-follow-button" data-show-count="false" data-lang="en-gb" data-size="large">Follow</a><script>(function(d,s,id){ + --><div><a href="http://jmeter.apache.org/";><img class="logo" src="../images/logo.svg" alt="Apache JMeter"></a></div><div class="banner"><iframe src="http://www.apache.org/ads/bannerbar.html"; style="border-width:0;" frameborder="0" scrolling="no"></iframe><div class="clear"></div></div></div><div class="nav"><div class="social menu"><div><a href="https://twitter.com/share"; class="twitter-share-button" data-text="Powerful Load Testing with Apache #JMeter" data-via="ApacheJMeter" data-lang="en-gb" data-size="large">Tweet</a><script> + (function(d,s,id){ var js, fjs=d.getElementsByTagName(s)[0], p=/^http:/.test(d.location)?'http':'https'; @@ -27,8 +16,19 @@ js.src=p+'://platform.twitter.com/widgets.js'; fjs.parentNode.insertBefore(js,fjs); } - })(document, 'script', 'twitter-wjs'); - </script></div></div><div class="banner"><iframe src="http://www.apache.org/ads/bannerbar.html"; style="border-width:0;" frameborder="0" scrolling="no"></iframe><div class="clear"></div></div></div><div class="nav"><ul class="menu"><li><div class="menu-title">About</div><ul><li><a href="../index.html">Overview</a></li><li><a href="http://twitter.com/ApacheJMeter";>JMeter on Twitter<img src="../images/twitter.png" alt="Icon for JMeter on Twitter"></a></li><li><a href="../issues.html">Issue Tracking</a></li><li><a href="http://projects.apache.org/feeds/rss/jmeter.xml";>Subscribe to What's New</a></li><li><a href="http://www.apache.org/licenses/";>License</a></li></ul></li></ul><ul class="menu"><li><div class="menu-title">Download</div><ul><li><a href="../download_jmeter.cgi">Download Releases</a></li><li><a href="../nightly.html">Developer (Nightly) Builds</a></li></ul></li></ul><ul class="menu"><li><div class="menu-title">Documentation</div><ul><li><a href="../changes.html" >Changes per version</a></li><li><a href="../usermanual/get-started.html">Get >Started</a></li><li><a href="../usermanual/index.html">User >Manual</a></li><li><a href="../usermanual/best-practices.html">Best >Practices</a></li><li><a >href="../usermanual/component_reference.html">Component >Reference</a></li><li><a href="../usermanual/functions.html">Functions >Reference</a></li><li><a href="../api/index.html">Javadocs</a></li><li><a >href="../building.html">Building JMeter and Add-Ons</a></li><li><a >href="http://wiki.apache.org/jmeter";>JMeter Wiki</a></li><li><a >href="http://wiki.apache.org/jmeter/JMeterFAQ";>FAQ >(Wiki)</a></li></ul></li></ul><ul class="menu"><li><div >class="menu-title">Tutorials (PDF format)</div><ul><li><a >href="../usermanual/jmeter_distributed_testing_step_by_step.pdf">Distributed >Testing</a></li><li><a >href="../usermanual/jmeter_proxy_step_by_step.pdf">Recording >Tests</a></li><li><a href="../usermanual/junitsampler_tutorial.pdf">JUnit >Sampler</a></li><li><a href="../us ermanual/jmeter_accesslog_sampler_step_by_step.pdf">Access Log Sampler</a></li><li><a href="../extending/jmeter_tutorial.pdf">Extending JMeter</a></li></ul></li></ul><ul class="menu"><li><div class="menu-title">Community</div><ul><li><a href="http://wiki.apache.org/jmeter/JMeterCommitters";>Contributors</a></li><li><a href="../mail.html">Mailing Lists</a></li><li><a href="../svnindex.html">SVN Repositories</a></li></ul></li></ul><ul class="menu"><li><div class="menu-title">Foundation</div><ul><li><a href="http://www.apache.org/";>ASF</a></li><li><a href="http://www.apache.org/foundation/getinvolved.html";>Get Involved in the ASF</a></li><li><a href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a></li><li><a href="http://www.apache.org/foundation/thanks.html";>Thanks</a></li></ul></li></ul></div><div class="main" id="content"><ul class="pagelinks"><li><a href="build-ftp-test-plan.html">< Prev</a></li><li><a href="../index.html">Index</a></li><li><a href="build-ldape xt-test-plan.html">Next ></a></li></ul><div class="section"><h1 id="building">9a. Building an LDAP Test Plan<a class="sectionlink" href="#building" title="Link to here">¶</a></h1> + })(document, 'script', 'twitter-wjs'); + </script></div><div><a href="https://twitter.com/ApacheJMeter"; class="twitter-follow-button" data-show-count="false" data-lang="en-gb" data-size="large">Follow</a><script>(function(d,s,id){ + var js, + fjs=d.getElementsByTagName(s)[0], + p=/^http:/.test(d.location)?'http':'https'; + if (!d.getElementById(id)) { + js=d.createElement(s); + js.id=id; + js.src=p+'://platform.twitter.com/widgets.js'; + fjs.parentNode.insertBefore(js,fjs); + } + })(document, 'script', 'twitter-wjs'); + </script></div><div><a href="https://github.com/apache/jmeter";><img alt="star this repo" src="http://githubbadges.com/star.svg?user=apache&repo=jmeter&style=default";></a></div><div><a href="https://github.com/apache/jmeter/fork";><img alt="fork this repo" src="http://githubbadges.com/fork.svg?user=apache&repo=jmeter&style=default";></a></div><div><a href="https://maven-badges.herokuapp.com/maven-central/org.apache.jmeter/ApacheJMeter";><img alt="Maven Central" src="https://maven-badges.herokuapp.com/maven-central/org.apache.jmeter/ApacheJMeter/badge.png";></a></div></div><ul class="menu"><li onClick="return true"><div class="menu-title">About</div><ul><li><a href="../index.html">Overview</a></li><li><a href="http://www.apache.org/licenses/";>License</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><div class="menu-title">Download</div><ul><li><a href="../download_jmeter.cgi">Download Releases</a></li><li><a href="../nightly.html">Developer (Nightly) Builds</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><div class="menu-title">Documentation</div><ul><li><a href="../changes.html">Changes per version</a></li><li><a href="../usermanual/get-started.html">Get Started</a></li><li><a href="../usermanual/index.html">User Manual</a></li><li><a href="../usermanual/best-practices.html">Best Practices</a></li><li><a href="../usermanual/component_reference.html">Component Reference</a></li><li><a href="../usermanual/functions.html">Functions Reference</a></li><li><a href="../api/index.html">Javadocs</a></li><li><a href="../building.html">Building JMeter and Add-Ons</a></li><li><a href="http://wiki.apache.org/jmeter";>JMeter Wiki</a></li><li><a href="http://wiki.apache.org/jmeter/JMeterFAQ";>FAQ (Wiki)</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><div class="menu-title">Tutorials (PDF format)</div><ul><li><a href="../usermanual/jmeter_distributed_testing_step_by_step.pdf">Distributed Testing</a ></li><li><a href="../usermanual/jmeter_proxy_step_by_step.pdf">Recording >Tests</a></li><li><a href="../usermanual/junitsampler_tutorial.pdf">JUnit >Sampler</a></li><li><a >href="../usermanual/jmeter_accesslog_sampler_step_by_step.pdf">Access Log >Sampler</a></li><li><a href="../extending/jmeter_tutorial.pdf">Extending >JMeter</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><div >class="menu-title">Community</div><ul><li><a href="../issues.html">Issue >Tracking</a></li><li><a href="../mail.html">Mailing Lists</a></li><li><a >href="../svnindex.html">Source Repositories</a></li><li><a >href="../building.html">Building and Contributing</a></li><li><a >href="https://projects.apache.org/project.html?jmeter";>Project info at >Apache</a></li><li><a >href="http://wiki.apache.org/jmeter/JMeterCommitters";>Contributors</a></li></ul></li></ul><ul > class="menu"><li onClick="return true"><div >class="menu-title">Foundation</div><ul><li><a >href="http://www.apache.org/";>ASF</a></li><li><a href= "http://www.apache.org/foundation/getinvolved.html";>Get Involved in the ASF</a></li><li><a href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a></li><li><a href="http://www.apache.org/foundation/thanks.html";>Thanks</a></li></ul></li></ul></div><div class="main" id="content"><ul class="pagelinks"><li><a href="build-ftp-test-plan.html">< Prev</a></li><li><a href="../index.html">Index</a></li><li><a href="build-ldapext-test-plan.html">Next ></a></li></ul><div class="section"><h1 id="building">9a. Building an LDAP Test Plan<a class="sectionlink" href="#building" title="Link to here">¶</a></h1> <p>In this section, you will learn how to create a basic Test Plan to test an LDAP server. 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 4 times. So, the total number of requests is (4 users) x (4 requests) x @@ -44,7 +44,8 @@ repeat 4 times) = 40 LDAP requests. To c 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>Go ahead and add the ThreadGroup element by first selecting the Test Plan, clicking your -right mouse button to get the <b>Add</b> menu, and then select <b>Add</b>><b>ThreadGroup</b>. You should now see the +right mouse button to get the <span class="menuchoice"><span class="guimenuitem">Add</span></span> menu, and then select +<span class="menuchoice"><span class="guimenuitem">Add</span> → <span class="guimenuitem">ThreadGroup</span></span>. 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. <figure><a href="../images/screenshots/ldaptest/threadgroup.png"><img src="../images/screenshots/ldaptest/threadgroup.png" width="" height="" alt=" @@ -53,10 +54,11 @@ Figure 9a.1. Thread Group and final test </p> </div><div class="section"><h1 id="add_login">9a.2 Adding Login Config Element<a class="sectionlink" href="#add_login" title="Link to here">¶</a></h1> - <p>Begin by selecting the <b>LDAP Users</b> element. Click your right mouse -button to get the Add menu, and then select <b>Add</b>><b>Config Element</b>><b>Login Config Element</b>. + <p>Begin by selecting the <span class="code">LDAP Users</span> element. Click your right mouse +button to get the Add menu, and then select + <span class="menuchoice"><span class="guimenuitem">Add</span> → <span class="guimenuitem">Config Element</span> → <span class="guimenuitem">Login Config Element</span></span>. Then, select this new element to view its Control Panel.</p> - <p>Like most JMeter elements, the <b>Login Config Element</b>'s Control Panel has a name + <p>Like most JMeter elements, the <span class="code">Login Config Element</span>'s Control Panel has a name field that you can modify. In this example, leave this field with the default value.</p> <figure><a href="../images/screenshots/ldaptest/login-config-element.png"><img src="../images/screenshots/ldaptest/login-config-element.png" width="" height="" alt=" @@ -64,14 +66,15 @@ field that you can modify. In this examp Figure 9a.2 Login Config Element for our Test Plan</figcaption></figure> <div class="clear"></div><div class="note"><p>Enter Username field to "your LDAP Username",<br> - The password field to "your LDAP Passowrd"</p> + The password field to "your LDAP Password"</p> <p>These values will be used by the LDAP Requests.</p></div><div class="clear"></div> </div><div class="section"><h1 id="add_defaults">9a.3 Adding LDAP Request Defaults<a class="sectionlink" href="#add_defaults" title="Link to here">¶</a></h1> - <p>Begin by selecting the LDAP Users element. Click your right mouse button -to get the <b>Add</b> menu, and then select <b>Add</b>><b>Config Element</b>><b>LDAP Request Defaults</b>. Then, + <p>Begin by selecting the <span class="code">LDAP Users</span> element. Click your right mouse button +to get the <span class="menuchoice"><span class="guimenuitem">Add</span></span> menu, and then select +<span class="menuchoice"><span class="guimenuitem">Add</span> → <span class="guimenuitem">Config Element</span> → <span class="guimenuitem">LDAP Request Defaults</span></span>. Then, select this new element to view its Control Panel.</p> - <p>Like most JMeter elements, the <b>LDAP Request Defaults</b> Control Panel has a name + <p>Like most JMeter elements, the <span class="code">LDAP Request Defaults</span> Control Panel has a name field that you can modify. In this example, leave this field with the default value.</p> @@ -79,9 +82,9 @@ field that you can modify. In this examp Figure 9a.3 LDAP Defaults for our Test Plan"></a><figcaption> Figure 9a.3 LDAP Defaults for our Test Plan</figcaption></figure> - <div class="clear"></div><div class="note">Enter DN field to "your LDAP Root Distinguished Name".<br> - Enter LDAP Server's Servername field to "ldap.test.com".<br> - The port to 389.<br> + <div class="clear"></div><div class="note">Enter <span class="code">DN</span> field to "<span class="code">your LDAP Root Distinguished Name</span>".<br> + Enter LDAP Server's <span class="code">Servername</span> field to "<span class="code">ldap.test.com</span>".<br> + The <span class="code">port</span> to <span class="code">389</span>.<br> These values are default for the LDAP Requests.</div><div class="clear"></div> </div><div class="section"><h1 id="add_requests">9a.4 Adding LDAP Requests<a class="sectionlink" href="#add_requests" title="Link to here">¶</a></h1> <p>In our Test Plan, we need to make four LDAP requests.</p> @@ -93,26 +96,26 @@ field that you can modify. In this examp </ol> <p>JMeter sends requests in the order that you add them to the tree. -Start by adding the first LDAP Request to the LDAP Users element (<b>Add</b>><b> -Sampler</b>><b>LDAP Request</b>). Then, select the LDAP Request element in the tree +Start by adding the first LDAP Request to the LDAP Users element +(<span class="menuchoice"><span class="guimenuitem">Add</span> → <span class="guimenuitem">Sampler</span> → <span class="guimenuitem">LDAP Request</span></span>). Then, select the LDAP Request element in the tree and edit the following properties</p> <ol> - <li>Rename to "Add" this element</li> - <li>Select the <b>Add Test</b> radio button in <b>Test Configuration</b> group</li> + <li>Rename to "<span class="code">Add</span>" this element</li> + <li>Select the <span class="code">Add Test</span> radio button in <span class="code">Test Configuration</span> group</li> </ol> <figure><a href="../images/screenshots/ldaptest/add.png"><img src="../images/screenshots/ldaptest/add.png" width="" height="" alt=" Figure 9a.4.1 LDAP Request for Inbuilt Add test"></a><figcaption> Figure 9a.4.1 LDAP Request for Inbuilt Add test</figcaption></figure> - <p>You do not have to set the Server Name field, port field, Username, Password -and DN because you already specified this value in the <b>Login Config Element</b> and -<b>LDAP Request Defaults.</b></p> + <p>You do not have to set the <span class="code">Servername</span> field, <span class="code">port</span> field, <span class="code">Username</span>, <span class="code">Password</span> +and <span class="code">DN</span> because you already specified this value in the <span class="code">Login Config Element</span> and +<span class="code">LDAP Request Defaults.</span></p> <p>Next, add the second LDAP Request and edit the following properties</p> <ol> - <li>Rename to "Search" this element</li> - <li>Select the <b>Search Test</b> radio button in <b>Test Configuration</b> group</li> + <li>Rename to "<span class="code">Search</span>" this element</li> + <li>Select the <span class="code">Search Test</span> radio button in <span class="code">Test Configuration</span> group</li> </ol> Next, add the Third LDAP Request and edit the following properties <figure><a href="../images/screenshots/ldaptest/search.png"><img src="../images/screenshots/ldaptest/search.png" width="" height="" alt=" @@ -120,8 +123,8 @@ properties</p> Figure 9a.4.2 LDAP Request for Inbuilt Search test</figcaption></figure> <ol> - <li>Rename to "Modify" this element</li> - <li>Select the <b>Modify Test</b> radio button in <b>Test Configuration</b> group</li> + <li>Rename to "<span class="code">Modify</span>" this element</li> + <li>Select the <span class="code">Modify Test</span> radio button in <span class="code">Test Configuration</span> group</li> </ol> Next, add the fourth LDAP Request and edit the following properties @@ -130,8 +133,8 @@ properties</p> Figure 9a.4.3 LDAP Request for Inbuilt Modify test</figcaption></figure> <ol> - <li>Rename to "Delete" this element</li> - <li>Select the <b>Delete Test</b> radio button in <b>Test Configuration</b> group</li> + <li>Rename to "<span class="code">Delete</span>" this element</li> + <li>Select the <span class="code">Delete Test</span> radio button in <span class="code">Test Configuration</span> group</li> </ol> <figure><a href="../images/screenshots/ldaptest/delete.png"><img src="../images/screenshots/ldaptest/delete.png" width="" height="" alt=" Figure 9a.4.4 LDAP Request for Inbuilt Delete test"></a><figcaption> @@ -139,13 +142,14 @@ properties</p> </div><div class="section"><h1 id="ResponseAssertion">9a.5 Adding a Response Assertion<a class="sectionlink" href="#ResponseAssertion" title="Link to here">¶</a></h1> <p>You can add a Response Assertion element. - This element will check the received response data by verifying if the response text is "successful". - (<b>Add</b>><b>Assertion</b>><b>Response Assertion</b>).<br>Note: A this position in the tree, - the Response Assertion will be executed for each LDAP Request.</p> + This element will check the received response data by verifying if the response text is "<span class="code">successful</span>". + (<span class="menuchoice"><span class="guimenuitem">Add</span> → <span class="guimenuitem">Assertion</span> → <span class="guimenuitem">Response Assertion</span></span>).</p> +<div class="clear"></div><div class="note">Note: A this position in the tree, + the Response Assertion will be executed for each LDAP Request.</div><div class="clear"></div> <ol> - <li>Select <b>Text Response</b> Radio button in <b>Response Field to Test</b> group</li> - <li>Select <b>Substring</b> Radio button in <b>Pattern Matching Rules</b> group</li> - <li>Click on <b>Add</b> button and add the string "successful" in <b>Pattern to Test</b> field</li> + <li>Select <span class="code">Text Response</span> Radio button in <span class="code">Response Field to Test</span> group</li> + <li>Select <span class="code">Substring</span> Radio button in <span class="code">Pattern Matching Rules</span> group</li> + <li>Click on <span class="code">Add</span> button and add the string "<span class="code">successful</span>" in <span class="code">Pattern to Test</span> field</li> </ol> <figure><a href="../images/screenshots/ldaptest/responseassertion.png"><img src="../images/screenshots/ldaptest/responseassertion.png" width="" height="" alt=" Figure 9a.5 LDAP Response Assertion"></a><figcaption> @@ -154,7 +158,8 @@ properties</p> <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 LDAP -Users element and add a View Results in Table (<b>Add</b>><b>Listener</b>><b>View Results in Table</b>)</p> +Users element and add a View Results in Table +(<span class="menuchoice"><span class="guimenuitem">Add</span> → <span class="guimenuitem">Listener</span> → <span class="guimenuitem">View Results in Table</span></span>)</p> <figure><a href="../images/screenshots/ldaptest/viewtable.png"><img src="../images/screenshots/ldaptest/viewtable.png" width="" height="" alt=" Figure 9a.6 View Results in Table Listener"></a><figcaption> Figure 9a.6 View Results in Table Listener</figcaption></figure> @@ -162,7 +167,7 @@ Users element and add a View Results in </div><ul class="pagelinks"><li><a href="build-ftp-test-plan.html">< Prev</a></li><li><a href="../index.html">Index</a></li><li><a href="build-ldapext-test-plan.html">Next ></a></li></ul></div><div class="footer"><div class="copyright"> Copyright © 1999 – - 2015 + 2016 , Apache Software Foundation </div><div class="trademarks">Apache, Apache JMeter, JMeter, the Apache feather, and the Apache JMeter logo are Modified: jmeter/trunk/docs/usermanual/build-ldapext-test-plan.html URL: http://svn.apache.org/viewvc/jmeter/trunk/docs/usermanual/build-ldapext-test-plan.html?rev=1739469&r1=1739468&r2=1739469&view=diff ============================================================================== --- jmeter/trunk/docs/usermanual/build-ldapext-test-plan.html (original) +++ jmeter/trunk/docs/usermanual/build-ldapext-test-plan.html Sat Apr 16 14:36:00 2016 @@ -1,23 +1,12 @@ <!DOCTYPE html SYSTEM "about:legacy-compat"> <html lang="en"><head><META http-equiv="Content-Type" content="text/html; charset=iso-8859-15"><title>Apache JMeter - - User's Manual: Building an Extended LDAP Test Plan</title><meta name="viewport" content="width=device-width, initial-scale=1"><link href="http://fonts.googleapis.com/css?family=Merriweather:400normal"; rel="stylesheet" type="text/css"><link rel="stylesheet" type="text/css" href="../css/new-style.css"></head><body role="document"><a href="#content" class="hidden">Main content</a><div class="header"><!-- + User's Manual: Building an Extended LDAP Test Plan</title><meta name="viewport" content="width=device-width, initial-scale=1"><link href="http://fonts.googleapis.com/css?family=Merriweather:400normal"; rel="stylesheet" type="text/css"><link rel="stylesheet" type="text/css" href="../css/new-style.css"><link rel="apple-touch-icon-precomposed" href="../images/apple-touch-icon.png"><link rel="icon" href="../images/favicon.png"><meta name="msapplication-TileColor" content="#ffffff"><meta name="msapplication-TileImage" content="../images/mstile-144x144.png"><meta name="theme-color" content="#ffffff"></head><body role="document"><a href="#content" class="hidden">Main content</a><div class="header"><!-- APACHE LOGO - --><div><a href="http://www.apache.org";><img title="Apache Software Foundation" width="290" height="75" src="../images/asf-logo.png" alt="Logo ASF"></a></div><!-- + --><div><a href="http://www.apache.org";><img title="Apache Software Foundation" class="logo" src="../images/asf-logo.svg" alt="Logo ASF"></a></div><!-- PROJECT LOGO - --><div><a href="http://jmeter.apache.org/";><img src="../images/logo.jpg" alt="Apache JMeter"></a></div><div class="twitter"><div><a href="https://twitter.com/share"; class="twitter-share-button" data-text="Powerful Load Testing with Apache #JMeter" data-via="ApacheJMeter" data-lang="en-gb" data-size="large">Tweet</a><script> - (function(d,s,id){ - var js, - fjs=d.getElementsByTagName(s)[0], - p=/^http:/.test(d.location)?'http':'https'; - if (!d.getElementById(id)) { - js=d.createElement(s); - js.id=id; - js.src=p+'://platform.twitter.com/widgets.js'; - fjs.parentNode.insertBefore(js,fjs); - } - })(document, 'script', 'twitter-wjs'); - </script></div><div><a href="https://twitter.com/ApacheJMeter"; class="twitter-follow-button" data-show-count="false" data-lang="en-gb" data-size="large">Follow</a><script>(function(d,s,id){ + --><div><a href="http://jmeter.apache.org/";><img class="logo" src="../images/logo.svg" alt="Apache JMeter"></a></div><div class="banner"><iframe src="http://www.apache.org/ads/bannerbar.html"; style="border-width:0;" frameborder="0" scrolling="no"></iframe><div class="clear"></div></div></div><div class="nav"><div class="social menu"><div><a href="https://twitter.com/share"; class="twitter-share-button" data-text="Powerful Load Testing with Apache #JMeter" data-via="ApacheJMeter" data-lang="en-gb" data-size="large">Tweet</a><script> + (function(d,s,id){ var js, fjs=d.getElementsByTagName(s)[0], p=/^http:/.test(d.location)?'http':'https'; @@ -27,8 +16,19 @@ js.src=p+'://platform.twitter.com/widgets.js'; fjs.parentNode.insertBefore(js,fjs); } - })(document, 'script', 'twitter-wjs'); - </script></div></div><div class="banner"><iframe src="http://www.apache.org/ads/bannerbar.html"; style="border-width:0;" frameborder="0" scrolling="no"></iframe><div class="clear"></div></div></div><div class="nav"><ul class="menu"><li><div class="menu-title">About</div><ul><li><a href="../index.html">Overview</a></li><li><a href="http://twitter.com/ApacheJMeter";>JMeter on Twitter<img src="../images/twitter.png" alt="Icon for JMeter on Twitter"></a></li><li><a href="../issues.html">Issue Tracking</a></li><li><a href="http://projects.apache.org/feeds/rss/jmeter.xml";>Subscribe to What's New</a></li><li><a href="http://www.apache.org/licenses/";>License</a></li></ul></li></ul><ul class="menu"><li><div class="menu-title">Download</div><ul><li><a href="../download_jmeter.cgi">Download Releases</a></li><li><a href="../nightly.html">Developer (Nightly) Builds</a></li></ul></li></ul><ul class="menu"><li><div class="menu-title">Documentation</div><ul><li><a href="../changes.html" >Changes per version</a></li><li><a href="../usermanual/get-started.html">Get >Started</a></li><li><a href="../usermanual/index.html">User >Manual</a></li><li><a href="../usermanual/best-practices.html">Best >Practices</a></li><li><a >href="../usermanual/component_reference.html">Component >Reference</a></li><li><a href="../usermanual/functions.html">Functions >Reference</a></li><li><a href="../api/index.html">Javadocs</a></li><li><a >href="../building.html">Building JMeter and Add-Ons</a></li><li><a >href="http://wiki.apache.org/jmeter";>JMeter Wiki</a></li><li><a >href="http://wiki.apache.org/jmeter/JMeterFAQ";>FAQ >(Wiki)</a></li></ul></li></ul><ul class="menu"><li><div >class="menu-title">Tutorials (PDF format)</div><ul><li><a >href="../usermanual/jmeter_distributed_testing_step_by_step.pdf">Distributed >Testing</a></li><li><a >href="../usermanual/jmeter_proxy_step_by_step.pdf">Recording >Tests</a></li><li><a href="../usermanual/junitsampler_tutorial.pdf">JUnit >Sampler</a></li><li><a href="../us ermanual/jmeter_accesslog_sampler_step_by_step.pdf">Access Log Sampler</a></li><li><a href="../extending/jmeter_tutorial.pdf">Extending JMeter</a></li></ul></li></ul><ul class="menu"><li><div class="menu-title">Community</div><ul><li><a href="http://wiki.apache.org/jmeter/JMeterCommitters";>Contributors</a></li><li><a href="../mail.html">Mailing Lists</a></li><li><a href="../svnindex.html">SVN Repositories</a></li></ul></li></ul><ul class="menu"><li><div class="menu-title">Foundation</div><ul><li><a href="http://www.apache.org/";>ASF</a></li><li><a href="http://www.apache.org/foundation/getinvolved.html";>Get Involved in the ASF</a></li><li><a href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a></li><li><a href="http://www.apache.org/foundation/thanks.html";>Thanks</a></li></ul></li></ul></div><div class="main" id="content"><ul class="pagelinks"><li><a href="build-ldap-test-plan.html">< Prev</a></li><li><a href="../index.html">Index</a></li><li><a href="build-ws-t est-plan.html">Next ></a></li></ul><div class="section"><h1 id="ldapexttest">9b. Building an Extended LDAP Test Plan<a class="sectionlink" href="#ldapexttest" title="Link to here">¶</a></h1> + })(document, 'script', 'twitter-wjs'); + </script></div><div><a href="https://twitter.com/ApacheJMeter"; class="twitter-follow-button" data-show-count="false" data-lang="en-gb" data-size="large">Follow</a><script>(function(d,s,id){ + var js, + fjs=d.getElementsByTagName(s)[0], + p=/^http:/.test(d.location)?'http':'https'; + if (!d.getElementById(id)) { + js=d.createElement(s); + js.id=id; + js.src=p+'://platform.twitter.com/widgets.js'; + fjs.parentNode.insertBefore(js,fjs); + } + })(document, 'script', 'twitter-wjs'); + </script></div><div><a href="https://github.com/apache/jmeter";><img alt="star this repo" src="http://githubbadges.com/star.svg?user=apache&repo=jmeter&style=default";></a></div><div><a href="https://github.com/apache/jmeter/fork";><img alt="fork this repo" src="http://githubbadges.com/fork.svg?user=apache&repo=jmeter&style=default";></a></div><div><a href="https://maven-badges.herokuapp.com/maven-central/org.apache.jmeter/ApacheJMeter";><img alt="Maven Central" src="https://maven-badges.herokuapp.com/maven-central/org.apache.jmeter/ApacheJMeter/badge.png";></a></div></div><ul class="menu"><li onClick="return true"><div class="menu-title">About</div><ul><li><a href="../index.html">Overview</a></li><li><a href="http://www.apache.org/licenses/";>License</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><div class="menu-title">Download</div><ul><li><a href="../download_jmeter.cgi">Download Releases</a></li><li><a href="../nightly.html">Developer (Nightly) Builds</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><div class="menu-title">Documentation</div><ul><li><a href="../changes.html">Changes per version</a></li><li><a href="../usermanual/get-started.html">Get Started</a></li><li><a href="../usermanual/index.html">User Manual</a></li><li><a href="../usermanual/best-practices.html">Best Practices</a></li><li><a href="../usermanual/component_reference.html">Component Reference</a></li><li><a href="../usermanual/functions.html">Functions Reference</a></li><li><a href="../api/index.html">Javadocs</a></li><li><a href="../building.html">Building JMeter and Add-Ons</a></li><li><a href="http://wiki.apache.org/jmeter";>JMeter Wiki</a></li><li><a href="http://wiki.apache.org/jmeter/JMeterFAQ";>FAQ (Wiki)</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><div class="menu-title">Tutorials (PDF format)</div><ul><li><a href="../usermanual/jmeter_distributed_testing_step_by_step.pdf">Distributed Testing</a ></li><li><a href="../usermanual/jmeter_proxy_step_by_step.pdf">Recording >Tests</a></li><li><a href="../usermanual/junitsampler_tutorial.pdf">JUnit >Sampler</a></li><li><a >href="../usermanual/jmeter_accesslog_sampler_step_by_step.pdf">Access Log >Sampler</a></li><li><a href="../extending/jmeter_tutorial.pdf">Extending >JMeter</a></li></ul></li></ul><ul class="menu"><li onClick="return true"><div >class="menu-title">Community</div><ul><li><a href="../issues.html">Issue >Tracking</a></li><li><a href="../mail.html">Mailing Lists</a></li><li><a >href="../svnindex.html">Source Repositories</a></li><li><a >href="../building.html">Building and Contributing</a></li><li><a >href="https://projects.apache.org/project.html?jmeter";>Project info at >Apache</a></li><li><a >href="http://wiki.apache.org/jmeter/JMeterCommitters";>Contributors</a></li></ul></li></ul><ul > class="menu"><li onClick="return true"><div >class="menu-title">Foundation</div><ul><li><a >href="http://www.apache.org/";>ASF</a></li><li><a href= "http://www.apache.org/foundation/getinvolved.html";>Get Involved in the ASF</a></li><li><a href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a></li><li><a href="http://www.apache.org/foundation/thanks.html";>Thanks</a></li></ul></li></ul></div><div class="main" id="content"><ul class="pagelinks"><li><a href="build-ldap-test-plan.html">< Prev</a></li><li><a href="../index.html">Index</a></li><li><a href="build-ws-test-plan.html">Next ></a></li></ul><div class="section"><h1 id="ldapexttest">9b. Building an Extended LDAP Test Plan<a class="sectionlink" href="#ldapexttest" title="Link to here">¶</a></h1> <p> In this section, you will learn how to create a basic Test Plan to test an LDAP server.</p> @@ -40,15 +40,15 @@ needs. <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 one time. So, the total number of requests is (1 users) x (9 requests) x -repeat 1 time) = 9 LDAP requests. To construct the Test Plan, you will use the following elements:<br> +the users to run their tests one time. So, the total number of requests is <span class="code">(1 users) x (9 requests) x +repeat 1 time) = 9</span> LDAP requests. To construct the Test Plan, you will use the following elements:<br> <a href="test_plan.html#thread_group">Thread Group</a>,<br> <a href="../usermanual/component_reference.html#Adding_LDAP_Extended_Request_Defaults">Adding LDAP Extended Request Defaults</a>,<br> <a href="../usermanual/component_reference.html#Adding_LDAP_Requests">Adding LDAP Requests</a>, and<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 available at ldap.test.com. +This example assumes that the LDAP Server is available at <span class="code">ldap.test.com</span>. </p> <p> For the less experienced LDAP users, I build a <a href="ldapops_tutor.html">small @@ -56,26 +56,28 @@ LDAP tutorial</a> which shortly explains the several LDAP operations that can be used in building a complex testplan. </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. -extra exeption: if you want to add a \ character in a distinguished name (in an add or rename operation), you need to use 4 backslashes. -examples: -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> +Take care when using LDAP special characters in the distinguished name, in that case (e.g. you want to use a <span class="code">+</span> sign in a +distinguished name) you need to escape the character by adding an "<span class="code">\</span>" sign before that character. +Extra exception: if you want to add a <span class="code">\</span> character in a distinguished name (in an add or rename operation), you need to use 4 backslashes. +</p> +Examples: +<dl> +<dt><span class="code">cn=dolf\+smits</span></dt><dd>to add/search an entry with the name like <span class="code">cn=dolf+smits</span></dd> +<dt><span class="code">cn=dolf \\ smits</span></dt><dd>to search an entry with the name <span class="code">cn=dolf \ smits</span></dd> +<dt><span class="code">cn=c:\\\\log.txt</span></dt><dd>to add an entry with a name like <span class="code">cn=c:\log.txt</span></dd> +</dl> - <div class="subsection"><h2>9b.1 Adding Users<a class="sectionlink" href="#ext_adding_users" title="Link to here">¶</a></h2> + <div class="subsection"><h2 id="ext_adding_users">9b.1 Adding Users<a class="sectionlink" href="#ext_adding_users" title="Link to here">¶</a></h2> <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> -Go ahead and add the <b>Thread Group</b> element by first selecting the <b>Test Plan</b>, clicking your -right mouse button to get the <b>Add</b> menu, and then select <b>Add</b>><b>Threads (Users)</b>><b>Thread Group</b>. -You should now see the <b>Thread Group</b> element under <b>Test Plan</b>. If you do not see the element, then "expand" the Test Plan tree by +Go ahead and add the <span class="code">Thread Group</span> element by first selecting the <span class="code">Test Plan</span>, clicking your +right mouse button to get the <span class="code">Add</span> menu, and then select <span class="code">Add</span>→<span class="code">Threads (Users)</span>→<span class="code">Thread Group</span>. +You should now see the <span class="code">Thread Group</span> element under <span class="code">Test Plan</span>. If you do not see the element, then "expand" the Test Plan tree by clicking on the Test Plan element. </p> <p> @@ -85,14 +87,14 @@ Figure 9b.1. Thread Group with Default V </p> </div> - <div class="subsection"><h2>9b.2 Adding LDAP Extended Request Defaults<a class="sectionlink" href="#add_ldapext_defaults" title="Link to here">¶</a></h2> + <div class="subsection"><h2 id="add_ldapext_defaults">9b.2 Adding LDAP Extended Request Defaults<a class="sectionlink" href="#add_ldapext_defaults" title="Link to here">¶</a></h2> <p> Begin by selecting the LDAP Ext Users element. Click your right mouse button -to get the <b>Add</b> menu, and then select <b>Add </b>><b>Config Element</b>><b>LDAP Extended Request Defaults</b>. Then, +to get the <span class="code">Add</span> menu, and then select <span class="code">Add</span>→<span class="code">Config Element</span>→<span class="code">LDAP Extended Request Defaults</span>. Then, select this new element to view its Control Panel. </p> <p> -Like most JMeter elements, the <b>LDAP Extended Request Defaults</b> Control Panel has a name +Like most JMeter elements, the <span class="code">LDAP Extended Request Defaults</span> Control Panel has a name field that you can modify. In this example, leave this field with the default value. </p> <p><figure><a href="../images/screenshots/ldaptest/extrequestdefaults.png"><img src="../images/screenshots/ldaptest/extrequestdefaults.png" width="" height="" alt=" @@ -102,12 +104,12 @@ field that you can modify. In this examp <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 value is entered which is necesarry for a test, the test will fail in an unpredictable way! + For each request, you can override the defaults by filling in the values in the LDAP extended request sampler. + When no value is entered which is necessary for a test, the test will fail in an unpredictable way! </p> We will not enter any default values here, as we will build a very small testplan, so we will explain all the different fields when we add the LDAP Extended samplers. </div> -<div class="subsection"><h2>9b.3 Adding LDAP Requests<a class="sectionlink" href="#add_extrequests" title="Link to here">¶</a></h2> +<div class="subsection"><h2 id="add_extrequests">9b.3 Adding LDAP Requests<a class="sectionlink" href="#add_extrequests" title="Link to here">¶</a></h2> <p> In our Test Plan, we want to use all 9 LDAP requests. </p> @@ -145,32 +147,32 @@ JMeter sends requests in the order that </p> <p> Adding a requests always start by:<br> -Adding the <b>LDAP Extended Request</b> to the LDAP Ext Users element (<b>Add</b>><b> -Sampler</b>><b>LDAP Ext Request</b>). Then, select the <b>LDAP Ext Request</b> element in the tree +Adding the <span class="code">LDAP Extended Request</span> to the LDAP Ext Users element (<span class="code">Add</span>→ +<span class="code">Sampler</span>→<span class="code">LDAP Ext Request</span>). Then, select the <span class="code">LDAP Ext Request</span> element in the tree and edit the following properties.</p> -<div class="subsection"><h2>9b.3.1 Adding a Thread bind Request<a class="sectionlink" href="#add_threadbind" title="Link to here">¶</a></h2> +<div class="subsection"><h2 id="add_threadbind">9b.3.1 Adding a Thread bind Request<a class="sectionlink" href="#add_threadbind" title="Link to here">¶</a></h2> <p> <ol> <li> -Rename the element: "1. Thread bind" +Rename the element: "<span class="code">1. Thread bind</span>" </li> <li> -Select the "Thread bind" button. +Select the "<span class="code">Thread bind</span>" button. </li> <li> Enter the hostname value from the LDAP server in the Servername field </li> <li> -Enter the portnumber from the LDAP server (636 : ldap over SSL) in the port field +Enter the portnumber from the LDAP server (<span class="code">636</span> : ldap over SSL) in the port field </li> <li> -<i>(Optional)</i> Enter the baseDN in the DN field, this baseDN will be used as thestarting point for searches, add, deletes etc.<br> -take care that this must be the uppermost shared level for all your request, eg When all information is stored under ou=Users, dc=test, dc=com, you can use this value in the basedn.<br> +<i>(Optional)</i> Enter the baseDN in the DN field, this baseDN will be used as the starting point for searches, add, deletes, etc.<br> +take care that this must be the uppermost shared level for all your request, e.g. when all information is stored under <span class="code">ou=Users, dc=test, dc=com</span>, you can use this value in the basedn.<br> </li> <li> -<i>(Optional)</i> Enter the distinghuised name from the user you want to use for authentication. +<i>(Optional)</i> Enter the distinguished name from the user you want to use for authentication. When this field is kept empty, an anonymous bind will be established. </li> <li> @@ -191,21 +193,21 @@ Figure 9b.3.1. Thread Bind example</figc </p> </div> -<div class="subsection"><h2>9b.3.2 Adding a search Request<a class="sectionlink" href="#add_searchreq" title="Link to here">¶</a></h2> +<div class="subsection"><h2 id="add_searchreq">9b.3.2 Adding a search Request<a class="sectionlink" href="#add_searchreq" title="Link to here">¶</a></h2> <p> <ol> <li> -Rename the element: "2. Search Test" +Rename the element: "<span class="code">2. Search Test</span>" </li> <li> -Select the "Search Test" button. +Select the "<span class="code">Search Test</span>" button. </li> <li> <i>(Optional)</i> enter the searchbase under which you want to perform the search, relative to the basedn, used in the thread bind request.<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> -Enter the searchfilter, any decent LDAP serach filter will do, but for now, use something simple, like (sn=Doe) or (cn=*) +Enter the searchfilter, any decent LDAP search filter will do, but for now, use something simple, like <span class="code">(sn=Doe)</span> or <span class="code">(cn=*)</span> </li> <li> <i>(Optional)</i> Enter the scope in the scope field, it has three options: @@ -218,18 +220,18 @@ Enter the searchfilter, any decent LDAP </li></ol> </li> <li> -<i>(Optional)</i> Size limit, specifies the maximun number of returned entries, +<i>(Optional)</i> Size limit, specifies the maximum number of returned entries, </li> <li> -<i>(Optional)</i> Time limit, specifies the maximum number of miliseconds, the SERVER can use for performing the search. it is NOT the maximun time the application will wait.<br> +<i>(Optional)</i> Time limit, specifies the maximum number of milliseconds, the SERVER can use for performing the search. It is NOT the maximum time the application will wait.<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><i>(Optional)</i> 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: +<li><i>(Optional)</i> Attributes you want in the search answer. This can be used to limit the size of the answer, especially when an object has very large attributes (like <span class="code">jpegPhoto</span>). There are three possibilities: <ol><li>Leave empty (the default setting must also be empty) This will return all attributes. </li> -<li>Put in one empty value (""), it will request a non-existent attributes, so in reality it returns no attributes +<li>Put in one empty value (<span class="code">""</span>), it will request a non-existent attributes, so in reality it returns no attributes </li> -<li>Put in the attributes, seperated by a semi-colon. It will return only the requested attributes +<li>Put in the attributes, separated by a semi-colon. It will return only the requested attributes </li></ol></li> <li> <i>(Optional)</i> Return object. Checked will return all java-object attributes, it will add these to the requested attributes, as specified above.<br> @@ -249,20 +251,20 @@ Figure 9b.3.2. search request example">< Figure 9b.3.2. search request example</figcaption></figure> </p></div> -<div class="subsection"><h2>9b.3.3 Adding a Compare Request<a class="sectionlink" href="#add_comparereq" title="Link to here">¶</a></h2> +<div class="subsection"><h2 id="add_comparereq">9b.3.3 Adding a Compare Request<a class="sectionlink" href="#add_comparereq" title="Link to here">¶</a></h2> <p> <ol> <li> -Rename the element: "3. Compare Test" +Rename the element: "<span class="code">3. Compare Test</span>" </li> <li> -Select the "Compare" button. +Select the "<span class="code">Compare</span>" button. </li> <li> -enter the entryname form the object on which you want the compare operation to work, relative to the basedn, eg "cn=jdoe,ou=Users" +enter the entryname form the object on which you want the compare operation to work, relative to the basedn, e.g. "<span class="code">cn=jdoe,ou=Users</span>" </li> <li> -Enter the compare filter, this must be in the form "attribute=value", eg "[email protected]" +Enter the compare filter, this must be in the form "<span class="code">attribute=value</span>", e.g. "<span class="code">[email protected]</span>" </li> </ol> </p> @@ -273,25 +275,25 @@ Figure 9b.3.3. Compare example</figcapti </p> </div> -<div class="subsection"><h2>9b.3.4 Adding a Single bind/unbind<a class="sectionlink" href="#add_sbind" title="Link to here">¶</a></h2> +<div class="subsection"><h2 id="add_sbind">9b.3.4 Adding a Single bind/unbind<a class="sectionlink" href="#add_sbind" title="Link to here">¶</a></h2> <p> <ol> <li> -Rename the element: "4. Single bind/unbind Test" +Rename the element: "<span class="code">4. Single bind/unbind Test</span>" </li> <li> -Select the "Single bind/unbind" button. +Select the "<span class="code">Single bind/unbind</span>" button. </li> <li> -Enter the FULL distinghuised name from the user you want to use for authentication.<br> -eg. cn=jdoe,ou=Users,dc=test,dc=com +Enter the FULL distinguished name from the user you want to use for authentication.<br> +E.g. <span class="code">cn=jdoe,ou=Users,dc=test,dc=com</span> When this field is kept empty, an anonymous bind will be established. </li> <li> Enter the password for the user you want to authenticate with, an empty password will also lead to an anonymous bind. </li> </ol> -<b>Take care</b>: This single bind/unbind is in reality two seperate operations but cannot easily be split! +<b>Take care</b>: This single bind/unbind is in reality two separate operations but cannot easily be split! </p><p> <figure><a href="../images/screenshots/ldaptest/extsbind.png"><img src="../images/screenshots/ldaptest/extsbind.png" width="" height="" alt=" Figure 9b.3.4. Single bind/unbind example"></a><figcaption> @@ -299,23 +301,23 @@ Figure 9b.3.4. Single bind/unbind exampl </p> </div> -<div class="subsection"><h2>9b.3.5 Adding an Add Request<a class="sectionlink" href="#add_addreq" title="Link to here">¶</a></h2> +<div class="subsection"><h2 id="add_addreq">9b.3.5 Adding an Add Request<a class="sectionlink" href="#add_addreq" title="Link to here">¶</a></h2> <p> <ol> <li> -Rename the element: "5. Add Test" +Rename the element: "<span class="code">5. Add Test</span>" </li> <li> -Select the "Add" button. +Select the "<span class="code">Add</span>" button. </li> <li> -Enter the distinghuised name for the object to add, relative to the basedn. +Enter the distinguished name for the object to add, relative to the basedn. </li> <li> -Add a line in the "add test" table, fill in the attribute and value.<br> +Add a line in the "<span class="code">add test</span>" table, fill in the attribute and value.<br> When you need the same attribute more than once, just add a new line, add the attribute again, and a different value.<br> All necessary attributes and values must be specified to pass the test, see picture!<br> -(sometimes the server adds the attribute "objectClass=top", this might give a problem. +(sometimes the server adds the attribute "<span class="code">objectClass=top</span>", this might give a problem. </li> </ol> </p> @@ -326,39 +328,41 @@ Figure 9b.3.5. Add request example</figc </p> </div> -<div class="subsection"><h2>9b.3.6 Adding a Modify Request<a class="sectionlink" href="#add_modreq" title="Link to here">¶</a></h2> +<div class="subsection"><h2 id="add_modreq">9b.3.6 Adding a Modify Request<a class="sectionlink" href="#add_modreq" title="Link to here">¶</a></h2> <p> <ol> <li> -Rename the element: "6. Modify Test" +Rename the element: "<span class="code">6. Modify Test</span>" </li> <li> -Select the "Modify test" button. +Select the "<span class="code">Modify test</span>" button. </li> <li> -Enter the distinghuised name for the object to modify, relative to the basedn. +Enter the distinguished name for the object to modify, relative to the basedn. </li> <li> -Add a line in the "modify test" table, with the "add" button. +Add a line in the "<span class="code">modify test</span>" table, with the "<span class="code">add</span>" button. </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><b>add</b><br> this will mean that the attribute value (not optional in this case) willbe added to the attribute.<br> +<dl> +<dt><span class="code">add</span></dt><dd>this will mean that the attribute value (not optional in this case) will be added to the attribute.<br> When the attribute is not existing, it will be created and the value added<br> When it is existing, and defined multi-valued, the new value is added.<br> -when it is existing, but single valued, it will fail.</li> -<li><b>replace</b><br> +when it is existing, but single valued, it will fail.</dd> +<dt><span class="code">replace</span></dt><dd> This will overwrite the attribute with the given new value (not optional here)<br> When the attribute is not existing, it will be created and the value added<br> -When it is existing, old values are removed, the new value is added.</li> -<li><b>delete</b><br> +When it is existing, old values are removed, the new value is added.</dd> +<dt><span class="code">delete</span></dt><dd> When no value is given, all values will be removed<br> When a value is given, only that value will be removed<br> when the given value is not existing, the test will fail -</li></ol> +</dd> +</dl> </li> <li> -<i>(Optional)</i> Add more modifications in the "modify test" table.<br> +<i>(Optional)</i> Add more modifications in the "<span class="code">modify test</span>" table.<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> @@ -371,26 +375,26 @@ Figure 9b.3.6. Modify example</figcaptio </p> </div> -<div class="subsection"><h2>9b.3.7 Adding a Rename Request (moddn)<a class="sectionlink" href="#add_moddn" title="Link to here">¶</a></h2> +<div class="subsection"><h2 id="add_moddn">9b.3.7 Adding a Rename Request (moddn)<a class="sectionlink" href="#add_moddn" title="Link to here">¶</a></h2> <p> <ol> <li> -Rename the element: "7. Rename entry (moddn)" +Rename the element: "<span class="code">7. Rename entry (moddn)</span>" </li> <li> -Select the "Rename Entry" button. +Select the "<span class="code">Rename Entry</span>" button. </li> <li> -Enter the name of the entry, relative to the baseDN, in the "old entry name-Field".<br> -that is, if you want to rename "cn=Little John Doe,ou=Users", and you set the baseDN to "dc=test,dc=com", -you need to enter "cn=John Junior Doe,ou=Users" in the old entry name-field. +Enter the name of the entry, relative to the baseDN, in the "<span class="code">old entry name</span>"-Field.<br> +that is, if you want to rename "<span class="code">cn=Little John Doe,ou=Users</span>", and you set the baseDN to "<span class="code">dc=test,dc=com</span>", +you need to enter "<span class="code">cn=John Junior Doe,ou=Users</span>" in the <span class="code">old entry name</span>-Field. </li> <li> -Enter the new name of the entry, relative to the baseDN, in the "new distinghuised name-Field".<br> +Enter the new name of the entry, relative to the baseDN, in the "<span class="code">new distinguished name</span>"-Field.<br> when you only change the RDN, it will simply rename the entry<br> -when you also add a different subtree, eg you change from cn=john doe,ou=Users to cn=john doe,ou=oldusers, it will move the entry. -You can also move a complete subtree (If your LDAP server supports this!), eg ou=Users,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. +when you also add a different subtree, e.g. you change from <span class="code">cn=john doe,ou=Users</span> to <span class="code">cn=john doe,ou=oldusers</span>, it will move the entry. +You can also move a complete subtree (If your LDAP server supports this!), e.g. <span class="code">ou=Users,ou=retired</span>, to <span class="code">ou=oldusers,ou=users</span>, +this will move the complete subtree, plus all retired people in the subtree to the new place in the tree. </li> </ol> </p> @@ -401,19 +405,19 @@ Figure 9b.3.8. Rename example</figcaptio </p> </div> -<div class="subsection"><h2>9b.3.8 Adding a Delete Request<a class="sectionlink" href="#add_delreq" title="Link to here">¶</a></h2> +<div class="subsection"><h2 id="add_delreq">9b.3.8 Adding a Delete Request<a class="sectionlink" href="#add_delreq" title="Link to here">¶</a></h2> <p> <ol> <li> -Rename the element: "8. Delete Test" +Rename the element: "<span class="code">8. Delete Test</span>" </li> <li> -Select the "Delete" button. +Select the "<span class="code">Delete</span>" button. </li> <li> -Enter the name of the entry, relative to the baseDN, in the Delete-Field.<br> -that is, if you want to remove "cn=John Junior Doe,ou=Users,dc=test,dc=com", and you set the baseDN to "dc=test,dc=com", -you need to enter "cn=John Junior Doe,ou=Users" in the Delete-field. +Enter the name of the entry, relative to the baseDN, in the <span class="code">Delete</span>-Field.<br> +that is, if you want to remove "<span class="code">cn=John Junior Doe,ou=Users,dc=test,dc=com</span>", and you set the baseDN to "<span class="code">dc=test,dc=com</span>", +you need to enter "<span class="code">cn=John Junior Doe,ou=Users</span>" in the <span class="code">Delete</span>-field. </li> </ol> </p> @@ -424,14 +428,14 @@ Figure 9b.3.7. Delete example</figcaptio </p> </div> -<div class="subsection"><h2>9b.3.9 Adding an unbind Request<a class="sectionlink" href="#add_unbind" title="Link to here">¶</a></h2> +<div class="subsection"><h2 id="add_unbind">9b.3.9 Adding an unbind Request<a class="sectionlink" href="#add_unbind" title="Link to here">¶</a></h2> <p> <ol> <li> -Rename the element: 9. Thread unbind" +Rename the element: "<span class="code">9. Thread unbind</span>" </li> <li> -Select the "Thread unbind" button. +Select the "<span class="code">Thread unbind</span>" 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> @@ -444,12 +448,12 @@ Figure 9b.3.9. Unbind example</figcaptio </div> </div> -<div class="subsection"><h2>9b.4 Adding a Listener to View/Store the Test Results<a class="sectionlink" href="#add_ldapext_listener" title="Link to here">¶</a></h2> +<div class="subsection"><h2 id="add_ldapext_listener">9b.4 Adding a Listener to View/Store the Test Results<a class="sectionlink" href="#add_ldapext_listener" title="Link to here">¶</a></h2> <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 <b>View Results Tree</b> (<b>Add</b>><b>Listener</b>><b>View Results Tree</b>) +requests in a file and presenting a visual model of the data. Select the Thread group +element and add a <span class="code">View Results Tree</span> (<span class="code">Add</span>→<span class="code">Listener</span>→<span class="code">View Results Tree</span>) </p> <p> <figure><a href="../images/screenshots/ldaptest/extviewtree.png"><img src="../images/screenshots/ldaptest/extviewtree.png" width="" height="" alt=" @@ -477,7 +481,7 @@ this is given in a (self defined) xml-st </div><ul class="pagelinks"><li><a href="build-ldap-test-plan.html">< Prev</a></li><li><a href="../index.html">Index</a></li><li><a href="build-ws-test-plan.html">Next ></a></li></ul></div><div class="footer"><div class="copyright"> Copyright © 1999 – - 2015 + 2016 , Apache Software Foundation </div><div class="trademarks">Apache, Apache JMeter, JMeter, the Apache feather, and the Apache JMeter logo are
![http://githubbadges.com/star.svg?user=apache&repo=jmeter&style=default"](http://githubbadges.com/star.svg?user=apache&repo=jmeter&style=default"){kind=link}
![http://githubbadges.com/fork.svg?user=apache&repo=jmeter&style=default"](http://githubbadges.com/fork.svg?user=apache&repo=jmeter&style=default"){kind=link}
![https://maven-badges.herokuapp.com/maven-central/org.apache.jmeter/ApacheJMeter/badge.png"](https://maven-badges.herokuapp.com/maven-central/org.apache.jmeter/ApacheJMeter/badge.png"){kind=link}