BigSur.tar

4/28/95

This directory contains a 4.8MB tar file which in turn contains the
data and scripts ("tools") necessary to implement the BigSur Schema,
in an Illustra database, along with all of the requisite datatypes/DataBlades.
(The contents of this file are repeated in various README files within
the distribution.)

This document contains:

	A brief description of the items included in this distribution.

	Directions on how to load the schema.


Please Note:

	At present, maintenance of this collection is performed by Mike
	Stonebrakers Database Research staff: Paul Brown and Richard
	Troy (addresses above). The database schema itself has a small
	team assigned to flush out issues and solutions, headed by Jean
	Anderson: jta@cts.com.

	This is a "beta"... it's Beta Dan Nut'n!

	If you give this a try, please let us know how it goes... 
	Email us... Our addresses are:

	rtroy@postgres.berkeley.edu & pbrown@postgres.berkeley.edu


Contents of the Big Sur Schema distribution

	This "tar wad" contains all the necessary components to implement
	an instance of the BigSur schema, along with all of its accompanying
	"infrastructure" components (eg. new datatypes). It is intended that
	the target environment be a working Illustra installation. The
	mechanism by which it is "installed" is the "make" utility.

   Included are:
 
     BigSur  - This directory contains the Schema stuff for
               the BigSur schema and infrastructure. 

     Dlobh   - This is the source and principle ports for the 
               Distributed Large Object Handle datatype. Paul Brown
               wrote the 'C' version of this based on an idea
               by Jean Anderson. Further work on DLOBH is likely to
		expand the architecture somewhat.

     MiTcl   - This is the embedding of libmi from Illustra into
               John Ousterhout's Tcl/Tk toolkit.

     MiBrowse - This is an application written to employ mitcl. It
		is escentially a gui version of "msql" along with
		some extra system admin features.

     OK - This directory contains the Illustra Object Knowledge "Project"
		(application) called NewWorldOrder. This Project is the
		first prototype illustrating how to use this schema. To
		load it you need Illustra OK installed (on a Sun), and
		then simply "import" it via the OK Project Editor.

How to load this software:

	The components which make up the BigSur environment are all included in
	this "Tar wad." Please see the Description.README for more information
	on each of the components.

	If you are loading the BigSur Schema, you will automagically get all of
	the other necessary components. If, however, you wish only to use the
	DLOBH Blade, you may; Please follow the directions for it below.

To load the BigSur Schema you must first have Illustra 2.x or higher.
Use one of the following methods: (for each, you must first cd into the 
./BigSur/Schema directory)

    $make MI_DATABASE=TARGET load        - Load into existing database.

    $make MI_DATABASE=TARGET create load - Create and load a new database.

    $make MI_DATABASE=TARGET new load    - Delete and create, then load.


To load the Dlobh blade, do so by:

	1)    You will need to set the environment variable MI_PLATFORM. This
	      is set to either 'alpha' or 'sun4'. There is a file called 
	      ./Dlobh/SOURCEME which does this correctly.

	2)    Then, go to the ./Dlobh/install directory and type;

 	      make MI_DATABASE=databasename install
 
	3)    To install on another server, modify the MSQL variable in 
	      ./install/Makefile.