summaryrefslogtreecommitdiff
path: root/scripts/scalability/README.rst
diff options
context:
space:
mode:
authordrebs <drebs@riseup.net>2017-10-29 14:28:12 -0200
committerdrebs <drebs@riseup.net>2017-11-02 09:36:31 -0200
commita7f93cec7999de04614d7adaf91c4348a3313e2e (patch)
treeea7e089f0f3d7baec50bc34f0cf39bbedefcd8fd /scripts/scalability/README.rst
parent21584bc33fdc672a0f59436ba5d66f66439d6366 (diff)
[benchmarks] add some orchestration to scalability tests
Diffstat (limited to 'scripts/scalability/README.rst')
-rw-r--r--scripts/scalability/README.rst36
1 files changed, 36 insertions, 0 deletions
diff --git a/scripts/scalability/README.rst b/scripts/scalability/README.rst
new file mode 100644
index 00000000..a2d891a7
--- /dev/null
+++ b/scripts/scalability/README.rst
@@ -0,0 +1,36 @@
+Blobs Server Scalability Tests
+==============================
+
+This folder contains code for running benchmark tests for determining Soledad
+Server Blobs service scalability. This consists basically in launching a number
+of parallel blobs upload or download requests, to assess the number of requests
+per second that the server is able to answer.
+
+When analyzing results, it's important to have in mind that the size of the
+blobs that are transferred as well as the bandwith of both the server and the
+client used for the test are resources that have high impact in the results.
+
+Test Controller server
+----------------------
+
+In the server, run the following to have an instance of the Test Controller
+server running:
+
+ make install-server
+ make start-server
+
+And, if you want to see the logs, use:
+
+ make log
+
+Alternativelly, use `make start-server-nodaemon` to avoid detaching from the
+terminal.
+
+Test Controller client
+----------------------
+
+Make sure an instance of the Test Controller Server is reachable at $(URI),
+and run:
+
+ make install-client
+ make run-test