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