Changeset 9832

Timestamp:

2005-05-06T11:27:47+12:00 (19 years ago)

Author:

kjdon

Message:

more notes

File:

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

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

@@ -29 +29 @@
 Environment (1.4 or higher), and Ant installed to use Greenstone. You can download Ant from http://ant.apache.org/bindownload.cgi.
 
-In the gsdl3 directory, you can run ant which will give you a help message.
+In the gsdl3 directory, you can run 'ant' which will give you a help message.
 Running 'ant -projecthelp' gives a list of the targets that you can run - these
 do various things like compile the source code, startup the server etc.
@@ -35 +35 @@
 For a first time install, run 'ant install'.
 
-The file build.properties contains various parameters that can be set by the user.
-
+The file build.properties contains various parameters that can be set by the user. Please check these settings before running 'ant install'. The install process will ask you if you accept the properties before starting.
 For a  non-interactive version of the install, run
 ant -Dproperties.accepted=yes install
@@ -43 +42 @@
 ant -Dproperties.accepted=yes -logfile build.log install
 
+Under Linux, Java and C/C++ compilation is carried out. For windows, since Visual Studio is not a standard component, only Java compilation is carried out. Pre-compiled binaries are provided for the C/C++ components (packages and Greenstone 2 style building). If you have Visual Studio installed (version 6), you can run the compile-windows-c++ targets to compile the code locally. (Don't forget to setup the Visual Studio environment first, by running, e.g. C:/Program Files/Microsoft Visual Studio/VC98/Bin/VCVARS32.BAT or equivalent.)
+
 Running Greenstone:
 -------------------
 
-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.
+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.
@@ -64 +65 @@
 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:
+
+You need to have Perl installed and on your PATH.
 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).
+
+In the gsdl3 directory, run: 'source gs3-setup.sh' (linux) or 'gs3-setup' (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.
+Rename the building directory to index (in gsdl3/web/sites/<sitename>/collect/<collname>) and reload the collection in Tomcat (?a=s&sa=a&st=collection&sn=<collname>), or restart Tomcat.
 
 See the manual for more details about both styles of collection building.
@@ -87 +91 @@
 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.
 
+ant can't seem to do cvs using pserver cvs on windows:
+there were some classes missing - www.ibiblio.org/maven/jsch/jars/jsch-0.1.17.jar
+many ssh processes seemed to be started up - all waiting in the background for password??
+So should only use anonymous cvs.
+