root / snf-tools / README @ 4c9918f9
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 \ |
20 |
--image-id=IMAGE-ID --log-folder=LOG_FOLDER |
21 |
|
22 |
|
23 |
For more options: |
24 |
------------------ |
25 |
snf-burnin --help |
26 |
|
27 |
========== |
28 |
Log files |
29 |
========== |
30 |
|
31 |
In each run, snf-burnin stores log files in the folder defined in the |
32 |
--log-folder parameter (default is /var/log/burnin) under the folder |
33 |
with the timestamp of the snf-burnin-run and the image used for it. |
34 |
The name prefixes of the log files are: |
35 |
|
36 |
- details: Showing the complete log of snf-burnin run. |
37 |
- error: Showing the testcases that encountered a runtime error. |
38 |
- failed: Showing the testcases that encountered a failure. |
39 |
|
40 |
|
41 |
Example scripts |
42 |
----------------- |
43 |
Under /snf-tools/conf/ you can find example scripts for automating |
44 |
snf-burnin testing using cron. |
45 |
|
46 |
- **snf-burnin-run.sh** runs snf-burnin with the given parameters, deletes |
47 |
stale instances (servers, networks) from old runs and delete logs older than |
48 |
a week. It aborts if snf-burnin runs for longer than expected. |
49 |
|
50 |
- **Usage**: ./snf-burnin-run.sh TOKEN IMAGE-ID LOG_FOLDER |
51 |
|
52 |
- **snf-burnin-output.sh** checks for failed snf-burnin tests the last 30 |
53 |
minutes in a given log folder. Exit status is 0 if no failures where |
54 |
encountered, else exit status is 1. |
55 |
|
56 |
- **Usage**: ./snf-burnin-output.sh LOG_FOLDER |