1 | Compiling and Installing Greenstone 2
|
---|
2 | --------------------------------------
|
---|
3 |
|
---|
4 | Note: more up-to-date notes may be available on our website, at
|
---|
5 | http://wiki.greenstone.org/doku.php?id=en:user_advanced:installation
|
---|
6 |
|
---|
7 |
|
---|
8 | The following instructions assume the top level Greenstone folder is called
|
---|
9 | Greenstone2. Please adjust these instructions to match the folder name in
|
---|
10 | your situation.
|
---|
11 |
|
---|
12 | The Greenstone Librarian Interface (GLI) code will be in the gli folder inside
|
---|
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
|
---|
16 | svn checkout http://svn.greenstone.org/main/trunk/gli
|
---|
17 | in the Greenstone2 folder.
|
---|
18 |
|
---|
19 | -- Compiling and installing on Unix --
|
---|
20 |
|
---|
21 | cd to the top level Greenstone2 directory (i.e. the directory
|
---|
22 | where this file lives) and run the following:
|
---|
23 |
|
---|
24 | 1. makegs2.sh gnome-lib imagemagick
|
---|
25 | 2. cd gli
|
---|
26 | 3. ./makegli.sh
|
---|
27 | 4. ./makejar.sh
|
---|
28 |
|
---|
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.
|
---|
40 |
|
---|
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 |
|
---|
48 | Note that the Greenstone directory structure is important to the operation
|
---|
49 | of the software. Therefore the --prefix, --bindir etc. options to configure (which is run by makegs2.sh)
|
---|
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
|
---|
52 | entire Greenstone2 directory there.
|
---|
53 |
|
---|
54 | Greenstone will install Apache into apache-httpd/linux. You can disable this
|
---|
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
|
---|
59 | for more details.
|
---|
60 |
|
---|
61 |
|
---|
62 |
|
---|
63 | -- Compiling on Windows --
|
---|
64 |
|
---|
65 | Prerequisites:
|
---|
66 | * Java JDK 8 or later
|
---|
67 | * PERL (ActivePerl for Windows
|
---|
68 | * Visual Studio 8 or later
|
---|
69 |
|
---|
70 | There is a batch script you can run to set up and compile Greenstone.
|
---|
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:
|
---|
79 | For 64 bit machines, run
|
---|
80 | * makegs2x64.bat
|
---|
81 | For 32 bit machines, run
|
---|
82 | * makegs2.bat
|
---|
83 |
|
---|
84 |
|
---|
85 |
|
---|
86 | For more information about compiling Greenstone, or for manual compiling
|
---|
87 | instructions, see
|
---|
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
|
---|
90 |
|
---|
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
|
---|
94 | directory and server.exe to the top level Greenstone directory.
|
---|
95 |
|
---|
96 | To compile the GLI, cd to the gli directory and run makegli.bat.
|
---|
97 |
|
---|