| <?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 '8'> |
| <!ENTITY rarr "→" > |
| ]> |
| |
| <document prev="build-db-test-plan.html" next="build-ldap-test-plan.html" id="$Id$"> |
| |
| <properties> |
| <title>User's Manual: Building an FTP Test Plan</title> |
| </properties> |
| |
| <body> |
| |
| <section name="§-num;. Building an FTP Test Plan" anchor="building"> |
| <p>In this section, you will learn how to create a basic |
| <a href="build-test-plan.html">Test Plan</a> to test an FTP site. You will |
| create four users that send requests for two files on a FTP site. |
| Also, you will tell the users to run their tests twice. So, the total number of |
| requests is (4 users) x (2 requests) x (repeat 2 times) = 16 FTP requests.</p> |
| <p>To construct the Test Plan, you will use the following elements: |
| <a href="test_plan.html#thread_group">Thread Group</a>, |
| <complink name="FTP Request"/>, |
| <complink name="FTP Request Defaults"/>, and |
| <complink name="View Results in Table"/>.</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 |
| <a href="test_plan.html#thread_group">Thread Group</a> 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 Thread Group element by first selecting the Test Plan, |
| clicking your right mouse button to get the Add menu, and then select |
| <b>Add</b> → <b>ThreadGroup.</b></p> |
| |
| <p>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 clicking on the |
| <b>Test Plan</b> element.</p> |
| |
| <p>Next, you need to modify the default properties. Select the <b>Thread Group</b> element |
| in the tree, if you have not already selected it. You should now see the Thread |
| Group Control Panel in the right section of the JMeter window (see Figure §-num;.1 |
| below)</p> |
| |
| <figure image="webtest/threadgroup.png"> |
| Figure §-num;.1. Thread Group with Default Values</figure> |
| |
| <p>Start by providing a more descriptive name for our <b>Thread Group.</b> In the name |
| field, enter 'FTP Users'.</p> |
| |
| <p>Next, increase the number of users to 4.</p> |
| |
| <p>In the next field, the <i>Ramp-Up</i> Period, leave the default value of 0 |
| seconds. This property tells JMeter how long to delay between starting each |
| user. For example, if you enter a <i>Ramp-Up</i> Period of 5 seconds, JMeter will |
| finish starting all of your users by the end of the 5 seconds. So, if we have |
| 5 users and a 5 second <i>Ramp-Up</i> Period, then the delay between starting users |
| would be 1 second (5 users / 5 seconds = 1 user per second). If you set the |
| value to 0, then JMeter will immediately start all of your users.</p> |
| |
| <p>Finally, enter a value of 2 in |
| the <i>Loop Count</i> field. This property tells JMeter how many times to repeat your |
| test. To have JMeter repeatedly run your <b>Test Plan,</b> select the <i>Forever</i> |
| checkbox.</p> |
| |
| <note>In most applications, you have to manually accept |
| changes you make in a Control Panel. However, in JMeter, the Control Panel |
| automatically accepts your changes as you make them. If you change the |
| name of an element, the tree will be updated with the new text after you |
| leave the Control Panel (for example, when selecting another tree element).</note> |
| |
| <p>See Figure §-num;.2 for the completed FTP Users Thread Group.</p> |
| |
| <figure image="ftptest/threadgroup2.png"> |
| Figure §-num;.2. FTP Users Thread Group</figure> |
| |
| </section> |
| |
| <section name="§-num;.2 Adding Default FTP Request Properties" anchor="adding_defaults"> |
| <p>Now that we have defined our users, it is time define the tasks that they |
| will be performing. In this section, you will specify the default settings |
| for your FTP requests. And then, in section §-num;.3, you will add <b>FTP Request</b> |
| elements which use some of the default settings you specified here.</p> |
| |
| <p>Begin by selecting the FTP Users element. Click your right mouse button |
| to get the Add menu, and then select <b>Add</b> → <b>Config Element</b> → <b>FTP Request |
| Defaults.</b> Then, select this new element to view its Control Panel (see Figure §-num;.3). |
| </p> |
| |
| <figure image="ftptest/ftp-defaults.png"> |
| Figure §-num;.3. FTP Request Defaults</figure> |
| |
| <p> |
| Like most JMeter elements, the <complink name="FTP Request Defaults"/> Control |
| Panel has a name field that you can modify. In this example, leave this field with |
| the default value.</p> |
| |
| <p>Skip to the next field, which is the FTP Server's Server Name/IP. For the |
| Test Plan that you are building, all FTP requests will be sent to the same |
| FTP server, ftp.domain.com in this case. Enter this domain name into the field. |
| This is the only field that we will specify a default, so leave the remaining |
| fields with their default values.</p> |
| |
| <note>The FTP Request Defaults element does not tell JMeter |
| to send an FTP request. It simply defines the default values that the |
| FTP Request elements use.</note> |
| |
| <p>See Figure §-num;.4 for the completed FTP Request Defaults element</p> |
| |
| <figure image="ftptest/ftp-defaults2.png"> |
| Figure §-num;.4. FTP Defaults for our Test Plan</figure> |
| |
| </section> |
| |
| <section name="§-num;.3 Adding FTP Requests" anchor="adding_requests"> |
| |
| <p>In our <b>Test Plan</b>, we need to make two <b>FTP requests</b>.</p> |
| |
| <note>JMeter sends requests in the order that they appear in the tree.</note> |
| |
| <p>Start by adding the first <complink name="FTP Request"/> |
| to the FTP Users element (<b>Add</b> → <b>Sampler</b> → <b>FTP Request</b>). |
| Then, select the <b>FTP Request</b> element in the tree and edit the following properties |
| (see Figure §-num;.5): |
| <ol> |
| <li>Change the <i>Name</i> to "File1".</li> |
| <li>Change the <i>Remote File</i> field to "/directory/file1.txt".</li> |
| <li>Change the <i>Username</i> field to "anonymous".</li> |
| <li>Change the <i>Password</i> field to "anonymous@test.com".</li> |
| </ol> |
| </p> |
| |
| <note>You do not have to set the <i>Server Name</i> field because you already specified |
| this value in the <b>FTP Request Defaults</b> element.</note> |
| |
| <figure image="ftptest/ftp-request.png"> |
| Figure §-num;.5. FTP Request for file1</figure> |
| |
| <p>Next, add the second <b>FTP Request</b> and edit the following properties (see |
| Figure §-num;.6: |
| <ol> |
| <li>Change the <i>Name</i> to "File2".</li> |
| <li>Change the <i>Remote File</i> field to "/directory/file2.txt".</li> |
| <li>Change the <i>Username</i> field to "anonymous".</li> |
| <li>Change the <i>Password</i> field to "anonymous@test.com".</li> |
| </ol> |
| </p> |
| |
| <figure image="ftptest/ftp-request2.png"> |
| Figure §-num;.6. FTP Request for file2</figure> |
| |
| </section> |
| |
| <section name="§-num;.4 Adding a Listener to View/Store the Test Results" anchor="adding_listener"> |
| <p>The final element you need to add to your <b>Test Plan</b> is a |
| <a href="component_reference.html#listeners">Listener</a>. This element is |
| responsible for storing all of the results of your <b>FTP requests</b> in a file and presenting |
| a visual model of the data.</p> |
| |
| <p>Select the FTP Users element and add a <complink name="View Results in Table"/> |
| listener (<b>Add</b> → <b>Listener</b> → <b>View Results in Table</b>).</p> |
| <p>Run your test and view the results.</p> |
| |
| <figure image="ftptest/ftp-results.png"> |
| Figure §-num;.7. View Results in Table Listener</figure> |
| |
| </section> |
| |
| </body> |
| </document> |