Readme

Leo Lewis

~~~~~~~ Open Visual Trace Route ~~~~~~~

Version 1.6.1

Thank you for downloading Open Visual Traceroute.

I could successfully make this version run on Windows 8 64bits, Ubuntu 12.04 64 bits, MacOS X 10.10
But my tests do not cover everything, so if you find some bug feel free to post a bug report and/or fix
- on Sourceforge
- or by email at leo.lewis.software@gmail.com
Please specify your OS, a stack trace, and the steps to reproduce the issue on the bug report.
I cannot guaranty to fix issues, (this software is free and open source) but I can promise to take a look at them when I have a moment.

Enjoy and share,
Leo Lewis

Installation and execution procedure:

Pre required

Download and install java >= 1.6

Windows

Download and run the windows installer OpenVisualTraceroute.exe

MacOSX

Download and mount the mac package OpenVisualTraceroute.dmg then double click on the OpenVisualTraceroute icon
If you see a "The application is damaged and can't be opened" kind of message, you need to change your security settings as the application is not signed yet (will work on that for a future release)
See this web site for how to change your security settings

Linux Ubuntu, Debian

Download and install the deb package ovtr_1.6.1-1_i386.deb or ovtr_1.6.1-1-amd64.deb

sudo apt-get update
sudo apt-get install traceroute gksu
(if you don't have any java >sudo apt-get install openjdk-7-jre-headless)
(might need a >sudo apt-get install -f)
sudo dpkg -i ovtr_1.6.*.deb
The application will be available in your Unity launcher, type "Open" and the application will should show up.
If you have issues installing this package, please follow the Linux other distributions instructions

Linux other distributions

Download the universal package OpenVisualTraceRoute.zip, unzip it, set execute privileges to the ovtr.sh, and run

unzip OpenVisualTraceRoute.zip
cd OpenVisualTraceRoute
chmod +x ovtr.sh
./ovtr.sh

OS/Arch notice:

Tested on the following systems :
- Windows 8 64bits
- Ubuntu 12.04 64 bits
- MacOS X 10.10

Manually updating the IP geolocation database:

The geo ip data file is named GeoLiteCity.dat and is located in your temp folder (C:\Users\%USER%\AppData\Local\Temp on Windows). I usually update the file every version, but you can update it manually by downloading the latest version from maxmind website and replace your local file.

Limitations, Known issues:

  • Systems that don't have a graphic card/drivers that supports required OpenGL features will not be able to use the 3D map
  • System not correctly setup in term of network/privileges/OS will not be able to use the embedded trace route implementation and will default to the OS traceroute implementation
  • Sniffer feature is not available on MacOS systems

A word in regard of some anti-virus software:

Some users reported that their Symantec anti-virus classified this software as a Trojan.Gen.SMH class malware on Windows.
This software is open source, so if you have some concerns (and you a little bit of knowledge in Java), you can actually look at the code and see by yourself that it's not doing anything funky. Besides, it has been certified by independent websites such as Softpedia.
I also ran the exe file by 39 anti-virus software and as you can see, only Symantec marked it as malware. Here is the full report:

VirSCAN.org Scanned Report :
Scanned time : 2015-03-12 21:18:38
File Name : ovtr.exe
File Size : 136704 byte
File Type : application/x-dosexec
MD5 : 0a9c095d11811e3b01c1bd9980add8c2
SHA1 : 4250dd1282097e8d6bf0a4604255499083cc10b8
Online report : http://r.virscan.org/report/07dbc4a5583e270abb1e659f8dc25418

Scanner Engine Ver Sig Ver Sig Date Time Scan result
ahnlab 9.9.9 9.9.9 2013-05-28 5 Found nothing
antivir 1.9.2.0 1.9.159.0 7.11.216.54 14 Found nothing
antiy AVL SDK 3.0 2014112615531100 2014-11-26 1 Found nothing
arcavir 1.0 2011 2014-05-30 8 Found nothing
asquared 9.0.0.4453 9.0.0.4453 2014-07-03 1 Found nothing
avast 150226-0 4.7.4 2015-02-26 31 Found nothing
avg 2109/8526 10.0.1405 2015-01-30 6 Found nothing
baidu 2.0.1.0 4.1.3.52192 2.0.1.0 5 Found nothing
baidusd 1.0 1.0 2014-04-02 3 Found nothing
bitdefender 7.58879 7.90123 2015-01-16 1 Found nothing
clamav 20174 0.97.5 2015-03-11 1 Found nothing
comodo 15023 5.1 2015-03-11 3 Found nothing
ctch 4.6.5 5.3.14 2013-12-01 1 Found nothing
drweb 5.0.2.3300 5.0.1.1 2015-01-23 29 Found nothing
fortinet 25.015, 25.015 5.1.158 2015-03-12 1 Found nothing
fprot 4.6.2.117 6.5.1.5418 2015-02-01 1 Found nothing
fsecure 2014-04-02-01 9.13 2014-04-02 6 Found nothing
gdata 25.635 25.635 2015-03-12 9 Found nothing
hauri 2.73 2.73 2015-01-30 1 Found nothing
ikarus 1.06.01 V1.32.31.0 2015-01-30 14 Found nothing
jiangmin 16.0.100 1.0.0.0 2015-03-03 30 Found nothing
kaspersky 5.5.33 5.5.33 2014-04-01 20 Found nothing
kingsoft 2.1 2.1 2013-09-22 7 Found nothing
mcafee 7638 5400.1158 2014-11-30 7 Found nothing
nod32 0801 3.0.21 2014-11-29 1 Found nothing
panda 9.05.01 9.05.01 2015-03-11 3 Found nothing
pcc 11.532.02 9.500-1005 2015-03-11 2 Found nothing
qh360 1.0.1 1.0.1 1.0.1 13 Found nothing
qqphone 1.0.0.0 1.0.0.0 2015-03-12 1 Found nothing
quickheal 14.00 14.00 2015-03-11 2 Found nothing
rising 25.56.03.04 25.56.03.04 2015-03-05 4 Found nothing
sophos 5.08 3.55.0 2014-12-01 7 Found nothing
sunbelt 3.9.2623.2 3.9.2623.2 2015-03-09 2 Found nothing
symantec 20150309.001 1.3.0.24 2015-03-09 1 Trojan.Gen.SMH
tachyon 9.9.9 9.9.9 2013-12-27 3 Found nothing
thehacker 6.8.0.5 6.8.0.5 2015-03-10 1 Found nothing
tws 17.47.17308 1.0.2.2108 2015-03-11 6 Found nothing
vba 3.12.26.3 3.12.26.3 2015-03-11 4 Found nothing
virusbuster 15.0.985.0 5.5.2.13 2014-12-05 15 Found nothing