AppLoader Quick Start Guide - 5 user Server Trial

In this article we will explain how to take an already built script, send it to the Controller (AppLoader), and set up and execute a load test for 5 users.

NOTE – if you should encounter issues along the way, please reach out to us for assistance at +1 833-288-6624 (+1 833-AUTOMAI) or support@automai.com. We are committed to helping you have a positive trial experience.

Prerequisites

  • ScenarioBuilder, Injectors, and AppLoader are installed on a server operating system that can access the application you want to test.
  • If your application requires domain users, you have 5 domain user accounts that have permissions to log onto the server via remote desktop connection. If using domain users, create a csv file that contains the user account info for the 5 users (format: username, password, domain; put each user on a separate line)
  • Server is configured for remote desktop sessions (see the Injector Configuration Guide for details, if needed)
  • You’ve created at least one script in ScenarioBuilder (see the ScenarioBuilder Quick Start Guide, if needed)

Steps in ScenarioBuilder

  1. Add log off steps to your script. When executed multiple times in a run the script will log in over and over, therefore it needs to log off the app before it starts the next execution.
  2. Add Begin and End Transactions to your script. To do this, add a Begin Transaction action at the point in the script you want to track as a transaction and give it a meaningful name. Add an End Transaction action at the point where the transaction ends. Select the Begin Transaction name in the Properties Transaction Name drop-down. Repeat this process to cover all the transactions that you want to track. For example, you could add a Begin Transaction before the step that launches the application and an End Transaction after the step where the login page appears. That will provide a transaction time on how long it takes to launch the application.
  3. Execute your script multiple times. If it passes all iterations, you are ready to proceed. If it fails, edit your script. If the script can’t successfully execute multiple iterations in ScenarioBuilder it won’t be able to successfully execute in AppLoader. Be sure to set the Reference Time. This value is needed for AppLoader.
  4. If your script uses a CSV file, make sure it has enough data to support a 5 minute run including the ramp up and ramp down time. The formula to determine if you have enough data is [420 (5 minute run time plus 1 minute ramp up and 1 minute ramp down in seconds) / Reference Time (in seconds)] rounded up * 5 (users running script). For a script that takes 74 seconds to execute, you would need at least 30 rows of data in your CSV file to support 5 users during a 5 minute test. In the case of the login script, it can be different users, or it can be the same user that logs in over and over again.
  5. Verify connectivity to AppLoader.
    a. Click the View tab.
    b. Click Options.
    c. Click the Base tab.
    d. You should see a Type of “AL” with the address for your server. If you don’t see an entry, click Add to add it. Select it and then click Test. If the test is not successful, verify the address and port. If needed, update the entries and click Test.
  6. When the script is ready for use and you’ve verified connectivity to AppLoader, click Send Scenario. This will make the script available in AppLoader.

Steps in AppLoader

7. Double-click the AppLoader shortcut on the desktop to launch the AppLoader Controller in your default browser.

8. Log in to AppLoader (User Name: admin / Password: admin).

9. Once you login, you will see that the Injector has registered itself with the AppLoader Controller.

NOTE - if the Injector does not appear on the “Manage Injectors” page, run Start Injector [Start> All Programs> Injector> Start Injector].

rUsers

rUsers are the robots that execute the scripts. They simulate real user actions – giving the most realistic test possible.

10. Click Define rUsers.

11. Select Mode:
a. If you have domain user accounts:
i. For Mode, select From CSV File from the drop-down.
ii. Browse to the CSV file that contains the user information (this is the prerequisite file that contains the username, password, and domain info for each user).
b. If you are using local accounts:
i. For Mode, select Incremental.
ii. You can leave the Start Index, User Name, and Password set as the default values, or you can change them as desired. Local user accounts will be created using this information. For example, if you leave the default values, the users will be rUser1, rUser2, rUser3, etc. They will all have the same password.

12. Click Submit.

13. Click Start rUsers. The Start rUsers window opens.

14. Enter “5” for Number of Users, enter “30” for Launch Delay, and then click Submit. Once you start the rUsers, rUserManager will automatically start.

Create a Test Plan and Run It

15. Click Manage Tests.

16. Click Create New Test Plan.

17. Fill out the form as follows:
a. Name: enter a name for your test plan
b. Steady State Time: 5
c. Enforce SST: Yes
d. Injector: Click the “Click to select from Injector list” and select your injector.
e. Scenario: Click the “Click to select from Scenario list” and select your script.
f. rUsers: 5

18. Click Save. A Success window appears.

19. Click No. The Run Load Test window appears.

20. Click Yes. The Specify Load Test Name appears.

21. Click Submit. The Success window appears.

22. Click OK. AppLoader shifts to the “Real Time” page automatically after submitting the test.

Viewing a Run In Progress

Graphical View

The Real Time page provides a graphical view of the test in progress, from the Controller perspective.

See your rUsers' status as they progress through connected, waiting, playing, and completed stages. Click status icons to drill down rUser by rUser for up-to-the-minute performance results, including where they are in their current scenario and screenshots of any errors they have encountered.

View the rUsers Executing the Scripts

While a test is running, you can view the execution process through rUserManager. Maximize rUserManager to see each rUser session executing scenarios in real time.

WARNING - while it is OK to minimize the rUserManager window, do NOT close it. Doing so will shut down the rUser sessions and stop further execution of the test run.

Analyze Load Test Results

After a load test has completed, you can analyze the final results from the Test Analysis page. An important part of the load testing process is viewing and studying the results of a test. Get response time graphs and reports, and export complete test data and graphs into an Excel format. See the timing of your transactions, scenarios, and how your rUsers performed.

Next Steps

By now you should have executed a test in your environment against your application. Hopefully you have the confidence to go forth and run more tests with many more users! However, before you start there are a few things you need to consider.

First – if this is a trial version, it only allows for a 5 user test. To continue using the software and ramp up the user count, you’ll need a license for the software and more users. Contact sales at +1 833-288-6624 (+1 833-AUTOMAI) or sales@automai.com to discuss your needs.

NOTE – if your trial period expired before you had a chance to create and execute a run, contact us at support@automai.com for an extension.

Second – Before ramping up the users, you need to make sure your server can handle the load. Your Injector might only handle 50 users. The number of concurrent rUsers that an Injector can handle will depend largely on the resources that are available (CPU and memory), and what each client of the application under test requires.

If you don’t have hardware in house to support a large number of users, don’t worry. Automai offers turn key cloud solutions to handle your load and performance testing needs.

Lastly – there are many more capabilities in AppLoader, so be sure to check out these resources for more information:
1. AppLoader User Guide
2. AppLoader Knowledge Base
3. AppLoader Training Videos

Getting Help and Support

Free POC!

Need a Proof of Concept? Our experts will help establish AppLoader’s viability so that your organization, from stakeholders down to data entry clerks, are 100% behind your decision to go forward with AppLoader!

Support Team

If at any point during your trial you need more help, our technicians are waiting to help you! Don’t hesitate to call our experts at +1 833-288-6624 (+1 833-AUTOMAI) or email Automai Support support@automai.com.

Help Center

For one-on-one help, create a support request at Automai Help Center. A support engineer will follow up with you quickly. If you don't have an account, you can create one - just follow the prompts. When submitting your support request, please provide as much detail as possible. This will help us resolve your issue faster.

Send Us Feedback

We would love to hear your thoughts on AppLoader and your ideas for future features and improvements. Also, occasionally bugs do happen. If you find one, we'll do our best to fix it.

The AppLoader navigation pane includes a ticket form for you to submit your problems, questions and suggestions about the product. Let us know what you think!