Statistics
| Branch: | Tag: | Revision:

root / snf-tools / README @ 6138f0ef

History | View | Annotate | Download (1.5 kB)

1 c1fc703c John Giannelos
README
2 c1fc703c John Giannelos
=======
3 c1fc703c John Giannelos
4 c1fc703c John Giannelos
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 9b69f7e6 John Giannelos
snf-burnin --api=API_URL --token=TOKEN --image-id=IMAGE-ID --log-folder=LOG_FOLDER
20 e93db675 John Giannelos
21 e93db675 John Giannelos
22 e93db675 John Giannelos
For more options:
23 e93db675 John Giannelos
------------------
24 e93db675 John Giannelos
snf-burnin --help
25 e93db675 John Giannelos
26 b03be261 John Giannelos
==========
27 b03be261 John Giannelos
Log files
28 b03be261 John Giannelos
==========
29 b03be261 John Giannelos
30 b03be261 John Giannelos
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 b03be261 John Giannelos
32 b03be261 John Giannelos
- details: Showing the complete log of snf-burnin run.
33 b03be261 John Giannelos
- error: Showing the testcases that encountered a runtime error.
34 b03be261 John Giannelos
- failed: Showing the testcases that encountered a failure.
35 b03be261 John Giannelos
36 e93db675 John Giannelos
37 e93db675 John Giannelos
Example scripts
38 e93db675 John Giannelos
-----------------
39 e93db675 John Giannelos
Under /snf-tools/conf/ you can find example scripts for automating snf-burnin testing using cron.
40 e93db675 John Giannelos
41 e93db675 John Giannelos
- **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 b03be261 John Giannelos
  
43 b03be261 John Giannelos
  - **Usage**: ./snf-burnin-run.sh TOKEN IMAGE-ID LOG_FOLDER
44 b03be261 John Giannelos
45 e93db675 John Giannelos
- **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 b03be261 John Giannelos
  
47 b03be261 John Giannelos
  - **Usage**: ./snf-burnin-output.sh LOG_FOLDER