Follow the steps below to set up the system. This is the "quick-and-easy" version of the installation instruction to get you started. Later on this page, there is information on other settings that can be made to customize the system.

1. Make sure you are on a Sparc running Solaris 2.5. You can make sure of this by typing uname -a.
2. Create the directory, called PREDATOR, where you wish to unpack the distribution. 'cd' into this directory.
3. Download the tar file predator.tar.gz. You will be prompted for a username and password (which you should have received by email upon accepting the license agreement).
4. Decompress the tar file as follows:

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

   This will unpack the distribution, creating a directory tree with some subdirectories. 'cd' into the code subdirectory
5. 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 MAKE, GCCINSTALL, GCCINCLUDES, FLEXHOME, FLEXVERSION, BISONHOME, and BISONVERSION.
6. PREDATOR requires some environment variables to be set during runtime and compilation. The cshrc.setvar file in this directory defines these variables, some of which you will have to modify. Make the changes and copy the entire file into your .cshrc file (or add a line to your .cshrc file which sources cshrc.setvar). Then source your .cshrc file before proceeding. Below is a table of the variables you should change and their meanings:

   Variable Name	Meaning
   XXX_INSTALLROOT	A path to the root of the installation. By convention, this should point to a directory called PREDATOR where you unpacked your distribution.
   XXXSHORELOGDIR	The directory in which SHORE will store its log files. This directory MUST exist and be writeable. Try to place your log files on a local disk. You MUST define this variable.
   XXXTMPDATADIR	The directory is used by the server for temporary files and query processing information. This directory MUST exist and be writeable. You MUST define this variable.
   XXX_JDK	Location of your JDK installation.

   Note: The string "XXX" in this document really means "XXX". Do not subsitute with other strings.

7. Run script to capture the screen output of your installation process. This will help us debug your installation in case something goes wrong.
8. Check that the default 'make' in your path is Gnu Make. Check that your current working directory is code. Then type make Compilation is a lengthy process (approximately 30--60 minutes on a SparcStation 20). If you like, you can exploit the parallel make feature of Gnu Make. For example, you can compile three files in parallel using make -j 3 . We recommend this for faster compilation. You will receive an e-mail informing you if the compilation was successful. There may be several warning messages which you can typically ignore.
9. When your installation compiles successfully, you should run regression tests to make sure that the system is running as expected.

There are some further settings you can make to modify the behavior of PREDATOR.

• The release setup defaults to building a debug non-optimized version of Predator. If you are happy with this, skip this bullet. If you wish to change this behavior, edit the file make_include.config as follows:

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

  You will need to remake the whole system (in the code directory, first make clean, then make).
• There are other environment variables in cshrc.setvar that may be modified. These variables only affect the runtime execution of the system and do not require a recompilation.

  Variable Name	Meaning
  XXXSHOREDEFDEVPATH	The desired location of your "default disk". This is the file used by ADTs as a storage volume. For instance, images and audio objects are stored in this file. Try to place your "default disk" on a local file system.
  XXXSHOREDEFDEVSIZE	The size of your defdisk, in kilobytes. A good starting size is 50000.
  XXXSHORERELDISKPATH	The desired location of your relational data "disk". This is the file used to store relational data. Try to place your "relational disk" on a local file system.
  XXXSHORERELDISKSIZE	The size of your reldisk, in kilobytes. A good starting size is 10000.
  XXXSHOREDISKRW	The location of SHORE's diskrw program, which performs asynchronous disk accesses. Change this only if you are using an independent installation of SHORE.
  XXX_SERVER_PORT	A port number (preferably above 5000) where the regression tests can safely start a server. This is meaningful only for the regression tests, not for normal execution.

Trouble Shooting