RubyGems - bacuview - Versions diffs - 1.5 - Mend

bacuview 1.5

Files changed (112) hide show

data/AUTHORS +2 -0
data/ChangeLog +454 -0
data/README.bacuview +7 -0
data/README.rails +153 -0
data/Rakefile +94 -0
data/app/controllers/application.rb +11 -0
data/app/controllers/client_controller.rb +27 -0
data/app/controllers/job_controller.rb +100 -0
data/app/controllers/jobmedia_controller.rb +2 -0
data/app/controllers/media_controller.rb +44 -0
data/app/controllers/misc_controller.rb +14 -0
data/app/controllers/pool_controller.rb +38 -0
data/app/helpers/application_helper.rb +88 -0
data/app/helpers/client_finder.rb +112 -0
data/app/helpers/client_helper.rb +45 -0
data/app/helpers/job_helper.rb +56 -0
data/app/helpers/jobmedia_helper.rb +2 -0
data/app/helpers/media_helper.rb +14 -0
data/app/helpers/misc_helper.rb +15 -0
data/app/helpers/pool_helper.rb +2 -0
data/app/models/client.rb +14 -0
data/app/models/job.rb +21 -0
data/app/models/jobmedia.rb +9 -0
data/app/models/media.rb +23 -0
data/app/models/pool.rb +13 -0
data/app/views/client/_spec.rhtml +1 -0
data/app/views/client/check.rhtml +1 -0
data/app/views/client/index.rhtml +27 -0
data/app/views/client/show.rhtml +8 -0
data/app/views/job/_spec.rhtml +7 -0
data/app/views/job/index.rhtml +38 -0
data/app/views/job/last.rhtml +52 -0
data/app/views/job/show.rhtml +19 -0
data/app/views/job/spec.rhtml +38 -0
data/app/views/layouts/bacuview-layout.rhtml +50 -0
data/app/views/media/_spec.rhtml +1 -0
data/app/views/media/index.rhtml +30 -0
data/app/views/media/show.rhtml +8 -0
data/app/views/misc/about.rhtml +2 -0
data/app/views/misc/help.rhtml +1 -0
data/app/views/pool/_spec.rhtml +1 -0
data/app/views/pool/index.rhtml +29 -0
data/app/views/pool/show.rhtml +8 -0
data/bin/bacuview +3 -0
data/config/bacuview.yml.template +2 -0
data/config/boot.rb +19 -0
data/config/database.yml.template +13 -0
data/config/environment.rb +87 -0
data/config/environments/development.rb +19 -0
data/config/environments/production.rb +19 -0
data/config/environments/test.rb +19 -0
data/config/routes.rb +61 -0
data/log/development.log +0 -0
data/log/production.log +0 -0
data/log/test.log +0 -0
data/public/404.html +8 -0
data/public/500.html +8 -0
data/public/bacu-bat.png +0 -0
data/public/bacuweb.css +7 -0
data/public/client-sophie-thumb.png +0 -0
data/public/client-sophie.png +0 -0
data/public/clients-thumb.png +0 -0
data/public/clients.png +0 -0
data/public/dispatch.cgi +10 -0
data/public/dispatch.fcgi +24 -0
data/public/dispatch.rb +10 -0
data/public/favicon.ico +0 -0
data/public/home.html +108 -0
data/public/images/bacu-bat.png +0 -0
data/public/images/busy.png +0 -0
data/public/images/dunno.png +0 -0
data/public/images/error.png +0 -0
data/public/images/okay.png +0 -0
data/public/images/pool_pie.png +0 -0
data/public/install.html +156 -0
data/public/javascripts/application.js +2 -0
data/public/javascripts/client_check.js +24 -0
data/public/javascripts/controls.js +815 -0
data/public/javascripts/dragdrop.js +724 -0
data/public/javascripts/effects.js +953 -0
data/public/javascripts/prototype.js +1985 -0
data/public/job-1449-thumb.png +0 -0
data/public/job-1449.png +0 -0
data/public/job-last-thumb.png +0 -0
data/public/job-last.png +0 -0
data/public/jobs-thumb.png +0 -0
data/public/jobs.png +0 -0
data/public/media-39-thumb.png +0 -0
data/public/media-39.png +0 -0
data/public/media-thumb.png +0 -0
data/public/media.png +0 -0
data/public/news.html +144 -0
data/public/pool-lto3-thumb.png +0 -0
data/public/pool-lto3.png +0 -0
data/public/pools-thumb.png +0 -0
data/public/pools.png +0 -0
data/public/robots.txt +1 -0
data/public/stylesheets/bacuview.css +37 -0
data/script/about +3 -0
data/script/breakpointer +3 -0
data/script/console +3 -0
data/script/destroy +3 -0
data/script/generate +3 -0
data/script/performance/benchmarker +3 -0
data/script/performance/profiler +3 -0
data/script/plugin +3 -0
data/script/process/reaper +3 -0
data/script/process/spawner +3 -0
data/script/process/spinner +3 -0
data/script/runner +3 -0
data/script/server +3 -0
metadata +168 -0

data/config/routes.rb ADDED Viewed

@@ -0,0 +1,61 @@
+ActionController::Routing::Routes.draw do |map|
+  # Add your own custom routes here.
+  # The priority is based upon order of creation:
+  # first created -> highest priority.
+  # Here's a sample route:
+  # map.connect 'products/:id', :controller => 'catalog', :action => 'view'
+  # Keep in mind you can assign values other than :controller and :action
+  # You can have the root of your site routed by hooking up ''
+  # -- just remember to delete public/index.html.
+  # map.connect '', :controller => "welcome"
+  map.connect '', :controller => "job", :action => "index",
+    :name => '0', :days => '1', :jsort => 'id'
+  # job route
+  map.connect 'job/last/:name',
+    :controller => 'job', :action => 'last'
+  map.connect 'job/show/:jid',
+    :controller => 'job', :action => 'show'
+  map.connect 'job/:name/:days/:jsort',
+    :controller => 'job', :action => 'index',
+    :name => '0', :days => '1', :jsort => 'id',
+    :requirements => { :jsort => /.*/ }
+  # client route
+  map.connect 'client/show/:cid',
+    :controller => 'client', :action => 'show'
+  map.connect 'client/check',
+    :controller => 'client', :action => 'check'
+  map.connect 'client/:csort',
+    :controller => 'client', :action => 'index', :csort => 'name',
+    :requirements => { :csort => /.*/ }
+  # pool route
+  map.connect 'pool/show/:pid',
+    :controller => 'pool', :action => 'show'
+  map.connect 'pool/dist/:psort',
+    :controller => 'pool', :action => 'dist', :psort => 'name'
+  map.connect 'pool/:psort',
+    :controller => 'pool', :action => 'index', :psort => 'name',
+    :requirements => { :psort => /.*/ }
+  # media route
+  map.connect 'media/show/:mid',
+    :controller => 'media', :action => 'show'
+  map.connect 'media/:msort',
+    :controller => 'media', :action => 'index', :msort => 'name',
+    :requirements => { :msort => /.*/ }
+  # misc routes
+  map.connect "about", :controller => 'misc', :action => 'about'
+  map.connect "help",  :controller => 'misc', :action => 'help'
+  # Allow downloading Web Service WSDL as a file with an extension
+  # instead of a file named 'wsdl'
+  map.connect ':controller/service.wsdl', :action => 'wsdl'
+  # Install the default route as the lowest priority.
+  map.connect ':controller/:action/:id'
+end

data/log/development.log ADDED Viewed

File without changes

data/log/production.log ADDED Viewed

File without changes

data/log/test.log ADDED Viewed

File without changes

data/public/404.html ADDED Viewed

@@ -0,0 +1,8 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
+   "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<body>
+  <h1>File not found</h1>
+  <p>Change this error message for pages not found in public/404.html</p>
+</body>
+</html>

data/public/500.html ADDED Viewed

@@ -0,0 +1,8 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
+   "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<body>
+  <h1>Application error (Apache)</h1>
+  <p>Change this error message for exceptions thrown outside of an action (like in Dispatcher setups or broken Ruby code) in public/500.html</p>
+</body>
+</html>

data/public/bacu-bat.png ADDED Viewed

Binary file

data/public/bacuweb.css ADDED Viewed

@@ -0,0 +1,7 @@
+body {
+  margin: 0 auto; width: 80%;
+  background-image: url('/bacu-bat.png');
+  background-repeat: no-repeat; background-position: 8px 8px;
+}
+pre { font-weight: bold; use-normal-font-size: larger; }
+hr { width: 30%; }

data/public/client-sophie-thumb.png ADDED Viewed

Binary file

data/public/client-sophie.png ADDED Viewed

Binary file

data/public/clients-thumb.png ADDED Viewed

Binary file

data/public/clients.png ADDED Viewed

Binary file

data/public/dispatch.cgi ADDED Viewed

@@ -0,0 +1,10 @@
+#!/usr/bin/ruby
+require File.dirname(__FILE__) + "/../config/environment" unless defined?(RAILS_ROOT)
+# If you're using RubyGems and mod_ruby, this require should be changed to an absolute path one, like:
+# "/usr/local/lib/ruby/gems/1.8/gems/rails-0.8.0/lib/dispatcher" -- otherwise performance is severely impaired
+require "dispatcher"
+ADDITIONAL_LOAD_PATHS.reverse.each { |dir| $:.unshift(dir) if File.directory?(dir) } if defined?(Apache::RubyRun)
+Dispatcher.dispatch

data/public/dispatch.fcgi ADDED Viewed

@@ -0,0 +1,24 @@
+#!/usr/bin/ruby
+#
+# You may specify the path to the FastCGI crash log (a log of unhandled
+# exceptions which forced the FastCGI instance to exit, great for debugging)
+# and the number of requests to process before running garbage collection.
+#
+# By default, the FastCGI crash log is RAILS_ROOT/log/fastcgi.crash.log
+# and the GC period is nil (turned off).  A reasonable number of requests
+# could range from 10-100 depending on the memory footprint of your app.
+#
+# Example:
+#   # Default log path, normal GC behavior.
+#   RailsFCGIHandler.process!
+#
+#   # Default log path, 50 requests between GC.
+#   RailsFCGIHandler.process! nil, 50
+#
+#   # Custom log path, normal GC behavior.
+#   RailsFCGIHandler.process! '/var/log/myapp_fcgi_crash.log'
+#
+require File.dirname(__FILE__) + "/../config/environment"
+require 'fcgi_handler'
+RailsFCGIHandler.process!

data/public/dispatch.rb ADDED Viewed

@@ -0,0 +1,10 @@
+#!/usr/bin/ruby
+require File.dirname(__FILE__) + "/../config/environment" unless defined?(RAILS_ROOT)
+# If you're using RubyGems and mod_ruby, this require should be changed to an absolute path one, like:
+# "/usr/local/lib/ruby/gems/1.8/gems/rails-0.8.0/lib/dispatcher" -- otherwise performance is severely impaired
+require "dispatcher"
+ADDITIONAL_LOAD_PATHS.reverse.each { |dir| $:.unshift(dir) if File.directory?(dir) } if defined?(Apache::RubyRun)
+Dispatcher.dispatch

data/public/favicon.ico ADDED Viewed

Binary file

data/public/home.html ADDED Viewed

@@ -0,0 +1,108 @@
+<html>
+<head>
+  <title>Bacuview -- a Bacula Status Monitor</title>
+  <link href="/bacuweb.css" rel="Stylesheet"
+   media="screen" type="text/css" />
+</head>
+<body>
+  <div style="text-align: center"> <hr width="30%"/>
+  <h1>Bacuview -- a Bacula Status Monitor</h1>
+  </div>
+  <p> The Bacuview application provides a web-based view into the
+  status of a Bacula backup system.  Views are provided for the status
+  of the jobs, the clients, the media, and the pools of the
+  system. </p>
+  <p> Bacuview was developed in surprisingly short order thanks
+  largely to the use of the <a href="http://rubyonrails.org/"> Ruby on Rails
+  </a> development framework and the <a href="http://ruby-doc.org/">
+  Ruby </a> programming language.  The Bacuview application is
+  generously hosted at <a href="http://rubyforge.org/"> RubyForge</a>,
+  where the project is available <a
+  href="http://rubyforge.org/frs/?group_id=1288"> for download. </a>
+  </p>
+  <p> If this sounds like something that you might find useful, you
+  can take a look at the <a href="news.html">news</a> and <a
+  href="ChangeLog">ChangeLog</a> files, and review the <a
+  href="install.html"> installation notes </a> prior to getting
+  started. </p>
+  <div style="text-align: center"> <hr width="30%"/>
+  <h2>The Job View</h2>
+  <a href="jobs.png"> <img src="jobs-thumb.png"/> </a>
+  <a href="job-1449.png"> <img src="job-1449-thumb.png"/> </a>
+  <a href="job-last.png"> <img src="job-last-thumb.png"/> </a>
+  </div>
+  <p> The most useful view into the status of a Bacula system is
+  provided by the Jobs view, which will initially show the completion
+  status of all jobs that have been scheduled during the current
+  day. </p>
+  <p> The "Jobs..."  links along the left of the page are sticky, so
+  you can get a list of all "bubba" jobs run in the last month by
+  selecting the appropriate "Job..." links in any order. </p>
+  <p> The contents of the jobs table can be sorted by clicking the
+  links in the column headings of the table.  Sorting on the same
+  column multiple times will toggle the sort order.  The current sort
+  column is indicated by a black bar under the column header.
+  <p> Clicking the "Job Id" link for a job will provide a more
+  detailed view of the information available for that job. One of the
+  more useful features of this page is that it provides an easy way to
+  find out the media volumes that are used by a job.  Clicking the
+  "Job Name" link will provide a summary of the last backups of the
+  job. </p>
+  <div style="text-align: center"> <hr width="30%">
+  <h2>The Media View</h2>
+  <a href="media.png"> <img src="media-thumb.png"/> </a>
+  <a href="media-39.png"> <img src="media-39-thumb.png"/> </a>
+  </div>
+  <p> The Media view shows the current status of all the media volumes
+  registered with Bacula, as well as some information about the pool
+  to which each volume belongs.  As with the Jobs view, the Media
+  table can be sorted by clicking the links in the column headers,
+  with a more detailed report on each volume available by following
+  the link that shows the label of the volume. </p>
+  <div style="text-align: center"> <hr width="30%">
+  <h2>The Client View</h2>
+  <a href="clients.png"> <img src="clients-thumb.png"/> </a>
+  <a href="client-sophie.png"> <img src="client-sophie-thumb.png"/> </a>
+  </div>
+  <p> The Client view shows what information is available on each of
+  the clients that are registered with Bacula.  If you've enabled
+  Javascript support in your web browser, you can also perform a quick
+  status check on any of all of the clients by clicking the "OK?"
+  column.  The page detailing the information on a particular client
+  is provided for consistancy, even though it supplies no additional
+  information. </p>
+  <div style="text-align: center"> <hr width="30%">
+  <h2>The Pool View</h2>
+  <a href="pools.png"> <img src="pools-thumb.png"/> </a>
+  <a href="pool-lto3.png"> <img src="pool-lto3-thumb.png"/> </a>
+  </div>
+  <p> The Pool view summarized the pools available for backups.  Its
+  primary value is as a way to select one of the detailed views of a
+  particular pool, where a great deal of information is
+  available. </p>
+  <div style="text-align: center"> <hr width="30%">
+  <address>
+    <a href="mailto:john@kodis.org">John Kodis</a>
+  </address>
+  </div>
+</body>
+</html>

data/public/images/bacu-bat.png ADDED Viewed

Binary file

data/public/images/busy.png ADDED Viewed

Binary file

data/public/images/dunno.png ADDED Viewed

Binary file

data/public/images/error.png ADDED Viewed

Binary file

data/public/images/okay.png ADDED Viewed

Binary file

data/public/images/pool_pie.png ADDED Viewed

Binary file

data/public/install.html ADDED Viewed

@@ -0,0 +1,156 @@
+<html>
+<head>
+  <title>Bacuview Installation</title>
+  <link href="/bacuweb.css" rel="Stylesheet"
+   media="screen" type="text/css" />
+</head>
+<body>
+  <div class='head'>
+  <hr/><h1>Bacuview Installation</h1>
+  </div>
+  <div class='head'> <hr/>
+  <h2>OVERVIEW</h2>
+  </div>
+  <p> The Bacuview application has been developed using the Ruby on
+  Rails framework, as described at <a
+  href='http://rubyonrails.org'>the Ruby on Rails</a> web site.  While
+  this greatly speeds development, it adds a few prerequisites to the
+  application.  The installation procedure involves installing Ruby,
+  using Ruby to build RubyGems, the Ruby package manager, and finally
+  using the resulting gem command to install the Ruby on Rails package
+  and the Bacuview application.  After a few configuration file changes
+  your Bacuview installation should be operational. </p>
+  <div class='head'> <hr/>
+  <h2>INSTALL RUBY</h2>
+  </div>
+  <p> It's best to install as much of the required software using the
+  packaging system provided by your operating system.  For Fedora Core
+  6 and derived operating systems, this should cover all the bases:
+  </p>
+  <pre>
+    $ su -
+    # yum install ruby ruby-rdoc ruby-postgres ruby-mysql </pre>
+  <p> Of course, you could also simply "yum install \*ruby\*" to get
+  all the Ruby goodness that Fedora has to offer, while at the other
+  extreme you could omit either ruby-postgress or ruby-mysql. </p>
+  <div class='head'> <hr/>
+  <h2>INSTALL RUBYGEMS</h2>
+  </div>
+  <p> RubyGems, the Ruby package manager is installed next.  The
+  RubyGems application is distributed as a tar file containing a
+  "setup.rb" Ruby script that handles the RubyGems installation and
+  setup.  As with Ruby itself, rubygems is available for <a
+  href="http://rubyforge.org/frs/download.php/11289/rubygems-0.9.0.tgz">
+  download </a> from the rubyforge.org web site. </p>
+  <p> Given the rubygems-0.9.0.tgz file... </p>
+  <pre>
+    $ tar xzf rubygems-0.9.0.tgz
+    $ su -
+    # cd rubygems-0.9.0
+    # ruby setup.rb </pre>
+  <div class='head'> <hr/>
+  <h2>INSTALL RAILS AND BACUVIEW</h2>
+  </div>
+  <p> With the RubyGems package available, the installation of the
+  Bacuview web application and the Ruby on Rails framework that it
+  uses is trivial: </p>
+  <pre>
+    # gem install rails --include-dependencies
+    # gem install bacuview </pre>
+  <div class='head'> <hr/>
+  <h2>CREATE A BACUVIEW USER</h2>
+  </div>
+  <p> While strictly optional, you can protect your bacula database
+  against inadvertent modification by the Bacuview application by
+  setting up a "bacuview" database user that has select-only rights to
+  the few tables that the Bacuview application uses.  As the postgres
+  user, or whatever user has administrative rights to your database:
+  </p>
+  <pre>
+    $ psql bacula
+    # create user bacuview password 'bacuview';
+    # grant select on job, jobmedia, client, media, pool to bacuview; </pre>
+  <p> It may also be necessary to add lines to the pg_hba.conf file to
+  allow the bacuview user to connect to the bacula database: </p>
+  <pre>
+    local bacula bacuview md5
+    host  bacula bacuview 127.0.0.1/32 md5 </pre>
+  <div class='head'> <hr/>
+  <h2>CONFIGURE BACUVIEW</h2>
+  </div>
+  <p> Local configurations are performed through two configuration
+  files, config/database.yml and bacuview/custom.yml.  Begin by copying
+  over the supplied template files: </p>
+  <pre>
+    # cd /usr/lib/ruby/gems/1.8/gems/bacuview/config
+    # cp database.yml.template database.yml
+    # cp bacuview.yml.template bacuview.yml </pre>
+  <p> The database.yml file is initially set up for a Postgres
+  database running on the local machine, accessing a database instance
+  named bacula and accessed by the bacuview user with a password of
+  bacuview.  For a MySQL database, use 'adapter: mysql', and edit the
+  other parameters appropriately. </p>
+  <p> The bacuview.yml file is currently used only to allow Bacuview
+  to find the Bacula configuration files so that the mapping between
+  client names and host names can be extracted for use by the client
+  status check.  If these are kept in /etc/bacula, no changes should
+  be required. </p>
+  <div class='head'> <hr/>
+  <h2>STARTUP</h2>
+  </div>
+  <p> The simplest way to run the Baculview application is to use
+  WEBrick, the web server supplied with the Rails framework.  In the
+  gem installation, /usr/bin/bacuview is a simple wrapper script that
+  runs the WEBrick server: </p>
+  <pre>
+    $ /usr/sbin/bacuview
+    => Booting WEBrick...
+    => Rails application started on http://0.0.0.0:3000 </pre>
+  <p> If all is well, you should be able to access the initial
+  Bacuview web page by pointing your web browser to the URL shown in
+  the server startup message, http://0.0.0.0:3000 </p>
+  <p> If so, congratulations, and welcome to Bacuview! </p>
+  <p> Once you're satisfied that all is well, you may want to switch
+  to the Bacuview production environment, which is slightly faster and
+  which gives less informative error messages.  You may also want to
+  run the server as a daemon, and to use a more standard web server
+  port.  This can be done by passing options when starting the web
+  server: </p>
+  <pre>
+    $ bacuview -d -e production -p 8080 </pre>
+  <div class='head'> <hr/>
+  <address> <a href="mailto:john@kodis.org">John Kodis</a> </address>
+  </div>
+</body>
+</html>

data/public/javascripts/application.js ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ // Place your application-specific JavaScript functions and classes here
2	+ // This file is automatically included by javascript_include_tag :defaults

data/public/javascripts/client_check.js ADDED Viewed

@@ -0,0 +1,24 @@
+function check(n) {
+  document.getElementById("client-" + n).innerHTML =
+    '<img src="/images/busy.png" class="em1"/>';
+  var req = new XMLHttpRequest();
+  req.open("GET", "/client/check?id=" + n);
+  req.onreadystatechange = function() {
+    if (req.readyState == 4) {
+      document.getElementById("client-" + n).innerHTML = req.responseText;
+    }
+  }
+  req.send(null);
+  return false;
+}
+function check_through(n) {
+  for (i=1; i<=n; i++) {
+    check(i);
+  }
+  return false;
+}
+function js_hide() {
+  document.getElementById("js").innerHTML = "";
+}