Swiss Original. Mirrors: DE, US, IE, TW

SmokeTrace

DESCRIPTION

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.

SETUP

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 .htaccess 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/
  3. 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/
  4. Copy htdocs/resource into the directory where you put tr.html
     cp -r $src/htdocs/resource $web/ 
  5. Copy htdocs/tr.cgi.dist 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 
  6. 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.

COPYRIGHT

Copyright (c) 2008 by Tobias Oetiker. All rights reserverd.

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.

AUTHOR

Tobi Oetiker <tobi@oetiker.ch>


NOTE: The content of this website is accessible with any browser. The graphical design though relies completely on CSS2 styles. If you see this text, this means that your browser does not support CSS2. Consider upgrading to a standard conformant browser like Mozilla Firefox or Opera but also Apple's Safari or KDE's Konqueror for example. It may also be that you are looking at a mirror page which did not copy the CSS for this page.