Changeset 9788

Timestamp:

2005-04-29T16:41:22+12:00 (19 years ago)

Author:

kjdon

Message:

added more ant info

File:

• branches/ant-install-branch/gsdl3/README.txt (modified) (3 diffs)

branches/ant-install-branch/gsdl3/README.txt

@@ -37 +37 @@
 The file build.properties contains various parameters that can be set by the user.
 
+For a  non-interactive version of the install, run
+ant -Dproperties.accepted=yes install
+
+To log the output in build.log, run
+ant -Dproperties.accepted=yes -logfile build.log install
 
 Running Greenstone:
 -------------------
 
-To startup the servers, run 'ant startup'. 'ant restart' and 'ant shutdown' restarts and shuts down the servers.
+To startup the servers, run 'ant startup'. 'ant restart' and 'ant shutdown' restarts and shuts down the servers. TO start or stop just Tomcat or MYSQL, use the startup-tomcat, startup-mysql, shutdown-tomcat, shutdown-mysql targets.
 
-On Windows, if you have installed a binary version, you can also start Greenstone by  selecting Greenstone 3 Digital Library from the Start menu.
+On Windows, if you have installed a binary version, you can also start Greenstone by selecting Greenstone 3 Digital Library from the Start menu.
 
 Using SOAP (Linux and Windows):
@@ -54 +59 @@
 This will prompt you for the sitename (the directory name), and the site uri - this should be a unique identifier for the site's web service.
 
+For a non-interactive version, run
+ant -Daxis.sitename=xxx -Daxis.siteuri=yyy soap-deploy-site
+
 Building Collections:
 -----------------------
 Windows: need to have Perl installed and on your PATH.
+
+You can build collections using either Greenstone 2 style building, or native Greenstone 3 style.
+Greenstone 2:
+run  'ant gli", or cd to gsdl3/gli and run gli4gs3.sh/bat. This is a graphical tool for building collections.
+
+Greenstone 3:
+in the gsdl3 directory, run: source gs3-setup.sh (linux) or gs3-sestup (windows).
+To create a new collection, run 'gs3-mkcol.sh/bat <sitename> <collname>'
+Put documents in the import directory (gsdl3/web/sites/<sitename>/collect/<collname>/import), edit the collection configuration file (gsdl3/web/sites/<sitename>/collect/<collname>/etc/collectionConfig.xml), and run 'gs3-build.sh <sitename> <collname>'
+Rename the building directory to index (in gsdl3/web/sites/<sitename>/collect/<collname>) and reload the collection in Tomcat, or restart Tomcat.
+
+See the manual for more details about both styles of collection building.
 
 Other Notes:
@@ -63 +83 @@
 See gsdl3/docs/manual/manual.pdf for more details about the software and installation etc.
 
-Tomcat logs output in gsdl3/comms/jakarta/tomcat/logs/catalina.out.
+Under Linux, Tomcat logs output in gsdl3/comms/jakarta/tomcat/logs/catalina.out.
 
 To prevent Tomcat showing directory listings, edit the gsdl3/comms/jakarta/tomcat/conf/web.xml file and set the value of the "listings" servlet parameter to false.