###################################################################
# Instructions for installing and using Brahms on Ubuntu w/ Eclipse
# Delroy Cameron
# May 28th 2007, Jan 07 2008
##################################################################

#create a folder called BRAHMS
	a) in this folder place the tar files for raptor, brahms1.0.1 and brahms_semdis, then do the following

#install raptor (version 1.4.15)
	a) install libxml2-dev (sudo apt-get install libxml2-dev)
	b) extract raptor from the tar file (tar -xzvf raptor...)
	c) configure raptor (./configure)
	d) make raptor (make)
	e) make install raptor (sudo make install)

#install brahms (version brahms1.0.1)
	a) extract and configure brahms1.0.1 (./configure)
	b) install the g++ compiler (sudo apt-get install g++) 
	c) make brahms (make)
	d) make install brahms (sudo make install)

#install brahms_semdis
	a) navigate to the folder /usr/local/include and create symbolic links to each file below
		- jni.h is located in $JAVA_HOME/include (ln -s $JAVA_HOME/include/jni.h jni.h)
		- jni_md.h is located in $JAVA_HOME/include/linux (ln -s $JAVA_HOME/include/linux/jni_md.h jni_md.h)
	b) extract brahms_semdis_version
	c) configure (./configure)
	d) make brahms_semdis
	e) make install brahms_semdis
		- Note that brahms creates various libraries in /usr/local/lib

#set environment variables
	a) set LD_LIBRARY_PATH=/usr/local/lib in (/etc/bash.bashrc)
	b) you may also need to create a .bash_profile file if it does not exist 
	   and type the source ~/.bash_profile at the command line to effect the changes to you PATH variable

#test a snapshot
	a) read an rdf/xml into main memory and copy it onto disk.
	b) snapshotCreator .snapfile schema ontology
	c) snapshotStatistics

#test in java
	a) from brahms_semdis, go to java-examples
	b) test ant, (simply ant)

#using brahms in eclipse
	a) in eclipse, in your project 
		-> Open Run Dialog -> Environment
		- and create a new Environment variable called LD_LIBRARY_PATH=/usr/local/lib
	b) at the command line, create a "dot.snap" file for loading
		- snapshotCreator filename.snap schema ontology
	c) in your java program, load the "dot.snap" file and query 

NOTE:
	a) Brahms Exception Handling may not be thoroughly implemented.
	   In cases when the directory containing the dot snap file
	   is incorrectly specified, Brahms will throw an invalid memory
	   pointer error.

############################## END #############################################