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

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

testing svn

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