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