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/src/packages
|
---|
56 | cvs co mgpp
|
---|
57 | cd ../..
|
---|
58 | [if you want greenstone 2 building:
|
---|
59 | cvs co -P gli
|
---|
60 | cvs co -P gs2build
|
---|
61 | ]
|
---|
62 | [if you are on windows
|
---|
63 | cvs co winbin
|
---|
64 | ]
|
---|
65 | ant -Dnocvs.mode=yes prepare install (prepare needs to be online, install can be done offline)
|
---|
66 |
|
---|
67 | 4. Updating your Greenstone installation from CVS (and reconfigure/recompile):
|
---|
68 | cd greenstone3
|
---|
69 | ant update
|
---|
70 |
|
---|
71 | 5. Updating your Greenstone installation from CVS, offline:
|
---|
72 | cd greenstone3
|
---|
73 | [online]
|
---|
74 | ant cvsupdate
|
---|
75 | [offline]
|
---|
76 | ant -Dnocvs.mode=yes update
|
---|
77 |
|
---|
78 | 6. Updating your Greenstone installation, with CVS done outside of Ant:
|
---|
79 | cd greenstone3
|
---|
80 | cvs update -l
|
---|
81 | cvs update -dP bin docs lib resources src winutil packages
|
---|
82 | cd web (or the path-to-tomcat/webapps/greenstone3 if have installed greenstone as a webapp in Tomcat, see Using External Tomcat section)
|
---|
83 | cvs update -dP
|
---|
84 | cd ../
|
---|
85 | [ if you have greenstone 2 building:
|
---|
86 | cvs update -dP gli
|
---|
87 | cvs checkout -P gs2build
|
---|
88 | Note that the gs2build one uses checkout not update.
|
---|
89 | ]
|
---|
90 | ant -Dnocvs.mode=yes update
|
---|
91 |
|
---|