Changeset 6499 for trunk/gsdl3/docs/manual

Timestamp:

2004-01-14T16:39:50+13:00 (20 years ago)

Author:

kjdon

Message:

* empty log message *

File:

• trunk/gsdl3/docs/manual/manual.tex (modified) (3 diffs)

trunk/gsdl3/docs/manual/manual.tex

@@ -1955 +1955 @@
 *** need to make sure building stuff is in here ***
 
-Greenstone 3 is also available via CVS. You can download the latest version of the code. This is not guaranteed to be stable, in fact it is likely to be unstable. The advantage of using CVS is that you can update the code and get the latest fixes. Whats in CVS is quite different to what comes in a release. The code needs to be compiled, and some files need editing...
+Greenstone 3 is also available via CVS. You can download the latest version of the code. This is not guaranteed to be stable, in fact it is likely to be unstable. The advantage of using CVS is that you can update the code and get the latest fixes. 
+
+Note that you will need the Java 2 SDK, version 1.4.0 or higher.
 
 To check out the greenstone code, use:
@@ -1974 +1976 @@
 \begin{quote}\begin{gsc}
 cd gsdl3\\
-source setup.bash\\
-install.bash\\
-source setup.bash\\
+source gs3-setup.sh\\
+./gs3-prepare.sh\\
+./gs3-configure.sh \\
+./gs3-compile.sh \\
+./gs3-finalise.sh\\
 \end{gsc}\end{quote}
 
-Note: if you are using mozilla it doesn't seem to like localhost - you should edit the siteConfig files (web/sites/<sitename>/siteConfig.xml) to have your computer name instead of localhost.
-
-Note: \gst{source setup.bash} needs to be done once in any xterm window before doing a make or running Tomcat. setup.bash sets the environment variables \gst{CLASSPATH, PATH, JAVA\_HOME} etc.
-
-To shutdown or startup Tomcat, the commands are:
+Note: \gst{source gs3-setup.sh} sets the environment variables \gst{CLASSPATH, PATH, JAVA\_HOME} and needs to be done in a shell before doing collection building etc. 
+
+To startup or shutdown the library (includes the Tomcat server and MYSQL server), the commands are:
 \begin{quote}\begin{gsc}
-\gsdlhome/comms/jakarta/tomcat/bin/shutdown.sh\\
-\gsdlhome/comms/jakarta/tomcat/bin/startup.sh\\
+./gs3-launch.sh
+./gs3-launch.sh -shutdown
 \end{gsc}\end{quote}
 
-You shouldn't run install.bash twice. 
-To update your installation, you can run update.bash - this updates your code from CVS, and re-makes all the java stuff.
-
 \subsection{Windows install}
+
+Make sure that the following environment variables are set: JAVA\_HOME (where the JAva 2 SDK is installed); PATH (should include the CVS program, and \%JAVA\_HOME\%$\backslash$bin). The following commands should be run in a DOS prompt.
+
+Run gs3-setup.bat\\
+Run gs3-prepare.bat\\
+Using Wordpad, edit the gsdl3$\backslash$comms$\backslash$jakarta$\backslash$tomcat$\backslash$conf$\backslash$server.xml file. Add
+
+\begin{quote}\begin{gsc}
+<!-- GSDL3 Service -->\\
+<Context path='/gsdl3' docBase='@gsdl3home@$\backslash$web' debug='1'
+   reloadable='true'/>
+\end{gsc}\end{quote}
+
+above the line:
+\gst{<!-- Tomcat Root Context -->}
+
+Still using Wordpad, edit the gsdl3$\backslash$comms$\backslash$jakarta$\backslash$tomcat$\backslash$conf$\backslash$web.xml file. set the value of the 'listings' parameter to false.
+
+Run make.bat\\
+Run make.bat install.\\
+Run gs3-finalise.bat\\
+
+To run Greenstone, run gs3-launch.bat. This will start the Tomcat server in a new DOS window (stop it by closing the window), and open a broser window showing the Greenstone 3 homepage.
+
 \newpage
 \section{Tomcat}\label{app:tomcat}
@@ -2053 +2076 @@
 \newpage
 \section{SOAP}\label{app:soap}
+
 \subsection{Setting up SOAP from CVS}\label{app:soap-cvs}