git.sur5r.net Git - bacula/bacula/blob - regress/README

   1      Bacula Regression
   2      Kern Sibbald
   3      April 2003
   4
   5 This is Bacula's regression script directory.  At this time
   6 (May 2003), it is still in development, so all the tests are
   7 not complete.
   8
   9 To set it up, first edit Makefile and set BACULA-SOURCE to point
  10 to your source.
  11
  12 !!!!!!!!!! IMPORTANT !!!!!!!!
  13 Second, edit the EMAIL address in the Makefile to be your
  14 email address and not mine or I will get LOTS of unwanted
  15 email!
  16
  17 Third, edit the DEPKGS path in the Makefile to point to the
  18 depkgs directory.
  19
  20 Fourth, make sure that depkgs is pre-built if it isn't
  21 already: (cd your-depkgs; make sqlite).
  22
  23 Then do:
  24
  25    make setup
  26
  27 You run the above one time.  This will copy the Bacula
  28 source, configure, build it, and configure all the scripts
  29 and conf files.  If you change your source, you will need
  30 to 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>