Quick Installation Guide

Below is the result of our efforts to be able to walk you through, step by step, the process of installing PDUMon on a central server and have it monitor your systems. Walk through it sequentially or hit the quick links to skip to the juicy bits. We've tried very hard to not leave anything out, but, hey, we're only humanoid. If you're having problems, visit our documentation pages to see if your problem has already been addressed. If not, please, .



System Requirements

  • Disk Space
  • In general, you will need around 1.7MB for each PDU RRD database, and ~15MB for each UPS RRD database. For example, we have around 57 PDUs, and 1 UPS, and the data directory takes up 105 megabytes.

  • CPU
  • Depending on what else is running, an Intel p5 3.0Ghz will work.

  • OS
  • Linux, of course.

  • Perl 5.8.8 (or greater)
  • Also, the following modules, all of which are available from http://www.perl.com

    Required Perl Modules
    CGI(CGI.pm)
    CGI::Carp(CGI/Carp.pm)
    POSIX(standard distribution)
    File::Basename(standard distribution.pm)
    Template(Template.pm)
    File::Copy(File/Copy.pm)
    Net::SNMP(Net/SNMP.pm)
    RRDs(RRD)
    Log::Log4Perl(Log/Log4Perl.pm)

    Some of the above modules come with Perl while the others are available from the Perl website listed above.

  • HTTP Server
  • For graph display and control interface.

  • RRDTool
  • v1.3.8, Avaliable at: http://oss.oetiker.ch/rrdtool/

Installation

There are two modes of installation:

  1. primary - Everything is installed.
  2. backup - Everything is installed, minus the RRDTool graphs of the PDUs and/or UPS's.

NOTE: The primary server does all the hard work. It performs the data collection for the RRD databases and generates the graphs. Both primary and backup servers have the ability to conrol the PDU outlets, re-name the outlets, and view PDU Hardware information. The backup server does have any of the graphing capability. The purpose of the backup server is to provide you with alternative means of controlling the PDUS in the case that your primary server is hosed. WE STRONGLY RECOMMEND YOU HAVE A BACKUP SERVER.

So, to install:

  1. Make sure all of the above prerequisites are installed.
  2. Edit the Makefile and modify the variables to suit your site. The Makefile variables are as follows:
    1. ORGANIZATION - your organization name.

      PDUMON2_PREFIX - the path to installation, such as '/usr/local/'.

      PDUMON2_HTTP - the HTTP server root for PDUMon2.

      WEB_PATH - The HTTP path relative to the web server hostname, e.g. https://cheyenne/pdumon2/

      RRDTOOL_BIN - the path to the RRDTOOL binaries rrdtool and rrdcgi.

      RRDTOOL_LIB - the path to the RRDTOOL perl modules.

      CROND_ETC - The path where cron.d entries live on your system, such as /etc/cron.d .

      DIR_OWNER, DIR_GROUP - The user and group that will run the data collection scripts, and update the RRDTool data. Please note: Make sure this user exists on your system.

      HTTPD_USER, HTTPD_GROUP - The user and group that own the files on your web server.

  3. Type 'make install'. This will install the primary version.
  4. OR: Type'make installbackup'. This will install the backup version
  5. cd /usr/local/pdumon2/bin, add the ScriptAlias lines from the file httpd.conf-pdumon2 to the appropriate area of your web server configuration file, and make sure that your web server is configured to run CGI scripts.
  6. Restart your Apache web server so the configuration changes take effect.

Configuration/Post-Installation

  1. Configure your Apache web server.
  2. cd /usr/local/pdumon2/bin, add the ScriptAlias lines from the file httpd.conf-pdumon2 to the appropriate area of your web server configuration file, and make sure that your web server is configured to run CGI scripts.

  3. Restart your Apache web server
  4. Make sure that Apache sees the configuration changes.

  5. Edit the pdu.cfg file.
  6. Change directory to ${PDUMON2_PREFIX}/pdumon2/cfg and edit the pdu.cfg file.

    Ex. % cd /usr/local/pdumon2/cfg
       % vi pdu.cfg


    The pdu.cfg file provided documents the fields.

  7. Edit the ups.cfg file.
  8. Change directory to ${PDUMON2_PREFIX}/pdumon2/cfg and edit the ups.cfg file.

    Ex. % cd /usr/local/pdumon2/cfg
       % vi ups.cfg


    The ups.cfg file provided documents the fields.

  9. Run webgen
  10. Ex. % /usr/local/pdumon2/webgen

    This will create the rrdtool databases, and write the rrdcgi graphs if the installation mode is primary.

  11. Restart the cron daemon
  12. PDUMon depends on crontab entries located in Restart the cron daemon

That should be it. Congrats! You now have SARGE installed. For questions and support, see our documentation page where you can get all kinds of useless helpful information, or .