source: trunk/gsdl3/README-CVS.txt@ 13383

Last change on this file since 13383 was 13383, checked in by kjdon, 15 years ago

brought these files a bit more up to date

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