git.sur5r.net Git - bacula/bacula/blob - gui/brestore/README

   1 ################################################################
   2 #             brestore -- a bacula perl interface              #
   3 ################################################################
   4
   5 As we felt a need for a restoration GUI for bacula, we developed a simple
   6 Perl/GTK GUI.
   7 It has the following features :
   8
   9     * Direct SQL access to the database for good performance
  10
  11     * Fast Time Navigation (switch almost instantaneously between the different
  12       versions of a directory, by changing the date from a list)
  13
  14     * Possibility to choose a selected file, then browse all its available
  15       versions, and see directly if these versions are online in a library or
  16       not
  17
  18     * Simple restoration by the generation of a BSR file
  19
  20     * Works indifferently with postgresql and mysql
  21
  22 We have a working (if a bit unpolished) version ready, and think it is time for
  23 us to publish it and have user and Kern feedback.
  24
  25 What's missing :
  26
  27     * We want to add some other features such as : the user has selected a FD
  28       and a date, we want to display the list of media requested and their
  29       availability.
  30
  31     * Plenty of features. As we don't have lots of imagination. Don't hesitate
  32       to suggest us your ideas ...
  33
  34 For the moment, we want to concentrate on having a restoration interface. We
  35 don't care about seeing the restoration progress, or anything else.
  36
  37 These tools are available with Bweb.
  38
  39 ################ INSTALL #######################################
  40
  41 # you can put glade file on /usr/share/brestore or /usr/local/share/brestore
  42 mkdir -p /usr/share/brestore
  43 install -m 644 -o root -g root brestore.glade /usr/share/brestore
  44 install -m 755 -o root -g root brestore.pl    /usr/bin
  45
  46 # you must get Bconsole.pm from bweb modules (bweb/lib/Bconsole.pm)
  47 install -m 644 -o root -g root Bconsole.pm /usr/share/perl5
  48
  49 ################ INSTALL MODULES ###############################
  50
  51 Perl Modules
  52 The Debian Way
  53
  54 apt-get install libgtk2-gladexml-perl
  55 apt-get install libdbd-mysql-perl
  56 apt-get install libdbd-pg-perl
  57 apt-get install libexpect-perl
  58
  59 The Red Hat way
  60 Please contribute, neither of us have a Red Hat to test on :)
  61 Other distros/Unices
  62 Please contribute ...
  63 The generic Way, if those modules aren't packaged by your distro
  64
  65 perl -MCPAN -e shell
  66 install Gtk2
  67 install Expect
  68 install Gtk2::GladeXML
  69
  70 install DBD::mysql
  71 or
  72 install DBD::Pg
  73
  74 ################ BCONSOLE WITHOUT CONIO ########################
  75
  76 You must use bconsole without conio support. For that, use
  77 bconsole -n option.
  78
  79 WARNING : You must be able to execute bconsole and able to read bconsole.conf !
  80
  81 ################ CONFIGURATION #################################
  82
  83 You can make configuration from brestore himself (if brestore can find
  84 his glade file).
  85
  86 Example :
  87
  88 $parameters = {
  89                 'mozilla' => 'mozilla',
  90                 'bconsole' => '/usr/local/bin/bconsole.noconio -c /etc/bacula/bconsole.conf',
  91                 'bweb' => 'http://localhost/cgi-bin/bweb/bweb.pl',
  92                 'connection_string' => 'DBI:mysql:database=bacula;host=127.0.0.1;port=3306',
  93                 'username' => 'bacula',
  94                 'password' => 'xxxx',
  95                 'bsr_dest' => 'file://var/tmp',
  96                 'debug' => 0,
  97                 'use_ok_bkp_only' => 1,
  98                 'default_restore_job' => 'restore'
  99               };