Changeset 17957

Show
Ignore:
Timestamp:
27.11.2008 21:21:34 (11 years ago)
Author:
kjdon
Message:

updated this for new source release

Files:
1 modified

Legend:

Unmodified
Added
Removed
  • gsdl/trunk/Install.txt

    r11392 r17957  
    11Note: more up-to-date notes may be available on our website, at 
    2  http://www.greenstone.org/english/docs/compiling.html 
     2 http://wiki.greenstone.org/wiki/index.php/Installing_Greenstone 
     3 
     4The following instructions assume the top level Greenstone folder is called 
     5Greenstone2 (which is the standard name used for Greenstone 2 releases).  
     6If you have got Greenstone from SVN, the top level directory will be gsdl.  
     7 
     8The Greenstone Librarian Interface (GLI) code will be in the gli folder inside 
     9the Greenstone2 folder. If you are using SVN and you want to use the GLI to  
     10build collections, you'll need to check it out by running 
     11 svn checkout http://svn.greenstone.org/gli/trunk gli 
     12in the Greenstone2 folder. 
    313 
    414-- Compiling and installing on Unix -- 
    515 
    6 cd to the top level gsdl directory (i.e. the directory where this file 
    7 lives) and perform the following three steps. 
     16cd to the top level Greenstone2 directory (i.e. the directory  
     17where this file lives) and perform the following three steps. 
    818 
    9191. ./configure 
     
    11213. make install 
    1222 
    13 This will install the library executable to gsdl/cgi-bin. If you want to 
    14 run Greenstone from a system cgi-bin directory you'll need to move the 
    15 library executable and gsdlsite.cfg from gsdl/cgi-bin to your system 
    16 cgi-bin. 
     23This will install the library and oaiserver executables to  
     24Greenstone2/cgi-bin.  
     25If you want to run Greenstone from a system  
     26cgi-bin directory you'll need to move the library executable and  
     27gsdlsite.cfg from Greenstone2/cgi-bin to your system cgi-bin. 
    1728 
    1829Note that the Greenstone directory structure is important to the operation 
     
    2031make no sense and will have no effect. If you want Greenstone to be 
    2132installed somewhere specific (say /usr/local) you'll need to move the 
    22 entire gsdl directory there. 
     33entire Greenstone2 directory there. 
     34 
     35You'll need to install Apache and set it up to serve Greenstone. Then you'll need to edit Greenstone2\cgi-bin\gsdlsite.cfg. See  
     36http://wiki.greenstone.org/wiki/index.php/Setting_up_an_Apache_Web_Server_for_Greenstone_2_Walkthrough 
     37for more details.   
     38 
     39To compile the GLI, cd to the gli directory and run makegli.sh 
    2340 
    2441-- Compiling on Windows -- 
     
    2744versions 4.2, 6.0 and 2005. If anyone succeeds in compiling Greenstone with 
    2845another compiler (or another version of VC++) we'd appreciate hearing about 
    29 it at greenstone@cs.waikato.ac.nz. 
     46it at greenstone-devel@list.scms.waikato.ac.nz 
    3047 
    31 The major difference between compiling with VC++ 4.2 compared with VC++ 6.0/2005 
    32 is that 4.2 must use the STLport standard template library (packaged with 
    33 Greenstone) while VC++ 6.0/2005 may use its own built in STL implementation. 
     48The major difference between compiling with VC++ 4.2 compared with  
     49VC++ 6.0/2005 is that 4.2 must use the STLport standard template library  
     50(packaged with Greenstone) while VC++ 6.0/2005 may use its own built in  
     51STL implementation. 
    3452 
    3553Perform the following steps to compile and install Greenstone. Note that 
     
    4058   zip files themselves are contained). 
    4159 
    42    * gsdl\packages\windows\gdbm\gdbm.zip 
    43    * gsdl\packages\windows\crypt\crypt.zip 
    44    * gsdl\packages\windows\stlport\stlport.zip (VC++ 4.2 only) 
     60   * Greenstone2\common-src\indexers\packages\windows\iconv\iconv.zip 
     61   * Greenstone2\common-src\packages\windows\gdbm\gdbm.zip 
     62   * Greenstone2\common-src\packages\windows\crypt\crypt.zip 
     63   * Greenstone2\common-src\packages\windows\expat\expat.zip 
     64   * Greenstone2\common-src\packages\windows\stlport\stlport.zip (VC++ 4.2 only) 
    4565 
    46662. To use VC++ command line tools you may need to execute the 
    4767   MSDEV\BIN\VCVARS32.BAT batch file to set up your environment. 
    4868 
    49 3. cd to the top level gsdl directory (i.e. the directory where this file 
    50    lives). 
     693. cd to the top level Greenstone2 directory (i.e. the directory where  
     70   this file lives). 
    5171 
    52 4. compile the web library (library.exe) with 
     724. compile the web library (library.exe) and OAI server (oaiserver.exe) with 
    5373   "nmake /f win32.mak GSDL_VC4=1" (VC++ 4.2) 
    5474   or 
     
    6080   "nmake /f win32.mak LOCAL_LIBRARY=1" (VC++ 6.0/2005) 
    6181 
    62 This will install library.exe to the gsdl\cgi-bin directory and server.exe 
    63 to the top level gsdl directory. 
     82This will install library.exe and oaiserver.exe to the Greenstone2\cgi-bin  
     83directory and server.exe to the top level Greenstone2 directory.  
     84 
     85To 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  
     86http://wiki.greenstone.org/wiki/index.php/Setting_up_an_Apache_Web_Server_for_Greenstone_2_Walkthrough 
     87for more details about using Apache, or  
     88http://wiki.greenstone.org/wiki/index.php/Installing_Greenstone#How_do_I_use_Greenstone.27s_web_library_with_IIS.3F 
     89for more details about using IIS. 
     90 
     91To compile the GLI, cd to the gli directory and run makegli.bat. 
     92