source: greenstone3/branches/3.03a/README-CVS.txt@ 14759

Last change on this file since 14759 was 13849, checked in by kjdon, 14 years ago

updated instructions

  • Property svn:keywords set to Author Date Id Revision
File size: 3.2 KB
Line 
1Greenstone 3 (GSDL3)
2Copyright (C) 2003 New Zealand Digital Libraries, University Of Waikato
3Greenstone3 comes with ABSOLUTELY NO WARRANTY; for details see LICENSE.txt
4This is free software, and you are welcome to redistribute it
5
6These 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
8Installing Greenstone from a CVS checkout:
9---------------------------------------------------------------------
10
11Make sure the CVS executable is on your PATH.
12
13Checkout the code:
14
15cvs -d :pserver:cvs_anon@cvs.scms.waikato.ac.nz:2402/usr/local/global-cvs/gsdl-src co greenstone3
16
17Build and install:
18
19In 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
21The '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
23The prepare/install targets will ask you if you accept the properties before starting.
24To suppress this prompt, use the -Dproperties.accepted=yes flag. E.g.
25ant -Dproperties.accepted=yes prepare install (from CVS), or
26To log the output, run
27ant -Dproperties.accepted=yes -logfile build.log prepare install (from CVS), or
28
29Extra Configuration notes:
30--------------------------------------------------------------
31
32Greenstone 3 uses some parts of Greenstone 2 for collection building,
33including external packages and the Librarian Interface. These will be
34installed during the Greenstone 3 installation process. If you do not want
35collection building capability, please set the disable.collection.building property to true in build.properties.
36
37
38Common install/update targets:
39---------------------------------------------------------------------
401. Install for the first time from CVS:
41cvs co greenstone3
42cd greenstone3
43ant prepare install
44
452. Install for the first time from CVS, mostly offline:
46[online]
47cvs co greenstone3
48cd greenstone3
49ant prepare
50[offline]
51ant install
52
533. Install for the first time, with CVS done outside of Ant (if you have problems running CVS commands from Ant):
54cvs co -P greenstone3
55cd greenstone3
56[if you want collection building:
57cvs co -P gli
58cvs co -P gs2build
59]
60[if you didn't want collection building
61cd src/packages
62cvs co indexers
63cd ../../
64]
65[if you are on windows
66cvs co winbin
67]
68ant -Dnocvs.mode=yes prepare install (prepare needs to be online, install can be done offline)
69
704. Updating your Greenstone installation from CVS (and reconfigure/recompile):
71cd greenstone3
72ant update
73
745. Updating your Greenstone installation from CVS, offline:
75cd greenstone3
76[online]
77ant cvsupdate
78[offline]
79ant -Dnocvs.mode=yes update
80
816. Updating your Greenstone installation, with CVS done outside of Ant:
82cd greenstone3
83cvs update -l
84cvs update -dP bin docs lib resources src winutil packages
85cd web (or the path-to-tomcat/webapps/greenstone3 if have installed greenstone as a webapp in Tomcat, see Using External Tomcat section)
86cvs update -dP
87cd ../
88[ if you have greenstone 2 building:
89cvs update -dP gli
90cvs checkout -P gs2build
91Note that the gs2build one uses checkout not update.
92]
93ant -Dnocvs.mode=yes update
94
Note: See TracBrowser for help on using the repository browser.