git.sur5r.net Git - bacula/bacula/blob - 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