bweb: Update some GPL2 notice to AGPL

[bacula/bacula] / gui / bweb / INSTALL

diff --git a/gui/bweb/INSTALL b/gui/bweb/INSTALL
index 63dfc81fa56779940a9b60e6b7beda9a7c53cd7c..7c1ae65f13a98172c865ce3ff6f6af5b815e195b 100644 (file)
--- a/gui/bweb/INSTALL
+++ b/gui/bweb/INSTALL
@@ -2,11 +2,11 @@
 #               INSTALL NOTES                                  #
 ################################################################
 
-Bweb works well with 2.0 release or later.
+Bweb works well with 3.0 release or later.
 
 1) install Perl lib
-2) using lighttpd
-3) copy your files (using apache)
+2) using lighttpd (quick install)
+3) using apache 
 4) initialize your configuration file
 5) do some sql stuff (for postgresql or mysql 5 users)
 6) use the -n option on bconsole so that it works with Expect
@@ -69,25 +69,40 @@ Bweb works well with 2.0 release or later.
 ################# USE LIGHTTPD WITH BWEB #######################
 
 In this example, bweb files are in /home/bacula/bweb
+You should have installed lighttpd.
 
 bacula:~$ cd bweb
-bacula:~/bweb$ sed -i "s:/etc/bacula/bweb.conf:$PWD/bweb.conf:" lib/Bweb.pm
-bacula:~/bweb$ cat > bweb.conf <<EOF
-$VAR1 = { template_dir => '$PWD/lang',
-          fv_write_path => '/tmp/',
- };
-EOF
 
+# configure the database
+bacula:~/bweb$ mysql bacula < script/bweb-mysql.sql
+# or
+bacula:~/bweb$ psql bacula < script/bweb-postgresql.sql
 
 # You can start the web server from the bweb directory
 bacula@localhost:~/bweb$ ./script/starthttp
- Using bweb on /home/eric/dev/git/gui/bweb,  use firefox http://localhost:9180
+ Making configuration template in /home/bacula/bweb/bweb.conf
+ Adjusting bweb.conf path
+ Using bweb on /home/bacula/bweb,  use firefox http://localhost:9180
  2009-07-18 22:23:12: (log.c.75) server started
 
 
 By default, only the loopback interface is binded, you can change that
 in the bweb/script/httpd.conf file.
 
+You will have to configure bweb with your database and bconsole info, it
+can be done in the web interface.
+
+I [Kern] used the following in the Configuration panel. Note: I am 
+   using Ubuntu Hardy (8.04):
+DBI:     DBI:mysql:database=bacula;host=roxie 
+user:    bacula
+Password:   (nothing -- I have none)
+email_media:  my@email.com
+bconsole:  /opt/bacula/bin/bconsole -n
+
+Click: Save
+Click: Main -- you should see the charts
+
 
 ################ FILE COPY (Full Apache methode) ###############
  # you must get bweb svn files
@@ -148,10 +163,10 @@ Put this in your httpd.conf, and add user with htpasswd
 
 Alias /bweb /usr/share/bweb/html
 <Directory /usr/share/bweb/html>
-       Options FollowSymLinks MultiViews
-       AllowOverride None
-       Order allow,deny
-       allow from all
+        Options FollowSymLinks MultiViews
+        AllowOverride None
+        Order allow,deny
+        allow from all
 </Directory>
 
 ScriptAlias /cgi-bin/bweb /usr/lib/cgi-bin/bweb
@@ -241,7 +256,7 @@ To get database size with mysql5, edit Bweb.pm and change the DB_SIZE macro
  # with mysql < 5, you have to play with the ugly SHOW command
  DB_SIZE => " SELECT 0 ",
  # works only with mysql 5
- # DB_SIZE => " SELECT sum(DATA_LENGTH) FROM INFORMATION_SCHEMA.TABLES ",
+ DB_SIZE => " SELECT sum(DATA_LENGTH) FROM INFORMATION_SCHEMA.TABLES ",
 
 ################ BCONSOLE NOTES ################################
 
@@ -305,11 +320,9 @@ Add (or configure) a writable location to the parameters in bweb.conf
 
 ###### BFILEVIEW only part
 
-You have to remove "<!-- Remove this to activate bfileview" and "-->" from
-tpl/en/display_job_zoom.tpl.
-
-You MUST use brestore.pl -b or bresto.pl action=batch to initialize the database, and
-you CAN use bfileview.pl mode=batch jobid=xxx where=/ to compute tree size.
+You MUST use brestore.pl -b or bresto.pl action=batch to initialize the
+database, and you CAN use bfileview.pl mode=batch jobid=xxx where=/ to compute
+tree size.
 
 At this time, it's a good idea to schedule brestore.pl -b after your 
 BackupCatalog job.
@@ -318,7 +331,7 @@ Job {
   Name = "BackupCatalog"
   ...
   # This creates an ASCII copy of the catalog
-  RunBeforeJob = "/opt/bacula/etc/make_catalog_backup bacula bacula Pei0ahm9"
+  RunBeforeJob = "/opt/bacula/etc/make_catalog_backup.pl MyCatalog"
   # This deletes the copy of the catalog
   RunAfterJob  = "/opt/bacula/etc/delete_catalog_backup"
   RunAfterJob  = "/usr/lib/cgi-bin/bweb/bresto.pl action=batch"
@@ -356,11 +369,8 @@ GRANT INSERT,UPDATE,DELETE ON bacula.LocationLog
 You keep Jobs informations across retention into a JobHisto table.
 You have to setup stat_job_table = JobHisto in bweb configuration.
 
-CREATE TABLE JobHisto (LIKE Job);
-
-And run this on crontab when you want :
-INSERT INTO JobHisto 
-  (SELECT * FROM Job WHERE JobId NOT IN (SELECT JobId FROM JobHisto) );
+And use Statistics module from Bacula (see documentation and update stats
+command).
 
 ################ USE USERS AND GROUPS WITH BWEB ##########################
 
@@ -372,7 +382,7 @@ For postgresql, it will be done with bweb/script/bweb-postgresql.sql (already do
 
 It will do some basics things on a working bweb/brestore setup.
 
-1) Go to http://extjs.com and download their toolkit (last 2.2 release)
+1) Go to http://extjs.com and download their toolkit (use the 2.2 release)
 
 2) Install files in /bweb/ext web root 
  example on debian : 
@@ -386,7 +396,7 @@ It will do some basics things on a working bweb/brestore setup.
 
 5) Use the last Bweb.pm
   If you are trying bresto in a working bweb/brestore setup, you must make sure that you use 
-  the last Bweb.pm SVN version.
+  the last Bweb.pm git version.
 
 6) Go on http://you-director/bweb/bresto.html