| 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 | (cvs co gsdl3) (if not already done)
|
|---|
| 19 | cd gsdl3
|
|---|
| 20 | source gs3-setup.sh
|
|---|
| 21 | ./gs3-prepare.sh
|
|---|
| 22 | ./configure
|
|---|
| 23 | make
|
|---|
| 24 | make install
|
|---|
| 25 | [make docs] (for the javadoc)
|
|---|
| 26 | ./gs3-finalise.sh
|
|---|
| 27 |
|
|---|
| 28 | 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.
|
|---|
| 29 |
|
|---|
| 30 | Running Greenstone:
|
|---|
| 31 | -------------------
|
|---|
| 32 |
|
|---|
| 33 | 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
|
|---|
| 34 |
|
|---|
| 35 | Using SOAP:
|
|---|
| 36 | -----------
|
|---|
| 37 |
|
|---|
| 38 | To install SOAP into Tomcat (SOAP runs as a servlet), run
|
|---|
| 39 | ./gs3-install-soap.sh
|
|---|
| 40 | Then re-launch Greenstone.
|
|---|
| 41 |
|
|---|
| 42 | A SOAP server for localsite comes predeployed.
|
|---|
| 43 | You should be able to see all localsite's collections through the gateway servlet.
|
|---|
| 44 |
|
|---|
| 45 | To set up a SOAP server on a new site, run
|
|---|
| 46 | gs3-soap-deploy-site <sitename> <siteURI>
|
|---|
| 47 | where the sitename is the directory name of the site, and siteURI is a unique
|
|---|
| 48 | identifier for the sites 'web service'.
|
|---|
| 49 |
|
|---|
| 50 |
|
|---|
| 51 |
|
|---|
| 52 | |----------|
|
|---|
| 53 | | Windows: |
|
|---|
| 54 | |----------|
|
|---|
| 55 |
|
|---|
| 56 | Installing Greenstone from a binary distribution:
|
|---|
| 57 | -------------------------------------------------
|
|---|
| 58 |
|
|---|
| 59 | Download the gsdl3-x.xx-win32.exe executable file, and double click on it.
|
|---|
| 60 |
|
|---|
| 61 | To run Greenstone, select Greenstone 3 Digital Library from the Start menu.
|
|---|
| 62 |
|
|---|
| 63 | Installing Greenstone from a CVS checkout:
|
|---|
| 64 | ------------------------------------------
|
|---|
| 65 |
|
|---|
| 66 | (cvs co gsdl3) (if not already done)
|
|---|
| 67 | cd gsdl3
|
|---|
| 68 | gs3-setup
|
|---|
| 69 | gs3-prepare
|
|---|
| 70 |
|
|---|
| 71 | Using Wordpad, edit the gsdl3\comms\jakarta\tomcat\conf\server.xml file. Add:
|
|---|
| 72 |
|
|---|
| 73 | <!-- GSDL3 Service -->
|
|---|
| 74 | <Context path="/gsdl3" docBase="@gsdl3home@\web" debug="1" reloadable="true"/>
|
|---|
| 75 |
|
|---|
| 76 | above this line:
|
|---|
| 77 |
|
|---|
| 78 | <!-- Tomcat Root Context -->
|
|---|
| 79 |
|
|---|
| 80 | Still using Wordpad, edit the gsdl3\comms\jakarta\tomcat\conf\web.xml file. Set the value of the "listings" servlet parameter to "false".
|
|---|
| 81 |
|
|---|
| 82 | make
|
|---|
| 83 | make install
|
|---|
| 84 | gs3-finalise
|
|---|
| 85 |
|
|---|
| 86 | To run Greenstone, run
|
|---|
| 87 | gs3-launch
|
|---|
| 88 |
|
|---|
| 89 | |--------------|
|
|---|
| 90 | | Other notes: |
|
|---|
| 91 | |--------------|
|
|---|
| 92 |
|
|---|
| 93 | See gsdl3/docs/manual/manual.pdf for more details about the software and installation etc.
|
|---|
| 94 |
|
|---|
| 95 | Note: the windows version doesn't have greenstone 3 native building yet.
|
|---|
