| 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 read the README.txt file for general information as almost all of that applies here too.
|
|---|
| 7 |
|
|---|
| 8 | Installing Greenstone from an SVN checkout:
|
|---|
| 9 | ---------------------------------------------------------------------
|
|---|
| 10 |
|
|---|
| 11 | Make sure an SVN executable is on your PATH.
|
|---|
| 12 |
|
|---|
| 13 | Checkout the code:
|
|---|
| 14 |
|
|---|
| 15 | svn co http://svn.greenstone.org/greenstone3/trunk greenstone3
|
|---|
| 16 |
|
|---|
| 17 | Build and install:
|
|---|
| 18 |
|
|---|
| 19 | In the greenstone3 directory, edit the build.properties file (see 'Configuring your installation' in README.txt), and run 'ant prepare install'. The two targets can be run separately if you like.
|
|---|
| 20 |
|
|---|
| 21 | The 'prepare' target will download additional code (using SVN and http), so you need to be online to run it. The 'install' target can be run offline.
|
|---|
| 22 |
|
|---|
| 23 | The prepare/install targets will ask you if you accept the properties before starting.
|
|---|
| 24 | To suppress this prompt, use the -Dproperties.accepted=yes flag. E.g.
|
|---|
| 25 | ant -Dproperties.accepted=yes prepare install (from CVS), or
|
|---|
| 26 | To log the output, run
|
|---|
| 27 | ant -Dproperties.accepted=yes -logfile build.log prepare install (from CVS), or
|
|---|
| 28 |
|
|---|
| 29 | Extra Configuration notes:
|
|---|
| 30 | --------------------------------------------------------------
|
|---|
| 31 |
|
|---|
| 32 | Greenstone 3 uses some parts of Greenstone 2 for collection building,
|
|---|
| 33 | including external packages and the Librarian Interface. These will be
|
|---|
| 34 | installed during the Greenstone 3 installation process. If you do not want
|
|---|
| 35 | collection building capability, please set the disable.collection.building property to true in build.properties.
|
|---|
| 36 |
|
|---|
| 37 |
|
|---|
| 38 | Common install/update targets:
|
|---|
| 39 | ---------------------------------------------------------------------
|
|---|
| 40 | 1. Install for the first time from SVN:
|
|---|
| 41 | svn co http://svn.greenstone.org/greenstone3/trunk greenstone3
|
|---|
| 42 | cd greenstone3
|
|---|
| 43 | ant prepare install
|
|---|
| 44 |
|
|---|
| 45 | 2. Install for the first time from SVN, mostly offline:
|
|---|
| 46 | [online]
|
|---|
| 47 | svn co http://svn.greenstone.org/greenstone3/trunk greenstone3
|
|---|
| 48 | cd greenstone3
|
|---|
| 49 | ant prepare
|
|---|
| 50 | [offline]
|
|---|
| 51 | ant install
|
|---|
| 52 |
|
|---|
| 53 | 3. Updating your Greenstone installation from SVN (and reconfigure/recompile):
|
|---|
| 54 | cd greenstone3
|
|---|
| 55 | ant update
|
|---|
| 56 |
|
|---|
| 57 | 4. Updating your Greenstone installation from SVN, mostly offline:
|
|---|
| 58 | cd greenstone3
|
|---|
| 59 | [online]
|
|---|
| 60 | ant svnupdate
|
|---|
| 61 | [offline]
|
|---|
| 62 | ant -Dnosvn.mode=yes update
|
|---|
| 63 |
|
|---|
