| 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 CVS. Please also read the README.txt file for general information as almost all of that applies here too.
|
|---|
| 7 |
|
|---|
| 8 | Installing Greenstone from a CVS checkout:
|
|---|
| 9 | ---------------------------------------------------------------------
|
|---|
| 10 |
|
|---|
| 11 | Make sure the CVS executable is on your PATH.
|
|---|
| 12 |
|
|---|
| 13 | Checkout the code:
|
|---|
| 14 |
|
|---|
| 15 | cvs -d :pserver:[email protected]:2402/usr/local/global-cvs/gsdl-src co 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 CVS 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 CVS:
|
|---|
| 41 | cvs co greenstone3
|
|---|
| 42 | cd greenstone3
|
|---|
| 43 | ant prepare install
|
|---|
| 44 |
|
|---|
| 45 | 2. Install for the first time from CVS, mostly offline:
|
|---|
| 46 | [online]
|
|---|
| 47 | cvs co greenstone3
|
|---|
| 48 | cd greenstone3
|
|---|
| 49 | ant prepare
|
|---|
| 50 | [offline]
|
|---|
| 51 | ant install
|
|---|
| 52 |
|
|---|
| 53 | 3. Install for the first time, with CVS done outside of Ant (if you have problems running CVS commands from Ant):
|
|---|
| 54 | cvs co -P greenstone3
|
|---|
| 55 | cd greenstone3
|
|---|
| 56 | [if you want collection building:
|
|---|
| 57 | cvs co -P gli
|
|---|
| 58 | cvs co -P gs2build
|
|---|
| 59 | ]
|
|---|
| 60 | [if you didn't want collection building
|
|---|
| 61 | cd src/packages
|
|---|
| 62 | cvs co indexers
|
|---|
| 63 | cd ../../
|
|---|
| 64 | ]
|
|---|
| 65 | [if you are on windows
|
|---|
| 66 | cvs co winbin
|
|---|
| 67 | ]
|
|---|
| 68 | ant -Dnocvs.mode=yes prepare install (prepare needs to be online, install can be done offline)
|
|---|
| 69 |
|
|---|
| 70 | 4. Updating your Greenstone installation from CVS (and reconfigure/recompile):
|
|---|
| 71 | cd greenstone3
|
|---|
| 72 | ant update
|
|---|
| 73 |
|
|---|
| 74 | 5. Updating your Greenstone installation from CVS, offline:
|
|---|
| 75 | cd greenstone3
|
|---|
| 76 | [online]
|
|---|
| 77 | ant cvsupdate
|
|---|
| 78 | [offline]
|
|---|
| 79 | ant -Dnocvs.mode=yes update
|
|---|
| 80 |
|
|---|
| 81 | 6. Updating your Greenstone installation, with CVS done outside of Ant:
|
|---|
| 82 | cd greenstone3
|
|---|
| 83 | cvs update -l
|
|---|
| 84 | cvs update -dP bin docs lib resources src winutil packages
|
|---|
| 85 | cd web (or the path-to-tomcat/webapps/greenstone3 if have installed greenstone as a webapp in Tomcat, see Using External Tomcat section)
|
|---|
| 86 | cvs update -dP
|
|---|
| 87 | cd ../
|
|---|
| 88 | [ if you have greenstone 2 building:
|
|---|
| 89 | cvs update -dP gli
|
|---|
| 90 | cvs checkout -P gs2build
|
|---|
| 91 | Note that the gs2build one uses checkout not update.
|
|---|
| 92 | ]
|
|---|
| 93 | ant -Dnocvs.mode=yes update
|
|---|
| 94 |
|
|---|
