]> git.sur5r.net Git - bacula/bacula/blob - regress/README
spelling correction: windows 2003 instead of 3000 in vss chapter
[bacula/bacula] / regress / README
1       Bacula Regression
2         Kern Sibbald
3         December 2003
4
5 This is Bacula's regression script directory.  At this time
6 (December 2003), it is still in development, so all the tests are
7 not complete.
8
9 To set it up, create your personal configuration file, by
10 copying prototype.conf to xxx.conf or simply editing prototype.conf
11 directly.
12
13 Then edit your conf file and define appropriate values
14 for the variables that are in that file.  If you want to see
15 a real example, look at kern.conf, but please don't use my
16 email address!
17
18 Make sure that depkgs is pre-built if it isn't 
19 already: (cd your-depkgs; make sqlite).
20
21 Then do:
22
23    ./config xxx.conf
24    make setup
25
26 You run the above one time.  This will build a Makefile from
27 Makefile.in and your xxx.conf file, copy the Bacula source,
28 configure, build it, and configure all the Bacula scripts
29 and conf files.  If you change your source, you will need to
30 redo this command.
31
32 Then you can run any of the tests in the tests subdirectory.
33 Each test whose name ends in -root requires you to be root for
34 a resonable run.  Each test is totally independent of any other
35 test. Aside from the required "make setup", each test is totally
36 self-initalizing and should clean up after itself.
37
38 Not all the tests yet report OK.  This is simply because there are
39 some spurious differences that I haven't yet taken the time to
40 eliminate.  The working scrips as of 24 Apr 03 are:
41
42 backup-bacula-test
43 sparse-test
44 compressed-test
45 sparse-compressed-test
46 two-jobs-test
47 wierd-files-test
48 verify-vol-test
49
50 The tests expect you to execute them from the main regress 
51 directory!               
52
53 You can run them individually as:
54
55    tests/two-jobs-test
56
57 or all non-root tests (my normal testing under my account)
58
59   ./all-non-root-tests
60
61 or all tests (I only run these before a production release):
62
63    su
64    ./all-tests
65
66
67 after running the root tests, while still root, it is a good idea
68 to do:
69
70    make reset
71
72 this cleans up any files that may be created with root permissions.
73
74 If you want to add more tests, do so by putting the shell script 
75 in the tests subdirectory. Be careful when adding (or better not)
76 new clients, pools, and such to the test-bacula-dir.conf.in file
77 as it may invalidate a good number of tests, which respond to
78 questions by answering with a number (i.e. the order of the selection
79 list is known). It might be better to add your own testb-bacula...
80 configuration file.  
81
82 To avoid re-doing a make setup if you have made a change to the
83 conf files, and you do not need a new copy of the source, you can simply do:
84
85    scripts/do-sed <your-email-address>
86
87 Debugging failed tests:
88 The simplest thing to do is to edit tests/xxxx where xxxx is the name of
89 a or the test that is failing and change all:
90  
91  @output
92
93 to
94   
95  @tee
96
97 re-run the test. The output will display on your terminal.  In rare cases,        
98 for example to get bacula debug output, you might want to remove the
99 "2>&1 >/dev/null" from the end of the bin/bacula call or from the end
100 of the diff call, assuming you want to "see" the diff output.
101