Calypso Linux v1.0
------------------

1. The recommended Calypso root directory is /usr/local/calypso.  That
is where this package is installed on our (milan.cs.nyu.edu domain)
machines.  Instillation is quite simple: Simply put
/usr/local/calypso/bin and /usr/local/calypso/examples directories on
your search path.

 * Edit your ~/.bashrc now before moving on. *

2. It is also useful to have a .rhosts file in your home directory,
containing the list of machines that you want to use.  If you are on
our domain (ie, milan.cs.nyu.edu) this is already done for you.

3. Make sure you have 'xterm' is on your default search path also.
For Red Hat Linux, this means that /usr/X11R6/bin must be on your
search path.  If you are on our domain (ie, milan.cs.nyu.edu) this is
already done for you.

4. You need to run the 'rstatd' daemon on each machine that you want
to use.  You can use the daemon that I have compiled
(calypso/bin/rpc.rstatd) or get the official one from the address
below.

ftp://sunsite.unc.edu/pub/Linux/system/network/daemons/rpc.rstatd-3.03.tar.gz
       ----------------

Everything else that you need to run a Calypso program is already
configured.  (There are some executables in /usr/local/caluypso/bin,
some example programs in /usr/local/calypso/examples, and a
configuration file in /usr/local/calypso/calypsorc.)  You are ready to
run sample programs.

I recommend using the Calypso Graphical User Interface (cgui) first
time around.  Simply issue the 'cgui' command to pop up the window and
the rest is point & click.  

You can also run a program at the command line and the let system take
over -- there just won't be much graphics to see.  If you want to see
the available options for a Calypso program, run it with the following
argument '-- -help'.  Go ahead, try the following command:

   gol -- -help


The examples directory contains some sample calypso files that people
might find of some use.  It contains:

Description                                 File
------------------------                  ----------
parallel merge sort                       sort.csl
parallel radix Sort                       radix.csl
computing PI in parallel (several ways)   pi.csl
parallel (Conway's) game of life          gol.csl
parallel matrix multiply                  mm.csl
sequential matrix multiply                mm-seq.C
A nice little utility                     timer.i

Good luck and please forward your questions and comments to me.
Thanks,

-arash
baratloo@cs.nyu.edu
www.cs.nyu.edu/phd_students/baratloo

