Some useful information about smokeping as packaged by Fedora
-------------------------------------------------------------

To use the package
------------------

 o Define you targets in /etc/smokeping/config

 There are some examples defined all ready, for more options please consult 
 the documentation available here:

   file:///usr/share/doc/smokeping-2.4.2/doc/smokeping_install.html

 o Start the smokeping daemon:

   $ service smokeping start
   $ chkconfig --level 35 smokeping on

 o Start Apache httpd webserver:

   $ service httpd start
   $ chkconfig --level 35 httpd on

 o smokeping in it's full glory is now serving you at the following address:
  
   http://localhost/smokeping/sm.cgi

   Please visit with your browser of choice. You might have to wait some
   time until the daemon has got some data to see something useful

   If you want to access smokeping from a remote host, please edit
   /etc/httpd/conf.d/smokeping.conf 


To enable SmokeTrace support
----------------------------
 o Uncomment the SmokeTrace section in /etc/smokeping/config

 o Make the traceroute binary setuid: 

   $ chmod u+s /bin/traceroute

  (Beware of the security implications this action might have)
 
 o Uncomment the tr.cgi ScriptAlias line in /etc/httpd/conf.d/smokeping.conf .

 o Restart the webserver 

   $ service httpd restart


Caveats
-------

 SELinux
 -------
 
 If your system are using SELinux, smokeping will not work, unless you
 execute the following commands:

  $ chcon -v -R --type=httpd_sys_script_exec_t /usr/share/smokeping/cgi/
  $ chcon -v -R --type=httpd_sys_content_t /var/lib/smokeping/

 
 These rules (and then some?) may be needed too:

 module smokeudpsocket 1.0;

   require {
        type httpd_sys_script_t;
        class udp_socket connect;
   }

   #============= httpd_sys_script_t ==============
   allow httpd_sys_script_t self:udp_socket connect;



 Need for additional perl modules
 --------------------------------

 The TacacsPlus and Radius probes needs the Authen::Tacas and/or
 Authen::Radius CPAN modules, in order to use these probes, please
 install these modules.


Happy pinging!