The following are hints to compile and run ins.

#--------------------------------------------------------
# Requirements:
#--------------------------------------------------------
JDK1.4.0 or later is required to compile ins/libs/security
and ins/apps/tests/
The rest of the files may be compiled with JDK1.3

#--------------------------------------------------------
# How to setup the classpath
#--------------------------------------------------------

Assuming you checked-out ins inside directory "dir", they you
have to set your classpath to:

dir/:dir/ins/apps:dir/ins/libs/security/cryptix32.jar:dir/ins/libs:.:dir/ins/libs/remotetea/classes/oncrpc.jar:dir/ins/libs/remotetea/classes/jrpcgen.jar:dir/ins/libs/remotetea/classes/jportmap.jar:dir/ins/libs/mpegjava/mpegjava10.jar

You can do this using the script provided in
ins/scripts/setpaths.sh

#--------------------------------------------------------
# How to compile
#--------------------------------------------------------

Simply type "make" in the top-level directory.

If you get compilation errors, check the list of partial targets
in the top level Makefile. Try to compile one target at the time.

If this still fails, try to compile some files by hand. You 
probably want to start with ins/namespace

Note: the content of keyrouters/chordkeyrouter/ isn't re-compiled
by default. The linux binaries are included in the repository, so they
may not work on your system. If you need to recompile that
directory, you have to install sfs and chord (also called sfsnet) 
(check http://pdos.lcs.mit.edu for more details). Once you
installed both systems, update the paths in 

- keyrouters/chordkeyrouter/Makefile
- keyrouters/keyroutersvc/Makefile

to reflect your installation. Then simply run make clean and make.

#--------------------------------------------------------
# Running
#--------------------------------------------------------

To run the resolver and the applications, see the directory ins/doc
It contains html documentation with some explanations on how
to run things.

The directory ins/scripts contains a few very useful scripts
to run both the old and new (Twine) versions of INS.

#--------------------------------------------------------
# Troubleshooting
#--------------------------------------------------------

Send me a message, or pass by my office
Magdalena Balazinska
email: mbalazin@mit.edu
NE43-506
