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