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

Revision 22766, 4.0 KB (checked in by mdewsnip, 10 years ago)

Instead of having two copies of expat in Greenstone (one for Linux and one for Windows), added Windows makefiles into the version in common-src/packages/expat. This means we can remove the Windows-only version in common-src/packages/windows/expat, and also means that expat now works the same as SQLite.

  • 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 gsdl.
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/gli/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
202. make
213. make install
22
23This will install the library.cgi and oaiserver.cgi executables to
24Greenstone/cgi-bin.
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 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
35You'll need to install Apache and set it up to serve Greenstone. Then you'll need to edit Greenstone/cgi-bin/gsdlsite.cfg. See
36http://wiki.greenstone.org/wiki/index.php/Setting_up_an_Apache_Web_Server_for_Greenstone_2_Walkthrough
37for more details. 
38
39To compile the GLI, cd to the gli directory and run makegli.sh
40
41-- Compiling on Windows --
42
43Greenstone has been successfully compiled using Microsoft Visual C++
44versions 4.2, 6.0 and 2005. If anyone succeeds in compiling Greenstone with
45another compiler (or another version of VC++) we'd appreciate hearing about
46it at greenstone-devel@list.scms.waikato.ac.nz
47
48The major difference between compiling with VC++ 4.2 compared with
49VC++ 6.0/2005 is that 4.2 must use the STLport standard template library
50(packaged with Greenstone) while VC++ 6.0/2005 may use its own built in
51STL implementation.
52
53Perform the following steps to compile and install Greenstone. Note that
54some parts of the process described are specific to one or other of the two
55compilation options mentioned above. These steps are marked as such.
56
571. Unzip the following zip archives (into the directories in which the
58   zip files themselves are contained).
59
60   * Greenstone\common-src\indexers\packages\windows\iconv\iconv.zip
61   * Greenstone\common-src\packages\windows\gdbm\gdbm.zip
62   * Greenstone\common-src\packages\windows\crypt\crypt.zip
63   * Greenstone\common-src\packages\windows\stlport\stlport.zip (VC++ 4.2 only)
64
652. To use VC++ command line tools you may need to execute the
66   MSDEV\BIN\VCVARS32.BAT batch file to set up your environment.
67
683. cd to the top level Greenstone directory (i.e. the directory where
69   this file lives).
70
714. compile the web library (library.cgi) and OAI server (oaiserver.cgi) with
72   "nmake /f win32.mak GSDL_VC4=1" (VC++ 4.2)
73   or
74   "nmake /f win32.mak" (VC++ 6.0/2005)
75
765. compile the local library (server.exe) with
77   "nmake /f win32.mak GSDL_VC4=1 LOCAL_LIBRARY=1" (VC++ 4.2)
78   or
79   "nmake /f win32.mak LOCAL_LIBRARY=1" (VC++ 6.0/2005)
80
81This will install library.cgi and oaiserver.cgi to the Greenstone\cgi-bin
82directory and server.exe to the top level Greenstone directory.
83
84To run the web library you'll need to set up a web server to serve Greenstone. Then you'll need to edit Greenstone\cgi-bin\gsdlsite.cfg. See
85http://wiki.greenstone.org/wiki/index.php/Setting_up_an_Apache_Web_Server_for_Greenstone_2_Walkthrough
86for more details about using Apache, or
87http://wiki.greenstone.org/wiki/index.php/Installing_Greenstone#How_do_I_use_Greenstone.27s_web_library_with_IIS.3F
88for more details about using IIS.
89
90To compile the GLI, cd to the gli directory and run makegli.bat.
91
Note: See TracBrowser for help on using the browser.