Greenstone 3 (GSDL3)
Copyright (C) 2003 New Zealand Digital Libraries, University Of Waikato
Greenstone3 comes with ABSOLUTELY NO WARRANTY; for details see LICENSE.txt
This is free software, and you are welcome to redistribute it

These are some extra notes for installing Greenstone from SVN. Please also read the README.txt file for general information as almost all of that applies here too.

Installing Greenstone from an SVN checkout:
---------------------------------------------------------------------

Make sure an SVN executable is on your PATH.

Checkout the code:

svn co http://svn.greenstone.org/greenstone3/trunk greenstone3

Build and install:

In the greenstone3 directory, edit the build.properties file (see 'Configuring your installation' in README.txt), and run 'ant prepare install'. The two targets can be run separately if you like.

The 'prepare' target will download additional code (using SVN and http), so you need to be online to run it. The 'install' target can be run offline.

The prepare/install targets will ask you if you accept the properties before starting.
To suppress this prompt, use the -Dproperties.accepted=yes flag. E.g.
ant -Dproperties.accepted=yes prepare install (from CVS), or
To log the output, run
ant -Dproperties.accepted=yes -logfile build.log prepare install (from CVS), or

Extra Configuration notes:
--------------------------------------------------------------

Greenstone 3 uses some parts of Greenstone 2 for collection building, 
including external packages and the Librarian Interface. These will be 
installed during the Greenstone 3 installation process. If you do not want 
collection building capability, please set the disable.collection.building property to true in build.properties. 


Common install/update targets:
---------------------------------------------------------------------
1. Install for the first time from SVN:
svn co http://svn.greenstone.org/greenstone3/trunk greenstone3
cd greenstone3
ant prepare install

2. Install for the first time from SVN, mostly offline:
[online]
svn co http://svn.greenstone.org/greenstone3/trunk greenstone3
cd greenstone3
ant prepare
[offline]
ant install

3. Updating your Greenstone installation from SVN (and reconfigure/recompile):
cd greenstone3
ant update

4. Updating your Greenstone installation from SVN, mostly offline:
cd greenstone3
[online]
ant svnupdate
[offline]
ant -Dnosvn.mode=yes update