Merge pull request #251 from biconou/biconou_develop_PR_jmeter

Add jmeter main test plan + a bit of documentation.
2017-02-16 14:31:14 -08:00
parent 760d261275 f9b4577dbe
commit 253b24e8d0
3 changed files with 340 additions and 0 deletions
@@ -0,0 +1,26 @@
+#Performance test using Apache JMeter
+
+This document explains how to run performance tests on Libresonic using [Apache JMeter](http://jmeter.apache.org/). 
+The installation and setup of JMeter is not documented bellow; please refer to the JMeter web site.
+
+##Main test plan
+The Libresonic sources come with a main performance test case defined in file libresonic-main/src/test/resources/jmeter/libresonicMainTestPlan.jmx.
+This is a JMeter test plan file.
+
+This test plan simulates a single user that picks up a random album id (xxx) every 5 second and run the main.view?id=xxx http request. 
+
+To run the test plan, open the libresonicMainTestPlan.jmx file in JMeter.
+Run Libresonic. Note that the default configuration of this test plan expects Libresonic to be reached at the http://localhost:8080 URL.
+Then run the test plan in JMeter. 
+After a while, you'll obtain a beautiful graph like this
+
+![](jmeter-main-test-plan.png)
+
+If you want to run the test with more than one user, just change the _Number of Threads_ property in the main _Thread Group_ configuration.
+
+If you want to change the delay between each request, change the value in the _Wait next request Timer_ _Constant Timer_ definition. 
+
+
+
+
+