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
./gs3-install.sh

If you change the source and want to compile it again later, you can run 'make' then 'make install' from this directory.

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

Greenstone requires Java 1.4.

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

Greenstone comes setup to use SOAP. SOAP runs as a servlet inside Tomcat, and is disabled by default. To enable it, run
./gs3-enable-soap.sh
Then re-launch Greenstone: 
./gs3-launch.sh -shutdown
./gs3-launch.sh

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

To run Greenstone, run
gs3-launch
This starts up the Tomcat web server and mysql database server.

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

Greenstone comes setup to use SOAP. SOAP runs as a servlet inside Tomcat, and is disabled by default. To enable it, run
gs3-enable-soap
Then shutdown and restart 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'.

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

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

To prevent Tomcat showing directory listings, edit the gsdl3/comms/jakarta/tomcat/conf/web.xml file and set the value of the "listings" servlet parameter to false.