1 | Greenstone 3 (GSDL3)
|
---|
2 | Copyright (C) 2003 New Zealand Digital Libraries, University Of Waikato
|
---|
3 | Greenstone3 comes with ABSOLUTELY NO WARRANTY; for details see LICENSE.txt
|
---|
4 | This is free software, and you are welcome to redistribute it
|
---|
5 |
|
---|
6 | These are some extra notes for installing Greenstone from SVN. Please also
|
---|
7 | read the README.txt file for general information as almost all of that applies
|
---|
8 | here too.
|
---|
9 |
|
---|
10 | You will need Java and Ant to run Greenstone 3.
|
---|
11 |
|
---|
12 | Your Java version should be 1.4 or higher. We recommend Sun Java. You need the
|
---|
13 | SDK (development environment). Set the environment variable JAVA_HOME to be
|
---|
14 | the root of your Java installation.
|
---|
15 |
|
---|
16 | Ant (Apache's Java based build tool) can be downloaded from
|
---|
17 | http://ant.apache.org/bindownload.cgi. Set the environment variable
|
---|
18 | ANT_HOME to be the root of your Ant installation, and make sure the Ant
|
---|
19 | executables are on your PATH.
|
---|
20 | Greenstone 3 requires Ant 1.7.1 or higher.
|
---|
21 |
|
---|
22 | Installing Greenstone from an SVN checkout:
|
---|
23 | ---------------------------------------------------------------------
|
---|
24 |
|
---|
25 | Make sure an SVN executable is on your PATH.
|
---|
26 |
|
---|
27 | Checkout the code:
|
---|
28 |
|
---|
29 | svn co http://svn.greenstone.org/greenstone3/trunk greenstone3
|
---|
30 |
|
---|
31 | Build and install:
|
---|
32 |
|
---|
33 |
|
---|
34 | In the greenstone3 directory, check and/or edit the build.properties file. In
|
---|
35 | particular, set the Tomcat port number. See 'Configuring your installation' in
|
---|
36 | README.txt for more information.
|
---|
37 |
|
---|
38 | Note, initial checkouts from SVN have a build.properties.in file. Running
|
---|
39 | 'ant' will result in the build.properties file being generated from the .in
|
---|
40 | file (a straight copy).
|
---|
41 |
|
---|
42 | Then, run 'ant prepare install'. The two targets can be run separately if you
|
---|
43 | like.
|
---|
44 |
|
---|
45 | The 'prepare' target will download additional code (using SVN and http), so
|
---|
46 | you need to be online to run it. The 'install' target can be run offline.
|
---|
47 |
|
---|
48 | The prepare/install targets will ask you if you accept the properties before
|
---|
49 | starting.
|
---|
50 | To suppress this prompt, use the -Dproperties.accepted=yes flag. E.g.
|
---|
51 | ant -Dproperties.accepted=yes prepare install
|
---|
52 |
|
---|
53 | To log the output, run
|
---|
54 | ant -Dproperties.accepted=yes -logfile build.log prepare install
|
---|
55 |
|
---|
56 | On Windows, Visual Studio is used for compiling. The VCVARS32.bat script needs
|
---|
57 | to be run in the command prompt before compiling with "ant install".
|
---|
58 |
|
---|
59 | In the greenstone3 directory, you can run 'ant' which will give you a help
|
---|
60 | message.
|
---|
61 | Running 'ant -projecthelp' gives a list of the targets that you can run - these
|
---|
62 | do various things like compile the source code, start up the server etc.
|
---|
63 |
|
---|
64 | Extra Configuration notes:
|
---|
65 | --------------------------------------------------------------
|
---|
66 |
|
---|
67 | Greenstone 3 uses some parts of Greenstone 2 for collection building,
|
---|
68 | including external packages and the Librarian Interface. These will be
|
---|
69 | installed during the Greenstone 3 installation process. If you do not want
|
---|
70 | collection building capability, please set the disable.collection.building
|
---|
71 | property to true in build.properties.
|
---|
72 |
|
---|
73 |
|
---|
74 | Common install/update targets:
|
---|
75 | ---------------------------------------------------------------------
|
---|
76 | 1. Install for the first time from SVN:
|
---|
77 | svn co http://svn.greenstone.org/greenstone3/trunk greenstone3
|
---|
78 | cd greenstone3
|
---|
79 | ant prepare install
|
---|
80 |
|
---|
81 | 2. Install for the first time from SVN, mostly offline:
|
---|
82 | [online]
|
---|
83 | svn co http://svn.greenstone.org/greenstone3/trunk greenstone3
|
---|
84 | cd greenstone3
|
---|
85 | ant prepare
|
---|
86 | [offline]
|
---|
87 | ant install
|
---|
88 |
|
---|
89 | 3. Updating your Greenstone installation from SVN (and reconfigure/recompile):
|
---|
90 | cd greenstone3
|
---|
91 | ant update
|
---|
92 |
|
---|
93 | 4. Updating your Greenstone installation from SVN, mostly offline:
|
---|
94 | cd greenstone3
|
---|
95 | [online]
|
---|
96 | ant svnupdate
|
---|
97 | [offline]
|
---|
98 | ant -Dnosvn.mode=yes update
|
---|
99 |
|
---|