Repository In a Box (RIB), v2.1.2
=================================

1) Intro
2) Obtaining and unpacking RIB
3) Installing RIB
4) Scheduling interoperation updates
5) Starting and stopping the RIB server
6) Acknowledgements


1) Introduction
---------------

Repository In a Box is an integrated suite of tools for creating and
maintaining online metadata repositories. A RIB server consists of the
following components:

-  Apache
-  MySQL
-  Perl
-  RIB

The RIB installation process installs a copy of each of these components,
providing RIB with a known software environment in which to operate. This 
document explains the RIB setup process.


2) Obtaining and unpacking RIB
------------------------------

RIB can be obtained from the RIB project website at

   http://icl.cs.utk.edu/rib

To unpack the RIB distribution, copy rib-2.1.2.tgz to a temporary directory
and execute

   gunzip -dc rib-2.1.2.tgz | tar -xf -

This will create the directory rib-2.1.2


3) Installing RIB
-----------------

To install RIB, execute the following instructions:

   cd rib-2.1.2
   ./install.sh

The install.sh script will prompt for information RIB needs, e.g. install
directory. It will then build, install, and configure MySQL, Apache, Perl,
and RIB.


4) Scheduling interoperation updates
------------------------------------

Interoperations between RIB repositories must be updated to keep them 
current. RIB provides a script to update interoperations. This script must
be run at regular intervals. The easiest way to do so is to add the following
line to the RIB user's crontab:

    0,15,30,45 * * * * /usr/local/rib/bin/updateAllInterops.pl


5) Starting and stopping the RIB server
---------------------------------------

To start the RIB server, execute

    /usr/local/rib/bin/ribctl start

To stop the RIB server, execute

    /usr/local/rib/bin/ribctl stop

To restart the RIB server, execute

   /usr/local/rib/bin/ribctl restart


6) Acknowledgements
-------------------

o  RIB Development Team
 - Jeremy Millar <millar@cs.utk.edu>
    Project Lead
 - Don Fike <fike@cs.utk.edu>
    Programming
    Windows support
 - Scott Wells <swells@cs.utk.edu>
    Testing

o  RIB Development Alumni
 - Paul McMahan
 - Jeff Horner
 - Nathan Garner
 - Sharon Chambers
 - Tammy Race


Please send questions or comments to <rib@nhse.org>.
