Overview Plugin

Introduction

This plugin adds an alternative user interface to RRFW. The main feature is that it allows for creation of overview pages showing counters from different parts of a tree. For example a page containing all CPU usage counters of all network devices.

Other features are:

date and time picker

    <param name="rrd-create-rra">
        RRA:AVERAGE:0:1:209664
        RRA:AVERAGE:0.1:12:17472 RRA:MAX:0.1:12:17472 RRA:MIN:0.1:12:17472
        RRA:AVERAGE:0.1:288:1456 RRA:MAX:0.1:288:1456 RRA:MIN:0.1:288:1456
        RRA:AVERAGE:0.1:2016:416 RRA:MAX:0.1:2016:416 RRA:MIN:0.1:2016:416
    </param>

'window' picker.

show hidden checkbox.

auto-scale checkbox.

This plugin has been tested with Internet Explorer 6.0, Netscape 7.1, and Mozilla 1.4. Other browsers were not tested and will most likely not work.

Required Software (apart from RRFW)

Perl Modules

http://www.apache-asp.org/

XML::Sablotron http://www.cpan.org/

XML::LibXSLT http://www.cpan.org/

WebFx modules

http://webfx.eae.net/download/tabpane102.zip

Xtree (modified version is included in this plugin)

jscalendar

http://sourceforge.net/projects/jscalendar/

Installation

Unpack RRFW main distribution and the plugin in some directories. From RRFW distribution directory, run

  ./configure --with-plugins=../rrfw-plugin-overview-0.0.1
  make install

After RRFW installation has finished:

Install the perl module Apache::ASP acording to the instructions on http://www.apache-asp.org/

Add the following lines to your apache config file (http.conf). (Note: WEBPLAINDIR is /usr/local/rrfw-xyz/web/plain by default):

  ScriptAlias /menu/ "WEBPLAINDIR/menu/"
  ScriptAlias /overviews/ "WEBPLAINDIR/overviews/"

  <Location /menu>
  SetHandler  perl-script
  PerlModule  Apache::ASP
  PerlHandler Apache::ASP
  PerlSetVar  Global /www/asp
  PerlSetVar  StateDir /tmp/asp
  PerlSetVar NoState 1
  PerlSetVar XSLTParser XML::Sablotron
  PerlSetVar XSLTParser XML::LibXSLT
  PerlSetVar XSLTMatch xml$
  PerlSetVar XSLT menu.xsl
  PerlSetVar RequestParams 1
  </Location>

  <Location /overviews>
  SetHandler  perl-script
  PerlModule  Apache::ASP
  PerlHandler Apache::ASP
  PerlSetVar  Global /www/asp
  PerlSetVar  StateDir /tmp/asp
  PerlSetVar NoState 1
  PerlSetVar XSLTParser XML::Sablotron
  PerlSetVar XSLTParser XML::LibXSLT
  PerlSetVar XSLTMatch xml$
  PerlSetVar XSLT overview.xsl
  PerlSetVar RequestParams 1
  </Location>

Create the directories /www/asp and /tmp/asp.

Copy the contents of http://webfx.eae.net/download/tabpane102.zip to 'WEBPLAINDIR'/tabpane

Copy the contents of the jscalendar package to 'WEBPLAINDIR'/calendar

Usage

Now you're ready to go. A usage example has been included. In order to use the example you need to follow these additional steps:

install rrfw-plugin-overview
Edit your rrfw-siteconfig.pl:

    'ovExamples' => {
        'description' => 'Example data for overview',
        'xmlfiles' => [
            'defaults.xml',
            'ovDefaults.xml',
            'examples/ovExample.xml',
        ],
        'run' => { 'collector' => 1, 'monitor' => 1 } },

Also add the following lines:

    %RRFW::Renderer::styling =
        ( 'default' => {'stylesheet' => 'rrfw.css',
                        'ovStylesheet' => 'ov.css',
                       },
          'printer' => {'stylesheet' => 'rrfw-printer.css',
                        'ovStylesheet' => 'ov-printer.css',
                       },
         );

    $RRFW::Renderer::Chooser::template = 'ov/ov-chooser.html';

run the collector

Enjoy!

http://your-server/menu/sampleMenu.xml

Overview Plugin

Introduction

Required Software (apart from RRFW)

Installation

Usage

Author