Cooperative Association for Internet Data Analysis GTrace: A tool for the geographical visualization of Internet paths.


About
Features
Snapshots
Usage Notes
Installing
Mailing Lists
FAQ




1. Download the latest version of GTrace

Current Release 1.0.0 (Beta)
Release Date 11/5/99
Changes CHANGELOG
Download GTrace-v1.0.0Beta.tar.gz
Download BerkeleyDB BerkeleyDB
NOTES: Points will be off by a slight margin in the middle sections of the US maps, as the map parameters for the translation are not perfect/known.

2. Program Requirements

    1. Solaris/Linux/FreeBSD
    2. JDK 1.1.7 or higher.
    3. JFC Swing 1.1.1
    4. BerkeleyDB's tarball
    5. traceroute
    6. whois
    7. ping
    8. nslookup
3. Installing GTrace
To install GTrace, do the following:


1. Unpack the distribution and place a copy of the latest BerkeleyDB tarball
   (currently db-2.7.7.tar.gz) in the GTrace-v1.0.0Beta directory.

   You can get a copy of db-2.7.7.tar.gz from

        http://www.sleepycat.com/download.html

2. Type ./configure

      By default GTrace will be installed in /usr/local/GTrace, to change
   this add the following to the ./configure line

         --prefix=

         eg. --prefix=/home/ram

   where  is where you want the GTrace directory to be installed.

   The installation procedure defaults JAVA_HOME to

        /usr/local/jdk1.1.8
     
   If this is not where your java tree is then add the following to the
   ./configure line:
        
        --with-java=

        eg. --with-java=/home/ram/jdk1.1.8

   The installation procedure defaults SWING_HOME to

        /usr/local/share/java/classes/jfc-1.1.1
     
   and looks for swing.jar in there. If this not where your swing.jar is
   located then add the following to the ./configure line:
        
        --with-swing=

        eg. --with-swing=/home/ram/swing-1.1.1fcs

   GTrace requires that you have JFC Swing installed, if you do not have this
   installed on your system get a copy from

        http://java.sun.com/products/jfc/index.html#download-swing
        
 
   The installation procedure defaults BDB_VER (current BerkeleyDB tarball
      filename) to

	db-2.7.7

   If you download a later realease then add the following to the ./configure line:

	--with-bdbver=

	eg. --with-bdbver=db-2.7.9

   If ./configure can't find all the required tools, determine where they
   are on your system and add that directory to your PATH environment variable.

3. Type make    (as root, if necessary)


4. Lastely `make install` will create and populate <DESTDIR>/GTrace with the
   following:

<DESTDIR>/GTrace/BerkeleyDB/ -- BerkeleyDB Java class files
<DESTDIR>/GTrace/CHANGELOG   -- log of changes made to GTrace
                                since release date
<DESTDIR>/GTrace/COPYRIGHT   -- Copyright notice
<DESTDIR>/GTrace/GTrace*     -- Shell script to start GTrace
<DESTDIR>/GTrace/GTrace.properties -- GTrace configuration file
<DESTDIR>/GTrace/INSTALL     -- Instructions on how to install GTrace
<DESTDIR>/GTrace/Makefile    -- Makefile
<DESTDIR>/GTrace/OROMatcher-1.1/ -- Java Regex Package
<DESTDIR>/GTrace/README      -- Readme
<DESTDIR>/GTrace/caida/      -- GTrace class files
<DESTDIR>/GTrace/config/     -- autoconf configuration files
<DESTDIR>/GTrace/db/         -- GTrace databases
<DESTDIR>/GTrace/deps        -- GTrace source file dependencies
<DESTDIR>/GTrace/doc/        -- Documentation
<DESTDIR>/GTrace/dpfs/       -- Domain Parsing Files
<DESTDIR>/GTrace/images/     -- Images/Icons
<DESTDIR>/GTrace/libdb/      -- BerekeleyDB shared library
                                This directory is populated by make itself.
<DESTDIR>/GTrace/log/        -- logs
<DESTDIR>/GTrace/maps/       -- maps
<DESTDIR>/GTrace/src/        -- source files


for more information:   info @ caida.org last update:  
this page: