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