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

   1 bimagemgr.pl
   2 14 May 2006
   3
   4 This is a utility to monitor and burn file backups to CDR. It is a web
   5 based interface written in perl. It requires perl and an apache or other
   6 http server. It also requires the perl DBI module and the driver for the
   7 database used to store your bacula catalog. It has been tested on MySQL
   8 catalogs but an untested configuration is present for Postgresql and SQLite.
   9
  10 It can be run on the same server as bacula or on another machine on the
  11 network if you are willing to relax permissions on the backup Volume files
  12 (see below).
  13
  14 Installation from tarball:
  15 1. Examine the Makefile and adjust it to your configuration if needed.
  16 2. Edit config.pm to fit your configuration.
  17 3. Do 'make install' as root.
  18 4. Edit httpd.conf and change the Timeout value. The web server must not time
  19 out and close the connection before the burn process is finished. The exact
  20 value needed may vary depending upon your cd recorder speed and whether you are
  21 burning on the bacula server on on another machine across your network. In my
  22 case I set it to 1000 seconds. Restart httpd.
  23 5. Make sure that cdrecord is setuid root.
  24
  25 Installation from rpm package:
  26 1. Install the rpm package for your platform.
  27 2. Edit /cgi-bin/config.pm to fit your configuration.
  28 3. Edit httpd.conf and change the Timeout value. The web server must not time
  29 out and close the connection before the burn process is finished. The exact
  30 value needed may vary depending upon your cd recorder speed and whether you are
  31 burning on the bacula server on on another machine across your network. In my
  32 case I set it to 1000 seconds. Restart httpd.
  33 4. Make sure that cdrecord is setuid root.
  34
  35 For bacula systems less than 1.36:
  36 1. Edit the configuration section of config.pm to fit your configuration.
  37 2. Run /etc/bacula/create_cdimage_table.pl from a console on your bacula
  38 server (as root) to add the CDImage table to your bacula database.
  39
  40 Accessing the Volume files:
  41 The Volume files by default have permissions 640 and can only be read by root.
  42 The recommended approach to this is as follows (and only works if bimagemgr and
  43 apache are running on the same host as bacula.
  44
  45 For bacula-1.34 or 1.36 installed from tarball -
  46 1. Create a new user group bacula and add the user apache to the group for
  47 Red Hat or Mandrake systems. For SuSE systems add the user wwwrun to the
  48 bacula group.
  49 2. Change ownership of all of your Volume files to root.bacula
  50 3. Edit the /etc/bacula/bacula startup script and set SD_USER=root and
  51 SD_GROUP=bacula. Restart bacula.
  52
  53 Note: step 3 should also be done in /etc/init.d/bacula-sd but released versions
  54 of this file prior to 1.36 do not support it. In that case it would be necessary after
  55 a reboot of the server to execute '/etc/bacula/bacula restart'.
  56
  57 For bacula-1.38 installed from tarball -
  58 1. Your configure statement should include:
  59         --with-dir-user=bacula
  60         --with-dir-group=bacula
  61         --with-sd-user=bacula
  62         --with-sd-group=disk
  63         --with-fd-user=root
  64         --with-fd-group=bacula
  65 2. Add the user apache to the bacula group for Red Hat or Mandrake systems.
  66 For SuSE systems add the user wwwrun to the bacula group.
  67 3. Check/change ownership of all of your Volume files to root.bacula
  68
  69 For bacula-1.36 or bacula-1.38 installed from rpm -
  70 1. Add the user apache to the group bacula for Red Hat or Mandrake systems.
  71 For SuSE systems add the user wwwrun to the bacula group.
  72 2. Check/change ownership of all of your Volume files to root.bacula
  73
  74 bimagemgr installed from rpm > 1.38.9 will add the web server user to the
  75 bacula group in a post install script. Be sure to edit the configuration
  76 information in config.pm after installation of rpm package.
  77
  78 bimagemgr will now be able to read the Volume files but they are still not
  79 world readable.
  80
  81 If you are running bimagemgr on another host (not recommended) then you will
  82 need to change the permissions on all of your backup volume files to 644 in
  83 order to access them via nfs share or other means. This approach should only
  84 be taken if you are sure of the security of your environment as it exposes
  85 the backup Volume files to world read.
  86
  87 That's it. Call the script from a web browser as http://server/cgi-bin/bimagemgr.pl
  88 place a blank cd in your recorder and press a Burn button. See the bimagemgr section
  89 in the bacula manual for more information.