HOWTO: ORE ANTS service on Accelar 

Phil Y. Wang
Email: pywang@nortelnetworks.com
Date:  Mon May 22 11:30:40 EDT 2000
URL:   http://www.openetlab.org

The MIT Active Networks project ANTS has been ported to ORE, and is available on Nortel Accelar 1000 series routers. We have tested this package "ORE-ANTS" with the below testbed, see README.rob (authored by Rob Jaeger) for more details.

 a. one Accelar 1000 switch <router>, running ORE and modified ANTS
 b. two Solaris 2.6 boxes <source and destination host>, running MIT ANTS  
 c. one Linux box <HTTP server>, providing ORE 0.3.2 and modified ANTS (jars and configuration


1. Software

This package "ORE-ANTS" includes two major parts:

	accelar/: ORE Ants source packages for Accelar 1000 router
	host/:    MIT Ants and application source packages for hosts

Each part is provided with the Java codes, configuration files, exceution scripts and other documents.


2. Installation
At first, please download the ORE-ANTS package via "http://www.openetlab.org/downloads.htm".

The package file is "ore-ants.tgz", which is a gzipped tar file. To install it, just do:
	$ cd <your_dir>
	$ tar xvfz <source_dir>/ore-ants.tgz # GNU tar
or
	$ gunzip -c <source_dir>/ore-ants.tgz | tar xvf -

If you need to download and install the ORE package, also go to "http://www.openetlab.org/downloads.htm".

3. Run
You should set up an experiental environment stated as above, see README.rob for example. Before you run, you need to make some changes to reflect your local configuration.

3.1 Accelar startup
The Accelar part is in ore-ants/accelar. you should make two chages. One is to create a new file "ants.jar" after specifying your HTTP server. The other is to create the configuation files for ANTS and ORE: ants.config and ping.routes.

- new ants.jar
	$ cd ore-ants/accelar
	$ cd ants/com/nortelnetworks/ore/service/ants
	$ vi AntsNodeServiceImpl.java  # two changes
   [1] HTTP server: must be changed
	     ==>line 58: DEFAULT_CONFIG = <your_http_server>/ants/ants.config
   [2] Accelar IP address: should be changed if getLocalHost() is not supported
	     ==>line 76: the whole line is commented
             ==>line 80: the whole line is uncommented, and the Accelar IP address is set here!

	$ OREROOT=<your_ORE_dir>  # export OREROOT
	$ make
	     ==>new ants.jar

	$ ftp <http_server>/httpd/html/jars
	     ==>upload ants.jar

- new configuration
	$ cd ore-ants/accelar
	$ cd configs
 [ORE startup]
	$ cd jars
	$ ftp <http_server>/httpd/html/jars
	     ==>upload start.properties
 [ANTS config]
	$ cd ants
	$ vi ants.config
		==> change IP addresses

	$ vi ping.routes
		==> change IP routes

	$ ftp <http_server>/httpd/html/ants
	     ==>upload ants.config & ping.routes

- reboot the Accelar

- telnet Accelar where the ORE start.jar is

	$ telnet 10.120.101.102 1966     // my Accelar
	Trying 10.120.101.102...
	Connected to 10.120.101.102.
	Escape character is '^]'.
	Please give ORE invocation parameters
input==> http://134.177.116.106/jars/start.jar

- check the ORE status on the accelar
	$ telnet 10.120.101.102 1999 
	<...>


3.2 Destination host: running ANTS
Another ORE_ANTS part is provided for source and destination nodes (hosts). You can use the Java classes, but need to make your configuration before running.

- new configuration
	$ cd ore-ants/host
	$ cd runs
	$ vi ants.config
		==> change IP addresses, different from the Accelar

	$ vi ping.routes
		==> change IP routes, same as the Accelar

- new command script
	$ vi ants.start
		==> change destination IP address

- run
	$ ants.start

It's an ANTS server program waiting for a ping.


3.3 Source host: running the Ants Ping
You need to make your configuration before running.

- new configuration
	<same as 3.2>

- new command script
	$ vi ping.start
		==> change source IP address

- run
	$ ping.start

It runs a GUI application by which you can decide how to ping the destination. You may set two values: "num iteration" and "ping interval".

Once you click Button "Ping", you will see outputs from three machines: the Accelar router, the source host and the destination host. Check the messages, you can make sure whether the package is working.


EOF