| <?xml version="1.0"?> |
| <!-- |
| 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. |
| --> |
| |
| <!DOCTYPE document |
| [ |
| <!ENTITY sect-num '9a'> |
| ]> |
| |
| <document prev="build-ftp-test-plan.html" next="build-ldapext-test-plan.html" id="$Id$"> |
| |
| |
| <properties> |
| <title>User's Manual: Building an LDAP Test Plan</title> |
| </properties> |
| |
| <body> |
| <section name="§-num;. Building an LDAP Test Plan" anchor="building"> |
| <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 |
| repeat 4 times) = 40 LDAP requests. To construct the Test Plan, you will use the following elements: |
| <a href="test_plan.html#thread_group">Thread Group</a>, |
| <complink name="LDAP Request"/>, |
| <complink name="LDAP Request Defaults"/>, and |
| <complink name="View Results in Table"/> |
| .</p> |
| <p>This example assumes that the LDAP Server is available at ldap.test.com.</p> |
| </section> |
| <section name="§-num;.1 Adding Users" anchor="adding_users"> |
| <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 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 |
| 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 image="ldaptest/threadgroup.png"> |
| Figure §-num;.1. Thread Group and final test tree</figure> |
| |
| </p> |
| </section> |
| <section name="§-num;.2 Adding Login Config Element" anchor="add_login"> |
| <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>. |
| 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 |
| field that you can modify. In this example, leave this field with the default value.</p> |
| |
| <figure image="ldaptest/login-config-element.png"> |
| Figure §-num;.2 Login Config Element for our Test Plan</figure> |
| |
| <note><p>Enter Username field to "your LDAP Username",<br/> |
| The password field to "your LDAP Passowrd"</p> |
| |
| <p>These values will be used by the LDAP Requests.</p></note> |
| </section> |
| |
| <section name="§-num;.3 Adding LDAP Request Defaults" anchor="add_defaults"> |
| <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, |
| 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 |
| field that you can modify. In this example, leave this field with the default value.</p> |
| |
| |
| <figure image="ldaptest/requestdefaults.png"> |
| Figure §-num;.3 LDAP Defaults for our Test Plan</figure> |
| |
| <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/> |
| These values are default for the LDAP Requests.</note> |
| </section> |
| |
| |
| <section name="§-num;.4 Adding LDAP Requests" anchor="add_requests"> |
| <p>In our Test Plan, we need to make four LDAP requests.</p> |
| <ol> |
| <li>Inbuilt Add Test</li> |
| <li>Inbuilt Search Test</li> |
| <li>Inbuilt Modify Test</li> |
| <li>Inbuilt Delete Test</li> |
| |
| </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 |
| 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> |
| </ol> |
| <figure image="ldaptest/add.png"> |
| Figure §-num;.4.1 LDAP Request for Inbuilt Add test</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>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> |
| </ol> |
| Next, add the Third LDAP Request and edit the following properties |
| <figure image="ldaptest/search.png"> |
| Figure §-num;.4.2 LDAP Request for Inbuilt Search test</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> |
| </ol> |
| Next, add the fourth LDAP Request and edit the following properties |
| |
| <figure image="ldaptest/modify.png"> |
| Figure §-num;.4.3 LDAP Request for Inbuilt Modify test</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> |
| </ol> |
| <figure image="ldaptest/delete.png"> |
| Figure §-num;.4.4 LDAP Request for Inbuilt Delete test</figure> |
| |
| </section> |
| <section name="§-num;.5 Adding a Response Assertion" anchor="ResponseAssertion"> |
| <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.</br></p> |
| <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> |
| </ol> |
| <figure image="ldaptest/responseassertion.png"> |
| Figure §-num;.5 LDAP Response Assertion</figure> |
| </section> |
| <section name="§-num;.6 Adding a Listener to View/Store the Test Results" anchor="add_listener"> |
| <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> |
| <figure image="ldaptest/viewtable.png"> |
| Figure §-num;.6 View Results in Table Listener</figure> |
| |
| </section> |
| |
| </body> |
| </document> |
