root/main/trunk/greenstone2/Install.txt @ 31904

Revision 30378, 3.7 KB (checked in by kjdon, 4 years ago)

testing svn

  • Property svn:keywords set to Author Date Id Revision
Line 
1
2Note: more up-to-date notes may be available on our website, at
3 http://wiki.greenstone.org/wiki/index.php/Installing_Greenstone
4
5The following instructions assume the top level Greenstone folder is called
6Greenstone (which is the standard name used for Greenstone 2 releases).
7If you have got Greenstone from SVN, the top level directory will be greenstone2.
8
9The Greenstone Librarian Interface (GLI) code will be in the gli folder inside
10the Greenstone folder. If you are using SVN and you want to use the GLI to
11build collections, you'll need to check it out by running
12 svn checkout http://svn.greenstone.org/main/trunk/gli
13in the Greenstone folder.
14
15-- Compiling and installing on Unix --
16
17cd to the top level Greenstone directory (i.e. the directory
18where this file lives) and perform the following three steps.
19
201. ./configure --enable-apache-httpd
212. make
223. make install
23
24This will install the library.cgi and oaiserver.cgi executables to
25Greenstone/cgi-bin/linux.
26If you want to run Greenstone from a system
27cgi-bin directory you'll need to move the library executable and
28gsdlsite.cfg from Greenstone/cgi-bin/linux to your system cgi-bin.
29
30Note that the Greenstone directory structure is important to the operation
31of the software. Therefore the --prefix, --bindir etc. options to configure
32make no sense and will have no effect. If you want Greenstone to be
33installed somewhere specific (say /usr/local) you'll need to move the
34entire Greenstone directory there.
35
36Greenstone will install Apache into apache-httpd/linux. You can disable this
37by running ./configure without the -enable-apache-httpd option. In that case
38you'll need to set up your own apache to serve Greenstone. See   See
39http://wiki.greenstone.org/wiki/index.php/Setting_up_an_Apache_Web_Server_for_Greenstone_2_Walkthrough
40for more details. 
41
42To compile the GLI, cd to the gli directory and run makegli.sh
43
44-- Compiling on Windows --
45
46Greenstone has been successfully compiled using Microsoft Visual C++
47versions 4.2, 6.0 and 2005. If anyone succeeds in compiling Greenstone with
48another compiler (or another version of VC++) we'd appreciate hearing about
49it at greenstone-devel@list.scms.waikato.ac.nz
50
51If you have got Greenstone from svn, you'll also need to download some Windows binaries.
521. cd to top-level greenstone2 folder.
532. cd bin
543. svn co http://svn.greenstone.org/main/trunk/binaries/windows/bin windows
55
56
57There is a batch script you can run to set up and compile Greenstone.
58
59If you want Greenstone to try and guess your Visual Studio setup, edit the
60makegs2.bat file and set SET_GS_ENV to true. Otherwise you'll need to set up
61your Visual Studio environment before running the make script.
62For example, run
63C:\Program Files\Microsoft Visual Studio\vc\vcvarsall.bat
64
65To compile greenstone:
66For 64 bit machines, run
67   * makegs2x64.bat
68For 32 bit machines, run
69   * makegs2.bat
70
71
72
73For more information about compiling Greenstone, or for manual compling
74instructions, see
75http://wiki.greenstone.org/wiki/index.php/Compiling_Greenstone
76
77These scripts will unpack necessary zip files, set up paths etc, then compile
78Greenstone. They will install library.cgi and oaiserver.cgi to the
79Greenstone\cgi-bin\windows
80directory and server.exe to the top level Greenstone directory.
81
82To run the web library you'll need to set up a web server to serve Greenstone.
83Then you'll need to edit Greenstone\cgi-bin\gsdlsite.cfg. See
84http://wiki.greenstone.org/wiki/index.php/Setting_up_an_Apache_Web_Server_for_Greenstone_2_Walkthrough
85for more details about using Apache, or
86http://wiki.greenstone.org/wiki/index.php/Installing_Greenstone#How_do_I_use_Greenstone.27s_web_library_with_IIS.3F
87for more details about using IIS.
88
89To compile the GLI, cd to the gli directory and run makegli.bat.
90
Note: See TracBrowser for help on using the browser.