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-linux executable file, and run it. Follow the instructions given.

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

(cvs co gsdl3) (if not already done)
cd gsdl3
source gs3-setup.sh
./gs3-prepare.sh
./configure 
make
make install
[make docs] (for the javadoc)
./gs3-finalise.sh

If you want to compile the test servlet, (useful is you are unsure whether Tomcat is working properly), go to gsdl3/web/WEB-INF/classes, and run 'javac TestServlet.java'. You will need to have sourced gs3-setup.sh in the gsdl3 directory first.

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 install SOAP into Tomcat (SOAP runs as a servlet), run 
./gs3-install-soap.sh
Then re-launch Greenstone.

A SOAP server for localsite comes predeployed.
You should be able to see all localsite's collections through the gateway servlet.

To set up a SOAP server on a new site, run
gs3-soap-deploy-site <sitename> <siteURI>
where the sitename is the directory name of the site, and siteURI is a unique 
identifier for the sites 'web service'.



|----------|
| 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.