root / snf-tools / README @ 6138f0ef
History | View | Annotate | Download (1.5 kB)
| 1 |
README |
|---|---|
| 2 |
======= |
| 3 |
|
| 4 |
snf-burnin is an integration testing tool for a running Synnefo deployment. |
| 5 |
It runs test scenarios from the following categories: |
| 6 |
|
| 7 |
- Authentication |
| 8 |
- Images |
| 9 |
- Flavors |
| 10 |
- Servers |
| 11 |
- Networking |
| 12 |
|
| 13 |
====== |
| 14 |
Usage |
| 15 |
====== |
| 16 |
|
| 17 |
Example: |
| 18 |
-------- |
| 19 |
snf-burnin --api=API_URL --token=TOKEN --image-id=IMAGE-ID --log-folder=LOG_FOLDER |
| 20 |
|
| 21 |
|
| 22 |
For more options: |
| 23 |
------------------ |
| 24 |
snf-burnin --help |
| 25 |
|
| 26 |
========== |
| 27 |
Log files |
| 28 |
========== |
| 29 |
|
| 30 |
In each run, snf-burnin stores log files in the folder defined in the --log-folder parameter (default is /var/log/burnin) under the folder with the timestamp of the snf-burnin-run and the image used for it. The name prefixes of the log files are: |
| 31 |
|
| 32 |
- details: Showing the complete log of snf-burnin run. |
| 33 |
- error: Showing the testcases that encountered a runtime error. |
| 34 |
- failed: Showing the testcases that encountered a failure. |
| 35 |
|
| 36 |
|
| 37 |
Example scripts |
| 38 |
----------------- |
| 39 |
Under /snf-tools/conf/ you can find example scripts for automating snf-burnin testing using cron. |
| 40 |
|
| 41 |
- **snf-burnin-run.sh** runs snf-burnin with the given parameters, deletes stale instances (servers, networks) from old runs and delete logs older than a week. It aborts if snf-burnin runs for longer than expected. |
| 42 |
|
| 43 |
- **Usage**: ./snf-burnin-run.sh TOKEN IMAGE-ID LOG_FOLDER |
| 44 |
|
| 45 |
- **snf-burnin-output.sh** checks for failed snf-burnin tests the last 30 minutes in a given log folder. Exit status is 0 if no failures where encountered, else exit status is 1. |
| 46 |
|
| 47 |
- **Usage**: ./snf-burnin-output.sh LOG_FOLDER |