Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

..
Octocat-spinner-32 docs
Octocat-spinner-32 railroad
Octocat-spinner-32 sample
Octocat-spinner-32 static
Octocat-spinner-32 templates
Octocat-spinner-32 LICENSE
Octocat-spinner-32 README
README
    _______________________________________________________________________
        
        Railroad :: Graphing front-end for Nagcat/Nagios and RRDtool
    _______________________________________________________________________


Introduction

    Railroad is a web frontend for Nagcat which allows you to view graphs of
    live and historical trend data. This is done via the Nagcat coil
    configurations and the RRDs generated by Nagcat.

Dependencies

    Requirement         Version         Notes

    * python            >= 2.5          untested on earlier versions/3.x
    * apache            >= 2.0          requires wsgi support
    * django            >= 1.1
    * mod_wsgi
    * python-json
    * Nagcat
    * rrdtool                           Python bindings needed

Installation
    
    To install Railroad on Apache, follow the steps below:

    0. Make sure all of the dependencies are installed. They *will* silently
       break things. If you realize you didn't install something after
       following these instructions, make sure you install it and restart
       Apache.

    1. Copy the source files to the directory of your choice (normally done as
       part of the Nagcat installation).

    2. Edit the configuration files. Samples are present in the samples
       directory:

       * Edit the Apache mod_wsgi configuration files 
         <install path>/sample/django.wsgi and
         <install path>/sample/railroad.conf, set the correct paths.

       * Edit the Django configuration file <install path>/sample/settings.py
         to reflect the correct paths for templates, data (status.dat and
         objects.cache), and rra. You may optionally change the timezone,
         language, and other Django settings as you prefer.

    3. Copy your settings.py to <install path>/railroad/settings.py

    4. Navigate to your Apache configuration directory. In Fedora, this is
       /etc/httpd/conf.d

    5. There are two roads you could take here:
       
       * If you are doing development on the project, we suggest soft linking
         the railroad.conf file:

         ln -s <install path>/sample/railroad.conf railroad.conf

       * If this is a long term install, we suggest cp'ing it:

         cp <install path>/sample/railroad.conf railroad.conf

    6. Make sure you either have the following line in your apache config, or
       in a file in your conf.d (ie, wsgi.conf):

           LoadModule wsgi_module modules/mod_wsgi.so

       This is often added by your distribution's package manager, but it's a
       good idea to double check.

       Also make sure the Apache configuration you loaded has the correct path
       to django.wsgi.

    7. ***Restart apache.***

    8. Open your favorite web browser and navigate to (assuming localhost):
       
       http://localhost/railroad/

    9. Congratulations! You've installed Railroad. If it seems broken, make
       sure you installed all dependencies. If you still have problems,
       contact the developers/maintainers included at the bottom of this
       document.

Developers/Maintainers

    Mike Cooper (mythmon@google.com)
    Jordan Evans (jordane@google.com)
    Eric Harmon (eharmon@itasoftware.com)
    Ryan Clough (rclough@itasoftware.com)
    Michael Marineau (marineam@google.com)
    Jonathan Yu (jyu@itasoftware.com)

Something went wrong with that request. Please try again.