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'. 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 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 |--------------| | 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. Note: the windows version doesn't have greenstone 3 native building yet.