commit

bin/smokeping_cgi

@@ -0,0 +1,94 @@
+#!/usr/bin/perl
+# -*-perl-*-   
+
+use strict;
+use warnings;
+
+use FindBin;
+use lib (split /:/, q{}); # PERL5LIB
+use lib "$FindBin::RealBin/../lib";use lib "$FindBin::RealBin/../thirdparty/lib/perl5"; # LIBDIR
+
+# don't bother with zombies
+$SIG{CHLD} = 'IGNORE';
+
+use CGI::Carp qw(fatalsToBrowser);
+
+use Smokeping;
+
+use CGI::Fast;
+
+my $cfg = (shift @ARGV) || "$FindBin::Bin/../etc/config";
+
+
+while (my $q = new CGI::Fast) {
+   Smokeping::cgi($cfg,$q);
+}
+
+=head1 NAME
+
+smokeping_cgi - SmokePing webfrontend
+
+=head1 OVERVIEW
+
+This script acts as a 'website' for your SmokePing monitoring operation. It
+presents the targets you are looking at in a tree structure and draws graphs
+as they are required by people looking at the pages.
+
+=head1 DESCRIPTION
+
+To get B<smokeping_cgi> going, you need a webserver which allows you to run
+CGI or better FastCGI scripts. The system must be setup so that the cgi
+process is allowed to write to the image caching area as defined in the
+config file.
+
+This script runs fine as a normal CGI, B<BUT> it will appear to be very slow,
+because it does a lot of things when starting up. So if the script has to be
+started a fresh on every click, this is both slow and a tough thing for your
+webserver. I therefore strongly recommend using FastCGI.
+
+Please refer to the installation document for detailed setup instructions.
+
+=head1 SETUP
+
+There is a sample F<htdocs> directory in your smokeping installation root. 
+Copy its content to the place where your webserver expects its files.  The
+fcgi script shows the preferred method for running smokeping.  You can also
+run smokeping as a cgi.  But make sure to still use the wrapper as exposing
+ARGV to the webserver represents a security vulnerability you may rather not
+want to deal with.
+
+Adjust the paths in the script and you should be ready to go.
+
+=head1 SEE ALSO
+
+L<smokeping_config(5)>, L<smokeping(1)>, L<smokeping_install(7)>,
+L<smokeping_upgrade(7)>
+
+=head1 COPYRIGHT
+
+Copyright (c) 2011 by Tobias Oetiker. All right reserved.
+
+=head1 LICENSE
+
+This program is free software; you can redistribute it
+and/or modify it under the terms of the GNU General Public
+License as published by the Free Software Foundation; either
+version 2 of the License, or (at your option) any later
+version.
+
+This program is distributed in the hope that it will be
+useful, but WITHOUT ANY WARRANTY; without even the implied
+warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
+PURPOSE.  See the GNU General Public License for more
+details.
+
+You should have received a copy of the GNU General Public
+License along with this program; if not, write to the Free
+Software Foundation, Inc., 675 Mass Ave, Cambridge, MA
+02139, USA.
+
+=head1 AUTHOR
+
+Tobias Oetiker E<lt>tobi@oetiker.chE<gt>
+
+=cut