3
<TITLE>smokeping.cgi</TITLE>
4
<LINK REV="made" HREF="mailto:karrer@iis.ee.ethz.ch">
9
<A NAME="__index__"></A>
15
<LI><A HREF="#name">NAME</A></LI>
16
<LI><A HREF="#overview">OVERVIEW</A></LI>
17
<LI><A HREF="#description">DESCRIPTION</A></LI>
18
<LI><A HREF="#setup">SETUP</A></LI>
19
<LI><A HREF="#copyright">COPYRIGHT</A></LI>
20
<LI><A HREF="#license">LICENSE</A></LI>
21
<LI><A HREF="#author">AUTHOR</A></LI>
27
<H1><A NAME="name">NAME</A></H1>
28
<P>smokeping.cgi - SmokePing webfrontend</P>
31
<H1><A NAME="overview">OVERVIEW</A></H1>
32
<P>This script acts as a 'website' for your SmokePing monitoring operation. It
33
presents the targets you are looking at in a tree structure and draws graphs
34
as they are required by people looking at the pages.</P>
37
<H1><A NAME="description">DESCRIPTION</A></H1>
38
<P>To get <STRONG>smokeping.cgi</STRONG> going, you need a webserver which allows you to run
39
cgi scripts. The system must be setup so that the <STRONG>smokeping.cgi</STRONG> is
40
allowed to write to the image caching area as defined in the config file.</P>
41
<P>This script runs with normal perl. <STRONG>BUT</STRONG> it will appear to be very slow,
42
because it does a lot of things when starting up. So if the script has to be
43
started a fresh on every click, this is both slow and a tough thing for your
44
webserver. I therefore strongly recomment using SpeedyCGI.</P>
45
<P>Please refer to the installation document for detailed setup instructions.</P>
48
<H1><A NAME="setup">SETUP</A></H1>
49
<P>When installing SmokePing, this file has to be adjusted to fit your
50
local system. Three paths have to be entered.</P>
52
use lib qw(/usr/pack/rrdtool-1.0.33-to/lib/perl);</PRE>
53
<P>One pointing to your <STRONG>rrdtool</STRONG> installation</P>
55
use lib qw(/home/oetiker/public_html/smokeping/lib);</PRE>
56
<P>One pointing to the place where you have installed the SmokePing libraries</P>
60
Smokeping::cgi("/home/oetiker/.smokeping/config");</PRE>
61
<P>The third path is the argument to the Smokeping::main command. It points to
62
the SmokePing configuration file.</P>
65
<H1><A NAME="copyright">COPYRIGHT</A></H1>
66
<P>Copyright (c) 2001 by Tobias Oetiker. All right reserved.</P>
69
<H1><A NAME="license">LICENSE</A></H1>
70
<P>This program is free software; you can redistribute it
71
and/or modify it under the terms of the GNU General Public
72
License as published by the Free Software Foundation; either
73
version 2 of the License, or (at your option) any later
75
<P>This program is distributed in the hope that it will be
76
useful, but WITHOUT ANY WARRANTY; without even the implied
77
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
78
PURPOSE. See the GNU General Public License for more
80
<P>You should have received a copy of the GNU General Public
81
License along with this program; if not, write to the Free
82
Software Foundation, Inc., 675 Mass Ave, Cambridge, MA
86
<H1><A NAME="author">AUTHOR</A></H1>
87
<P>Tobias Oetiker <tobi\@oetiker.ch></P>