smoketrace

# 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 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>