Changeset 17957

Timestamp:

2008-11-27T21:21:34+13:00 (15 years ago)

Author:

kjdon

Message:

updated this for new source release

File:

• gsdl/trunk/Install.txt (modified) (6 diffs)

gsdl/trunk/Install.txt

@@ -1 +1 @@
 Note: more up-to-date notes may be available on our website, at
- http://www.greenstone.org/english/docs/compiling.html
+ http://wiki.greenstone.org/wiki/index.php/Installing_Greenstone
+
+The following instructions assume the top level Greenstone folder is called
+Greenstone2 (which is the standard name used for Greenstone 2 releases). 
+If you have got Greenstone from SVN, the top level directory will be gsdl. 
+
+The Greenstone Librarian Interface (GLI) code will be in the gli folder inside
+the Greenstone2 folder. If you are using SVN and you want to use the GLI to 
+build collections, you'll need to check it out by running
+ svn checkout http://svn.greenstone.org/gli/trunk gli
+in the Greenstone2 folder.
 
 -- Compiling and installing on Unix --
 
-cd to the top level gsdl directory (i.e. the directory where this file
-lives) and perform the following three steps.
+cd to the top level Greenstone2 directory (i.e. the directory 
+where this file lives) and perform the following three steps.
 
 1. ./configure
@@ -11 +21 @@
 3. make install
 
-This will install the library executable to gsdl/cgi-bin. If you want to
-run Greenstone from a system cgi-bin directory you'll need to move the
-library executable and gsdlsite.cfg from gsdl/cgi-bin to your system
-cgi-bin.
+This will install the library and oaiserver executables to 
+Greenstone2/cgi-bin. 
+If you want to run Greenstone from a system 
+cgi-bin directory you'll need to move the library executable and 
+gsdlsite.cfg from Greenstone2/cgi-bin to your system cgi-bin.
 
 Note that the Greenstone directory structure is important to the operation
@@ -20 +31 @@
 make no sense and will have no effect. If you want Greenstone to be
 installed somewhere specific (say /usr/local) you'll need to move the
-entire gsdl directory there.
+entire Greenstone2 directory there.
+
+You'll need to install Apache and set it up to serve Greenstone. Then you'll need to edit Greenstone2\cgi-bin\gsdlsite.cfg. See 
+http://wiki.greenstone.org/wiki/index.php/Setting_up_an_Apache_Web_Server_for_Greenstone_2_Walkthrough
+for more details.  
+
+To compile the GLI, cd to the gli directory and run makegli.sh
 
 -- Compiling on Windows --
@@ -27 +44 @@
 versions 4.2, 6.0 and 2005. If anyone succeeds in compiling Greenstone with
 another compiler (or another version of VC++) we'd appreciate hearing about
-it at greenstone@cs.waikato.ac.nz.
+it at greenstone[email protected]
 
-The major difference between compiling with VC++ 4.2 compared with VC++ 6.0/2005
-is that 4.2 must use the STLport standard template library (packaged with
-Greenstone) while VC++ 6.0/2005 may use its own built in STL implementation.
+The major difference between compiling with VC++ 4.2 compared with 
+VC++ 6.0/2005 is that 4.2 must use the STLport standard template library 
+(packaged with Greenstone) while VC++ 6.0/2005 may use its own built in 
+STL implementation.
 
 Perform the following steps to compile and install Greenstone. Note that
@@ -40 +58 @@
    zip files themselves are contained).
 
-   * gsdl\packages\windows\gdbm\gdbm.zip
-   * gsdl\packages\windows\crypt\crypt.zip
-   * gsdl\packages\windows\stlport\stlport.zip (VC++ 4.2 only)
+   * Greenstone2\common-src\indexers\packages\windows\iconv\iconv.zip
+   * Greenstone2\common-src\packages\windows\gdbm\gdbm.zip
+   * Greenstone2\common-src\packages\windows\crypt\crypt.zip
+   * Greenstone2\common-src\packages\windows\expat\expat.zip
+   * Greenstone2\common-src\packages\windows\stlport\stlport.zip (VC++ 4.2 only)
 
 2. To use VC++ command line tools you may need to execute the
    MSDEV\BIN\VCVARS32.BAT batch file to set up your environment.
 
-3. cd to the top level gsdl directory (i.e. the directory where this file
-   lives).
+3. cd to the top level Greenstone2 directory (i.e. the directory where 
+   this file lives).
 
-4. compile the web library (library.exe) with
+4. compile the web library (library.exe) and OAI server (oaiserver.exe) with
    "nmake /f win32.mak GSDL_VC4=1" (VC++ 4.2)
    or
@@ -60 +80 @@
    "nmake /f win32.mak LOCAL_LIBRARY=1" (VC++ 6.0/2005)
 
-This will install library.exe to the gsdl\cgi-bin directory and server.exe
-to the top level gsdl directory.
+This will install library.exe and oaiserver.exe to the Greenstone2\cgi-bin 
+directory and server.exe to the top level Greenstone2 directory. 
+
+To run the web library you'll need to set up a web server to serve Greenstone. Then you'll need to edit Greenstone2\cgi-bin\gsdlsite.cfg. See 
+http://wiki.greenstone.org/wiki/index.php/Setting_up_an_Apache_Web_Server_for_Greenstone_2_Walkthrough
+for more details about using Apache, or 
+http://wiki.greenstone.org/wiki/index.php/Installing_Greenstone#How_do_I_use_Greenstone.27s_web_library_with_IIS.3F
+for more details about using IIS.
+
+To compile the GLI, cd to the gli directory and run makegli.bat.
+