| 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 |
|
|---|
