RAToolSet

[Cengiz Alaettinoglu <]

Hi,

RAToolSet can be downloaded from http://www.isi.edu/ra/RAToolSet.
Below, I am including the instructions in case some of you may want to
try it out next week. My understanding is that the tools will stay
installed on meeting.ripe.net (acct name rademo) for a while.

Regards.

Cengiz

-- 
Cengiz Alaettinoglu           Information Sciences Institute
(310) 822-1511                University of Southern California
http://www.isi.edu/~cengiz
======================================================================
Instructions for RAToolSet Demos
================================

	Your feedback on these tools are greatly appreciated.

	You can download RAToolSet from:
		ftp.isi.edu:ra/RAToolSet
		http://www.isi.edu/ra/RAToolSet
	There is a mailing list
		ratoolset@localhost 
	To subscribe, send mail to majordomo@localhost with body of the message
	containing "subscribe ratoolset".

	NOTE: RAToolSet is configured to connect to RAWhoisd running
	at meeting.ripe.net at port 5045. If you get a connect failed error,
	RAWhoisd probably is not running anymore. In which case you can
	connect to whois.ra.net by issuing: 
		unsetenv IRR_HOST
		unsetenv IRR_PORT

To run:
	1) cd demo/data

	NOTE: Most of the executables are in ~cengiz/demo/bin. This
	directory is already in the PATH of the rademo account.
	Example data files are in the ~/demo/data directrory. The man pages
	are in ~demo/man. The MANPATH contains this directory.

	2) to generate a config file for a cisco router

		RtConfig < ornet-gw.ra

	   You may want to examine the file ornet-gw.ra first. This
	   file is used in production to configure one of the routers
	   of Oregon IX (courtesy of Dave Meyer).

	3) to generate a route server config file

		RtConfig -config rsd < rsd.sprint.tmpl

	   rs1.sprint.ra.net is configured using this template file
           every four hours.

	   You may want to add "-h meeting -p 5055" to speed this up. 
           (see relayd below).

	4) roe
		roe <your-as-number>

	   If you have a cisco bgp dump, you should load it from the
           file menu.


	   You may want to try "roe AS226", there is a bgp dump file
	   that goes with this AS in file roe_bgp_dump_as226.

	5) aoe
		aoe <your-as-number>

	   If you have a cisco bgp dump, you should load it from the
           file menu.

	   You may want to try "aoe AS3582", there is a bgp dump file
	   that goes with this AS in file aoe_bgp_dump_as3582.

	6) CIDRAdvisor
		CIDRAdvisor -incl_multihomed AS226
	   
	   This will not check any policies. Try:
		CIDRAdvisor -incl_multihomed AS226 -radius -3
	   to check policies of all ASes

	7) peval

		peval -expand_all 'AS1220 AND AS226'

	   peval will list the multihomed routes between AS1220 and AS226

	8) other (9 and 10 below are more interesting)

		prcheck <your-as-number>
		pmatch AS3130 cat.isi.edu
                prpath AS2914 193.85.128.0/24
		prtraceroute www.isi.edu

	   we are having problems running prtraceroute on bsdi.

	9) relayd is running on meeting.ripe.net on port 5055. All
	   tools above can be run using relayd by issuing the command
	   line options "-h meeting -p 5055". For example:

		RtConfig -config rsd -h meeting -p 5055 < rsd.sprint.tmpl

	   You will see warning messages saying the data comes from a CACHE.
	   You may also notice certain tools run faster.

	   If you get a connect() failed, most probably somebody
	   rebooted meeting.ripe.net, and relayd is no longer
	   running. You can restart relayd by: 

		relayd -c all-as.db

	10) IRRv

		irrv

	   Rusty's instructions:

For a demo the following things can be done:

1. Select "IRR -> AS Peers" menu option and enter as3333.
  => this expands as3333

2. Find Ebone (as1755) and drag it into the clear

3. Expand Ebone

4. Select "IRR -> Layout -> Gater Peers"
   => this will collect all of Ebones singly connected peers
   => around Ebone


* at this point you may want expand a few more ases to get the map a
   bit cluttered to demo the "Gather Nodes" option.  following are
   some suggested expansions
   
5. Expand as3215

6. Expand as5582

7. Expand UUNet (as175?)
   => this will cause the uunet icon to turn yellow, indicating no
   => registered peer info

8. Expand 6708

9. Select "IRR -> Layout -> Group Nodes" && select 3 or 4 levels on
   the popup
   => this will group all nodes of degree 3 (or 4) reducing much
   => clutter. 
   

10. Select RIPE (as3333) and pulldown the 'IRR -> IRR -> Display
    Autnum" menu.
    => this will show the '!man,as3333' query results in the text
    => window. 

11. Select RIPE (as3333) and pulldown the 'IRR -> IRR -> Display
    Routes" menu.
    => this will show the '!gas3333' query results in the text
    => window. 


12. You can select the 'IRR -> Geographic -> World' to show the
    geographic ability, although the maps should show as a backdrop,
    this may produce uninteresting results.


*** About exec'ing commands        

there is an executable script ~eddy/bin/irrv that will change
directories to ~eddy/bin and exec tkined.  I have symbolic links for:

  prpath -> ~cengiz/RAToolSet/src/prpath/prpath
  roe    -> ~cengiz/RAToolSet/src/roe/roe

  prtraceroute -> ~cengiz/demo/bin/prtraceroute

that will get executed when the 'IRR -> tools -> ..." gets selected.
after executing prtraceroute or prpath using the text log screen and
hyper commands, it is safest to quit the log window if you will
attempt another exec of prtraceroute or prpath.  This is because
tkined has a bug that jumbles subsequent hyper link commands.