libgist v.1.0 Installation Notes
Portability
Libgist was developed under Digital Unix with the g++ compiler and was
ported to Windows NT with the Microsoft Visual C++ 5.0 compiler and to
Solaris (both x86 and Sparc) and HP/UX with g++. Since these platforms
are quite different, we expect the code to be somewhat portable, but have
not done extensive porting ourselves. Before you port libgist to other
platforms, please check the libgist
home page and see if anybody has done it for you already. If not, and
you succeed in porting, contact us at gist@postgres.berkeley.edu!
NT Installation Notes
Requirements
-
Either an unzip package, or tar and gunzip. All of these are widely available
on the web.
-
Microsoft Visual C++ version 5.0; earlier versions may work, but we make
no guarantees
-
Microsoft Developer Studio: not strictly necessary, but you will have to
create your own NMAKE files if you don't have Developer Studio and want
to build the demonstration executables.
-
Bison & flex: not actually required for libgist, but necessary to use
the demonstration code. Bison and flex for Windows are freely available
on the Web from a variety of sources.
Procedure
-
Run the make.bat script in the src directory; this will
create the libraries and the parsers for the demo executables.
-
There are two demo projects (in src/examples/btree and src/examples/rtree);
in order to build the executables, load their workspaces into Developer
Studio.
-
Libraries and executables will be left with their sources. If you
wish to install them elsewhere, you will need to do so by hand.
UNIX Installation Notes
Requirements
-
Either an unzip package, or tar and gunzip. All of these should be somewhere
on your system; if not, they are widely available on the Web.
-
G++ version 2.7.2: other versions may work, as may other C++ compilers,
but we have not tested any.
-
Gmake: you may substitute make, but will need to rewrite the (simple) Makefiles
to suit.
-
Bison & flex: not actually required for libgist, but necessary in order
to compile the demonstration code. Bison and flex are freely available
on the Web from a variety of sources. It is possible that yacc and lex
may be substituted, but we have not tested them.
Procedure
-
Edit the top-level Makefile, and set paths for the various tools and the
g++ include directory.
-
Run gmake from the src directory -- it will recursively
make libgist, the B-tree and R-tree extensions and all the examples.
-
If you want to run some test scripts to make sure everything is working,
cd to ../tests and type ./runtests. If nothing suspicious comes up on the
screen, your installation has passed the tests.
-
Libraries and executables will be left with their sources. If you
wish to install them elsewhere, you will need to do so by hand.
SHORE Patch Installation Notes
(Warning: This patch has not been tested!)
Requirements
-
Either an unzip package, or tar and gunzip. All of these should be somewhere
on your system; if not, they are widely available on the Web.
-
GNU patch.
Procedure
-
Untar shorepatch.tar in the src directory of your SHORE
installation; this will install the new source files in the directories
sm and sm/ssh.
-
From the src directory, run patch < patchfile.
Comments, questions and suggestions may be directed to gist@postgres.berkeley.edu