How to install Harvest
----------------------

System Requirements
-------------------
You need following components to build and run Harvest:

- Unix like Operating System
- Bison (available at ftp.gnu.org and its mirrors)
- Flex (available at ftp.gnu.org and its mirrors)
- C compiler (GCC recommended)
- Perl 5
- Sh and csh (bash and tcsh are good replacements)
- Webserver

Building Harvest
----------------
After unpacking harvest, type "./configure" to configure Harvest.
configure has many options. To see a list of available options, type
"./configure --help | less".

This will install Harvest in "/usr/local/harvest":

./configure
make
make install

If you want another directory for Harvest, use:

./configure --prefix=/path/you/want
make
make install

If you are updating an older version of Harvest, you already have done
everything necessary to update Harvest.

Configuring Harvest
-------------------
To configure Harvest, change to the directory you have installed Harvest,
either "/usr/local/harvest" or "/path/you/want" and do:

./RunHarvest

RunHarvest will ask some questions. It usually makes reasonable suggestions,
so just hitting enter when promted to answer a question should be okay.
If you are familiar with Harvest or know that you want to change something,
feel free to override the suggestions.

After getting all answers, RunHarvest will create a gatherer/broker pair and
perform initial gathering.

Configuring the System
----------------------
Harvest assumes all of its files in "http://your.harvest.server/Harvest/"
and cgi scripts in "http://your.harvest.server/Harvest/cgi-bin/".
Modify your http daemon to reflect this.

For apache, add following lines to your access.conf or httpd.conf.

ScriptAlias /Harvest/cgi-bin/ "/usr/local/harvest/cgi-bin/"
Alias       /Harvest/         "/usr/local/harvest/"

Note that the order of these lines are important.

If you get error messages from http daemon when attempting to
access files in /Harvest/, it must be configured to follow symbolic
links.

For apache, add following lines to your httpd.conf.

<Location /Harvest/brokers/your-broker-path/>
          Options FollowSymLinks
</Location>

Don't forget to restart apache after reconfiguration.

For other http daemons, consult the documentation of your http daemon.

Using Harvest
-------------
Start your favourite web browser and visit the page:

"http://your.harvest.server/Harvest/brokers/your_broker/"

You should see the query page of Harvest.

Congratulations, you have successfully installed Harvest.

Additional Setup
----------------
To perform periodic gathering, add a line like this to your cron
table:

0 23 * * 5 /usr/local/harvest/gatherers/your_gatherer/RunGatherer

Managing Harvest
----------------
Read the Harvest User's Manual and FAQ in doc/ directory. The Harvest
Homepage "http://harvest.sourceforge.net/" might have more up to date
information.

If you have trouble building or using Harvest, feel free to contact me
or post an article in comp.infosystems.harvest.
--------------------------
Kang-Jin Lee <lee@arco.de>
11 April 2002
