Statistics
| Branch: | Tag: | Revision:

root / snf-tools / README @ 5adcc57e

History | View | Annotate | Download (1.5 kB)

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