WORKERS AHEAD!

You are viewing the development documentation for the Apereo CAS server. The functionality presented here is not officially released yet. This is a work in progress and will be continually updated as development moves forward. You are most encouraged to test the changes presented.

Locust Performance Testing

Locust is an easy-to-use, distributed, user load testing tool. It is intended for load-testing web sites (or other systems) and figuring out how many concurrent users a system can handle. See this guide for more info.

Setup

A fundamental feature of Locust is that you describe all your tests in Python code. No need for clunky UIs or bloated XML, just plain code. For this to work, you will need to download Python. Next download the Locust test suite from here and configure a virtual environment to install modules:

pip3 install virtualenv
virtualenv mylocustenv/
pip3 install -r requirements.txt

Install Locust via the following:

pip3 install locustio

Create a credentials.csv file that contains username,password entries used for load tests.

echo casuser,Mellon > cas/credentials.csv

Run the script as such:

locust -f cas/casLocust.py --host=https://cas.example.org
...
[2017-05-02 16:31:49,742] test/INFO/locust.main: Starting web monitor at *:8089
[2017-05-02 16:31:49,744] test/INFO/locust.main: Starting Locust 0.8a2

Navigate to http://localhost:8089 and proceed with starting the test swarm.

For additional options, use:

locust --help