CAIDA CoralReef Exercises

CAIDA CoralReef Exercises

How To Install CoralReef

Before you can use CoralReef it must be installed on your Unix system.

CoralReef is known to work under FreeBSD (2.7, 2.8, 3.0, and 3.1),
Linux (2.0.36 and 2.2 pre*) and Solaris 2.5. It should work on other
POSIX systems as well.

Before installing CoralReef you need to know what command name to type
to use the GNU version of make. On FreeBSD and Solaris this is
normally gmake. On Linux it is normally make. Try the
following command on your system:

gmake -v

if that fails try:
make -v

And look for the name GNU Make in the output (it's normally in the
first line).

If neither of these succeed you need to have GNU make installed on your
your system before you continue. Consult your system administrator.

The commands that follow are written as if gmake is the correct
command. Replace gmake with make if appropriate.

You must also decide where you are going to install CoralReef. This
differs depending on whether you want to install it system wide or in
your own private file space. Wherever you choose the install process
will create a subdirectory Coral with further subdirectories for
the libraries (lib), header files (include), executable
user programs (bin) and system administration commands
(etc).

The standard, system wide, location is
/usr/local/. If you are installing CoralReef in your own
directory space we recommend you use the same top level directory as
you download the file to in step~{download} below.

download
Begin by creating an empty directory where you are going to compile
CoralReef.
- Start a web browser and go to the page:
  https://www.caida.org/tools/measurement/coralreef or
  follow the links from the https://www.caida.org page.
  Download the current version (The current version was
  3.1.1 at the time these exercises were developed} of CoralReef
  and save it in the directory you created.
- In the directory unpack the tar.gz archive with the command:
  
  gunzip < downloadedfile.tar.gz | tar -xf -
  
  A directory for the current version of CoralReef will be
  create. Go to that directory.
patch
If the version is 3.1.1 a patch needs to be applied to use the
timestamp sorting feature. This patch is available
at: https://www.caida.org/~tonym/coral_data.c.cdiff (Expired Link).
Download this file and give it the name coral_data.c.cdiff in
in /usr/local/traces/tonym. Copy it to
the directory: coral-3.1.1/libsrc/libcoral
and execute the command: patch coral_data.c coral_data.c.cdiff

If patch does not exist on your system either have your system
administrator install it or examine the file
coral_data.c.cdiff and modify coral_data.c.cdiff by hand.
- The file README (in the package root directory which was
  created when you unpacked CoralReef) contains instructions for
  compiling the package. In most cases you just need to execute
  the following commands:
- Install CoralReef with the command:
  
  verb+gmake install
  
  Note: If you choose to install CoralReef system wide this
  command must be executed as root.

To use CoralReef commands you will need to include the bin direcory
into your path. If you use sh or bash as your shell use a command
like:

PATH=${PATH}:coral_install_dir/bin ; export PATH

If you use csh or tcsh use a command like:

setenv PATH ${PATH}:coral_install_dir/bin

If you're not sure try the csh version and if that give you an error
message use the sh version.
If everything checks out you can tidy up by typing:

gmake clean

in the root directory and by removing the download file.