Revision 3c595590

/dev/null
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
b/docs/snf-burnin.rst
91 91
                        Default = all
92 92

  
93 93

  
94
Log files
95
=========
96

  
97
In each run, snf-burnin stores log files in the folder defined in the
98
--log-foler parameter, under the folder with the timestamp of the
99
snf-burnin-run and the image used for it. The name prefixes of the log
100
files are:
101

  
102
* details: Showing the complete log of snf-burnin run.
103
* error: Showing the testcases that encountered a runtime error.
104
* failed: Showing the testcases that encountered a failure.
105

  
106

  
94 107
Detailed description of testcases
95 108
=================================
96 109

  
......
190 203
* Upload simple file to newly created container
191 204
* Download file from Pithos and test it is the same with the one uploaded
192 205
* Remove created file and container from Pithos
206

  
207

  
208
Example scripts
209
===============
210

  
211
Under /snf-tools/conf you can find example scripts for automating snf-burnin
212
testing using cron.
213

  
214
* **snf-burnin-run.sh** runs snf-burnin with the given parameters, deletes
215
  stale instances (servers, networks) from old runs and delete logs older
216
  than a week. It aborts if snf-burnin runs for longer than expected.
217

  
218
* **snf-burnin-output.sh** checks for failed snf-burnin tests the last 30
219
  minutes in a given log folder. Exit status is 0 if no failures were
220
  encountered, else exit status is 1.

Also available in: Unified diff