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