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

|--------|
| Linux: | 
|--------|

Installing Greenstone from a binary distribution:
-------------------------------------------------

Download the gsdl3-x.xx-unix.sh self-installing tar file into the directory you want Greenstone installed in, and run it.

Installing Greenstone from a CVS checkout:
------------------------------------------

(cvs co gsdl3) (if not already done)
cd gsdl3
source gs3-setup.sh
./gs3-prepare.sh
./gs3-configure.sh (will be replaced with ./configure)
./gs3-compile.sh (will be replaced with make, make install)
./gs3-finalise.sh


Running Greenstone:
-------------------

Run the script gs3-launch.sh from the gsdl3 directory. This starts up a Tomcat web server and a mysql database server. To shutdown, run gs3-launch.sh -shutdown

Using SOAP:
-----------

To set up a SOAP server on a site, run
gs3-soap-deploy-site <sitename>

Then re-launch Greenstone.

|----------|
| Windows: |
|----------|

Installing Greenstone from a binary distribution:
-------------------------------------------------

Download the gsdl3-x.xx-win32.exe executable file, and double click on it. 

To run Greenstone, select Greenstone 3 Digital Library from the Start menu.

Installing Greenstone from a CVS checkout:
------------------------------------------

(cvs co gsdl3) (if not already done)
cd gsdl3
gs3-setup
gs3-prepare

Using Wordpad, edit the gsdl3\comms\jakarta\tomcat\conf\server.xml file. Add:

<!-- GSDL3 Service -->
<Context path="/gsdl3" docBase="@gsdl3home@\web" debug="1" reloadable="true"/>

above this line:

<!-- Tomcat Root Context -->
  
Still using Wordpad, edit the gsdl3\comms\jakarta\tomcat\conf\web.xml file. Set the value of the "listings" servlet parameter to "false".

make
make install
gs3-finalise

To run Greenstone, run
gs3-launch

|--------------|
| Other notes: |
|--------------|

See gsdl3/docs/manual/manual.pdf for more details about the software and installation etc.

Note: the windows version doesn't have greenstone 3 native building yet.