NAME

SmokeTrace - Ajax based Traceroute for Smokeping


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 just have to copy a few files:

  1. Copy htdocs/script/Tr.js to your smokeping web directory.

  2. Copy and edit htdocs/tr.html to your smokeping web directory. Make sure the path to Tr.js is correct.

  3. Copy htdocs/resource into the directory where you put tr.html.

  4. Copy and edit htdocs/tr.cgi.dist to the directory where you put tr.html and change its name to tr.cgi. Make sure tr.cgi to adjust the use lib line to point to the smokeping per lib directory, as you did with smokeping.cgi. Make sure the webserver actually executes the tr.cgi script.

  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.


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>