[36234] | 1 | Compiling and Installing Greenstone 2
|
---|
| 2 | --------------------------------------
|
---|
[30378] | 3 |
|
---|
[2635] | 4 | Note: more up-to-date notes may be available on our website, at
|
---|
[36234] | 5 | http://wiki.greenstone.org/doku.php?id=en:user_advanced:installation
|
---|
| 6 |
|
---|
[2403] | 7 |
|
---|
[17957] | 8 | The following instructions assume the top level Greenstone folder is called
|
---|
[36234] | 9 | Greenstone2. Please adjust these instructions to match the folder name in
|
---|
| 10 | your situation.
|
---|
[17957] | 11 |
|
---|
| 12 | The Greenstone Librarian Interface (GLI) code will be in the gli folder inside
|
---|
[36234] | 13 | the Greenstone2 folder (if you have a Greenstone release). If you are using
|
---|
| 14 | SVN and you want to use the GLI to build collections, you'll need to check
|
---|
| 15 | it out by running
|
---|
[26971] | 16 | svn checkout http://svn.greenstone.org/main/trunk/gli
|
---|
[36234] | 17 | in the Greenstone2 folder.
|
---|
[17957] | 18 |
|
---|
[2403] | 19 | -- Compiling and installing on Unix --
|
---|
| 20 |
|
---|
[36234] | 21 | cd to the top level Greenstone2 directory (i.e. the directory
|
---|
| 22 | where this file lives) and run the following:
|
---|
[2403] | 23 |
|
---|
[36234] | 24 | 1. makegs2.sh gnome-lib imagemagick
|
---|
| 25 | 2. cd gli
|
---|
| 26 | 3. ./makegli.sh
|
---|
| 27 | 4. ./makejar.sh
|
---|
[2403] | 28 |
|
---|
[36234] | 29 | Notes:
|
---|
| 30 | 1. [gnome-lib] parameter: This will checkout and compile gnome-lib.
|
---|
| 31 | gnome-lib is needed on most linux machines to compile wvware. If you
|
---|
| 32 | don't need it. you can omit this parameter. If you need it but don't want
|
---|
| 33 | to compile it, you can download a gnome-lib-minimal package for your OS by
|
---|
| 34 | visiting http://trac.greenstone.org/browser/gs2-extensions/gnome-lib/trunk
|
---|
| 35 | (choose the appropriate package for your OS)
|
---|
| 36 | Then unzip the downloaded gnome-lib minimal package into your Greenstone2/ext
|
---|
| 37 | folder.
|
---|
| 38 | 2. [imagemagick] parameter - if you already have imagemagick installed, or
|
---|
| 39 | don't want it, you can omit this parameter.
|
---|
[2403] | 40 |
|
---|
[36234] | 41 | 3. CGI executables - This will install the library.cgi and oaiserver.cgi
|
---|
| 42 | executables to Greenstone2/cgi-bin/linux.
|
---|
| 43 | If you want to run Greenstone from a system cgi-bin directory you'll need to
|
---|
| 44 | move the library executable and gsdlsite.cfg from Greenstone2/cgi-bin/linux
|
---|
| 45 | to your system cgi-bin.
|
---|
| 46 | 4. The steps 2-4 are for compiling the Greenstone Librarian interface.
|
---|
| 47 |
|
---|
[2403] | 48 | Note that the Greenstone directory structure is important to the operation
|
---|
[36234] | 49 | of the software. Therefore the --prefix, --bindir etc. options to configure (which is run by makegs2.sh)
|
---|
[2403] | 50 | make no sense and will have no effect. If you want Greenstone to be
|
---|
| 51 | installed somewhere specific (say /usr/local) you'll need to move the
|
---|
[36234] | 52 | entire Greenstone2 directory there.
|
---|
[2403] | 53 |
|
---|
[26971] | 54 | Greenstone will install Apache into apache-httpd/linux. You can disable this
|
---|
[36234] | 55 | by editing makegs2.sh and removing the -enable-apache-httpd option to the
|
---|
| 56 | configure command. In that case you'll need to set up your own apache to
|
---|
| 57 | serve Greenstone. See
|
---|
| 58 | http://wiki.greenstone.org/doku.php?id=en:user_advanced:gs2_server
|
---|
[17957] | 59 | for more details.
|
---|
| 60 |
|
---|
| 61 |
|
---|
[36234] | 62 |
|
---|
[2403] | 63 | -- Compiling on Windows --
|
---|
| 64 |
|
---|
[36234] | 65 | Prerequisites:
|
---|
| 66 | * Java JDK 8 or later
|
---|
| 67 | * PERL (ActivePerl for Windows
|
---|
| 68 | * Visual Studio 8 or later
|
---|
[2403] | 69 |
|
---|
[26971] | 70 | There is a batch script you can run to set up and compile Greenstone.
|
---|
[26974] | 71 |
|
---|
| 72 | If you want Greenstone to try and guess your Visual Studio setup, edit the
|
---|
| 73 | makegs2.bat file and set SET_GS_ENV to true. Otherwise you'll need to set up
|
---|
| 74 | your Visual Studio environment before running the make script.
|
---|
| 75 | For example, run
|
---|
| 76 | C:\Program Files\Microsoft Visual Studio\vc\vcvarsall.bat
|
---|
| 77 |
|
---|
| 78 | To compile greenstone:
|
---|
[26971] | 79 | For 64 bit machines, run
|
---|
[26974] | 80 | * makegs2x64.bat
|
---|
[26971] | 81 | For 32 bit machines, run
|
---|
| 82 | * makegs2.bat
|
---|
[2403] | 83 |
|
---|
[26974] | 84 |
|
---|
| 85 |
|
---|
[36234] | 86 | For more information about compiling Greenstone, or for manual compiling
|
---|
[26974] | 87 | instructions, see
|
---|
[36234] | 88 | http://wiki.greenstone.org/doku.php?id=en:user_advanced:installation
|
---|
| 89 | http://wiki.greenstone.org/doku.php?id=en:developer:windows_source_install
|
---|
[2403] | 90 |
|
---|
[26974] | 91 | These scripts will unpack necessary zip files, set up paths etc, then compile
|
---|
| 92 | Greenstone. They will install library.cgi and oaiserver.cgi to the
|
---|
| 93 | Greenstone\cgi-bin\windows
|
---|
[19177] | 94 | directory and server.exe to the top level Greenstone directory.
|
---|
[17957] | 95 |
|
---|
| 96 | To compile the GLI, cd to the gli directory and run makegli.bat.
|
---|
| 97 |
|
---|