_S_M_O_K_E_P_I_N_G___I_N_S_T_A_L_L(7)               SmokePing              _S_M_O_K_E_P_I_N_G___I_N_S_T_A_L_L(7)

NNAAMMEE
       smokeping_install - How to install SmokePing

OOVVEERRVVIIEEWW
       This document explains how to setup SmokePing at your site.

DDEESSCCRRIIPPTTIIOONN
   PPrreerreeqquuiissiitteess
       SmokePing does not stand alone. It relies on various other tools and
       services being present. Apart from a Unix OS and a working Perl
       installation you need the following components:

       RRDtool 1.2.x or later
           Smokeping  uses  RRDtool  for  logging  and graphing. If your linux
           distro provides an rrdtool  package with perl support, use this. If
           you want to get the latest and greatest version, compile your  own:
           <http://oss.oetiker.ch/rrdtool/>

           Ubuntu:

            sudo apt install rrdtool librrds-perl libssl-dev

           RedHat:

            sudo yum install rrdtool perl-rrdtool openssl-devel

       FPing (optional)
           Go to <http://www.fping.org/> to grab a copy.

           Note  that fping must be installed setuid root. It seems that older
           versions of fping report  round  trip  times  in  0.1  milliseconds
           instead  of  1  milliseconds  as  advertised ... SmokePing tries to
           figure this out. It tells you when it starts ... let me know if  it
           gets it wrong.

       EchoPing  (Optional)
           <https://github.com/bortzmeyer/echoping/>

           You need this to run the EchoPing probes

       Curl (Optional)
           <http://curl.haxx.se/>

           You need this for the Curl probe.

       dig (Optional)
           <http://www.isc.org/sw/bind/>

           You need this for the DNS probe.

       SSH (Optional)
           <http://www.openssh.org/>

           You need this for the SSH probe.

       Webserver
           <http://httpd.apache.org/>

           Well  I won't get much into this. The important thing is, to have a
           webserver which allows  you  to  run  CGI  and  preferably  FastCGI
           scripts.  If  you  are  using Apache I strongly recommend using the
           _s_u_e_x_e_c system for running CGI scripts as a particular user.

           See   <http://httpd.apache.org/mod_fcgid/mod/mod_fcgid.html>    and
           <http://httpd.apache.org/docs/2.2/mod/mod_suexec.html>   for   more
           information on this.

       Perl 5.10.1 or later.
           If you still have an older version, maybe have a look at perlbrew.

           Ubuntu:

            sudo apt install perl

           RedHat:

            sudo yum install perl-core

   IInnssttaallllaattiioonn
       Once the tools listed above are in place,  you  can  start  setting  up
       SmokePing itself. Unpack the tar archive and run the included configure
       script:

        ./configure --prefix=/opt/smokeping

       Configure will verify that all the required perl modules are available.
       If  some  are  missing it will tell you to run the module build script.
       Just follow the instructions on screen and then  run  configure  again.
       Once it completes, you can run

        make install

       to finish your setup.

   CCoonnffiigguurraattiioonn
       Use the _e_t_c_/_c_o_n_f_i_g_._d_i_s_t file as a template to create your own smokeping
       configuration file.  See smokeping_config for details.

       Installing the webinterface
           Copy  the content of the _P_R_E_F_I_X_/_h_t_d_o_c_s directory to the place where
           your webserver expects its data. Maybe to _/_v_a_r_/_w_w_w_/_s_m_o_k_e_p_i_n_g.

           Edit the _s_m_o_k_e_p_i_n_g_._f_c_g_i  script  to  point  to  your  smokeping_cgi
           script.

           If  you  have no FastCGI support in your webserver, you may want to
           use the _s_m_o_k_e_p_i_n_g_._c_g_i script.

       _e_t_c_/_b_a_s_e_p_a_g_e_._h_t_m_l
           Edit the html template to your liking. Please  do  not  remove  the
           link  to  the SmokePing counter and my name from the template.  The
           content of the template will be rendered  by  smokeping.cgi.   This
           means  that  all  embedded links must be relative to smokeping.cgi.
           If you are using HTTP authentication, then  the  template  variable
           "authuser" will be populated from the $ENV{REMOTE_USER} environment
           variable.

       _e_t_c_/_s_m_o_k_e_m_a_i_l
           If  you  are  going  to  use  the DDYYNNAAMMIICC IP support, customize the
           contents of this file.

   SSttaarrttiinngg tthhee SSmmookkeeppiinngg DDaaeemmoonn
       With all the scaffolding in place, you can  now  launch  the  smokeping
       daemon and have it gather data for you. First you may want to run it in
       debug mode to see what it is doing

        ./bin/smokeping --config=/opt/smokeping/etc/config --debug

       once all is well, start it up as a daemon. I would recommend you enable
       the logfile option so that you can see if it runs into trouble.

        ./bin/smokeping --config=/opt/smokeping/etc/config --logfile=smoke.log

       Once  the  system works, you may want to put a SmokePing startup script
       into  your  _/_e_t_c_/_i_n_i_t_._d  tree.  Check   out   smokeping   for   further
       information.

       You can now open the smokeping.cgi webpage to look at your data.

       See  the  smokeping_cgi documentation on how to setup the smokeping web
       interface.

CCOOPPYYRRIIGGHHTT
       Copyright (c) 2001, 2011 by Tobias Oetiker. All right reserved.

LLIICCEENNSSEE
       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.

AAUUTTHHOORR
       Tobias Oetiker <tobi@oetiker.ch>

2.9.0                             2025-02-19              _S_M_O_K_E_P_I_N_G___I_N_S_T_A_L_L(7)
