SMOKETRACE(7) SmokePing SMOKETRACE(7) NNAAMMEE SmokeTrace - Ajax based Traceroute for Smokeping DDEESSCCRRIIPPTTIIOONN SmokeTraceoute is an browser based traceroute application written in the Qooxdoo. You can easily activate it in your Smokeping setup, to allow users to traceroute smokeping targets directly from the master host. SSEETTUUPP To activate SmokeTrace you have to copy a few files to your webserver. 1. Make sure your webserver can execute cgi files outside the cgi-bin directory. Maybe it is enough to create a _._h_t_a_c_c_e_s_s file with the following contents into the smokeping web directory ($web). AddHandler cgi-script cgi Options ExecCGI 2. Copy "htdocs/script/Tr.js" to your smokeping web directory (NOT the cgi-bin directory!). mkdir $web/script cp $src/htdocs/script/Tr.js $web/script/ 2. Copy "htdocs/tr.html" to your smokeping web directory (NOT cgi-bin). Make sure the path, pointing to "Tr.js" is correct. cp $src/htdocs/tr.html $web/ 3. Copy "htdocs/resource" into the directory where you put "tr.html" cp -r $src/htdocs/resource $web/ 4. Copy _h_t_d_o_c_s_/_t_r_._c_g_i_._d_i_s_t to the directory where you put "tr.html". Change its name to "tr.cgi". Edit "tr.cgi" to adjust the "use lib" line, to point to the smokeping perl library directory, as you did with "smokeping.cgi" and the smokeping daemon. cp $src/htdocs/tr.cgi.dist $web/tr.cgi 5. Edit your config file and add the line: menuextra = <a target='_blank' href='tr.html{HOST}' class='{CLASS}' \ onclick="window.open(this.href,this.target, \ 'width=800,height=500,toolbar=no,location=no,status=no,scrollbars=no'); \ return false;">*</a> to your "*** Targets ***" section. It will make a "*" appear next to each host name, and when you click on it, the SmokeTrace window will open. Note that the "href" atribut must point to the directory where you put the "tr.html" file. Not you should be all set. Try calling "tr.cgi" from your webbrowser. You should get some error message about not having sent a JSON request. CCOOPPYYRRIIGGHHTT Copyright (c) 2008 by Tobias Oetiker. All rights reserverd. LLIICCEENNSSEE 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 MER- CHANTABILITY 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. AAUUTTHHOORR Tobi Oetiker <tobi@oetiker.ch> 2.4.2 2008-06-13 SMOKETRACE(7)