RubyGems - bacuview - Versions diffs - 1.5 - Mend

bacuview 1.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

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 = "";
+}