| 1 | Greenstone 3 (GSDL3)
|
|---|
| 2 | Copyright (C) 2003 New Zealand Digital Libraries, University Of Waikato
|
|---|
| 3 | GSDL3 comes with ABSOLUTELY NO WARRANTY; for details see LICENSE.txt
|
|---|
| 4 | This is free software, and you are welcome to redistribute it
|
|---|
| 5 |
|
|---|
| 6 | |--------|
|
|---|
| 7 | | Linux: |
|
|---|
| 8 | |--------|
|
|---|
| 9 |
|
|---|
| 10 | Installing Greenstone from a binary distribution:
|
|---|
| 11 | -------------------------------------------------
|
|---|
| 12 |
|
|---|
| 13 | Download the gsdl3-x.xx-linux executable file, and run it. Follow the instructions given.
|
|---|
| 14 |
|
|---|
| 15 | Installing Greenstone from a CVS checkout:
|
|---|
| 16 | ------------------------------------------
|
|---|
| 17 |
|
|---|
| 18 |
|
|---|
| 19 | Checkout the code:
|
|---|
| 20 |
|
|---|
| 21 | cvs -d :pserver:[email protected]:2402/usr/local/global-cvs/gsdl-src co gsdl3
|
|---|
| 22 |
|
|---|
| 23 | Build and install:
|
|---|
| 24 |
|
|---|
| 25 | Greenstone is built and installed using Ant (Apache's Java based build tool,
|
|---|
| 26 | http://ant.apache.org). You will need a Java Development
|
|---|
| 27 | Environment (1.4 or higher), and Ant installed to use Greenstone.
|
|---|
| 28 |
|
|---|
| 29 | In the gsdl3 directory, you can run ant which will give you a help message.
|
|---|
| 30 | Running 'ant -projecthelp' gives a list of the targets that you can run - these
|
|---|
| 31 | do various things like compile the source code, startup the server etc.
|
|---|
| 32 |
|
|---|
| 33 | For a first time install, run 'ant install'.
|
|---|
| 34 |
|
|---|
| 35 | The file build.properties contains various parameters that can be set by the user.
|
|---|
| 36 |
|
|---|
| 37 |
|
|---|
| 38 | Running Greenstone:
|
|---|
| 39 | -------------------
|
|---|
| 40 |
|
|---|
| 41 | To startup the servers, run 'ant startup'. 'ant restart' and 'ant shutdown' restarts and shuts down the servers.
|
|---|
| 42 |
|
|---|
| 43 |
|
|---|
| 44 | Using SOAP:
|
|---|
| 45 | ------------
|
|---|
| 46 |
|
|---|
| 47 | Greenstone comes setup to use SOAP. SOAP runs as a servlet inside Tomcat, and is disabled by default. To enable it, run
|
|---|
| 48 | ./gs3-enable-soap.sh
|
|---|
| 49 | Then re-launch Greenstone:
|
|---|
| 50 | ./gs3-launch.sh -shutdown
|
|---|
| 51 | ./gs3-launch.sh
|
|---|
| 52 |
|
|---|
| 53 | A SOAP server for localsite comes predeployed.
|
|---|
| 54 | You should be able to see all localsite's collections through the gateway servlet.
|
|---|
| 55 |
|
|---|
| 56 | To set up a SOAP server on a new site, run
|
|---|
| 57 | gs3-soap-deploy-site.sh <sitename> <siteURI>
|
|---|
| 58 | where the sitename is the directory name of the site, and siteURI is a unique
|
|---|
| 59 | identifier for the sites 'web service'.
|
|---|
| 60 |
|
|---|
| 61 |
|
|---|
| 62 |
|
|---|
| 63 | |----------|
|
|---|
| 64 | | Windows: |
|
|---|
| 65 | |----------|
|
|---|
| 66 |
|
|---|
| 67 | Installing Greenstone from a binary distribution:
|
|---|
| 68 | -------------------------------------------------
|
|---|
| 69 |
|
|---|
| 70 | Download the gsdl3-x.xx-win32.exe executable file, and double click on it.
|
|---|
| 71 |
|
|---|
| 72 | To run Greenstone, select Greenstone 3 Digital Library from the Start menu.
|
|---|
| 73 |
|
|---|
| 74 | Installing Greenstone from a CVS checkout:
|
|---|
| 75 | ------------------------------------------
|
|---|
| 76 |
|
|---|
| 77 | (cvs co gsdl3) (if not already done)
|
|---|
| 78 | cd gsdl3
|
|---|
| 79 | gs3-install
|
|---|
| 80 |
|
|---|
| 81 | To run Greenstone, run
|
|---|
| 82 | gs3-launch
|
|---|
| 83 | This starts up the Tomcat web server and mysql database server.
|
|---|
| 84 |
|
|---|
| 85 | Using SOAP:
|
|---|
| 86 | ------------
|
|---|
| 87 |
|
|---|
| 88 | Greenstone comes setup to use SOAP. SOAP runs as a servlet inside Tomcat, and is disabled by default. To enable it, run
|
|---|
| 89 | gs3-enable-soap
|
|---|
| 90 | Then shutdown and restart Greenstone.
|
|---|
| 91 |
|
|---|
| 92 | A SOAP server for localsite comes predeployed.
|
|---|
| 93 | You should be able to see all localsite's collections through the gateway servlet.
|
|---|
| 94 |
|
|---|
| 95 | To set up a SOAP server on a new site, run
|
|---|
| 96 | gs3-soap-deploy-site <sitename> <siteURI>
|
|---|
| 97 | where the sitename is the directory name of the site, and siteURI is a unique
|
|---|
| 98 | identifier for the sites 'web service'.
|
|---|
| 99 |
|
|---|
| 100 | |--------------|
|
|---|
| 101 | | Other notes: |
|
|---|
| 102 | |--------------|
|
|---|
| 103 |
|
|---|
| 104 | See gsdl3/docs/manual/manual.pdf for more details about the software and installation etc.
|
|---|
| 105 |
|
|---|
| 106 | 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.
|
|---|
| 107 |
|
|---|
