[6444] | 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 |
|
---|
[6471] | 6 | |--------|
|
---|
| 7 | | Linux: |
|
---|
| 8 | |--------|
|
---|
[6444] | 9 |
|
---|
[6471] | 10 | Installing Greenstone from a binary distribution:
|
---|
| 11 | -------------------------------------------------
|
---|
[6444] | 12 |
|
---|
[7805] | 13 | Download the gsdl3-x.xx-linux executable file, and run it. Follow the instructions given.
|
---|
[6471] | 14 |
|
---|
| 15 | Installing Greenstone from a CVS checkout:
|
---|
| 16 | ------------------------------------------
|
---|
| 17 |
|
---|
| 18 | (cvs co gsdl3) (if not already done)
|
---|
[6444] | 19 | cd gsdl3
|
---|
[7892] | 20 | ./gs3-install.sh
|
---|
[6444] | 21 |
|
---|
[7984] | 22 | If you change the source and want to compile it again later, you can run 'make' then 'make install' from this directory.
|
---|
[7892] | 23 |
|
---|
[7813] | 24 | 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'.
|
---|
[6444] | 25 |
|
---|
[8428] | 26 | Greenstone requires Java 1.4.
|
---|
| 27 |
|
---|
[6471] | 28 | Running Greenstone:
|
---|
| 29 | -------------------
|
---|
[6444] | 30 |
|
---|
[6471] | 31 | 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
|
---|
[6444] | 32 |
|
---|
[6471] | 33 | Using SOAP:
|
---|
[7984] | 34 | ------------
|
---|
[6444] | 35 |
|
---|
[7984] | 36 | Greenstone comes setup to use SOAP. SOAP runs as a servlet inside Tomcat, and is disabled by default. To enable it, run
|
---|
| 37 | ./gs3-enable-soap.sh
|
---|
| 38 | Then re-launch Greenstone:
|
---|
| 39 | ./gs3-launch.sh -shutdown
|
---|
| 40 | ./gs3-launch.sh
|
---|
[6471] | 41 |
|
---|
[7805] | 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
|
---|
[7984] | 46 | gs3-soap-deploy-site.sh <sitename> <siteURI>
|
---|
[7805] | 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 |
|
---|
[6471] | 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
|
---|
[7891] | 68 | gs3-install
|
---|
[6444] | 69 |
|
---|
[6471] | 70 | To run Greenstone, run
|
---|
| 71 | gs3-launch
|
---|
[7984] | 72 | This starts up the Tomcat web server and mysql database server.
|
---|
[6471] | 73 |
|
---|
[7984] | 74 | Using SOAP:
|
---|
| 75 | ------------
|
---|
| 76 |
|
---|
| 77 | Greenstone comes setup to use SOAP. SOAP runs as a servlet inside Tomcat, and is disabled by default. To enable it, run
|
---|
| 78 | gs3-enable-soap
|
---|
| 79 | Then shutdown and restart Greenstone.
|
---|
| 80 |
|
---|
| 81 | A SOAP server for localsite comes predeployed.
|
---|
| 82 | You should be able to see all localsite's collections through the gateway servlet.
|
---|
| 83 |
|
---|
| 84 | To set up a SOAP server on a new site, run
|
---|
| 85 | gs3-soap-deploy-site <sitename> <siteURI>
|
---|
| 86 | where the sitename is the directory name of the site, and siteURI is a unique
|
---|
| 87 | identifier for the sites 'web service'.
|
---|
| 88 |
|
---|
[6471] | 89 | |--------------|
|
---|
| 90 | | Other notes: |
|
---|
| 91 | |--------------|
|
---|
| 92 |
|
---|
| 93 | See gsdl3/docs/manual/manual.pdf for more details about the software and installation etc.
|
---|
| 94 |
|
---|
[7891] | 95 | 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.
|
---|
| 96 |
|
---|