Requirements

To install and run the Shore documentation and binary releases, you will need:

• a Sparcstation running SunOS (we built this release under SunOS 4.1.3 on a Sparcstation-10), with at least 4MB bytes of shared memory, or

• a Sparcstation running Solaris (we built this release under Solaris 2.5.1 on a Sparcstation-10)

• GNU gcc 2.7.2 to use the binary release. (Gcc 2.6.3 and 2.7.2 are not link-compatible.)

• gzip file (de)compression facility to unpack the release.

• lots of free disk space. The disk space requirements are roughly:
  • documents: 5 MB (1.5 MB for HTML, 3.3 MB for Postscript; you can throw away the HTML or Postscript versions if you want to conserved disk space)
  • binaries configured with debugging: 70 MB (or less, depending on the architecture)
  • binaries configured without debugging: 25 MB (or less, depending on the architecture)
  • source release and space to build from scratch: 200 MB (or less, depending on the architecture)
• A World-Wide-Web (WWW) browser (such as Mosaic) for reading the HTML versions of the documentation, or software for reading or printing Postscript.

If you also wish to build Shore from the sources, you will need:

• GNU gcc 2.7.2 or 2.6.3(we used 2.7.2 to build the release) (including the GNU assembler, linker, and preprocessor)
• Disk space to build (in addition to space for sources):
  • without debugging symbols and without debugging code (-UDEBUG) : 115 MB
  • with debugging symbols and with debugging code (-DDEBUG) : 170 MB
• Perl version 5.0 (we built Shore with version 5.001, unofficial patch level 1m).
• Sun's /bin/make or GNU Make (we built Shore with GNU Make version 3.72.1 and /bin/make for SunOS 4.1.3).
• GNU Flex (we used version 2.5.2) and Bison (we used version 1.24).
• Imake (we used Revision 1.91 of 12/01/95) from the X Consortium. Imake can be found in your X11 installation as X11/bin/imake.
• The Tcl library (we use version 7.4)
• The normal Unix utilities like /bin/csh, /bin/sh, /bin/sed, /bin/mv, etc.

The GNU software is available via ftp from ftp://prep.ai.mit.edu/pub/gnu or ftp://gatekeeper.dec.com/pub/GNU.

If you are unfamiliar with Tcl, it stands for ``tool command language''. It was developed by Dr. John Ousterhout at UC-Berkeley for providing interfaces for tools, although it can be used for more than that. In Shore, it is used for test programs for the Shore Storage Manager and the Shore Value-Added Server. You must have Tcl to build Shore, however this might change with later releases. Tcl is available via ftp from ftp://ftp.cs.berkeley.edu/ucb/tcl. A FAQ is also available.

For all the following installation steps, we use two variables, so that you can "cut and paste" the instructions below.

    set TARDIR=directory-that-holds-tar-files
    set SHROOT=directory-in-which-to-install-shore

Whatever shell you use, make a directory in which to install Shore. (If you plan to install both a debugging binary release and a no-debugging binary release, you will need separate directories for the two releases.)

    mkdir $SHROOT