Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • In case you specify -region, --country or --group the name of the file generated will be annotated traceroutes$FROM-to-$REGIONNAME.txt. Here the $REGIONNAME is the name of the region, country or group in pinger that you specified and $FROM will have a value if you specify it using --from field. The same will be the case for graphs and rawtraceroutes.
  • In case you specify -file or --hostfilelist the name of the file generated will be annotatedtraceroutes$FROM-to-$FILENAME.txt. Here the $FILENAME is the name of the file specified in the --file or --hostfilelist and $FROM once again has a value if you specify the --from field. 
  • The annotated traceroute currently works if all the nodes are in the linked list of objects. If you specify --detail as 'country' then the objects are collapsed to only country objects and the relevant information is not there.

Output

...

Creating the

...

gif file

...

from the dot file

To create the gif file from the dot file use

Code Block

36cottrell@pinger:~/bin/projects/topology/trunk/unit_tests>dot -Tgif -o ~cottrell/public_html/rviz.gif tempdot-SaoPaolo-to-Latin_merica.txt
Error: Could not find/open font : Times in /usr/X11R6/lib/X11/fonts/TrueType:/usr/X11R6/lib/X11/fonts/truetype:/usr/X11R6/lib/X11/fonts/TTF:/usr/share/fonts/Tru
eType:/usr/share/fonts/truetype:/usr/openwin/lib/X11/fonts/TrueType:/usr/X11R6/lib/X11/fonts/Type1:/usr/common/share/fonts/ttf

 This will read input file tempdot-SaoPaolo-to-Latin_merica.txt and create output gif file ~cottrell/public_html/rviz.gif. Ignore the error message.  In the above case you will be able to view the output at http://www.slac.stanford.edu/~cottrell/rviz.gif

  Output

By default the topology gif file is placed in the current working directory with the name graph-<from>to<region|group|country>.gif.  Where <from> is the value in the --from option, <region|group|country> is the value in the --region | --group or -country option. For example if called with:

Code Block

region_topology.pl --region Africa --detail country --endnodes on --tracerouteserver 'http://www.unikin.cd/cgi-bin/ traceroute.pl' --from 'DRC'

then the topology gif file has the name:  graph-DRC-to-Africa.gif. If the --basepath option is specified then rather than placing the file in the current working directory it is placed in the directory specified by basepath. For example if called with:

Code Block

region_topology.pl --region Africa --detail country --tracerouteserver 'http://www.unikin.cd/cgi-bin/ traceroute.pl' --from 'DRC' --basepath '~cottrell/public_html'

then the file will appear at ~cottrell/public_html/graph-DRC-to-Africa.gif.  The output of this file is a graph with end nodes in rectangles, routers in ellipses and directed edges between the nodes.

It also creates three other files (for example):

  1. tempdot-DRC-to-Africa.txt, this is the dot file that provides the node relationships. It is of the form:
    Code Block
    
    digraph G {
            nodesep = 0.10;
            ranksep = 0.25;
            fontsize = 9;
            node [style=filled,height=0.15,width=0.3,fontsize=9];
            subgraph cluster_ {
                    label   =       " ()";
                    style   =       "dashed";
                    n0xa567b44      [label=""];
            }
            subgraph cluster_NI {
                    label   =       "Nicaragua (NI)";
                    style   =       "dashed";
                    nNI     [label="Nicaragua"];
            }
            subgraph cluster_EC {
                    label   =       "Ecuador (EC)";
                    style   =       "dashed";
                    nEC     [label="Ecuador"];
                    n200_31_30_47   [label="gye.impsat.net.ec",shape="polygon",sides="4"];
                    n200_125_133_7  [label="* www.gastromonde.edu.ec",shape="polygon",sides="4"];
                    n201_217_87_3   [label="3.201-217-87.uio.satnet.net",shape="polygon",sides="4"];
            }...        nBR     ->      n143_108_25_100;
            nBR     ->      n143_108_31_3;
            nBR     ->      nUS;
            nUS     ->      nUY;...}
    
Code Block

region_topology.pl --region Africa --detail country --endnodes on --tracerouteserver 'http://www.unikin.cd/cgi-bin/ traceroute.pl' --from 'DRC'

then the topology gif file has the name:  graph-DRC-to-Africa.gif. If the --basepath option is specified then rather than placing the file in the current working directory it is placed in the directory specified by basepath. For example if called with:

Code Block

region_topology.pl --region Africa --detail country --tracerouteserver 'http://www.unikin.cd/cgi-bin/ traceroute.pl' --from 'DRC' --basepath '~cottrell/public_html'

then the file will appear at ~cottrell/public_html/graph-DRC-to-Africa.gif.  The output of this file is a graph with end nodes in rectangles, routers in ellipses and directed edges between the nodes.

...

  1. rawtraceroutes-DRC-to-Africa.txt, this is the raw traceroute data measu4red, for example a series of traceroutes of the form:
    Code Block
    %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
    %Traceroute No 1
    %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
    traceroute to 212.88.97.44 (212.88.97.44), 30 hops max, 38 byte packets
     1  gate (172.16.1.1)  0.224 ms  0.187 ms  0.114 ms
     2  213.255.195.225 (213.255.195.225)  9.986 ms  1.067 ms  0.985 ms
     3  FE8-0-0.gw1.dcm.sky-vision.net (217.194.158.12)  563.816 ms  710.425 ms  760.908 ms
     4  gw-uk.sky-vision.net (217.194.158.210)  570.907 ms  569.249 ms  551.291 ms
     5  skyvision-01692-ldn-b2.c.telia.net (213.248.75.202)  653.103 ms  661.445 ms  644.227 ms
     6  * ldn-b2-geth10-0-336.telia.net (213.248.75.201)  647.579 ms *
     7  ldn-b2-link.telia.net (80.91.250.213)  645.400 ms  630.215 ms  640.610 ms
     8  ldn-bb2-link.telia.net (80.91.250.229)  650.851 ms  657.959 ms  660.839 ms
     9  ldn-b4-link.telia.net (80.91.254.22)  672.093 ms  639.208 ms  640.740 ms
    10  teleglobe-114869-ldn-b4.telia.net (213.248.74.2)  640.735 ms  670.570 ms  637.608 ms
    11  195.219.195.13 (195.219.195.13)  645.608 ms  680.312 ms  690.821 ms
         MPLS Label=2789 CoS=5 TTL=1 S=0
    12  195.219.195.10 (195.219.195.10)  650.858 ms  672.188 ms
    __END__
    
  2. annotatedtraceroutes-DRC-to-Africa.txt, which contain annotation information from the individual traceroutes, for example:
    Code Block
    %%%%%%%%%%%%%%%%%%%%%%%%%%%%%
    %Traceroute No. 1
    %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
    COUNTRY's: (total 4)
    --------------------------------
    Country:
    Name:
    --------------------
    1. gate (172.16.1.1)
    --------------------------------
    Country:        CG
    Name:   Congo
    --------------------
    2. 213.255.195.225 (213.255.195.225)
    --------------------------------
    Country:        GB
    Name:   United Kingdom
    --------------------
    3. FE8-0-0.gw1.dcm.sky-vision.net (217.194.158.12)
    4. gw-uk.sky-vision.net (217.194.158.210)
    5. 195.219.195.13 (195.219.195.13)
    6. 195.219.195.10 (195.219.195.10)
    --------------------------------
    Country:        EU
    Name:   Europe
    --------------------
    7. skyvision-01692-ldn-b2.c.telia.net (213.248.75.202)
    8. * ldn-b2-geth10-0-336.telia.net (213.248.75.201)
    9. ldn-b2-link.telia.net (80.91.250.213)
    10. ldn-bb2-link.telia.net (80.91.250.229)
    11. ldn-b4-link.telia.net (80.91.254.22)
    12. teleglobe-114869-ldn-b4.telia.net (213.248.74.2)
    --------------------------------
    ACTUAL TARGET NODE = 212.88.97.44 , TARGET COUNTRY = UG
    --------------------------------
    COUNTRYLINKS: (total 4)
    NAME:    -> NAME:       CG
    NAME:   CG -> NAME:     GB
    NAME:   GB -> NAME:     EU
    NAME:   EU -> NAME:     GB
    

...