source: main/trunk/greenstone2/Install.txt@ 36234

Last change on this file since 36234 was 36234, checked in by kjdon, 3 months ago

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

  • Property svn:keywords set to Author Date Id Revision
File size: 3.7 KB
Line 
1Compiling and Installing Greenstone 2
2--------------------------------------
3
4Note: more up-to-date notes may be available on our website, at
5http://wiki.greenstone.org/doku.php?id=en:user_advanced:installation
6
7
8The following instructions assume the top level Greenstone folder is called
9Greenstone2. Please adjust these instructions to match the folder name in
10your situation.
11
12The Greenstone Librarian Interface (GLI) code will be in the gli folder inside
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
16 svn checkout http://svn.greenstone.org/main/trunk/gli
17in the Greenstone2 folder.
18
19-- Compiling and installing on Unix --
20
21cd to the top level Greenstone2 directory (i.e. the directory
22where this file lives) and run the following:
23
241. makegs2.sh gnome-lib imagemagick
252. cd gli
263. ./makegli.sh
274. ./makejar.sh
28
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.
47
48Note that the Greenstone directory structure is important to the operation
49of the software. Therefore the --prefix, --bindir etc. options to configure (which is run by makegs2.sh)
50make no sense and will have no effect. If you want Greenstone to be
51installed somewhere specific (say /usr/local) you'll need to move the
52entire Greenstone2 directory there.
53
54Greenstone will install Apache into apache-httpd/linux. You can disable this
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
59for more details.
60
61
62
63-- Compiling on Windows --
64
65Prerequisites:
66 * Java JDK 8 or later
67 * PERL (ActivePerl for Windows
68 * Visual Studio 8 or later
69
70There is a batch script you can run to set up and compile Greenstone.
71
72If you want Greenstone to try and guess your Visual Studio setup, edit the
73makegs2.bat file and set SET_GS_ENV to true. Otherwise you'll need to set up
74your Visual Studio environment before running the make script.
75For example, run
76C:\Program Files\Microsoft Visual Studio\vc\vcvarsall.bat
77
78To compile greenstone:
79For 64 bit machines, run
80 * makegs2x64.bat
81For 32 bit machines, run
82 * makegs2.bat
83
84
85
86For more information about compiling Greenstone, or for manual compiling
87instructions, see
88http://wiki.greenstone.org/doku.php?id=en:user_advanced:installation
89http://wiki.greenstone.org/doku.php?id=en:developer:windows_source_install
90
91These scripts will unpack necessary zip files, set up paths etc, then compile
92Greenstone. They will install library.cgi and oaiserver.cgi to the
93Greenstone\cgi-bin\windows
94directory and server.exe to the top level Greenstone directory.
95
96To compile the GLI, cd to the gli directory and run makegli.bat.
97
Note: See TracBrowser for help on using the repository browser.