Requirements

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

• Solaris running on a SPARCstation or Intel X86 workstation (we built this release under Solaris 2.5.1 on a SPARCstation-10 and on Pentium Pro);
• An up-to-date version of the GNU C/C++ compiler (programs compiled with other compilers will not be link-compatible with the libraries supplied). Binary release 1.1.1 was built with gcc and g++ version 2.7.2.3 and #include files from libg++ release 2.7.2. Use of older versions of the compiler or libraries may cause problems. This software is available from the Free Software Foundation, http://www.fsf.org ;
• the gzip file (de)compression facility to unpack the release. This program is also available from the Free Software Foundation ;
• lots of free disk space: roughly
  • 5 MB for the documentation release (1.5 MB for HTML, 3.3 MB for Postscript). You can conserve disk space by throwing the Postscript version after (or before printing) it. You can even throw away both versions and read the documentation over the world-wide web directly from the University of Wisconsin site , as well as
  • 70 MB (or less, depending on the architecture) for the binaries configured with debugging,
  • 25 MB (or less, depending on the architecture) for the binaries configured without debugging, or
  • 200 MB (or less, depending on the architecture) for the source release and space to build from scratch;
• a World-Wide-Web (WWW) browser 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 also need

• an up-to-date version of GNU gcc and associated libraries (version 2.7.2.1 or later-we are using version 2.7.2.3);
• disk space to build (in addition to space for sources):
  • 115 MB without debugging symbols and without debugging code (-UDEBUG) or
  • 170 MB with debugging symbols and with debugging code (-DDEBUG);
• Perl 5 (we are currently using version 5.003). For more information about Perl, see the Perl home page at http://www.perl.com/perl ;
• GNU Make (we are currently using version 3.74), Flex (we are using version 2.5.2), and Bison (we are using version 1.24). These programs are available from the Free Software Foundation . Flex and Bison are only necessary if you wish to rebuild the SDL compiler. The GNU version of make is absolutely essential. None of the Makefiles in the source distribution are likely to work with other versions of make;
• the TCL (Tool Command Language) library (we use version 7.4). TCL is used to provide a command-line (shell-like) interface to various parts of Shore, including the Storage Manager and the Shore Server. We hope in future releases to get rid of the dependency on TCL. TCL is currently available from ftp://ftp.smli.com/pub/tcl or http://sunscript.sun.com/ ; and
• the normal Unix utilities /bin/sh, /bin/sed, /bin/mv, etc.

 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

(If you use the Bourne shell (/bin/sh) or one of the shells derived from it, such as ksh, omit the word "set".)

Whatever shell you use, make a directory in which to install Shore. (If you plan to install both the debugging and no-debugging versions, create a separate directory for each.)

    mkdir $SHROOT