Installing the Cooperative Computing Tools
13 September 2004
The Cooperative Computing Tools are Copyright (C) 2004 Douglas Thain and
the University of Notre Dame. This software is distributed under a BSD-style license.
See the file COPYING for details.
Overview
The Cooperative Computing Tools (cctools) are a collection of programs designed to
assist users with the difficulties of building and managing complex,
fault-prone distributed systems. The components of the cctools are:
Parrot - A personal virtual file system.
Chirp - A distributed file and storage system.
ftsh - A fault tolerant shell language.
This short manual describes how to install the cctools.
For more information about the tools themselves, see the links above.
Installing
The cctools may already be installed on your system.
Simply run chirp -v
. If you see something like
chirp version 1.0.1 built by dthain@hedwig on Sep 12 2004 at 20:04:51
then the cctools are installed, and you are ready to go.
Otherwise, you must install the cctools yourself.
Installing at Notre Dame
If you are on the Notre Dame campus,
you may find a recent version of the cctools in AFS.
Simply set up your path as follows:
% setenv PATH /afs/nd.edu/user37/ccl/software/stable/bin
Installation From a Binary Package
From any other location, we recommend that you install a binary
package from the cctools web page.
Simply unpack the tarball in any directory that you like,
and then add the bin
directory to your path.
For example, to install in /home/fred/parrot:
% cd /home/fred
% gunzip cctools-xxx-yyy.tar.gz
% tar xvf cctools-xxx-yyy.tar
% setenv PATH /home/fred/cctools/bin:$PATH
Installation From a Source Package
Building the cctools from source can be quite complicated simply because
the cctools works with a number of completely independent systems that
are quite complex themselves. Begin by downloading a source package:
- cctools (Required)
If you wish the cctools to operate with any of these other packages,
you must download and install them seperately:
- Kerberos V (Optional)
- Globus (Optional) (Must be Globus 2.x)
- NeST (Optional)
- RFIO (from Castor) (Optional)
- DCache (Optional)
Once all these packages are correctly installed, unpack the cctools and
then issue a configure command that points to all of the other
installations. Then, make and install. For example:
% gunzip cctools-xxx.tar.gz
% tar xvf cctools-xxx.tar
% cd cctools-xxx
% ./configure --prefix /home/fred/cctools --with-krb5-path /usr/kerberos --with-globus-path /usr/local/globus ...
% make
% make install
Finally, add the cctools to your path:
% setenv PATH /home/fred/cctools/bin:$PATH