...
- Create a new directory at the location where you want to install the software.
| Code Block |
|---|
| Wiki Markup |
{Code} akbar@iepm-resp $ pwd /afs/slac.stanford.edu/u/sg/akbar akbar@iepm-resp $ mkdir myprojects {Code} |
Now cd into the myprojects directory and download the iepm,topology and pinger projects using svn, by issuing the following commands:
...
| Code Block |
|---|
| Wiki Markup |
{Code} akbar@iepm-resp $ cd myprojects/ akbar@iepm-resp $ pwd /afs/slac.stanford.edu/u/sg/akbar/myprojects akbar@iepm-resp $ svn co file:///afs/slac.stanford.edu/g/scs/net/netmon/repo/svn/topology topology A topology/trunk A topology/trunk/unit_tests A topology/trunk/unit_tests/test_iepm-db-topology.pl A topology/trunk/unit_tests/regiontopology.conf A topology/trunk/unit_tests/test_canvas.pl A topology/trunk/unit_tests/test_topology.pl A topology/trunk/unit_tests/test_tools-tracerouteASN.pl A topology/trunk/unit_tests/lookup.txt A topology/trunk/unit_tests/test_canvasWithASs.pl A topology/trunk/unit_tests/region_topology.pl A topology/trunk/unit_tests/region_topology_wrapper.pl A topology/trunk/unit_tests/test_canvas-graphvizWithASN.pl A topology/trunk/unit_tests/test_canvas-graphviz.pl A topology/trunk/www A topology/trunk/www/html A topology/trunk/www/html/traceanal.css A topology/trunk/www/html/traceanal.js A topology/trunk/www/html/wz_tooltip.js A topology/trunk/doc A topology/trunk/install A topology/trunk/lib A topology/trunk/lib/IEPM A topology/trunk/lib/IEPM/Topology A topology/trunk/lib/IEPM/Topology/Node A topology/trunk/lib/IEPM/Topology/Node/Graphviz.pm A topology/trunk/lib/IEPM/Topology/Node/GraphvizCountry.pm A topology/trunk/lib/IEPM/Topology/Canvas.pm A topology/trunk/lib/IEPM/Topology/ASGroup.pm A topology/trunk/lib/IEPM/Topology/Canvas A topology/trunk/lib/IEPM/Topology/Canvas/Graphviz.pm A topology/trunk/lib/IEPM/Topology/Canvas/GraphvizCountry.pm A topology/trunk/lib/IEPM/Topology/CountryGroup.pm A topology/trunk/lib/IEPM/Topology/Link A topology/trunk/lib/IEPM/Topology/Link/Graphviz.pm A topology/trunk/lib/IEPM/Topology/Link/GraphvizCountry.pm A topology/trunk/lib/IEPM/Topology/Link/ASN.pm A topology/trunk/lib/IEPM/Topology/Link/Country.pm A topology/trunk/lib/IEPM/Topology/Traceroute A topology/trunk/lib/IEPM/Topology/Traceroute/ASN A topology/trunk/lib/IEPM/Topology/Traceroute/ASN/Graphviz.pm A topology/trunk/lib/IEPM/Topology/Traceroute/Country A topology/trunk/lib/IEPM/Topology/Traceroute/Country/GraphvizCountry.pm A topology/trunk/lib/IEPM/Topology/Traceroute/Graphviz.pm A topology/trunk/bin A topology/trunk/bin/traceroute_topology.pl A topology/trunk/bin/traceroute_analysis.pl Checked out revision 552. akbar@iepm-resp $ svn co file:///afs/slac.stanford.edu/g/scs/net/netmon/repo/svn/iepm iepm A iepm/trunk A iepm/trunk/unit_tests A iepm/trunk/unit_tests/test_table.pl A iepm/trunk/unit_tests/test_tools-traceroute.pl A iepm/trunk/unit_tests/test_cgi-typechecking.pl A iepm/trunk/unit_tests/test_ping.pl A iepm/trunk/unit_tests/test_time.pl A iepm/trunk/unit_tests/test_distribution.pl A iepm/trunk/unit_tests/test_topology-node.pl A iepm/trunk/unit_tests/test_tcpmon.pl A iepm/trunk/unit_tests/test_topology-nodeAndLink.pl A iepm/trunk/unit_tests/test_jitter.pl A iepm/trunk/unit_tests/test_jitter_tcpmon.pl A iepm/trunk/unit_tests/test_traceroute-comaprison-metadata.pl A iepm/trunk/unit_tests/test_traceanal-htmltable.pl A iepm/trunk/doc A iepm/trunk/doc/README.asn A iepm/trunk/install A iepm/trunk/install/Makefile.asn A iepm/trunk/lib A iepm/trunk/lib/IEPM A iepm/trunk/lib/IEPM/Tools A iepm/trunk/lib/IEPM/Tools/ASN A iepm/trunk/lib/IEPM/Tools/ASN/WhoIs.pm A iepm/trunk/lib/IEPM/Tools/Jitter A iepm/trunk/lib/IEPM/Tools/Jitter/ITU.pm A iepm/trunk/lib/IEPM/Tools/Jitter/IPDV.pm A iepm/trunk/lib/IEPM/Tools/Table.pm A iepm/trunk/lib/IEPM/Tools/Ping.pm A iepm/trunk/lib/IEPM/Tools/Traceroute.pm A iepm/trunk/lib/IEPM/Tools/Latency.pm A iepm/trunk/lib/IEPM/Tools/TCPMon.pm A iepm/trunk/lib/IEPM/Tools/ASN.pm A iepm/trunk/lib/IEPM/Tools/Jitter.pm A iepm/trunk/lib/IEPM/Tools/Traceroute A iepm/trunk/lib/IEPM/Tools/Traceroute/ASN.pm A iepm/trunk/lib/IEPM/Tools/Traceroute/Country.pm A iepm/trunk/lib/IEPM/Tools/Country.pm A iepm/trunk/lib/IEPM/CGI A iepm/trunk/lib/IEPM/CGI/TypeChecking.pm A iepm/trunk/lib/IEPM/Statistics A iepm/trunk/lib/IEPM/Statistics/Distribution A iepm/trunk/lib/IEPM/Statistics/Distribution/Cumulative.pm A iepm/trunk/lib/IEPM/Statistics/Distribution/Latency.pm A iepm/trunk/lib/IEPM/Statistics/Distribution/Cumulative A iepm/trunk/lib/IEPM/Statistics/Distribution/Cumulative/Latency.pm A iepm/trunk/lib/IEPM/Statistics/DistributionCumulative.pm A iepm/trunk/lib/IEPM/Statistics/DistributionCumulativeLatency.pm A iepm/trunk/lib/IEPM/Statistics/Distribution.pm A iepm/trunk/lib/IEPM/Statistics/DistributionLatency.pm A iepm/trunk/lib/IEPM/Stream A iepm/trunk/lib/IEPM/Stream/Tools A iepm/trunk/lib/IEPM/Stream/Tools/Traceroute A iepm/trunk/lib/IEPM/Stream/Tools/Traceroute/HTML.pm A iepm/trunk/lib/IEPM/Utilities A iepm/trunk/lib/IEPM/Utilities/Number.pm A iepm/trunk/lib/IEPM/Utilities/Dumper.pm A iepm/trunk/lib/IEPM/Utilities/Time.pm A iepm/trunk/lib/IEPM/Utilities/TimeConvert.pm A iepm/trunk/lib/IEPM/Utilities/TimeInterval.pm A iepm/trunk/lib/IEPM/Topology A iepm/trunk/lib/IEPM/Topology/Node.pm A iepm/trunk/lib/IEPM/Topology/SubnetChange.pm A iepm/trunk/lib/IEPM/Topology/TracerouteComparisonMetaData.pm A iepm/trunk/lib/IEPM/Topology/Link.pm A iepm/trunk/lib/IEPM/Topology/TracerouteMetaData.pm A iepm/trunk/lib/IEPM/Topology/Traceanal A iepm/trunk/lib/IEPM/Topology/Traceanal/Row.pm A iepm/trunk/lib/IEPM/Topology/Traceanal/Table.pm A iepm/trunk/lib/IEPM/Topology/Traceanal/Element.pm A iepm/trunk/lib/IEPM/Topology/Traceanal/Table A iepm/trunk/lib/IEPM/Topology/Traceanal/Table/HTML.pm A iepm/trunk/lib/IEPM/Topology/Traceanal/Element A iepm/trunk/lib/IEPM/Topology/Traceanal/Element/Symbolization.pm A iepm/trunk/lib/IEPM/CGI.pm A iepm/trunk/lib/IEPM/Plot A iepm/trunk/lib/IEPM/Plot/CanvasGnuplot.pm A iepm/trunk/lib/IEPM/Plot/Data.pm A iepm/trunk/lib/IEPM/Plot/Canvas.pm A iepm/trunk/lib/IEPM/Plot/DataGnuplot.pm A iepm/trunk/bin A iepm/trunk/bin/asn.pl Checked out revision 552. akbar@iepm-resp $ svn co file:///afs/slac.stanford.edu/g/scs/net/netmon/repo/svn/pinger pinger A pinger/trunk A pinger/trunk/unit_tests A pinger/trunk/lib A pinger/trunk/lib/IEPM A pinger/trunk/bin A pinger/trunk/bin/pingtable.pl A pinger/trunk/bin/HostSearcher.pl A pinger/trunk/bin/scriptdoc.pl A pinger/trunk/bin/prmout_filter.pl A pinger/trunk/bin/country_search_list.conf A pinger/trunk/bin/script_list.txt Checked out revision 552. akbar@iepm-resp $ {Code} |
Running the Program
- First you need to cd into the $HOME/myprojects/topology/trunk/unit_tests/. I am assuming that you created the myprojects in your home directory. In case there was another location, replace $HOME with that location.
- Next set the PERL5LIB environment variable for the system libraries. Once again if the location of your myprojects directory is different replace $HOME with that location.
- setenv PERL5LIB $HOME/myprojects/topology/trunk/lib:$HOME/myprojects/iepm/trunk/lib
- Finally you can run the program by simply running the script region_topology.pl
| Code Block |
|---|
| Wiki Markup |
{Code} akbar@iepm-resp $ ls -rtl total 82 -rwxr-xr-x 1 akbar sg 10212 Jul 2 15:55 test_topology.pl* -rwxr-xr-x 1 akbar sg 5828 Jul 2 15:55 test_tools-tracerouteASN.pl* -rwxr-xr-x 1 akbar sg 5201 Jul 2 15:55 test_iepm-db-topology.pl* -rw-r--r-- 1 akbar sg 9598 Jul 2 15:55 test_canvasWithASs.pl -rw-r--r-- 1 akbar sg 9602 Jul 2 15:55 test_canvas.pl -rw-r--r-- 1 akbar sg 9552 Jul 2 15:55 test_canvas-graphvizWithASN.pl -rwxr-xr-x 1 akbar sg 6557 Jul 2 15:55 test_canvas-graphviz.pl* -rw-r--r-- 1 akbar sg 1515 Jul 2 15:55 regiontopology.conf -rwxr-xr-x 1 akbar sg 4908 Jul 2 15:55 region_topology_wrapper.pl* -rwxr-xr-x 1 akbar sg 14552 Jul 2 15:55 region_topology.pl* -rw-r--r-- 1 akbar sg 155 Jul 2 15:55 lookup.txt akbar@iepm-resp $ region_topology.pl Usage: region_topology.pl --region |--group |--country |--file |--hostfilelist --detail [--tracerouteserver] [--colorlinks] [--endnodes] Arguments: --region Name of region in PingER to which the traceroutes must be done for generating graph --group Name of group in PingER to which the traceroutes must be done for generating graph --country Name of country in PingER to which the traceroutes must be done for generating graph --file Path of file containing a list of raw traceroutes, which to use for drawing the graph --hostfilelist Path of file containing a list of hosts to do traceroutes, for drawing the graph --detail Detail level of the graph (values include 'asn' or 'country' or 'all' and is mandatory) --tracerouteserver Complete address of traceroute server from which to do traceroutes. Default is localhost --colorlinks Whether to color links according to traceroute ('on' or 'off') --endnodes Whether to display end nodes in the graph ('on' or 'off') --basepath Base path where to generate the graphs --from Name of the site containing the tracerouteserver (optional, e.g. SLAC) Examples: region_topology.pl --group 'SUB.SAHARA' --detail 'country' region_topology.pl --region 'Latin America' --detail 'all' region_topology.pl --file 'rawtraceroutes.txt' --detail 'all' region_topology.pl --region 'Latin America' --detail 'all' --tracerouteserver 'http://www.tenet.ac.za/cgi-bin/traceroute.pl' region_topology.pl --hostfilelist 'beacons.txt' --detail 'country' region_topology.pl --basepath '/afs/slac/u/sg/akbar/graphs' {Code} |
If you run the script with --help or without any options it gives you the usage. The following options need to be provided:
...