Changeset 36234


Ignore:
Timestamp:
2022-05-31T13:26:19+12:00 (5 weeks ago)
Author:
kjdon
Message:

made this a bit more up to date, using the makegs2 scripts.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • main/trunk/greenstone2/Install.txt

    r30378 r36234  
     1Compiling and Installing Greenstone 2
     2--------------------------------------
    13
    24Note: more up-to-date notes may be available on our website, at
    3  http://wiki.greenstone.org/wiki/index.php/Installing_Greenstone
     5http://wiki.greenstone.org/doku.php?id=en:user_advanced:installation
     6 
    47
    58The following instructions assume the top level Greenstone folder is called
    6 Greenstone (which is the standard name used for Greenstone 2 releases).
    7 If you have got Greenstone from SVN, the top level directory will be greenstone2.
     9Greenstone2. Please adjust these instructions to match the folder name in
     10your situation.
    811
    912The Greenstone Librarian Interface (GLI) code will be in the gli folder inside
    10 the Greenstone folder. If you are using SVN and you want to use the GLI to
    11 build collections, you'll need to check it out by running
     13the Greenstone2 folder (if you have a Greenstone release). If you are using
     14SVN and you want to use the GLI to build collections, you'll need to check
     15it out by running
    1216 svn checkout http://svn.greenstone.org/main/trunk/gli
    13 in the Greenstone folder.
     17in the Greenstone2 folder.
    1418
    1519-- Compiling and installing on Unix --
    1620
    17 cd to the top level Greenstone directory (i.e. the directory
    18 where this file lives) and perform the following three steps.
     21cd to the top level Greenstone2 directory (i.e. the directory
     22where this file lives) and run the following:
    1923
    20 1. ./configure --enable-apache-httpd
    21 2. make
    22 3. make install
     241. makegs2.sh gnome-lib imagemagick
     252. cd gli
     263. ./makegli.sh
     274. ./makejar.sh
    2328
    24 This will install the library.cgi and oaiserver.cgi executables to
    25 Greenstone/cgi-bin/linux.
    26 If you want to run Greenstone from a system
    27 cgi-bin directory you'll need to move the library executable and
    28 gsdlsite.cfg from Greenstone/cgi-bin/linux to your system cgi-bin.
     29Notes:
     301. [gnome-lib] parameter: This will checkout and compile gnome-lib.
     31gnome-lib is needed on most linux machines to compile wvware. If you
     32don't need it. you can omit this parameter. If you need it but don't want
     33to compile it, you can download a gnome-lib-minimal package for your OS by
     34visiting http://trac.greenstone.org/browser/gs2-extensions/gnome-lib/trunk
     35(choose the appropriate package for your OS)
     36Then unzip the downloaded gnome-lib minimal package into your Greenstone2/ext
     37folder.
     382. [imagemagick] parameter - if you already have imagemagick installed, or
     39don't want it, you can omit this parameter.
     40
     413. CGI executables - This will install the library.cgi and oaiserver.cgi
     42executables to Greenstone2/cgi-bin/linux.
     43If you want to run Greenstone from a system cgi-bin directory you'll need to
     44move the library executable and gsdlsite.cfg from Greenstone2/cgi-bin/linux
     45to your system cgi-bin.
     464. The steps 2-4 are for compiling the Greenstone Librarian interface.
    2947
    3048Note that the Greenstone directory structure is important to the operation
    31 of the software. Therefore the --prefix, --bindir etc. options to configure
     49of the software. Therefore the --prefix, --bindir etc. options to configure (which is run by makegs2.sh)
    3250make no sense and will have no effect. If you want Greenstone to be
    3351installed somewhere specific (say /usr/local) you'll need to move the
    34 entire Greenstone directory there.
     52entire Greenstone2 directory there.
    3553
    3654Greenstone will install Apache into apache-httpd/linux. You can disable this
    37 by running ./configure without the -enable-apache-httpd option. In that case
    38 you'll need to set up your own apache to serve Greenstone. See   See
    39 http://wiki.greenstone.org/wiki/index.php/Setting_up_an_Apache_Web_Server_for_Greenstone_2_Walkthrough
     55by editing makegs2.sh and removing the -enable-apache-httpd option to the
     56configure command. In that case you'll need to set up your own apache to
     57serve Greenstone. See
     58http://wiki.greenstone.org/doku.php?id=en:user_advanced:gs2_server
    4059for more details. 
    4160
    42 To compile the GLI, cd to the gli directory and run makegli.sh
     61
    4362
    4463-- Compiling on Windows --
    4564
    46 Greenstone has been successfully compiled using Microsoft Visual C++
    47 versions 4.2, 6.0 and 2005. If anyone succeeds in compiling Greenstone with
    48 another compiler (or another version of VC++) we'd appreciate hearing about
    49 it at greenstone-devel@list.scms.waikato.ac.nz
    50 
    51 If you have got Greenstone from svn, you'll also need to download some Windows binaries.
    52 1. cd to top-level greenstone2 folder.
    53 2. cd bin
    54 3. svn co http://svn.greenstone.org/main/trunk/binaries/windows/bin windows
    55 
     65Prerequisites:
     66 * Java JDK 8 or later
     67 * PERL (ActivePerl for Windows
     68 * Visual Studio 8 or later
    5669
    5770There is a batch script you can run to set up and compile Greenstone.
     
    7184
    7285
    73 For more information about compiling Greenstone, or for manual compling
     86For more information about compiling Greenstone, or for manual compiling
    7487instructions, see
    75 http://wiki.greenstone.org/wiki/index.php/Compiling_Greenstone
     88http://wiki.greenstone.org/doku.php?id=en:user_advanced:installation
     89http://wiki.greenstone.org/doku.php?id=en:developer:windows_source_install
    7690
    7791These scripts will unpack necessary zip files, set up paths etc, then compile
     
    8094directory and server.exe to the top level Greenstone directory.
    8195
    82 To run the web library you'll need to set up a web server to serve Greenstone.
    83 Then you'll need to edit Greenstone\cgi-bin\gsdlsite.cfg. See
    84 http://wiki.greenstone.org/wiki/index.php/Setting_up_an_Apache_Web_Server_for_Greenstone_2_Walkthrough
    85 for more details about using Apache, or
    86 http://wiki.greenstone.org/wiki/index.php/Installing_Greenstone#How_do_I_use_Greenstone.27s_web_library_with_IIS.3F
    87 for more details about using IIS.
    88 
    8996To compile the GLI, cd to the gli directory and run makegli.bat.
    9097
Note: See TracChangeset for help on using the changeset viewer.