| 1 | ===================== |
|---|
| 2 | Stress Tests for Kofa |
|---|
| 3 | ===================== |
|---|
| 4 | |
|---|
| 5 | Stress- and performance tests in here are based on the Python package |
|---|
| 6 | `multi-mechanize`. See the homepage |
|---|
| 7 | http://testutils.org/multi-mechanize/ for details. |
|---|
| 8 | |
|---|
| 9 | Installation |
|---|
| 10 | ------------ |
|---|
| 11 | |
|---|
| 12 | The stuff in here is *not* buildout-based. |
|---|
| 13 | |
|---|
| 14 | To make it work, you need a Python with the packages |
|---|
| 15 | `multi-mechanize`, `numpy`, and `matplotlib` installed. |
|---|
| 16 | |
|---|
| 17 | I'm used to install such packages in a virtual environment like this:: |
|---|
| 18 | |
|---|
| 19 | $ virtualenv --no-site-packages mysandbox |
|---|
| 20 | $ source mysandbox/bin/activate |
|---|
| 21 | |
|---|
| 22 | Afterwards the required packages can be installed into this sandbox:: |
|---|
| 23 | |
|---|
| 24 | (mysandbox) $ pip install numpy |
|---|
| 25 | (mysandbox) $ pip install matplotlib |
|---|
| 26 | (mysandbox) $ pip install multi-mechanize |
|---|
| 27 | |
|---|
| 28 | Especially `matplotlib` is very demanding regarding already installed |
|---|
| 29 | (C and C++) libraries. On my Ubuntu I had to install at least:: |
|---|
| 30 | |
|---|
| 31 | $ sudo apt-get install libfreetype6-dev |
|---|
| 32 | $ sudo apt-get install libpng12-dev |
|---|
| 33 | |
|---|
| 34 | to make it compile and install. |
|---|
| 35 | |
|---|
| 36 | Running Stresstests |
|---|
| 37 | ------------------- |
|---|
| 38 | |
|---|
| 39 | The different stress tests are put into different multi-mechanize |
|---|
| 40 | 'projects'. Each project runs a certain stress test for which you have |
|---|
| 41 | to setup certain things to make it work. |
|---|
| 42 | |
|---|
| 43 | Basically, you run a stresstest like this:: |
|---|
| 44 | |
|---|
| 45 | (mysandbox) $ multimech-run <PROJECT> |
|---|
| 46 | |
|---|
| 47 | where ``<PROJECT>`` is one of the directories in here. |
|---|
| 48 | |
|---|
| 49 | The projects in here are the subdirectories, each one representing a |
|---|
| 50 | different 'project' or kind of stresstest. Please see the respective |
|---|
| 51 | README files in this folder to learn what conditions must be met to |
|---|
| 52 | run each test. |
|---|
| 53 | |
|---|
| 54 | Please keep in mind, that these tests normally require some local or |
|---|
| 55 | remote setup, for instance a running Kofa instance with certain |
|---|
| 56 | reachable URLs. Again, you can lookup the specific READMEs in this |
|---|
| 57 | directory to learn what setup is required to run a certain test. |
|---|
