What is Included

Included in this V0.1 distribution of PREDATOR are:

1. the system codebase (C++ and Java sources)
2. SHORE version 1.1 pre-release (only binaries and header files used by Predator). The complete and accurate version 1.1 is available at http://www.cs.wisc.edu/shore.
3. Portions of the JClass Table Libraries ( from the KL Group)
4. The httpd daemon web server from the WWW Consortium. You can use any other web server instead.
5. IJG's JPEG Library

Instructions

Stage 1

1. Create the directory, called PREDATOR, where you wish to unpack the distribution. (Please use all caps.) For installations of this distribution, the variable PREDATOR_LAIR must be a path to this directory. (See Installation later for details.)
2. Download the distribution into the PREDATOR directory (approx. 12 MB compressed, 50MB uncompressed).
3. In your PREDATOR directory, decompress the distribution by typing

         gzip -dc predator.tar.gz | tar -xvf -
         

   This will unpack the PREDATOR distribution, creating multiple directories. One of these directories is xxx, which is the root of the RCS hierarchy of source files.

Stage 2

Once you have located all of the above utilities, you will need to modify one or more configuration files as follows:

1. In the directory called PREDATOR in which you unzipped the distribution, type the following commands:

   cd xxx/code
   co -l make_include.utilities
   

   You should see the response

   RCS/make_include.utilities,v  -->  make_include.utilities
   revision 1.1 (locked)
   done
   

   Now edit the file make_include.utilities, which is a macro-definition file for make, to correctly point to the above utilities. The variables you must redefine are JDK, MAKE, RCS, CO, CI, GCCINSTALL, GCCINCLUDES, FLEXHOME, BISONHOME, and PERLDIR. When you are done, check in the file by typing

   ci make_include.utilities
   

   and entering "configuration" as the check-in message.

2. The release setup defaults to building a debug non-optimized version of Predator. If you are happy with this, skip this section. If you wish to change this behavior, do the following in the directory called PREDATOR in which you unzipped the distribution:

   cd xxx/code
   co -l make_include.config
   

   Then change the lines

   XXXFLAGS=$(DEBUG_FLAGS) $(STD_FLAGS)
   # XXXFLAGS=$(OPT_FLAGS) $(STD_FLAGS)
   

   to

   # XXXFLAGS=$(DEBUG_FLAGS) $(STD_FLAGS)
   XXXFLAGS=$(OPT_FLAGS) $(STD_FLAGS)
   

   Save these changes by typing

   ci make_include.config
   

   and entering "configuration" as the check-in message.

3. An optimized version of the SHORE libraries is used by default. If you are happy with this, skip this section. You may change this to a debugging version (or to any updated version of SHORE you've obtained) by editing make_include.components. If you plan to recompile your own SHORE libraries, download SHORE version 1.1 from Wisconsin. You probably do not need to do this in most cases. If you need to edit make_include.components, type

   co -l make_include.components
   

   Comment out the [relevant parts of the] following by prefixing a # before each line you wish to change

   ### This set is for a optimized version of SHORE
   SHORESRCDIR=$(PREDATOR_LAIR)/shore/aug97opt
   SHOREINCLUDES=-I$(SHORESRCDIR)/include
   SHORELIBPATH=-L$(SHORESRCDIR)/lib
   SHORELIBS=-lsm -lcommon -lst -lfc -lm -lg++
   SHOREFLAGS=-DEXTERNAL_TEMPLATES -DSM_PAGESIZE=8192 -D$(ARCH) -D$(OPSYS) -DSHOREVERSION=\"$(SHORESRCDIR)\"
   

   and set the variables SHORESRCDIR, SHOREINCLUDES, SHORELIBPATH, SHORELIBS, SHOREFLAGS to their new values.

   Save these changes by typing

   ci make_include.components
   

   and entering "configuration" as the check-in message.

Stage 3