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     * We want use bacula to generate bsr files, at this time, you can't restore
  35       files across different Storage (Full on tape, Incr on Disk for example)
  36
  37 For the moment, we want to concentrate on having a restoration interface. We
  38 don't care about seeing the restoration progress, or anything else.
  39
  40 These tools are available with Bweb.
  41
  42 ################ INSTALL #######################################
  43
  44 # you can put glade file on /usr/share/brestore or /usr/local/share/brestore
  45 mkdir -p /usr/share/brestore
  46 install -m 644 -o root -g root brestore.glade /usr/share/brestore
  47 install -m 755 -o root -g root brestore.pl    /usr/bin
  48
  49 # if you doesn't use bweb and bconsole.pl
  50 # you must get Bconsole.pm from bweb modules (bweb/lib/Bconsole.pm)
  51
  52 install -m 644 -o root -g root Bconsole.pm /usr/share/perl5
  53
  54 # copy bsr file directly to your director, use must use scp (or nfs stuff)
  55 # if you doesn't want to use this, you can dump the bsr file with "Gen BSR" button.
  56 # so you must have an ssh-key exchange. (you can also hack brestore.pl to use
  57 # something like '$err = `xterm -e scp $src $1 2>&1`'
  58
  59 your_login@yourws:~$ ssh-copy-id -i .ssh/your_pub_key login@bacula-dir
  60
  61 # you have to configure brestore preferences.
  62
  63 ################ WINDOWS INSTALL ###############################
  64
  65 Brestore works on win32 with ActivePerl. To get all libraries, you
  66 can install GCSTAR. You have also to copy libglade-2.0.dll
  67
  68 ################ INSTALL MODULES ###############################
  69
  70 Perl Modules
  71 The Debian Way
  72
  73 apt-get install libgtk2-gladexml-perl
  74 apt-get install libdbd-mysql-perl
  75 apt-get install libdbd-pg-perl
  76 apt-get install libexpect-perl
  77 apt-get install libwww-perl
  78
  79 The Red Hat way
  80 Please contribute, neither of us have a Red Hat to test on :)
  81 Other distros/Unices
  82 Please contribute ...
  83 The generic Way, if those modules aren't packaged by your distro
  84
  85 perl -MCPAN -e shell
  86 install Gtk2
  87 install Expect
  88 install Gtk2::GladeXML
  89 install LWP
  90
  91 install DBD::mysql
  92 or
  93 install DBD::Pg
  94
  95 ################ BCONSOLE WITHOUT CONIO ########################
  96
  97 If you doesn't use Bweb, you must use bconsole without conio support. For that, use
  98 bconsole -n option.
  99
 100 WARNING : You must be able to execute bconsole and able to read bconsole.conf !
 101
 102 ################ CONFIGURATION #################################
 103
 104 You can make configuration from brestore himself (if brestore can't find
 105 his glade file).
 106
 107 Example :
 108
 109 $parameters = {
 110                 'mozilla' => 'mozilla',
 111                 'bconsole' => '/usr/local/bin/bconsole.noconio -c /etc/bacula/bconsole.conf',
 112                 'bweb' => 'http://localhost/cgi-bin/bweb/bweb.pl',
 113                 'connection_string' => 'DBI:mysql:database=bacula;host=127.0.0.1;port=3306',
 114                 'username' => 'bacula',
 115                 'password' => 'xxxx',
 116                 'bsr_dest' => 'file://var/tmp',
 117                 'debug' => 0,
 118                 'use_ok_bkp_only' => 1,
 119                 'default_restore_job' => 'restore'
 120               };