| 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 using the Librarian Interface. These will be installed during the Greenstone 3 installation process. If you have Greenstone 2 already installed and want to use that version instead (or don't want to use it at all), please set the gsdl2.installed.path property (in build.properties) to be the root of your Greenstone 2 installation, or any non-empty string. Greenstone 3 will then use this installation rather than its own version. (Note, be careful about compatibility between versions.)
|
|---|
| 33 |
|
|---|
| 34 |
|
|---|
| 35 | Common install/update targets:
|
|---|
| 36 | ---------------------------------------------------------------------
|
|---|
| 37 | 1. Install for the first time from CVS:
|
|---|
| 38 | cvs co greenstone3
|
|---|
| 39 | cd greenstone3
|
|---|
| 40 | ant prepare install
|
|---|
| 41 |
|
|---|
| 42 | 2. Install for the first time from CVS, mostly offline:
|
|---|
| 43 | [online]
|
|---|
| 44 | cvs co greenstone3
|
|---|
| 45 | cd greenstone3
|
|---|
| 46 | ant prepare
|
|---|
| 47 | [offline]
|
|---|
| 48 | ant install
|
|---|
| 49 |
|
|---|
| 50 | 3. Install for the first time, with CVS done outside of Ant (if you have problems running CVS commands from Ant):
|
|---|
| 51 | cvs co -P greenstone3
|
|---|
| 52 | cd greenstone3/src/packages
|
|---|
| 53 | cvs co mgpp
|
|---|
| 54 | cd ../..
|
|---|
| 55 | [if you want greenstone 2 building:
|
|---|
| 56 | cvs co -P gli
|
|---|
| 57 | cvs co -P gs2build
|
|---|
| 58 | ]
|
|---|
| 59 | [if you are on windows
|
|---|
| 60 | cvs co winbin
|
|---|
| 61 | ]
|
|---|
| 62 | ant -Dnocvs.mode=yes prepare install (prepare needs to be online, install can be done offline)
|
|---|
| 63 |
|
|---|
| 64 | 4. Updating your Greenstone installation from CVS (and reconfigure/recompile):
|
|---|
| 65 | cd greenstone3
|
|---|
| 66 | ant update
|
|---|
| 67 |
|
|---|
| 68 | 5. Updating your Greenstone installation from CVS, offline:
|
|---|
| 69 | cd greenstone3
|
|---|
| 70 | [online]
|
|---|
| 71 | ant cvsupdate
|
|---|
| 72 | [offline]
|
|---|
| 73 | ant -Dnocvs.mode=yes update
|
|---|
| 74 |
|
|---|
| 75 | 6. Updating your Greenstone installation, with CVS done outside of Ant:
|
|---|
| 76 | cd greenstone3
|
|---|
| 77 | cvs update -l
|
|---|
| 78 | cvs update -dP extensions bin docs lib resources src winutil packages
|
|---|
| 79 | cd web (or the path-to-tomcat/webapps/greenstone3 if have installed greenstone as a webapp in Tomcat, see Using External Tomcat section)
|
|---|
| 80 | cvs update -dP
|
|---|
| 81 | cd greenstone3
|
|---|
| 82 | [ if you have greenstone 2 building:
|
|---|
| 83 | cvs update -dP gli
|
|---|
| 84 | cvs checkout -P gs2build
|
|---|
| 85 | Note that the gs2build one uses checkout not update.
|
|---|
| 86 | ]
|
|---|
| 87 | ant -Dnocvs.mode=yes update
|
|---|
| 88 |
|
|---|
